Azure App Service でのアプリの診断ログの有効化

このビデオでは、アプリの診断ログを有効にする方法について説明します。

ビデオの手順については、次のセクションでも説明します。

概要

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

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

App Service ファイル システムに保存されている場合、ログには価格レベルで使用可能なストレージが適用されます (App Serviceの制限に関するページを参照してください)。

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

Azure portal で Windows アプリのアプリケーション ログ記録を有効にするには、アプリに移動し、 [App Service ログ] を選択します。

[アプリケーション ログ (ファイル システム)] と [アプリケーション ログ (Blob)] の一方または両方で、 [オン] を選択します。

ファイル システム オプションは、一時的なデバッグ用であり、12 時間で自動的にオフになります。 Blob オプションは、長期的なログ記録用であり、ログを書き込む BLOB ストレージ コンテナーが必要です。 Blob オプションには、ログ メッセージの生成元 VM インスタンスの ID (InstanceId)、スレッド ID (Tid)、さらに細かいタイムスタンプ (EventTickCount) など、ログ メッセージの追加情報も含まれます。

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

終わったら、 [保存] を選択します。

アプリケーションのログ記録を有効にする (Linux/コンテナー)

Azure portal で Linux アプリまたはカスタム コンテナーのアプリケーション ログ記録を有効にするには、アプリに移動し、[App Service ログ] を選択します。

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

[クォータ (MB)] で、アプリケーション ログのディスク クォータを指定します。 [リテンション期間 (日)] で、ログを保持する日数を設定します。

終わったら、 [保存] を選択します。

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

Azure portal で Windows アプリの Web サーバー ログ記録を有効にするには、アプリに移動し、 [App Service ログ] を選択します。

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

[リテンション期間 (日)] で、ログを保持する日数を設定します。

終わったら、 [保存] を選択します。

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

Azure portal で Windows アプリのエラー ページまたは失敗した要求のトレースを保存するには、アプリに移動し、 [App Service ログ] を選択します。

[詳細なエラー ログ] または [失敗した要求のトレース] で [オン] を選択し、次に [保存] を選択します。

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

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

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

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

• 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 アプリケーションでは、OpenCensus パッケージを使用して、アプリケーション診断ログにログを送信できます。

ログのストリーミング

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

Azure Portal の場合

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

Cloud Shell の場合

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 クライアント ツール」をご覧ください。

App Service ファイル システムに格納されているログの場合、ファイルにアクセスする最も簡単な方法は、ブラウザーで次の ZIP ファイルをダウンロードすることです。

• Linux/custom コンテナー: https://<app-name>.scm.azurewebsites.net/api/logs/docker/zip
• Windows アプリ: https://<app-name>.scm.azurewebsites.net/api/dump

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 アプリのパフォーマンスのボトルネックを特定する