xDB Processing
The xDB Processing role analyses and aggregates collected data to make into usable in reporting.
Processing servers do not handle direct requests. Ensure that you use Application Initialization so you can successfully start the Processing role after you recycle the application pool.
If you do not do this, the Processing role will not be launched and its application pool may shut down due to inactivity.
Supported infrastructure
You can host the xDB Processing role on:
Refer to the Sitecore compatibility table for compatible versions.
Reference structure
The xDB Processing role has its place in the Sitecore reference structure. It can be referenced by other roles, and it can also reference other roles.
Referenced by
The xDB Processing role is referenced by the following roles:
References
The xDB Processing role references the following roles:
Storage roles
Role name |
Connection string name |
Port |
Type |
Notes |
---|---|---|---|---|
core |
1433 |
SQL | ||
security |
1433 |
SQL | ||
master |
1433 |
SQL | ||
reporting |
1433 |
SQL | ||
xDB Reporting database (secondary) |
reporting.secondary |
1433 |
SQL | |
xdb.referencedata |
1433 |
SQL |
Only used during history rebuild. | |
xdb.processing.pools |
1433 |
SQL | ||
xdb.processing.tasks |
1433 |
SQL |
The following API key must be included in a secure production environment, and should match the key configure in the Content Management role:
Role |
Connection string name |
Type |
Notes |
---|---|---|---|
xDB Processing |
reporting.apikey |
Unique string |
Required if you use a dedicated xDB Processing role. |
By default, the xDB Reporting and xDB Processing roles share the reporting.apikey connection string.
Application roles
Role name |
Connection string name |
Port |
Type |
Notes |
---|---|---|---|---|
xconnect.collection |
443 |
HTTPS |
The following client certificates are required in a secure production environment:
Role |
Connection string name |
Type |
Notes |
---|---|---|---|
xconnect.collection.certificate |
Certificate |
Other
The xDB Processing role includes a reference to the Package Management Service via the PackageManagementServiceUrl
connection string.
Privacy and security
The xDB Processing role handles personal data in the following ways:
-
Reads contact and interaction data during aggregation and processing.
Refer to the Security Guide for steps to secure the xDB Processing role.
Do not write personal data to the xDB Reporting database from custom contact or interaction aggregation processors or custom distributed processing workers.
Assumptions
-
Custom contact and interaction aggregation processors are not saving personal data to the xDB Reporting database.
-
Custom processing workers are not saving personal data to the xDB Reporting database.
-
Custom code and custom applications are not saving personal data to the xDB Reporting database.