|Project Name||Stars||Downloads||Repos Using This||Packages Using This||Most Recent Commit||Total Releases||Latest Release||Open Issues||License||Language|
|Client_golang||4,916||22,965||3 days ago||109||September 27, 2023||88||apache-2.0||Go|
|Prometheus instrumentation library for Go applications|
|Mtail||3,659||2 days ago||56||June 30, 2023||53||apache-2.0||Go|
|extract internal monitoring data from application logs for collection in a timeseries database|
|Client_python||3,609||844||18 days ago||49||November 21, 2023||94||apache-2.0||Python|
|Prometheus instrumentation library for Python applications|
|Appmetrics||2,191||24||94||16 days ago||65||November 26, 2021||99||apache-2.0||C#|
|App Metrics is an open-source and cross-platform .NET library used to record and report metrics within an application.|
|Client_java||2,070||580||546||24 days ago||40||June 15, 2022||90||apache-2.0||Java|
|Prometheus instrumentation library for JVM applications|
|Opentelemetry Java Instrumentation||1,542||106||16 hours ago||65||November 18, 2023||371||apache-2.0||Java|
|OpenTelemetry auto-instrumentation and instrumentation libraries for Java|
|Rust Prometheus||981||124||261||11 days ago||39||October 21, 2022||81||apache-2.0||Rust|
|Prometheus instrumentation library for Rust applications|
|Mgob||770||a year ago||15||June 15, 2021||mit||Go|
|MongoDB dockerized backup agent. Runs schedule backups with retention, S3 & SFTP upload, notifications, instrumentation with Prometheus and more.|
|Prometheus Fastapi Instrumentator||674||27||19 days ago||34||August 23, 2022||35||isc||Python|
|Instrument your FastAPI with Prometheus metrics.|
|Jaeger Client Python||410||87||65||a year ago||37||September 14, 2021||apache-2.0||Python|
|🛑 This library is DEPRECATED!|
This project provides a Java agent JAR that can be attached to any Java 8+ application and dynamically injects bytecode to capture telemetry from a number of popular libraries and frameworks. You can export the telemetry data in a variety of formats. You can also configure the agent and exporter via command line arguments or environment variables. The net result is the ability to gather telemetry data from a Java application without code changes.
This repository also publishes standalone instrumentation for several libraries (and growing) that can be used if you prefer that over using the Java agent. Please see the standalone library instrumentation column on Supported Libraries. If you are looking for documentation on using those.
Download the latest version.
This package includes the instrumentation agent as well as instrumentations for all supported libraries and all available data exporters. The package provides a completely automatic, out-of-the-box experience.
Enable the instrumentation agent using the
-javaagent flag to the JVM.
java -javaagent:path/to/opentelemetry-javaagent.jar \ -jar myapp.jar
Configuration parameters are passed as Java system properties (
-D flags) or
as environment variables. See the configuration documentation
for the full list of configuration items. For example:
java -javaagent:path/to/opentelemetry-javaagent.jar \ -Dotel.resource.attributes=service.name=your-service-name \ -Dotel.traces.exporter=zipkin \ -jar myapp.jar
The agent is highly configurable! Many aspects of the agent's behavior can be configured for your needs, such as exporter choice, exporter config (like where data is sent), trace context propagation headers, and much more.
Note: Config parameter names are very likely to change over time, so please check back here when trying out a new version! Please report any bugs or unexpected behavior you find.
We support an impressively huge number of libraries and frameworks and a majority of the most popular application servers...right out of the box! Click here to see the full list and to learn more about disabled instrumentation and how to suppress unwanted instrumentation.
Extensions add new features and capabilities to the agent without having to create a separate distribution or to fork this repository. For example, you can create custom samplers or span exporters, set new defaults, and embed it all in the agent to obtain a single jar file.
For most users, the out-of-the-box instrumentation is completely sufficient and nothing more has to be done. Sometimes, however, users wish to add attributes to the otherwise automatic spans, or they might want to manually create spans for their own custom code.
For detailed instructions, see Manual instrumentation.
It is possible to inject trace information like trace IDs and span IDs into your custom application logs. For details, see Logger MDC auto-instrumentation.
To turn on the agent's internal debug logging:
Note: These logs are extremely verbose. Enable debug logging only when needed. Debug logging negatively impacts the performance of your application.
Learn more about roles in the community repository.
Thanks to all the people who already contributed!