---
title: "ウォークスルー:xConnectのアプリケーションインサイトのためのアプリケーションマップの有効化"
slug: "walkthrough--enabling-application-map-for-application-insights-for-xconnect"
abstract: "Application Insightsのアプリケーションマップ機能をSitecore XPロールやサービスで有効化・設定する方法を示しています。"
---
# ウォークスルー:xConnectのアプリケーションインサイトのためのアプリケーションマップの有効化

Azure Application Insightsの一部であるApplication Mapを使って、アプリケーションのコンポーネント間の依存関係を視覚的に表示します。マップ内の各ノードは、アプリケーションコンポーネント(アプリケーションノード)またはその依存関係(依存ノード)を表します。コンポーネントは分散アプリケーションの独立展開可能な部分です。MicrosoftのAzure[ドキュメント](https://docs.microsoft.com/en-us/azure/azure-monitor/app/app-map?tabs=net) には詳細情報があります。この視覚的な表現は、分散アプリケーションのすべてのコンポーネントでパフォーマンスのボトルネックや障害ホットスポットを見つけるのに役立ちます。

Application InsightsサービスのApplication Mapは、Microsoft Azure App Serviceにデプロイする際にデフォルトで有効Sitecore XPしません。

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

> !重要Sitecore XP 10.5では、AppInsightsKeyのような独立したインストゥルメンテーションキー設定を使ってApplication Insightsを設定しないでください。代わりにAppInsightsConnectionString設定でApplication Insightsの完全な接続文字列を使用してください。

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

このウォークスルーでは、以下の方法を説明します:

-   Application Insights接続文字列の設定
-   Sitecore役割の依存性コレクタを有効にしてください
-   xConnect役割の依存性コレクタを有効にしてください
-   xConnectサービスの依存性コレクタを有効にする
-   xConnectの役割にコンポーネントロール名を指定する

## Application Insights接続文字列の設定

xConnectの役割やサービスでApplication Mapを有効にする前に、Application Insightsの接続文字列を設定してください。

接続文字列は通常以下の形式を持ちます:

InstrumentationKey={guid};IngestionEndpoint={url};LiveEndpoint={url};ApplicationId={guid}

接続文字列にはInstrumentationKey値が含まれていますが、Sitecore XP 10.5ではAppInsightsConnectionString設定を通じて接続列全体を使用します。

各該当AppSettings.configファイルで、前のスタンドアロン計測キー設定を置き換えます:

<add key="AppInsightsKey" value="..." />

接続ストリングの設定は以下の通りです:

<add key="AppInsightsConnectionString" value="InstrumentationKey={guid};IngestionEndpoint={url};LiveEndpoint={url};ApplicationId={guid}" />

プレースホルダーの値は、Application Insightsリソースの接続文字列に置き換えてください。

## Sitecore役割の依存性コレクタを有効にしてください

Sitecoreの役割に対する依存性テレメトリイベントの収集を可能にするために:

-   wwwrootフォルダ内のApplicationInsights.configファイルの次の行をコメントを消してください:
    
    <!-- <Add Type="Microsoft.ApplicationInsights.DependencyCollector.DependencyTrackingTelemetryModule, Microsoft.AI.DependencyCollector"/> -->
    
    コメントを消した後、そのラインは次のようになるはずです:
    
    <Add Type="Microsoft.ApplicationInsights.DependencyCollector.DependencyTrackingTelemetryModule, Microsoft.AI.DependencyCollector"/>
    

このステップは、Application Mapで追跡したい各Sitecoreロールで行います。

## xConnect役割の依存性コレクタを有効にしてください

xConnect役割の依存性テレメトリイベントの収集を可能にするために:

1.  wwwrootフォルダ内のApplicationInsights.configファイルの次の行をコメントを消してください:
    
    <!-- <Add Type="Microsoft.ApplicationInsights.DependencyCollector.DependencyTrackingTelemetryModule, Microsoft.AI.DependencyCollector"/> -->
    
    コメントを消した後、そのラインは次のようになるはずです:
    
    <Add Type="Microsoft.ApplicationInsights.DependencyCollector.DependencyTrackingTelemetryModule, Microsoft.AI.DependencyCollector"/>
    
2.  役割のAppSettings.configファイルで、前の計測キー設定を置き換えてください:
    
    <add key="AppInsightsKey" value="..." />
    
    接続ストリング設定の場合:
    
    <add key="AppInsightsConnectionString" value="InstrumentationKey={guid};IngestionEndpoint={url};LiveEndpoint={url};ApplicationId={guid}" />
    
3.  必要に応じて役割名の設定を維持または更新:
    
    <add key="AppInsightsRoleName" value="XConnect Collection" />
    

> !注Sitecore XP 10.5では、この変更のために手動でsc.AppInsights.Initializer.xmlを有効にしたり更新したりする必要はありません。必要な初期化装置の設定はデフォルトで含まれています。

追跡したい各xConnectロールでこれらのステップを実行する必要があります。

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

サポートされているxConnectサービスの依存関係の収集を有効にすることができます。

支援されるサービスには以下が含まれます:

-   **XConnect Search インデクサー**
    
    XConnect Search Indexerのウェブジョブは、xConnect Collection Searchの役割でホストされています:
    
    xp-xc-search/App\_Data/jobs/continuous/IndexWorker
    
-   **マーケティングオートメーションエンジン**
    
    マーケティングオートメーションエンジンのウェブ求人は、マーケティングオートメーションオペレーションの役割にホストされています:
    
    xp-ma-ops/App\_Data/jobs/continuous/AutomationEngine
    
-   **Sitecore Cortex処理エンジン**
    
    Sitecore Cortex Processing Engineのウェブジョブは、Sitecore Cortex Processingの役割でホストされています:
    
    xp-cortex-processing/App\_Data/jobs/continuous/ProcessingEngine
    

xConnectサービス用の依存関係テレメトリイベントの収集を可能にするために:

1.  ウェブジョブのルートフォルダで、ApplicationInsights.configファイルの次の行をコメントを消してください:
    
    <!-- <Add Type="Microsoft.ApplicationInsights.DependencyCollector.DependencyTrackingTelemetryModule, Microsoft.AI.DependencyCollector"/> -->
    
    コメントを消した後、そのラインは次のようになるはずです:
    
    <Add Type="Microsoft.ApplicationInsights.DependencyCollector.DependencyTrackingTelemetryModule, Microsoft.AI.DependencyCollector"/>
    
    例えば、XConnect Search Indexerの場合、ファイルは以下の位置にあります:
    
    App\_Data/jobs/continuous/IndexWorker/ApplicationInsights.config
    
2.  ウェブジョブのAppSettings.configファイルで、前の計測キー設定を置き換えてください:
    
    <add key="AppInsightsKey" value="..." />
    
    接続ストリング設定の場合:
    
    <add key="AppInsightsConnectionString" value="InstrumentationKey={guid};IngestionEndpoint={url};LiveEndpoint={url};ApplicationId={guid}" />
    
3.  必要に応じて役割名の設定を維持または更新:
    
    <add key="AppInsightsRoleName" value="XConnect Search Indexer" />
    

> !注Sitecore XP 10.5では、この変更のために手動でsc.AppInsights.Initializer.xmlを有効にしたり更新したりする必要はありません。必要な初期化装置の設定はデフォルトで含まれています。

追跡したい各xConnectサービスでこれらの手順を実行する必要があります。

## xConnectの役割にコンポーネントロール名を指定する

デフォルトでは、各xConnectの役割とサービスはそれぞれの役割名を持つ別個のアプリケーションノードとして表現されます。

アプリケーションノードの役割名は、AppSettings.configファイル内でAppInsightsRoleNameアプリケーション設定キーを使って指定されます。同じファイル内で、アプリケーション設定キーを使ってアプリケーションインサイト接続文字列を指定AppInsightsConnectionString 。

例:

<?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="AppInsightsConnectionString" value="InstrumentationKey={guid};IngestionEndpoint={url};LiveEndpoint={url};ApplicationId={guid}" />
 <add key="AppInsightsRoleName" value="XConnect Standalone" />
</appSettings>

以前のスタンドアロン計測キー設定は使わないでください:

<add key="AppInsightsKey" value="..." />

代わりに接続文字列全体の設定を使いましょう:

<add key="AppInsightsConnectionString" value="InstrumentationKey={guid};IngestionEndpoint={url};LiveEndpoint={url};ApplicationId={guid}" />