Automatic Instrumentation¶

Java 自動檢測使用可附加到任何 Java 8+ 應用程序的 Java 代理 JAR。它動態注入 bytecode 以從許多流行的庫和框架中捕獲遙測數據。它可用於在應用程序或服務的“邊緣”捕獲遙測數據，例如入站請求、出站 HTTP 調用、數據庫調用等。要了解如何手動檢測您的服務或應用程序代碼，請參閱手動檢測。

設置¶

1. 從 opentelemetry-java-instrumentation 存儲庫的 Releases 下載 opentelemetry-javaagent.jar。 JAR 文件包含代理和檢測庫。

2. 將 JAR 放在您的目錄中並使用您的應用程序啟動它：

   $ java -javaagent:path/to/opentelemetry-javaagent.jar -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

要查看全部配置選項，請參閱代理配置。

Exporters¶

以下配置屬性對所有導出器都是通用的：

OTLP exporter (span, metric, and log exporters)¶

OpenTelemetry 協議 (OTLP) span、metric 和 log 導出器:

要為 OTLP 導出器配置服務名稱，請將 service.name 鍵添加到 OpenTelemetry 資源（見下文），例如 OTEL_RESOURCE_ATTRIBUTES=service.name=myservice。

Jaeger exporter¶

Jaeger 導出器。該導出器使用 gRPC 作為其通信協議。

Zipkin exporter¶

Zipkin 導出器。它將 Zipkin 格式的 JSON 發送到指定的 HTTP URL。

Prometheus exporter¶

Prometheus 導出器。

請注意，這是一個拉式導出器 - 它在本地進程上打開一個服務器，偵聽指定的主機和端口，讓 Prometheus 服務器從中抓取指標數據。

Logging exporter¶

日誌導出器將 span 的名稱及其屬性打印到標準輸出。它主要用於測試和調試。

Propagator¶

Propagator 確定使用哪些分佈式跟踪標頭格式，以及使用哪些 baggage 傳播標頭格式。

支持的值有:

• tracecontext: W3C Trace Context (add baggage as well to include W3C baggage)
• baggage: W3C Baggage
• b3: B3 Single
• b3multi: B3 Multi
• jaeger: Jaeger (includes Jaeger baggage)
• xray: AWS X-Ray
• ottrace: OT Trace