---
title: "処理エージェントの設定"
slug: "configure-processing-agents"
abstract: "処理サーバーのパフォーマンスを最適化するために、処理エージェントやスレッドを設定しましょう。"
---
# 処理エージェントの設定

[xDB処理サーバー](https://doc.sitecore.com/xp/en/developers/100/platform-administration-and-architecture/xdb-processing.html)を設定する際には、パフォーマンスを最適化するために実行するアグリゲーションエージェントやスレッドの数を変更する必要があるかもしれません。アグリゲーションエージェントはアグリゲーションパイプラインで処理されるインタラクションを取得し、レポートデータベースに適した形式に変換します。

処理サーバー上でアグリゲーションエージェントやスレッドを設定するには:

1.  XMLエディタでSitecore.Analytics.Processing.Aggregation.Services.config ファイルを開いてください。同時に実行したいアグリゲーションエージェントの数を指定できます。まずはデフォルト設定から始めてください。
    
2.  maxAgents設定を編集して、サーバー上で実行したいアグリゲーションエージェントの数を指定します。また、必要なクリーンアップおよびリカバリースレッドの数も指定できます。利用可能なハードウェアやビジネス要件に応じてこれらの設定を調整してください。デフォルト値を使い、時間をかけてアグリゲーションサーバーの最適化に調整していきます。
    
    <module type="Sitecore.Analytics.Aggregation.AggregationModule" singleInstance="true">
     <BackgroundServices hint="list:Add">
     <aggregator type="Sitecore.Analytics.Core.AsyncBackgroundService">
     <param resolve="true" type="Sitecore.Abstractions.BaseLog, Sitecore.Kernel" />
     <param desc="agentPath">aggregation/aggregator</param>
     <param desc="interval" type="Sitecore.Analytics.Core.ConfigurationHelper, Sitecore.Analytics.Core" factoryMethod="ToTimeSpan" arg0="0.\`00:00\`:15" />
     <param desc="maxAgents" type="Sitecore.Analytics.Core.ConfigurationHelper, Sitecore.Analytics.Core" factoryMethod="ToInt" arg0="1" />
     </aggregator>
     <contactProcessing type="Sitecore.Analytics.Core.AsyncBackgroundService">
     <param resolve="true" type="Sitecore.Abstractions.BaseLog, Sitecore.Kernel" />
     <param desc="agentPath">aggregation/contactProcessing</param>
     <param desc="interval" type="Sitecore.Analytics.Core.ConfigurationHelper, Sitecore.Analytics.Core" factoryMethod="ToTimeSpan" arg0="0.\`00:00\`:15" />
     <param desc="maxAgents" type="Sitecore.Analytics.Core.ConfigurationHelper, Sitecore.Analytics.Core" factoryMethod="ToInt" arg0="1" />
     </contactProcessing>
     <rebuild type="Sitecore.Analytics.Core.AsyncBackgroundService">
     <param resolve="true" type="Sitecore.Abstractions.BaseLog, Sitecore.Kernel" />
     <param desc="agentPath">aggregation/rebuildAgent</param>
     <param desc="interval" type="Sitecore.Analytics.Core.ConfigurationHelper, Sitecore.Analytics.Core" factoryMethod="ToTimeSpan" arg0="0.\`00:00\`:15" />
     <param desc="maxAgents" type="Sitecore.Analytics.Core.ConfigurationHelper, Sitecore.Analytics.Core" factoryMethod="ToInt" arg0="1" />
     </rebuild>
     <history type="Sitecore.Analytics.Core.AsyncBackgroundService">
     <param resolve="true" type="Sitecore.Abstractions.BaseLog, Sitecore.Kernel" />
     <param desc="agentPath">aggregation/historyWorker</param>
     <param desc="interval" type="Sitecore.Analytics.Core.ConfigurationHelper, Sitecore.Analytics.Core" factoryMethod="ToTimeSpan" arg0="0.\`00:00\`:15" />
     <param desc="maxAgents" type="Sitecore.Analytics.Core.ConfigurationHelper, Sitecore.Analytics.Core" factoryMethod="ToInt" arg0="1" />
     </history>
     <historyCompletionCheck type="Sitecore.Analytics.Core.AsyncBackgroundService">
     <param resolve="true" type="Sitecore.Abstractions.BaseLog, Sitecore.Kernel" />
     <param desc="agentPath">aggregation/historyCompletionCheck</param>
     <param desc="interval" type="Sitecore.Analytics.Core.ConfigurationHelper, Sitecore.Analytics.Core" factoryMethod="ToTimeSpan" arg0="0.\`00:00\`:15" />
     <param desc="maxAgents" type="Sitecore.Analytics.Core.ConfigurationHelper, Sitecore.Analytics.Core" factoryMethod="ToInt" arg0="1" />
     </historyCompletionCheck>
     </BackgroundServices>
    </module>
    
3.  レポートデータベースのMax Pool Sizeプロパティを調整してください。プール容量は設定したエージェント数(処理、履歴、自動化ワーカー、クリーンアップを含む)の少なくとも120%にすべきです。この設定により、各スレッドが専用接続を持ち、別のスレッドが接続を解放するのを待つ必要がなくなり、実行されます。
    
4.  プールサイズを設定するには、報告データベースの接続文字列設定ファイルを開き、Max Pool Sizeプロパティを追加し、適切な値を設定します。
    

以下の表は各エージェントの目的を示しています。

エージェント

概要

アグリゲーション/アグリゲーター

ライブ集約中のインタラクション処理。使用されるスレッドが多いほど、新しいインタラクションに関するデータはレポートデータベースに速く表示されます。ウェブサイトのトラフィックが少なく新しいインタラクションも少ない場合は、割り当てるスレッド数を減らすことができます。

集約/接触処理

コンタクトを処理する。アグリゲーターと非常に似ているが、新しいコンタクトのパイプラインを実行する。

アグリゲーション/rebuildAgent

報告データベースの再構築に必要な手順を実行します。スレッドを1つ以上割り当てないでください。

集約/歴史ワーカー

Historyリビルドのメインアクター。リビルド前に最大数のスレッドを割り当てます。リビルドが終わったら、このエージェントはHistoryリビルド中のみ有効なので、スレッドを1に戻すことができます。

集約/履歴完了チェック

すべてのヒストリーワーカーエージェントがインタラクションの処理を終えているかを確認します。完了したら、ヒストリーリビルドプロセスが完了したとマークされます。エージェント1人で十分です。