opentelemetry-instrumentation-fmpy 0.1.0

OpenTelemetry instrumentation for FMPy

OpenTelemetry FMPy Instrumentation

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

Installation

pip install 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)

Example

You can run the demo code showing how it is used.

uv run python demo/main.py <paht-to-fmu-file>

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: [e-mail]},
  institution  = {Novia University of Applied Sciences}
}

License

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