OpenTelemetry FMPy Instrumentation

OpenTelemetry instrumentation for FMPy, providing distributed tracing and observability for Functional Mock-up Unit (FMU) simulations.

Installation

uv add opentelemetry-instrumentation-fmpy

Usage

Programmatic Instrumentation

from opentelemetry.instrumentation.fmpy import FmpyInstrumentor

# Enable instrumentation
FmpyInstrumentor().instrument()

import fmpy
# FMU operations are now traced automatically
result = fmpy.simulate_fmu("model.fmu", stop_time=10.0)

# Disable instrumentation
FmpyInstrumentor().uninstrument()

Development

Requirements

• Python 3.8+
• uv (for development)

Citation

If you use this repository in your research or publications, please cite it using the following BibTeX entry:

@misc{opentelemetry-instrumentation-fmpy,
  author       = {Christoffer Björkskog},
  title        = {OpenTelemetry Instrumentation for FMPy},
  year         = {2025},
  howpublished = {\url{https://github.com/Novia-RDI-Seafaring/opentelemetry-instrumentation-fmpy}},
  note         = {Contact: christoffer.bjorkskog@novia.fi},
  institution  = {Novia University of Applied Sciences}
}

License

This project is licensed under the MIT License - see the LICENSE file for details.