のバージョン 4 (V4) AWS SDK for .NET がリリースされました。

重要な変更とアプリケーションの移行については、[「移行トピック](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)

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# オブザーバビリティ
<a name="observability"></a>

オブザーバビリティとは、システムが出力するデータから、そのシステムの現在の状態をどの程度推測できるかという指標のことです。出力されるデータは、一般的にテレメトリと呼ばれます。

は、2 つの一般的なテレメトリシグナル、メトリクスとトレース、およびログ記録を提供 AWS SDK for .NET できます。[TelemetryProvider](https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/Runtime/TTelemetryProvider.html) をワイヤアップして、テレメトリデータをオブザーバビリティバックエンド ([AWS X-Ray](https://docs.aws.amazon.com/xray/?icmpid=docs_homepage_devtools) や [Amazon CloudWatch](https://docs.aws.amazon.com/cloudwatch/?icmpid=docs_homepage_mgmtgov) など) に送信し、それに対応できます。

デフォルトでは、テレメトリ信号は SDK で無効になっています。このトピックでは、テレメトリ出力を有効にして設定する方法について説明します。

## その他のリソース
<a name="observability-resources"></a>

オブザーバビリティの有効化と使用の詳細については、以下のリソースを参照してください。
+ [OpenTelemetry](https://opentelemetry.io/)
+ ブログ記事[OpenTelemetry AWS SDK for .NET を使用した のオブザーバビリティの強化](https://aws.amazon.com/blogs/developer/enhancing-observability-in-the-aws-sdk-for-net-with-opentelemetry/)」。
+ このブログ記事では[、 AWS .NET OpenTelemetry ライブラリの一般提供を発表しています](https://aws.amazon.com/blogs/dotnet/announcing-the-general-availability-of-aws-net-opentelemetry-libraries/)。
+ [OpenTelemetry のエクスポーター](https://opentelemetry.io/docs/languages/net/exporters/)
+ のオブザーバビリティの例については AWS Tools for PowerShell、[「Tools for PowerShell ユーザーガイド](https://docs.aws.amazon.com/powershell/latest/userguide/)」の[「オブザーバビリティ](https://docs.aws.amazon.com/powershell/latest/userguide/observability.html)」を参照してください。

## `TelemetryProvider` の設定
<a name="observability-conf-telemetry-provider"></a>

次の例に示すように、すべてのサービスクライアントまたは個々のクライアントについて、アプリケーションで `TelemetryProvider` をグローバルに設定できます。[テレメトリプロバイダー](observability-telemetry-providers.md) セクションには、SDK で提供される実装に関する情報など、テレメトリの実装に関する情報が含まれています。

### デフォルトのグローバルテレメトリプロバイダーを設定する
<a name="observability-conf-telemetry-provider-global"></a>

デフォルトでは、すべてのサービスクライアントはグローバルに利用可能なテレメトリプロバイダーの使用を試みます。これにより、プロバイダーを 1 回設定でき、すべてのクライアントがそれを使用します。これは、サービスクライアントを作成する前に 1 回だけ行う必要があります。

次のコードスニペットは、グローバルテレメトリプロバイダーを設定する方法を示しています。次に、Amazon S3 サービスクライアントを作成し、オペレーションの実行を試みますが、失敗します。このコードは、トレースとメトリクスの両方をアプリケーションに追加します。このコードは、`OpenTelemetry.Exporter.Console` および `OpenTelemetry.Instrumentation.AWS` の NuGet パッケージを使用します。

**注記**  
認証 AWS IAM アイデンティティセンター に を使用している場合は、必ず `AWSSDK.SSO`と も追加してください`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();
```

### 特定のサービスクライアントのテレメトリプロバイダーを設定する
<a name="observability-conf-telemetry-provider-client"></a>

個々のサービスクライアントは、特定のテレメトリプロバイダー (グローバルプロバイダーを除く) で設定できます。これを行うには、サービスクライアントコンストラクタの Config オブジェクトの `TelemetryProvider` クラスを使用します。例えば、[AmazonS3Config](https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/S3/TS3Config.html) を参照して、`TelemetryProvider` プロパティを探します。カスタムテレメトリの実装については、「[テレメトリプロバイダー](observability-telemetry-providers.md)」を参照してください。

**Topics**
+ [その他のリソース](#observability-resources)
+ [`TelemetryProvider` の設定](#observability-conf-telemetry-provider)
+ [メトリクス](observability-metrics.md)
+ [テレメトリプロバイダー](observability-telemetry-providers.md)