- 从reporeleases下载opentelemetry-javaagent.jar并将 JAR 放在你的首选目录中。JAR 该文件包括代理和检测库。
opentelemetry-java-instrumentation
- 添加
-javaagent:path/to/opentelemetry-javaagent.jar
还有其他配置给你的 JVM 启动参数并启动您的应用:
- 直接在启动命令上:
java -javaagent:path/to/opentelemetry-javaagent.jar -Dotel.service.name=your-service-name -jar myapp.jar
- 通过
JAVA_TOOL_OPTIONS
以及其它环境变量:
export JAVA_TOOL_OPTIONS="-javaagent:path/to/opentelemetry-javaagent.jar"export OTEL_SERVICE_NAME="your-service-name"java -jar myapp.jar
配置代理
原则是高度可配置。
选择是通过标志传递配置属性-D
。在这个例子中,配置了跟踪服务名称和服务名称 Zipkin 导出器:
java -javaagent:path/to/opentelemetry-javaagent.jar \ -Dotel.service.name=your-service-name \ -Dotel.traces.exporter=zipkin \ -jar myapp.jar
您还可以使用环境变量来配置代理:
OTEL_SERVICE_NAME=your-service-name \OTEL_TRACES_EXPORTER=zipkin \java -javaagent:path/to/opentelemetry-javaagent.jar \ -jar myapp.jar
您还可以提供一个 Java 配置值从属性文件中加载:
java -javaagent:path/to/opentelemetry-javaagent.jar \ -Dotel.javaagent.configuration-file=path/to/properties/file.properties \ -jar myapp.jar
或者
OTEL_JAVAAGENT_CONFIGURATION_FILE=path/to/properties/file.properties \java -javaagent:path/to/opentelemetry-javaagent.jar \ -jar myapp.jar
故障排除
您可以将-Dotel.javaagent.debug=true
将参数传递给代理商查看调试日志。请注意,这些都很冗长。
Java 该代理附有许多流行组件的检测库。有关完整列表,请参阅支持的库、框架、应用服务和 JVM。