Application Insights の接続文字列

接続文字列には、インストルメント化されたアプリケーションからテレメトリ データを送信する必要がある Application Insights リソースを指定します。 接続文字列は複数の設定で構成されます。各設定はキーと値のペアとして表され、セミコロンで区切られます。 このように構成方法が統合されているため、複数のプロキシ設定が不要になり、セットアップ プロセスが簡単になります。

接続文字列の機能性

• 信頼性: 接続文字列は、グローバルインジェストエンドポイントへの依存を取り除くことで、テレメトリーのインジェストの信頼性を高めます。
• セキュリティ: 接続文字列は、Application Insights の Microsoft Entra 認証を使用して、認証されたテレメトリをインジェストすることを可能にします。
• カスタマイズされたエンドポイント (ソブリンまたはハイブリッド クラウド環境): エンドポイント設定を使用すると、特定の Azure Government リージョンにデータを送信できます。 (次の例を参照してください。)
• プライバシー (リージョンのエンドポイント): 接続文字列では、データはリージョンのエンドポイントに送信され、地理的リージョンの外に流出しないので、プライバシーに関する懸念が軽減されます。

接続文字列を見つける

接続文字列は、Application Insights リソースの [概要] セクションに表示されます。

スキーマ

スキーマ要素については、以下のセクションで説明します。

最大長

接続でサポートされている最大長は 4096 文字です。

キーと値のペア

接続文字列は、キーと値のペアがセミコロンで区切られた設定のリストで構成されます: key1=value1;key2=value2;key3=value3

構文

• InstrumentationKey (例: 00000000-0000-0000-0000-000000000000)。 InstrumentationKey は "必須" フィールドです。

• Authorization (例: ikey)。 現時点では ikey 認証のみがサポートされているため、この設定は省略可能です。

• EndpointSuffix (例: applicationinsights.azure.cn)。 エンドポイント サフィックスを設定すると、SDK に接続先の Azure クラウドが指定されます。 SDK により、個々のサービスに対して残りのエンドポイントが構成されます。

• 明示的なエンドポイント。 どのサービスも、接続文字列内で明示的にオーバーライドできます:

  • IngestionEndpoint (例: https://dc.applicationinsights.azure.com)
  • LiveEndpoint (例: https://live.applicationinsights.azure.com)
  • ProfilerEndpoint (例: https://profiler.monitor.azure.com)
  • SnapshotEndpoint (例: https://snapshot.monitor.azure.com)

エンドポイント スキーマ

<prefix>.<suffix>

• プレフィックス: サービスを定義します。
• サフィックス: 共通ドメイン名を定義します。

有効なサフィックス

• applicationinsights.azure.cn
• applicationinsights.us

詳細については、「エンドポイントの変更が必要なリージョン」を参照してください。

有効なプレフィックス

• テレメトリ インジェスト: dc
• ライブ メトリック: live
• .NET 用プロファイラー: profiler
• スナップショット: snapshot

接続文字列の例

さまざまな接続文字列の例を次に示します。

エンドポイント サフィックスが付いた接続文字列

InstrumentationKey=00000000-0000-0000-0000-000000000000;EndpointSuffix=ai.contoso.com;

この例では、接続文字列でエンドポイント サフィックスが指定され、SDK によってサービス エンドポイントが構成されます。

• 認証方式の既定値は "ikey" です
• インストルメンテーション キー: 00000000-0000-0000-0000-000000000000
• リージョン サービスの Uniform Resource Identifier (URI) は、提供されたエンドポイントのサフィックスに基づいてます。
  • インジェスト: https://dc.ai.contoso.com
  • ライブ メトリック: https://live.ai.contoso.com
  • .NETのプロファイラー: https://profiler.ai.contoso.com
  • デバッガー: https://snapshot.ai.contoso.com

明示的なエンドポイント オーバーライドを含む接続文字列

InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://custom.com:111/;LiveEndpoint=https://custom.com:222/;ProfilerEndpoint=https://custom.com:333/;SnapshotEndpoint=https://custom.com:444/;

この例では、この接続文字列によって、すべてのサービスに明示的なオーバーライドが指定されています。 SDK により、提供された正確なエンドポイントがそのまま使用されます。

• 認証方式の既定値は "ikey" です
• インストルメンテーション キー: 00000000-0000-0000-0000-000000000000
• リージョン サービスの URI は、明示的なオーバーライド値に基づきます。
  • インジェスト: https://custom.com:111/
  • ライブ メトリック: https://custom.com:222/
  • .NETのプロファイラー: https://custom.com:333/
  • デバッガー: https://custom.com:444/

明示的なリージョンを含む接続文字列

InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://southcentralus.in.applicationinsights.azure.com/

この例では、接続文字列によって米国中南部リージョンが指定されています。

• 認証方式の既定値は "ikey" です
• インストルメンテーション キー: 00000000-0000-0000-0000-000000000000
• リージョン サービスの URI は、明示的なオーバーライド値に基づきます。
  • インジェスト: https://southcentralus.in.applicationinsights.azure.com/

使用できるリージョンを一覧表示するには、Azure CLI で次のコマンドを実行します。

az account list-locations -o table

接続文字列を設定する

すべての OpenTelemetry オファリングと次の SDK バージョン以降では、接続文字列がサポートされています。

• .NET v2.12.0
• JavaScript v2.3.0
• NodeJS v1.5.0
• Python v1.0.0
• Java v3.1.1

接続文字列を設定するには、コードを使用するか、環境変数または構成ファイルを使用します。

環境変数

接続文字列: APPLICATIONINSIGHTS_CONNECTION_STRING

コード サンプル

次のステップ

よく寄せられる質問 (FAQ) を確認するには:

• Application Insights の接続文字列に関する FAQ

実行時に開始する:

• Azure Virtual Machine (VM) と Azure Virtual Machine Scale Sets でホストされた IIS アプリ
• インターネット インフォメーション サーバー (IIS) サーバー
• Azure App Service の Web Apps の機能

開発の際に始めるには次を行ってください:

• ASP.NET Core
• ASP.NET
• ジャワ
• Node.js
• パイソン