Azure Go 向けコンテナアプリのトレース

Azure Container Apps にデプロイされた Go アプリケーションについては、 Instana の Go インプロセスコレクターを使用してトレースを設定できます。 Go のインプロセス・コレクターを有効にするには、アプリケーションに Instana の Go Tracer SDKを組み込み、 Azure のコンテナアプリにデプロイし、必要な環境変数が設定されていることを確認してください。

サポートされるランタイム

Instana Go in-processコレクタは、 Go、 1.21 以降に対応しています。

制限

現在、 Instana では、 Azure コンテナアプリのインフラストラクチャメトリクスの収集に対応していません。

Go 向けの「 Azure 」コンテナアプリ・トレーシングの設定

Go 向けの「 Azure 」コンテナアプリのトレースを設定するには、以下のセクションを参照してください

前提条件

Go のインプロセス・コレクター・モジュールは、必ず最新バージョンを使用してください。 Go のインプロセス・コレクター・モジュールが最新バージョンであることを確認するには、プロジェクト内のファイル go.mod を確認するか、次のコマンドを実行してください:

go get github.com/instana/go-sensor@latest

最新の Go インプロセス・コレクターをお持ちでない場合は、最新バージョンをダウンロードし、ファイル go.mod 内の必要なバージョンを更新してください。 詳細については、 「 Go のインストール」 を参照してください。

Azure コンテナアプリの設定

Instana Go インプロセス・コレクター( 1.63.0 )は、Azure エージェントにおいて Azure コンテナアプリに対応しています。 Go アプリケーションに Instana Go Tracer SDKを組み込むと、 Instana Go のインプロセス・コレクターはサーバーレスモードに切り替わります。 収集したスパンをホストエージェントに送信する代わりに、コレクターはそれらを Instana のサーバーレスアクセプターエンドポイントに直接送信します。このエンドポイントは、 INSTANA_ENDPOINT_URL 環境変数を使用して設定されます。

この処理では、環境 INSTANA_AGENT_KEY 変数に定義されているエージェントキーを使用します。 Azure Container Apps のリソース ID は、インフラストラクチャー相関のエンティティー ID として使用されます。 リソースIDを生成するには、環境変数 AZURE_SUBSCRIPTION_IDAZURE_RESOURCE_GROUP を設定する必要があります。

収集したスパンを Instana バックエンドに送信するには、 Azure のコンテナアプリで以下の環境変数を設定してください:

インフラストラクチャー相関の場合は、以下の環境変数を設定します。

トレースの使用可能化

Azure のコンテナアプリで Go アプリケーションのトレースを有効にするには、以下の手順を実行してください:

  1. Instana Go Tracer SDK をダウンロードしたら、ダウンロードした SDK を使用してアプリケーションに計測機能を組み込んでください。

  2. アプリケーションのコンテナー・イメージを作成します。

  3. コンテナー・イメージを Azure Container Apps にデプロイします。

    注: イメージをデプロイする前に、 Azure の「コンテナアプリ」で必要な環境変数が設定されていることを確認してください。 詳細については、 「 Azure コンテナアプリの構成」 を参照してください。

これで、 Instana のUIから Go のアプリケーショントレースを確認できるようになりました。

. ginNETで記述されたWebサーバーがあると仮定します。 トレースを有効にするには、 Instana の Go Tracer SDKを使用してアプリケーションに github.com/instana/go-sensor/tree/main/instrumentation/instagin トレース機能を組み込んでください。 次に、アプリケーションのコンテナイメージを作成し、 Azure のコンテナアプリにデプロイします。 イメージをデプロイするときに、必要な環境変数が設定されていることを確認してください。