xDB Processing

Current version: 9.2

The xDB Processing role analyses and aggregates collected data to make into usable in reporting.

Warning

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.

Illustration showing the xDB Processing role's place in the Sitecore reference structure.

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 database

core

1433

SQL

Security database

security

1433

SQL

Master database

master

1433

SQL

xDB Reporting database

reporting

1433

SQL

xDB Reporting database (secondary)

reporting.secondary

1433

SQL

xDB Reference Data database

xdb.referencedata

1433

SQL

Only used during history rebuild.

xDB Processing Pools database

xdb.processing.pools

1433

SQL

xDB Processing Tasks database

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.

Note

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 service

xconnect.collection

443

HTTPS

The following client certificates are required in a secure production environment:

Role

Connection string name

Type

Notes

xConnect Collection service

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.

Important

Do not write personal data to the xDB Reporting database from custom contact or interaction aggregation processors or custom distributed processing workers.

Assumptions

Do you have some feedback for us?

If you have suggestions for improving this article,