1. Sitecore on Azureで分析を使用する

Application Insightsを使用したSitecoreログの分析

Version:
日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

Sitecoreは、Microsoft Azure® App Serviceでの実行時にログ情報をMicrosoft Application Insights® に書き込みます。

Application Insightsでは、エラー メッセージと警告メッセージを識別したり、特定のロールやSitecoreインスタンスからのメッセージを識別したり、特定のログ メッセージを検索したりできます。

Application Insightsを使用したSitecoreログの検索

Application Insightsを使用すると、Sitecoreログで特定の単語またはサブスクリプションを検索できます。

  1. Microsoft Azureポータルに移動してログオンします。

  2. DashboardでAll resourcesをクリックし、プロビジョニングされたAzureリソースのリストからSitecoreインストールを選択します。

  3. Application Insightsリソースをクリックします。ページが開いたら、ツールバーのSearchをクリックします。

  4. 右側に表示されるSearch パネルで、Search ボックスに主要な検索語を入力し、Enterをクリックします。

    メモ

    たとえば、「例外」と入力すると、ログ内の例外メッセージを検索できます。例外の特定のインスタンスを検索するには、例外が発生した可能性のある場所に例外クラス名またはメソッド名を追加することもできます。

  5. Search パネルの上部にあるFiltersをクリックします。

  6. 右側に表示されるFilter パネルのEvent Typesで、Trace チェックボックスとException  チェックボックスを除くすべてのチェックボックスをオフにします。

  7. Trace イベントを表示するには、パネルの下部にあるUpdateをクリックします。

時間範囲でログ メッセージを検索する

Application Insightsを使用すると、検索結果を特定の時間範囲に絞り込むことができます。

  1. Azureポータルで、Search ページの上部にあるTime rangeをクリックします。

  2. 右側に表示されるTime Rangeパネルで、関連する最近の時間範囲(30分や1時間など)を選択するか、カスタムの日付と時刻の範囲を指定します。

  3. パネルの下部にあるUpdateをクリックします。検索結果には、指定した期間内のメッセージのみが表示されます。

特定のSitecoreロールのログ メッセージを検索する

Sitecore環境内のすべてのSitecoreインスタンスは、同じApplication Insightsリソースを共有します。つまり、Application Insightsを使用して、検索を特定のSitecoreロール (CD、CM、処理、レポートなど) に絞り込むことができます。

  1. Azure portalで、Search ページの上部にあるFiltersをクリックします。

  2. 右側に表示されるFilter パネルで、Role タブを展開します。

  3. 検索結果に表示する役割を選択します。

  4. 選択したロールのログメッセージを表示するには、パネルの下部にあるUpdateをクリックします。

ログメッセージを重大度のレベル別に検索する

Sitecoreは、Log4netメッセージの重大度レベルをApplication Insightsトレースの重大度レベルに変換します。サポートされている4つの重大度レベルは、Error、Warning、Informational、およびVerboseです。たとえば、Error メッセージとWarning メッセージのみを検索するには、次のようにします。

  1. Azureポータルで、Search パネルの上部にあるFiltersをクリックします。

  2. 右側に表示されるFilter パネルで、Severity levelタブを展開します。

  3. Error チェックボックスとWarning チェックボックスを選択します。

  4. 重大度がError とWarningのログ メッセージを表示するには、パネルの下部にあるUpdateをクリックします。

ログメッセージの詳細を調べる

検索 ページにログ メッセージやその他のイベントが表示されている場合は、項目をクリックして詳細を表示できます。右側にイベントの詳細パネルが表示され、次のTrace プロパティなど、ログメッセージに関する情報が表示されます。

  • ログメッセージの発信元からのWebアプリインスタンスID。

  • ログ・ファイルのメッセージ・テキスト。(新しいページにメッセージの全文を表示するには、テキストの近くにある省略記号ボタンをクリックします。

  • 例外の完全なスタック・トレース (例外イベントの場合のみ)。

ログ メッセージまたは例外の場合は、イベントの詳細パネルを使用して、次のような関連するテレメトリ イベントに移動します。

  • 同じ論理演算内のイベント (ASP.NET要求など)。つまり、例外の原因となったリクエストのURLと、遅いリクエストのログメッセージを確認できます。

  • 同じWebアプリ インスタンスIDを持つイベント。つまり、元のイベントと同じSitecoreインスタンスで発生したイベントを特定できます。

  • 元のイベントの前後5分以内に発生したイベント。つまり、Sitecore環境全体をスキャンして、元のイベントの近くで発生したイベントを特定できます。

また、これらのナビゲーション オプションを使用して、新しいSearch ページを開き、特定のイベントが発生したときのSitecoreの動作を調べることもできます。これにより、根本原因、例外、または特定の動作を特定できます。Microsoft AzureのWebサイトには、Application Insightsの検索機能の使用に関する詳細な診断検索ドキュメントが用意されています。

この記事を改善するための提案がある場合は、 お知らせください!