Skip to main content

SDK-003

Rate limited

The ingest endpoint returned HTTP 429 while receiving telemetry.

What the SDK does

Both SDKs pause sending for a positive Retry-After value in seconds, or 60 seconds when no valid value is provided.

What to check

  1. Allow the pause to finish

    Avoid forcing a flush loop. Sending resumes on a later flush after the pause expires.

  2. Review collection volume

    For the Node SDK, mode: 'low-data' reduces collection and batches less frequently. Review sampleRate and sampleThresholdPerMinute together; increasing the threshold keeps full collection active for longer.

  3. Check for repeated initialization across workers

    Each process or browser sends its own telemetry. If throttling continues, record the HTTP status, SDK version and approximate number of active instances for support.

Sampling and batching

Still seeing the error?

Send the code, SDK version, runtime and a redacted error message. Keep credentials and customer data out of the report.

Email SDK support