C# ASP.NET 用の Cloud Trace の設定

Cloud Trace for ASP.NET Framework アプリケーションを有効にするには、C# 用の Google.Cloud.Diagnostics.AspNet クライアントライブラリを使用します。

このページには、Google Cloud で Trace を有効にして構成する方法に関する一般的な情報を記載しています。Google.Cloud.Diagnostics.AspNet クライアントライブラリを構成して使用する方法については、Google.Cloud.Diagnostics.AspNet リファレンスドキュメントをご覧ください。

プラットフォームの構成

Cloud Trace は Google Cloud と他のプラットフォームで使用できます。

Google Cloud での実行

アプリケーションが Google Cloud で実行されている場合、認証情報をサービスアカウントの形式でクライアントライブラリに提供する必要はありません。ただし、Google Cloud Platform で Cloud Trace API のアクセススコープが有効になっている必要があります。

サポートされている Google Cloud 環境の一覧については、環境サポートをご覧ください。

次の構成では、デフォルトのアクセススコープ設定により Cloud Trace API が有効化されます。

App Engine フレキシブル環境
Google Kubernetes Engine（GKE）

注: Autopilot を使用している場合、または GKE クラスタで Workload Identity を有効にする場合は、Workload Identity を使用するようにアプリケーションを構成します。
Compute Engine
Cloud Run

カスタムアクセススコープを使用する場合は、Cloud Trace API のアクセススコープを有効にする必要があります。

Google Cloud Console を使用して環境のアクセススコープを構成する方法については、Google Cloud プロジェクトの構成をご覧ください。
gcloud ユーザーの場合は、--scopes フラグを使用してアクセススコープを指定し、trace.append Cloud Trace API アクセススコープを含めます。たとえば、Cloud Trace API のみを有効にして GKE クラスタを作成するには、次のようにします。
```
gcloud container clusters create example-cluster-name --scopes=https://www.googleapis.com/auth/trace.append
```

ローカルやその他の場所での実行

アプリケーションが Google Cloud の外部で実行されている場合は、認証情報をサービスアカウントの形式でクライアントライブラリに提供する必要があります。サービスアカウントには Cloud Trace エージェントロールが含まれている必要があります。手順については、サービスアカウントの作成をご覧ください。

Google Cloud クライアントライブラリは、アプリケーションのデフォルト認証情報（ADC）を使用してアプリケーションの認証情報を検索します。

これらの認証情報を指定するには、次の 3 つの方法があります。

実行 gcloud auth application-default login
オペレーティングシステムのデフォルトパスにサービスアカウントを配置します。以下に、Windows と Linux のデフォルトのパスを一覧表示します。
- Windows: %APPDATA%/gcloud/application_default_credentials.json
- Linux: $HOME/.config/gcloud/application_default_credentials.json
GOOGLE_APPLICATION_CREDENTIALS 環境変数をサービスアカウントのパスに設定します。

Linux / macOS

    export GOOGLE_APPLICATION_CREDENTIALS=path-to-your-service-accounts-private-key

Windows

    set GOOGLE_APPLICATION_CREDENTIALS=path-to-your-service-accounts-private-key

PowerShell:

    $env:GOOGLE_APPLICATION_CREDENTIALS="path-to-your-service-accounts-private-key"

トレースを表示

Google Cloud コンソールで、[Trace エクスプローラ] ページに移動します。

[Trace エクスプローラ] に移動

このページは、検索バーを使用して見つけることもできます。

トラブルシューティング

Cloud Trace に関する問題のトラブルシューティングについては、トラブルシューティングページをご覧ください。