Prompt
How do I troubleshoot missing API analytics data?
Latest observation
Here’s a practical way to troubleshoot missing API analytics data.
1) Confirm the expected delay
Many analytics systems are not real-time. Check whether the platform has:
- a processing delay
- batching behavior
- a time zone difference
- delayed backfill for some events
If data is only missing for the last few minutes or hours, it may still arrive later.
2) Verify the request is actually reaching the API
Make sure the calls are:
- going to the correct environment
- using the right API key/token
- not failing before reaching the analytics pipeline
- not being blocked by client-side retries, caching, or a gateway issue
Check your server logs, gateway logs, or request traces for the same time window.
3) Check filters and dimensions in the analytics UI
Missing data is often present but hidden by query settings:
- wrong date range
- incorrect timezone
- filters excluding certain endpoints, status codes, apps, or users
- grouping by a dimension with sparse values
- sampling or thresholds applied
Try removing filters and viewing the rawest available view.
4) Look for ingestion/collection issues
If analytics depend on an SDK, agent, or event collector:
- confirm the collector is running
- check for dropped events
- inspect error logs
- verify connectivity to the analytics endpoint
- confirm schema or payload format hasn’t changed
For self-hosted systems, check queues, workers, and database health.
5) Validate authentication and permissions
Some analytics are only recorded for:
- authenticated users
- specific applications
- specific API plans or tenants
- enabled tracking settings
Also verify the API key or account has permission to view the data.
6) Compare raw logs with analytics counts
A useful method:
- count requests in access logs
- compare with analytics totals
- identify which endpoints, clients, or status codes are missing
This helps determine whether the issue is collection, processing, or reporting.
7) Check for exclusions
Analytics may intentionally exclude:
- health checks
- internal traffic
- bots
- error-only requests
- specific IP ranges
- private or sensitive endpoints
- preflight OPTIONS requests
Review any exclusion rules in config.
8) Inspect rate limits, sampling, or truncation
If traffic is high, some systems:
- sample events
- cap daily volumes
- drop low-priority telemetry
- truncate payloads or labels
Look for documentation on quotas or sampling settings.
9) Review recent changes
Missing analytics often starts after:
- deployment changes
- SDK updates
- reverse proxy changes
- auth changes
- schema changes
- migration to a new workspace/project
Rollback or compare config with a known-good period.
10) Test with a known request
Send one controlled request and verify:
- it appears in logs
- it is accepted by the analytics pipeline
- it shows up after the expected delay
- the metadata fields are correct
This helps narrow down whether only certain requests are missing.
11) Check support or status pages
If the platform is managed by a vendor:
- check the service status page
- search incident notices
- confirm there isn’t a known ingestion delay or outage
12) Gather details before escalating
If you need support, include:
- approximate time range
- affected endpoints
- environment/tenant/account
- request IDs or trace IDs
- examples of missing vs present requests
- screenshots of filters
- logs showing the request occurred
If you want, I can also give you a step-by-step troubleshooting checklist tailored to a specific platform like Google Analytics, Postman, AWS API Gateway, Cloudflare, Datadog, or an internal API gateway.