PA Collections

Jace Benson

Table of content
  1. What PA Collections Do
  2. How Collections Run Async
  3. Key Concepts
  4. Performance Considerations
  5. Additional Resources

Docs

Performance Analytics (PA) Collections are scheduled data-gathering jobs that pull metrics from your data and store them in the PA data model. They run asynchronously because they can be expensive — scanning thousands of records takes time.

What PA Collections Do

A collection defines:

Each collection generates a job that runs on the pa_jobs table. The job counts records, aggregates values, and stores the results in pa_scores and pa_snapshots tables.

How Collections Run Async

PA Collections are queued and processed by the system's async infrastructure. The pa_collections_collect scheduled job picks up due collections and runs them. Each collection runs in its own context — they don't block each other, but they do compete for the same async processing capacity.

// Manually trigger a collection via script
var collector = new PerformanceAnalyticsCollector();
collector.collect('collection_sys_id');

Key Concepts

Performance Considerations

PA Collections can be expensive. A collection scanning 100k records with multiple breakdowns generates a lot of work. Be thoughtful about:

Additional Resources