快速开始
安装
- 从
opentelemetry-java-instrumentation
仓库的 Releases 下载 opentelemetry-javaagent.jar 并将 JAR 放在您偏好的目录中。 JAR 文件包含代理和插桩库。 - 添加
-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
要查看完整的配置选项,请参阅代理配置。
支持的库、框架、应用服务和 JVM
Java 代理附带许多流行组件的插桩库。 要查看完整的支持列表,请参阅支持的库、框架、应用服务和 JVM。
Troubleshooting
System property:
otel.javaagent.debug
Environment variable:
OTEL_JAVAAGENT_DEBUG
Description:
设置为 true
以查看调试日志。请注意,这些日志非常详细。
下一步操作
在为应用程序或服务配置好自动插桩后,你可能需要为选定的方法添加注解, 或通过手动插桩来收集自定义遥测数据。
Feedback
Was this page helpful?
Thank you. Your feedback is appreciated!
Please let us know how we can improve this page. Your feedback is appreciated!