Version 4 (V4) von AWS SDK für .NET wurde veröffentlicht\$1

Informationen zu wichtigen Änderungen und zur Migration Ihrer Anwendungen finden Sie im [Migrationsthema](https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/net-dg-v4.html).

 [https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/net-dg-v4.html](https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/net-dg-v4.html)

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.

# Beobachtbarkeit
<a name="observability"></a>

Beobachtbarkeit ist das Ausmaß, in dem der aktuelle Zustand eines Systems aus den ausgegebenen Daten abgeleitet werden kann. Die ausgegebenen Daten werden allgemein als Telemetrie bezeichnet.

 AWS SDK für .NET Sie können zwei gängige Telemetriesignale, Metriken und Traces, sowie Protokollierung bereitstellen. Sie können eine Verbindung herstellen [TelemetryProvider](https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/Runtime/TTelemetryProvider.html), um Telemetriedaten an ein Observability-Backend (z. B. [AWS X-Ray](https://docs.aws.amazon.com/xray/?icmpid=docs_homepage_devtools)oder [Amazon CloudWatch](https://docs.aws.amazon.com/cloudwatch/?icmpid=docs_homepage_mgmtgov)) zu senden und dann darauf zu reagieren.

Standardmäßig sind Telemetriesignale im SDK deaktiviert. In diesem Thema wird erklärt, wie die Telemetrieausgabe aktiviert und konfiguriert wird.

## Weitere Ressourcen
<a name="observability-resources"></a>

Weitere Informationen zur Aktivierung und Verwendung von Observability finden Sie in den folgenden Ressourcen:
+ [OpenTelemetry](https://opentelemetry.io/)
+ Der Blogbeitrag [Enhancing Observability in the AWS SDK für .NET with](https://aws.amazon.com/blogs/developer/enhancing-observability-in-the-aws-sdk-for-net-with-opentelemetry/). OpenTelemetry
+ Der Blogbeitrag [Ankündigung der allgemeinen Verfügbarkeit AWS OpenTelemetry von.NET-Bibliotheken](https://aws.amazon.com/blogs/dotnet/announcing-the-general-availability-of-aws-net-opentelemetry-libraries/).
+ [Exporteure für OpenTelemetry](https://opentelemetry.io/docs/languages/net/exporters/)
+ Beispiele für Observability in finden Sie unter [Observability](https://docs.aws.amazon.com/powershell/latest/userguide/observability.html) im [Tools for PowerShell ](https://docs.aws.amazon.com/powershell/latest/userguide/) User Guide. AWS -Tools für PowerShell

## Konfigurieren Sie ein `TelemetryProvider`
<a name="observability-conf-telemetry-provider"></a>

Sie können a `TelemetryProvider` in Ihrer Anwendung global für alle Service-Clients oder für einzelne Clients konfigurieren, wie in den folgenden Beispielen gezeigt. Der [Telemetrieanbieter](observability-telemetry-providers.md) Abschnitt enthält Informationen zu Telemetrie-Implementierungen, einschließlich Informationen zu Implementierungen, die mit dem SDK bereitgestellt werden.

### Konfigurieren Sie den globalen Standardtelemetrie-Anbieter
<a name="observability-conf-telemetry-provider-global"></a>

Standardmäßig versucht jeder Dienstclient, den weltweit verfügbaren Telemetrieanbieter zu verwenden. Auf diese Weise können Sie den Anbieter einmal festlegen, und alle Clients verwenden ihn. Dies sollte nur einmal durchgeführt werden, bevor Sie Service-Clients erstellen.

Der folgende Codeausschnitt zeigt Ihnen, wie Sie den globalen Telemetrieanbieter einrichten. Anschließend wird ein Amazon S3 S3-Serviceclient erstellt und versucht, einen fehlgeschlagenen Vorgang auszuführen. Der Code fügt der Anwendung sowohl Tracing als auch Metriken hinzu. Dieser Code verwendet die folgenden NuGet Pakete: `OpenTelemetry.Exporter.Console` und`OpenTelemetry.Instrumentation.AWS`.

**Anmerkung**  
Wenn Sie AWS IAM Identity Center für die Authentifizierung verwenden, achten Sie darauf, auch `AWSSDK.SSO` und hinzuzufügen`AWSSDK.SSOOIDC`.

```
using Amazon.S3;
using OpenTelemetry;
using OpenTelemetry.Metrics;
using OpenTelemetry.Resources;
using OpenTelemetry.Trace;

Sdk.CreateTracerProviderBuilder()
    .ConfigureResource(e => e.AddService("DemoOtel"))
    .AddAWSInstrumentation()
    .AddConsoleExporter()
    .Build();

Sdk.CreateMeterProviderBuilder()
    .ConfigureResource(e => e.AddService("DemoOtel"))
    .AddAWSInstrumentation()
    .AddConsoleExporter()
    .Build();

var s3Client = new AmazonS3Client();

try
{
    var listBucketsResponse = await s3Client.ListBucketsAsync();
    // Attempt to delete a bucket that doesn't exist.
    var deleteBucketResponse = await s3Client.DeleteBucketAsync("amzn-s3-demo-bucket");
}
catch (Exception ex)
{
    Console.WriteLine(ex.Message);
}

Console.Read();
```

### Konfigurieren Sie einen Telemetrieanbieter für einen bestimmten Service-Client
<a name="observability-conf-telemetry-provider-client"></a>

Sie können einen einzelnen Dienstclient mit einem bestimmten Telemetrieanbieter (mit Ausnahme des globalen) konfigurieren. Verwenden Sie dazu die `TelemetryProvider` Klasse des Config-Objekts eines Service-Client-Konstruktors. Sehen Sie sich zum Beispiel [AmazonS3Config](https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/S3/TS3Config.html) an und suchen Sie nach der Eigenschaft. `TelemetryProvider` Informationen zu benutzerdefinierten [Telemetrieanbieter](observability-telemetry-providers.md) Telemetrie-Implementierungen finden Sie unter.

**Topics**
+ [Weitere Ressourcen](#observability-resources)
+ [Konfigurieren Sie ein `TelemetryProvider`](#observability-conf-telemetry-provider)
+ [Metriken](observability-metrics.md)
+ [Telemetrieanbieter](observability-telemetry-providers.md)