Developer console: pipeline health, drop rates and live events

Integrations & Data Sources
#developer#console#monitoring#drops#rejections#latency#debug#live

See what arrives, what's rejected and why, what SDKs drop, when traffic peaks, and a live feed of events.

How It Works Under the Hood
  • •Every ingestion request is counted per hour as accepted or rejected, with the reason: revoked key, rate limited, invalid payload, batch too large or server error. Requests using a revoked key are attributed to that key, so you can see which deployment still has it. Keys that never existed can't be linked to an organization and aren't shown.
  • •JS SDK 1.8+ and Python SDK 0.2+ send delivery counters with their normal batches (about once a minute) or on their own every five minutes when idle: events delivered, dropped by reason (buffer full, key rejected, payload rejected, unreachable) and retried. That's where the drop rate comes from; it can't be measured from the server alone.
  • •Reports contain counters only, never event contents. Turn them off with deliveryReports: false (JS), delivery_reports=False (Python) or SHDW_DELIVERY_REPORTS=0.
  • •The console refreshes every 30 seconds (events every 10) while the tab is visible. Peaks and the hot-spot heat map use your local time zone.
How to Use It Step-by-Step
  1. 1Open Settings → Developer Settings & API Keys → Open console, or press g then d anywhere in the app.
  2. 2Check the status bar: Healthy, Degraded (more than 2% rejected or 1% dropped in 24 hours) or Stalled (nothing for 24 hours).
  3. 3Follow the suggested fix next to each rejection reason; outdated SDK versions are flagged in the integrations list.
Upgrade to get drop rates
npm install @shdwsdk/sdk@^1.8.0
pip install -U "shdwsdk>=0.2.0"

// Opt out of delivery counters (JS)
new ShdwTelemetryClient({ apiKey, deliveryReports: false });

Related guides