App下載

需要了解的有關 OpenTelemetry Java 代理的所有信息

草莓配可樂 2021-08-25 11:05:58 瀏覽數(shù) (4432)
反饋

OpenTelemetry Java 代理使 Java 應用程序能夠自動生成和捕獲遙測數(shù)據(jù)。本文將全面概述了 OpenTelemetry Java 代理,包括它的工作原理。但首先,讓我們一下了解 OpenTelemetry 是什么。

什么是OpenTelemetry?

OpenTelemetry 是一組代碼 , 一組 API、SDK、工具和集成,它可以幫你生成、發(fā)出、收集、處理和導出 Telemetry 數(shù)據(jù)。

使用 OpenTelemetry 捕獲的遙測數(shù)據(jù)可以讓你的系統(tǒng)和應用程序具有可觀察性。它還會標準化這個過程。你使用 OpenTelemetry 收集的數(shù)據(jù)與供應商無關,可以用多種格式導出。

OpenTelemetry 不附帶后端分析工具。對于 Telemetry 數(shù)據(jù)的存儲、分析和可視化,你還可以使用像SigNoz這樣的全??捎^察性平臺。

我們如何使用 OpenTelemetry 生成 Telemetry數(shù)據(jù)?

Telemetry 數(shù)據(jù)是使用稱為檢測的過程生成的。OpenTelemetry 為手動和自動檢測提供檢測庫。這些庫特定于它們所使用的語言。設置檢測的說明也因編程語言而異。

OpenTelemetry 將檢測庫定義為支持另一個庫的可觀察性的庫。

OpenTelemetry Java 庫

對于 Java 應用程序,OpenTelemetry 提供了三個存儲庫:

opentelemetry-java這個 repo 是主要的 OpenTelemetry Java SDK 并提供用于手動檢測的組件。頂級組件包括 OpenTelemetry API、擴展、SDK、用于 OpenTracing 和 OpenCensus 的橋接層。

opentelemetry-java-instrumentation這是opentelemetry-java的兄弟項目,提供一體化、易于安裝的自動檢測 Java 代理。OpenTelemetry Java 代理使您能夠從許多流行的庫和框架中捕獲 Telemetry 數(shù)據(jù)。你需要將其附加到任何 Java 8+ 應用程序。我們將在下面了解有關 Java 代理的更多信息。

opentelemetry-java-contribOpenTelemetry java 提供這個 repo 來涵蓋不適合 opentelemetry-java 和 opentelemetry-java-instrumentation 范圍的基于 JVM 的應用程序和工作流。

什么是 OpenTelemetry Java 代理?

OpenTelemetry 有一個非常方便的 Java JAR 代理,可以附加到任何 Java 8+ 應用程序以檢測 Java 應用程序。Java JAR 代理可以檢測許多流行的庫和框架,并開箱即用地對其進行檢測以生成遙測數(shù)據(jù)。

OpenTelemetry 收集器捕獲生成的 Telemetry 數(shù)據(jù),然后可以將其導出為所需的格式。如果你用的是 SigNoz,那么就可以使用默認的 OTLP 導出器。Java 代理和導出器可以通過命令行配置一些環(huán)境變量。你無需對代碼進行任何更改,這就是為什么開始使用 OpenTelemetry Java 代理如此方便的原因。

如何使用 OpenTelemetry Java 代理?

需要為要監(jiān)視的每個主機下載和分發(fā) Java 代理。

使用 OpenTelemetry Java 代理的步驟:

  • 下載最新的 Java JAR 代理并將其分發(fā)到每個受監(jiān)控的主機和服務。
  • 準備環(huán)境變量,例如受監(jiān)控服務的服務名稱和將導出數(shù)據(jù)的端點
  • 運行時將代理附加到應用程序的 jar 中

如果你想要將數(shù)據(jù)導出到SigNoz等可觀察性工具,則必須指定托管 SigNoz 的主機的 IP 地址。SigNoz 在端口號 4317 偵聽傳入數(shù)據(jù)。因此請記住允許傳入請求到 SigNoz 所在的端口號 4317。

要處理的一些環(huán)境變量的示例:

OTEL_TRACES_EXPORTER=otlp
OTEL_METRICS_EXPORTER=none
OTEL_EXPORTER_OTLP_ENDPOINT=<IP of SigNoz Backend>:4317
OTEL_RESOURCE_ATTRIBUTES="service.name=SERVICE_NAME"

讓我們看看當你想要運行附加到應用程序的 Java 代理時命令的樣子:

OTEL_METRICS_EXPORTER=none
OTEL_EXPORTER_OTLP_ENDPOINT="http://<IP of SigNoz>:4317"
OTEL_RESOURCE_ATTRIBUTES=service.name=javaApp
java -javaagent:/path/to/opentelemetry-javaagent-all.jar -jar target/*.jar

Java 代理 JAR 文件的路徑需要替換為下載文件的位置。例如,對于我的本地,命令??如下所示:

OTEL_METRICS_EXPORTER=none
OTEL_EXPORTER_OTLP_ENDPOINT="http://<IP of SigNoz>:4317"
OTEL_RESOURCE_ATTRIBUTES=service.name=javaApp
java -javaagent:/Users/Downloads/to/opentelemetry-javaagent-all.jar -jar target/*.jar

有了這個,OpenTelemetry Java 代理將動態(tài)注入字節(jié)碼以從許多流行的庫和框架中捕獲遙測數(shù)據(jù)。讓我們看看列表中包含的一些庫和框架是什么。

OpenTelemetry Java 代理支持的庫和框架列表

OpenTelemetry Java 代理支持的用于自動檢測的庫和框架包括:

  • Akka HTTP 10.0+
  • Apache HttpClient 2.0+
  • AWS Lambda 1.0+
  • AWS 開發(fā)工具包 1.11.x 和 2.2.0+
  • Cassandra 驅動程序 3.0+
  • 彈性搜索 API 5.0+
  • Elasticsearch REST 客戶端 5.0+
  • gRPC 1.6+
  • JDBC Java 8+
  • 絕地武士 1.4+
  • 卡夫卡 0.11+
  • Kubernetes 客戶端 7.0+
  • MongoDB 驅動程序 3.1+
  • OkHttp 3.0+
  • RabbitMQ 客戶端 2.7+
  • Spark Web 框架 2.3+
  • Spring Web 服務 2.0+
  • Vert.x 3.0+

Java 代理支持的一些流行應用服務器包括 Glassfish、JBoss EAP、Jetty、Payara、Tomcat、TomEE、Weblogic 和 Wildfly。

你可以在opentelemetry-java-instrumentation GitHub存儲庫中找到 OpenTelemetry Java 代理支持的受支持庫和框架的完整列表。

結論

OpenTelemetry Java Jar 代理提供了一種快速方便的方法來使您的 Java 應用程序具有可觀察性。通過對許多流行庫進行開箱即用的檢測,Java 代理可以成為使用 OpenTelemetry 檢測應用程序的良好起點。

如前所述,OpenTelemetry 是一個與供應商無關的工具庫。因此遙測數(shù)據(jù)是可移植的。您可以將其配置為以多種不同格式導出。像SigNoz這樣的工具支持默認的 OTLP 格式,是發(fā)送遙測數(shù)據(jù)的完美選擇。它還帶有一個可視化層,您可以在其中可視化圖表,例如流行的 RED 指標和使用火焰圖和甘特圖的分布式跟蹤。

用戶界面
火焰圖


0 人點贊