Розширення інструментацій за допомогою API

Вступ

На додачу до інструментації, що працює з коробки, ви можете розширити Java-агент власною ручною інструментацією за допомогою OpenTelemetry API. Це дозволяє вам створювати відрізки та метрики для вашого власного коду без внесення значних змін до коду.

Залежності

Додайте залежність від бібліотеки opentelemetry-api.

Maven

<dependencies>
  <dependency>
    <groupId>io.opentelemetry</groupId>
    <artifactId>opentelemetry-api</artifactId>
    <version>1.58.0</version>
  </dependency>
</dependencies>

Gradle

dependencies {
    implementation('io.opentelemetry:opentelemetry-api:1.58.0')
}

OpenTelemetry

Java-агент є особливим випадком, де GlobalOpenTelemetry встановлюється агентом. Просто викличте GlobalOpenTelemetry.getOrNoop() для доступу до екземпляра OpenTelemetry.

Відрізок

import io.opentelemetry.api.GlobalOpenTelemetry;
import io.opentelemetry.api.trace.Tracer;

Tracer tracer = GlobalOpenTelemetry.getTracer("application");

Використовуйте Tracer для створення відрізка, як пояснено в розділі Відрізок.

Повний приклад можна знайти в [репозиторії з прикладами].

Meter

import io.opentelemetry.api.GlobalOpenTelemetry;
import io.opentelemetry.api.metrics.Meter;

Meter meter = GlobalOpenTelemetry.getMeter("application");

Використовуйте Meter для створення лічильника, датчика або гістограми, як пояснено в розділі Meter.

Повний приклад можна знайти в репозиторії з прикладами.