快速开始

安装

  1. opentelemetry-java-instrumentation 仓库的 Releases 下载 opentelemetry-javaagent.jar 并将 JAR 放在您偏好的目录中。 JAR 文件包含代理和插桩库。
  2. 添加 -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.debugEnvironment variable: OTEL_JAVAAGENT_DEBUG

Description: 设置为 true 以查看调试日志。请注意,这些日志非常详细。

下一步操作

在为应用程序或服务配置好自动插桩后,你可能需要为选定的方法添加注解, 或通过手动插桩来收集自定义遥测数据。