AWS SDK for .NET V3 がメンテナンスモードになりました。

AWS SDK for .NET V4 に移行することをお勧めします。移行方法の詳細と情報については、メンテナンスモードのお知らせを参照してください。

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

オブザーバビリティ

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

は、2 つの一般的なテレメトリシグナル、メトリクスとトレース、およびログ記録を提供 AWS SDK for .NET できます。TelemetryProvider をワイヤアップして、テレメトリデータをオブザーバビリティバックエンド (AWS X-Ray や Amazon CloudWatch など) に送信し、それに対応できます。

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

その他のリソース

オブザーバビリティの有効化と使用の詳細については、以下のリソースを参照してください。

TelemetryProvider の設定

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

デフォルトのグローバルテレメトリプロバイダーを設定する

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

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

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();

特定のサービスクライアントのテレメトリプロバイダーを設定する

個々のサービスクライアントは、特定のテレメトリプロバイダー (グローバルプロバイダーを除く) で設定できます。これを行うには、サービスクライアントコンストラクタの Config オブジェクトの TelemetryProvider クラスを使用します。例えば、AmazonS3Config を参照して、TelemetryProvider プロパティを探します。カスタムテレメトリの実装については、「テレメトリプロバイダー」を参照してください。