Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Penyedia telemetri
<a name="observability-telemetry-providers"></a>

SDK saat ini mendukung [OpenTelemetry](https://opentelemetry.io/)(OTel) sebagai penyedia. SDK mungkin menawarkan penyedia telemetri tambahan di masa depan.

**Topics**
+ [Konfigurasikan penyedia telemetri OpenTelemetry berbasis](observability-telemetry-providers-otel.md)

# Konfigurasikan penyedia telemetri OpenTelemetry berbasis
<a name="observability-telemetry-providers-otel"></a>

SDK untuk Kotlin menyediakan implementasi `TelemetryProvider` antarmuka yang didukung oleh. OpenTelemetry

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

Perbarui dependensi project Anda untuk menambahkan OpenTelemetry penyedia seperti yang ditunjukkan pada cuplikan Gradle berikut. Anda dapat menavigasi ke *X.Y.Z* tautan untuk melihat versi terbaru yang tersedia.

```
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")
}
```

## Konfigurasikan SDK
<a name="observability-telemetry-providers-otel-conf"></a>

Kode berikut mengkonfigurasi klien layanan dengan menggunakan penyedia OpenTelemetry telemetri.

```
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
        …
    }
}
```

**catatan**  
Diskusi tentang cara mengkonfigurasi OpenTelemetry SDK berada di luar cakupan panduan ini. [Dokumentasi OpenTelemetry Java](https://opentelemetry.io/docs/instrumentation/java/) berisi informasi konfigurasi pada berbagai pendekatan: [secara manual](https://opentelemetry.io/docs/instrumentation/java/manual/), secara otomatis melalui [agen Java](https://opentelemetry.io/docs/instrumentation/java/automatic/), atau [kolektor](https://opentelemetry.io/docs/collector/) (opsional).

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

Sumber daya berikut tersedia untuk membantu Anda memulai OpenTelemetry.
+ [AWS Distro untuk OpenTelemetry](https://aws-otel.github.io/docs/introduction) - beranda AWS OTe L Distro
+ [aws-otel-java-instrumentation](https://github.com/aws-observability/aws-otel-java-instrumentation)- AWS Distro untuk Perpustakaan Instrumentasi OpenTelemetry Java
+ [aws-otel-lambda](https://github.com/aws-observability/aws-otel-lambda)- Lapisan OpenTelemetry Lambda yang AWS dikelola
+ [aws-otel-collector](https://github.com/aws-observability/aws-otel-collector)- AWS Distro untuk Kolektor OpenTelemetry
+ [AWS Praktik Terbaik Observabilitas - Praktik](https://aws-observability.github.io/observability-best-practices/) terbaik umum untuk observabilitas khusus AWS