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

チュートリアル: Application Insights for xConnectのアプリケーション マップの有効化

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

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

アプリケーション マップ (Azure Application Insightsの一部) を使用して、アプリケーションのコンポーネントの依存関係を視覚的に表現します。マップ内の各ノードは、アプリケーション コンポーネント (アプリケーション ノード) またはその依存関係 (依存関係ノード) を表します。コンポーネントは、分散アプリケーションの独立したデプロイ可能な部分です。詳細については、AzureのMicrosoftドキュメント を参照してください。この視覚的な表現は、分散アプリケーションのすべてのコンポーネントでパフォーマンスのボトルネックや障害のホットスポットを見つけるのに役立ちます。

Sitecore XPをMicrosoft Azure App Serviceにデプロイすると、Application Insights Serviceのアプリケーション マップはデフォルトでは有効になっていません。

SitecoreがMicrosoft Azure App Serviceであるとデプロイすると、SitecoreはデフォルトでApplication Insightsサービスと統合されます。リソース消費を最適化するために、Sitecore XPインスタンスからの送信HTTPおよびSQL接続に関する情報を記録する依存関係テレメトリ イベントは収集されません。アプリケーション マップ機能では、これらのテレメトリ イベントを使用して、サービス間の接続を視覚化し、診断情報を表示します。

このトピックでは、依存関係コレクターを有効にし、それによってアプリケーション マップを有効にする方法について説明します。

このチュートリアルでは、次の方法について説明します。

  • Sitecoreロールの依存関係コレクターを有効にする

  • xConnectロールの依存関係コレクターを有効にする

  • xConnectサービスの依存関係コレクターを有効にする

  • xConnectロールのコンポーネント ロール名の指定

Sitecoreロールの依存関係コレクターを有効にする

Sitecoreロールの依存関係テレメトリ イベントの収集を有効にするには:

  • wwwrootフォルダーで、ApplicationInsights.configファイル内の次の行のコメントを解除します。

    <!-- <Add Type="Microsoft.ApplicationInsights.DependencyCollector.DependencyTrackingTelemetryModule, Microsoft.AI.DependencyCollector"/> -->

xConnectロールの依存関係コレクターを有効にする

xConnectロールの依存関係テレメトリ イベントの収集を有効にするには、次の手順に従います。

  1. wwwrootフォルダーで、ApplicationInsights.configファイル内の次の行のコメントを解除します。

    <!-- <Add Type="Microsoft.ApplicationInsights.DependencyCollector.DependencyTrackingTelemetryModule, Microsoft.AI.DependencyCollector"/> -->

  2. \CoreServices\sc.AppInsights.Initializer.xml.disabled構成ファイルを有効にするには、.disabled拡張子を削除します。sc.AppInsights.Initializer.xmlファイルが指定されているには、ApplicationInsights.configファイルを使用してアクティブなテレメトリ構成を初期化する初期化子サービスが含まれています。

これらの手順は、追跡する各XConnectロールで実行する必要があります。Microsoftのドキュメントには、Application Insightsの構成に関する詳細情報が記載されています。

xConnectサービスの依存関係コレクターを有効にする

依存関係コレクターを有効にするように構成された、現在サポートされているすべてのサービスを構成できます。

  • XConnect検索インデクサー

    XConnect Search Indexer Webジョブは、xConnect Collection Searchロール ( xp-xc-search/App_Data/jobs/continuous/IndexWorker) でホストされます。

  • マーケティング自動化エンジン

    Marketing Automation Engine Webジョブは、Marketing Automation Operationsロールxp-ma-ops/App_Data/jobs/continuous/AutomationEngineでホストされます。

  • Sitecore Cortexプロセッシング エンジン

    Sitecore Cortex Processing Engine Webジョブは、Sitecore Cortex Processingロールxp-cortex-processing/App_Data/jobs/continuous/ProcessingEngineでホストされます。

xConnectサービスの依存関係テレメトリ イベントの収集を有効にするには、次の手順を実行します。

  1. Webジョブのルート フォルダーで、ApplicationInsights.configファイル内の次の行のコメントを解除します。

    <!-- <Add Type="Microsoft.ApplicationInsights.DependencyCollector.DependencyTrackingTelemetryModule, Microsoft.AI.DependencyCollector"/> -->

    ここでは、たとえば、xConnect Search Indexer (IndexWorker) のフォルダーとファイルを見つけます。ファイルはApp_Data\jobs\continuous\IndexWorker\ApplicationInsights.configです。

  2. App_Data\config\sitecore\CoreServices\sc.AppInsights.Initializer.xml.disabled構成ファイルを有効にするには、.disabled拡張子を削除します。sc.AppInsights.Initializer.xmlファイルは、ApplicationInsights.configファイルを使用してアクティブなテレメトリ構成を初期化する初期化子サービスを指定します。

これらの手順は、追跡する各XConnectサービスで実行する必要があります。Microsoftのドキュメントには、Application Insightsの構成に関する詳細情報が記載されています。

xConnectロールのコンポーネント ロール名の指定

デフォルトでは、各xConnectロール (インスタンス) とサービスは、独自のロール名を持つ個別のアプリケーション ノードとして表されます。

アプリケーション・ノードの役割名は、AppInsightsRoleNameアプリケーション設定キーのAppSettings.configで指定されます。デフォルトのデプロイメントには、各ロールとサービスに対して事前設定されたロール名設定が含まれています。ロール名は、公式ドキュメントから取得されます。

<?xml version="1.0" encoding="utf-8"?>
<appSettings configBuilders="SitecoreAppSettingsBuilder">
  <add key="configurationDirectorRoot" value="~/App_Data" />
  <add key="configurationEnvironment" value="Production" />
  <add key="AllowInvalidClientCertificates" value="True" />
  <add key="validateCertificateThumbprint" value="CBC23042652046E7C7DEF49AAC292A41D98D048" />
  <add key="AppInsightsKey" value="b17beac-e496-8a0f-cf1ff6ab1500" />
  <add key="AppInsightsRoleName" value="XConnect Standalone" />
</appSettings>

appSettingsキーは、sc.AppInsights.Initializer.xml設定ファイルで指定します。

<Options>                           
  <InstrumentationKeyAppSettingKey>AppInsightsKey</InstrumentationKeyAppSettingKey>
  <RoleNameAppSettingKey>AppInsightsRoleName</RoleNameAppSettingKey>
</Optiona>
この記事を改善するための提案がある場合は、 お知らせください!