

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.

# Anbieter von Telemetriedaten
<a name="observability-telemetry-providers"></a>

Das SDK unterstützt derzeit [OpenTelemetry](https://opentelemetry.io/)(OTel) als Anbieter. Das SDK könnte in future weitere Telemetrieanbieter anbieten.

**Topics**
+ [Konfigurieren Sie den OpenTelemetry basierten Telemetrieanbieter](observability-telemetry-providers-otel.md)

# Konfigurieren Sie den OpenTelemetry basierten 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](https://aws-otel.github.io/docs/introduction) - AWS OTe L Distro-Homepage
+ [aws-otel-java-instrumentation](https://github.com/aws-observability/aws-otel-java-instrumentation)- AWS Instrumentierungsbibliothek für Distro für Java OpenTelemetry 
+ [aws-otel-lambda](https://github.com/aws-observability/aws-otel-lambda)- AWS verwaltete OpenTelemetry Lambda-Schichten
+ [aws-otel-collector](https://github.com/aws-observability/aws-otel-collector)- AWS Distribution für Collector OpenTelemetry
+ AWS Bewährte Methoden [zur Beobachtbarkeit — Allgemeine bewährte](https://aws-observability.github.io/observability-best-practices/) Verfahren für Beobachtbarkeit, spezifisch für AWS