

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Konfigurieren Sie den OpenTelemetry-based Telemetrieanbieter
<a name="observability-telemetry-providers-otel"></a>

Das SDK für Kotlin bietet eine Implementierung der `TelemetryProvider` Schnittstelle, die von OpenTelemetry unterstützt wird.

## Voraussetzungen
<a name="observability-telemetry-providers-otel-prereqs"></a>

Aktualisieren Sie Ihre Projektabhängigkeiten, um den OpenTelemetry Anbieter hinzuzufügen, wie im folgenden Gradle-Snippet gezeigt. Sie können zum {{X.Y.Z}} Link navigieren, um die neueste verfügbare Version zu sehen.

```
dependencies {
    implementation(platform("aws.smithy.kotlin:bom:[https://github.com/smithy-lang/smithy-kotlin/releases/latest](https://github.com/smithy-lang/smithy-kotlin/releases/latest)"))
    implementation(platform("io.opentelemetry.instrumentation:opentelemetry-instrumentation-bom:[https://search.maven.org/#search|gav|1|g:io.opentelemetry.instrumentation%20AND%20a:opentelemetry-instrumentation-bom](https://search.maven.org/#search|gav|1|g:io.opentelemetry.instrumentation%20AND%20a:opentelemetry-instrumentation-bom)"))
    implementation("aws.smithy.kotlin:telemetry-provider-otel")

    // OPTIONAL: If you use log4j, the following entry enables the ability to export logs through OTel.
    runtimeOnly("io.opentelemetry.instrumentation:opentelemetry-log4j-appender-2.17")
}
```

## Das SDKs konfigurieren
<a name="observability-telemetry-providers-otel-conf"></a>

Mit dem folgenden Code wird ein Dienstclient mithilfe des OpenTelemetry Telemetrieanbieters konfiguriert.

```
import aws.sdk.kotlin.services.s3.S3Client
import aws.smithy.kotlin.runtime.telemetry.otel.OpenTelemetryProvider
import io.opentelemetry.api.GlobalOpenTelemetry
import kotlinx.coroutines.runBlocking

fun main() = runBlocking {
    val otelProvider = OpenTelemetryProvider(GlobalOpenTelemetry.get())

    S3Client.fromEnvironment().use { s3 ->
        telemetryProvider = otelProvider
        …
    }
}
```

**Anmerkung**  
Eine Erläuterung der Konfiguration des OpenTelemetry SDK würde den Rahmen dieses Handbuchs sprengen. Die [OpenTelemetryJava-Dokumentation](https://opentelemetry.io/docs/instrumentation/java/) enthält Konfigurationsinformationen zu den verschiedenen Ansätzen: [manuell](https://opentelemetry.io/docs/instrumentation/java/manual/), automatisch über den [Java-Agenten](https://opentelemetry.io/docs/instrumentation/java/automatic/) oder den (optionalen) [Collector](https://opentelemetry.io/docs/collector/).

## Ressourcen
<a name="observability-telemetry-providers-otel-res"></a>

Die folgenden Ressourcen stehen Ihnen für den Einstieg zur Verfügung OpenTelemetry.
+ [AWS Distro für OpenTelemetry -AWS oTEL](https://aws-otel.github.io/docs/introduction) Distro Homepage
+ [aws-otel-java-instrumentation — Bibliothek für die Distribution für die Java-Instrumentierung](https://github.com/aws-observability/aws-otel-java-instrumentation)AWS OpenTelemetry 
+ [aws-otel-lambda](https://github.com/aws-observability/aws-otel-lambda) — verwaltete Lambda-Schichten AWS OpenTelemetry 
+ [aws-otel-collector — Distribution](https://github.com/aws-observability/aws-otel-collector) für AWS Collector OpenTelemetry
+ AWS Bewährte Methoden [zur Beobachtbarkeit — Allgemeine bewährte Verfahren für](https://aws-observability.github.io/observability-best-practices/) Beobachtbarkeit, spezifisch für AWS