Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Configura il provider di telemetria basato OpenTelemetry
<a name="observability-telemetry-providers-otel"></a>

L'SDK per Kotlin fornisce un'implementazione dell'`TelemetryProvider`interfaccia supportata da. OpenTelemetry

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

Aggiorna le dipendenze del progetto per aggiungere il OpenTelemetry provider, come mostrato nel seguente frammento di Gradle. Puoi accedere al *X.Y.Z* link per vedere l'ultima versione disponibile.

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

## Configurare l'SDK
<a name="observability-telemetry-providers-otel-conf"></a>

Il codice seguente configura un client di servizio utilizzando il provider di OpenTelemetry telemetria.

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

**Nota**  
Una discussione su come configurare l' OpenTelemetry SDK non rientra nell'ambito di questa guida. La [documentazione OpenTelemetry Java](https://opentelemetry.io/docs/instrumentation/java/) contiene informazioni di configurazione sui vari approcci: [manualmente](https://opentelemetry.io/docs/instrumentation/java/manual/), automaticamente tramite l'[agente Java](https://opentelemetry.io/docs/instrumentation/java/automatic/) o il [raccoglitore](https://opentelemetry.io/docs/collector/) (opzionale).

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

Le seguenti risorse sono disponibili per aiutarti a iniziare. OpenTelemetry
+ AWS Homepage di [Distro for OpenTelemetry](https://aws-otel.github.io/docs/introduction) - AWS OTe L Distro
+ [aws-otel-java-instrumentation](https://github.com/aws-observability/aws-otel-java-instrumentation)- AWS Distro per OpenTelemetry la libreria di strumentazione Java
+ [aws-otel-lambda](https://github.com/aws-observability/aws-otel-lambda)- livelli OpenTelemetry Lambda AWS gestiti
+ [aws-otel-collector](https://github.com/aws-observability/aws-otel-collector)- AWS Distro per collezionisti OpenTelemetry
+ AWS Migliori pratiche [di osservabilità - Migliori pratiche](https://aws-observability.github.io/observability-best-practices/) generali per l'osservabilità specifiche per AWS