Azure App Service でアプリの診断ログを有効にする

Azure には、Azure App Service アプリのデバッグに役立つ組み込みの診断機能が用意されています。 この記事では、診断ログを有効にし、アプリケーションにインストルメンテーションを追加する方法について説明します。 また、Azure がログに記録する情報にアクセスする方法についても説明します。

この記事では、 Azure portal と Azure CLI を使用して診断ログを操作します。 Visual Studio を使用した診断ログの操作については、「Visual Studio を使用 した Azure App Service でのアプリのトラブルシューティング」を参照してください。

この記事のログ記録手順に加えて、Azure Monitor 統合ログ機能を使用できます。 詳細については、「 Azure Monitor へのログの送信」を参照してください。

ログの種類の概要

ログが App Service ファイル システムに格納されると、価格レベルで使用可能なストレージの対象になります。 詳細については、「 App Service の制限」を参照してください。

アプリケーションのログ記録を有効にする (Windows)

Azure portal で Windows アプリのアプリケーション ログを有効にするには:

1. アプリに移動し、 監視>App Service ログを選択します。

2. 次のいずれかのオプションまたは両方のオプション で [オン] を 選択します。

   • アプリケーション ログ (ファイルシステム): このオプションは、一時的なデバッグを目的とします。 12 時間でオフになります。

   • アプリケーション ログ (BLOB): このオプションは、長期的なログ記録用です。 ログを書き込むための BLOB ストレージ コンテナーが必要です。

     BLOB オプションには、ログ メッセージの配信元仮想マシン インスタンスの ID (InstanceId)、スレッド ID (Tid)、より詳細なタイム スタンプ (EventTickCount) など、ログ メッセージに追加情報が含まれます。

3. [ レベル] で、ログに記録する詳細のレベルを選択します。 次の表に、各レベルに含まれるログのカテゴリを示します。

   レベル	含まれるカテゴリ
   無効	なし
   エラー	エラー、 重大
   警告	警告、 エラー、 重大
   情報	情報、 警告、 エラー、 重大
   詳細	トレース、 デバッグ、 情報、 警告、 エラー、 重大 (すべてのカテゴリ)

4. 保存 を選択します。

BLOB にログを書き込む場合、アプリを削除しても BLOB にログを保持していると、アイテム保持ポリシーは適用されなくなります。 詳細については、「リソースの削除後に発生する可能性があるコスト」を参照してください。

現時点では、.NET アプリケーション ログのみを BLOB ストレージに書き込むことができます。 Java、PHP、Node.js、Python のアプリケーション ログは、外部ストレージにログを書き込むためのコードを変更することなく、App Service ファイル システムにのみ格納できます。

ストレージ アカウントのアクセス キーを再生成する場合は、更新されたアクセス キーを使用するように、それぞれのログ構成をリセットする必要があります。

1. [ 構成 ] タブで、それぞれのログ機能を [オフ] に設定します。 設定を保存します。

2. ストレージ アカウントの BLOB へのログ記録をもう一度有効にします。 設定を保存します。

アプリケーション ログを有効にする (Linux またはコンテナー)

Azure portal で Linux アプリまたはカスタム コンテナーのアプリケーション ログを有効にするには:

1. アプリに移動し、 監視>App Service ログを選択します。

2. [アプリケーション ログ記録] で [ファイル システム] を選択します。

3. [クォータ (MB)] で、アプリケーション ログのディスク クォータを指定します。

4. [ 保持期間 (日数)] で、ログを保持する日数を設定します。

5. 保存 を選択します。

Web サーバーのログ記録を有効にする

Azure portal で Windows アプリの Web サーバー ログを有効にするには:

1. アプリに移動し、 監視>App Service ログを選択します。

2. Web サーバーのログ記録の場合は、[ストレージ] を選択して BLOB ストレージにログを格納するか、[ファイル システム] を選択して App Service ファイル システムにログを格納します。

3. [ 保持期間 (日数)] で、ログを保持する日数を設定します。

4. 保存 を選択します。

BLOB にログを書き込む場合、アプリを削除しても BLOB にログを保持していると、アイテム保持ポリシーは適用されなくなります。 詳細については、「リソースの削除後に発生する可能性があるコスト」を参照してください。

ストレージ アカウントのアクセス キーを再生成する場合は、更新されたキーを使用するように、それぞれのログ構成をリセットする必要があります。

1. [ 構成 ] タブで、それぞれのログ機能を [オフ] に設定します。 設定を保存します。

2. ストレージ アカウントの BLOB へのログ記録をもう一度有効にします。 設定を保存します。

詳細なエラーのログを記録する

Azure portal で Windows アプリのエラー ページまたは失敗した要求トレースを保存するには:

1. アプリに移動し、 監視>App Service ログを選択します。

2. [ 詳細なエラー メッセージ ] または [失敗した要求トレース] で、[オン] を選択します。

3. 保存 を選択します。

どちらの種類のログも、App Service ファイル システムに格納されます。 最大 50 個のエラー (ファイルまたはフォルダー) が保持されます。 HTML ファイルの数が 50 を超えると、App Service は最も古いエラー ファイルを削除します。

既定では、失敗した要求トレースは、400 から 600 までの HTTP 状態コードで失敗した要求のログをキャプチャします。 カスタム規則を指定するには、<traceFailedRequests> ファイルの Web.config セクションをオーバーライドします。

コードでログ メッセージを追加する

アプリケーション コードでは、通常のログ機能を使用して、ログ メッセージをアプリケーション ログに送信できます。 次に例を示します。

• アプリケーション ASP.NET System.Diagnostics.Trace クラスを使用して、アプリケーション診断ログに情報を記録できます。 次に例を示します。

  System.Diagnostics.Trace.TraceError("If you're seeing this, something bad happened");
  

  ASP.NET Core では、既定で、Microsoft.Extensions.Logging.AzureAppServices ログ プロバイダーが使用されます。 詳しくは、Azure 内での ASP.NET Core のログ記録に関するページをご覧ください。 WebJobs SDK のログの詳細については、Azure WebJobs SDK の概要に関するページを参照してください。

• Python アプリケーションでは、OpenTelemetry を使用して、アプリケーション診断ログにログを送信できます。 詳細については、「 Azure Monitor OpenTelemetry を有効にする」を参照してください。

ログのストリーミング

ログをリアルタイムでストリーミングする前に、目的のログの種類を有効にします。 App Service は、コンソール出力に書き込まれた情報、または /home/LogFiles ディレクトリ (D:\home\LogFiles) に格納されている .txt、.log、または .htm で終わるファイルをストリーミングします。

Azure Portal

Azure portal でログをストリーミングするには、アプリに移動し、[監視>ログ ストリーム] を選択します。

Cloud Shell

Azure Cloud Shell でログをライブストリーミングするには、次のコマンドを使用します。

az webapp log tail --name appname --resource-group myResourceGroup

HTTP などの特定のログの種類をフィルター処理するには、 --provider パラメーターを使用します。 次に例を示します。

az webapp log tail --name appname --resource-group myResourceGroup --provider http

ローカル ターミナル

ローカル コンソールでログをストリーミングするには、 Azure CLI をインストール して アカウントにサインインします。 ログインした後、Cloud Shell の場合の手順に従います。

アクセス ログ ファイル

ログの種類に Azure Storage BLOB オプションを構成する場合は、Azure Storage で使用できるクライアント ツールが必要です。 詳細については、 Azure Storage を操作するための Microsoft クライアント ツールに関するページを参照してください。

App Service ファイル システムに格納されているログについては、Kudu エンジンを使用してログにアクセスします。

1. Azure portal でアプリを開き、[ 開発ツール>Advanced Tools] を選択し、[ Go] を選択します。
2. Kudu で、ツール>診断ダンプを選択します。

Linux またはカスタム コンテナーの場合、ZIP ファイルには Docker ホストと Docker コンテナーの両方のコンソール出力ログが含まれます。 スケールアウトされたアプリの場合、ZIP ファイルには、各インスタンスの 1 セットのログが含まれます。 App Service ファイル システムでは、これらのログ ファイルは /home/LogFiles ディレクトリの内容です。 デプロイ ログは、 /site/deployments/に格納されます。

Windows アプリの場合、ZIP ファイルには App Service ファイル システムの D:\Home\LogFiles ディレクトリの内容が含まれます。 その構造を次に示します。

ログを Azure Monitor に送信する

Azure Monitor 統合を使用すると、診断設定を作成して、ストレージ アカウント、イベント ハブ、Log Analytics ワークスペースにログを送信できます。 診断設定を追加すると、App Service がアプリ設定をアプリに追加し、それによってアプリの再起動がトリガーされます。

サポートされるログの種類

サポートされているログの種類とその説明の一覧については、「Microsoft.Web でサポートされているリソース ログ」を参照してください。

ネットワークに関する考慮事項

診断設定の制限については、「 宛先の制限」を参照してください。

関連コンテンツ

• Azure Monitor のログ クエリ
• Azure App Service のクォータとアラート
• Visual Studio を使用した Azure App Service でのアプリのトラブルシューティング
• チュートリアル: ロード テストを実行して Web アプリのパフォーマンスのボトルネックを特定する