Dx App Analytics Query

If you're an ISV partner who needs to pull managed package usage data from Salesforce's Intelligence Data Lake, this is the skill you want. It handles creating AppAnalyticsQueryRequest records via the REST API, polling them through the New-Pending-Complete lifecycle, and grabbing the presigned download URLs before they expire. You can query PackageUsageSummary, PackageUsageLog, or SubscriberSnapshot data, filter by time ranges or specific subscriber orgs, and get results as CSV or Parquet with optional compression. The gotcha worth knowing: these are sObject records you create and poll via REST, not metadata you deploy. Also covers AppAnalyticsSettings for enabling simulation mode when you're testing without real subscriber data.

skills.sh installs: 5.2K
GitHub stars: 1.2K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add forcedotcom/sf-skills --skill dx-app-analytics-query --agent claude-code

Installs into .claude/skills of the current project.

Files

App Analytics

When This Skill Owns the Task

Use dx-app-analytics-query when the work involves:

Creating AppAnalyticsQueryRequest records via the REST/sObject API
Configuring AppAnalyticsSettings via the Metadata API (simulation mode, opt-out)
Understanding the query lifecycle: New → Pending → Complete → Expired → Failed
Choosing between dataType values: PackageUsageSummary, PackageUsageLog, SubscriberSnapshot
File format and compression options for analytics downloads
Time-range filtering with startTime, endTime, availableSince
Troubleshooting failed or expired analytics queries

Delegate elsewhere when the user is:

Running standard CRM SOQL queries → platform-soql-query
Working with Data Cloud SQL or DMOs → retrieving-datacloud
Building reports/dashboards on standard objects → reporting skills
Deploying or retrieving generic metadata XML → deploying-metadata / retrieving-metadata