データ API ビルダーで Azure Application Insights を使用する

Azure Application Insights は、要求の詳細、パフォーマンス カウンター、ログ、例外などのテレメトリをキャプチャする監視サービスです。 これを Data API Builder (DAB) と統合すると、問題を診断し、運用環境でのランタイム動作を監視するのに役立ちます。

警告 Azure App Service Web アプリを使用して DAB がホストされている場合、Application Insights はサポートされません。

コンフィギュレーション

DAB 構成で Application Insights を構成するには:

CLI の例

dab add-telemetry \
  --app-insights-enabled true \
  --app-insights-conn-string "@env('app-insights-connection-string')"

JSON 例

"runtime": {
  ...
  "telemetry": {
    "application-insights": {
      "enabled": true,
      "connection-string": "@env('app-insights-connection-string')"
    }
  }
  ...
}

これは、 app-insights-connection-string が環境変数として設定されていることを前提としています。 .env ファイルを使用して定義できます。

キャプチャされる内容

タイプ	説明
テレメトリを要求する	URL、状態コード、応答時間
トレース テレメトリ	DAB からのコンソール ログ
例外テレメトリ	エラーとスタック トレース
性能カウンター	CPU、メモリ、ネットワーク メトリック

Azure での表示

1. Azure portal で Application Insights リソースに移動します。 https://portal.azure.com
2. 次のクエリを使用してログを確認します。

traces
| order by timestamp

LogLevel マッピング:

LogLevel	深刻さ	価値
トレース	詳細	0
デバッグ	詳細	0
情報	情報	1
Warnung	Warnung	2
エラー	エラー	3
危うい	危うい	4

3. ライブ メトリックを確認する

4. 要求に対して次のクエリを実行します。

requests
| order by timestamp

5. 例外については、次のクエリを実行します。

exceptions
| order by timestamp