FlagPilot tracks lightweight SDK connection telemetry per flag and environment to help you monitor evaluation activity and recent errors.
Telemetry Collection
Each evaluation request records the following, sent via the X-FlagPilot-SDK-Version request header:
- SDK Name & Version: Parsed from the SDK version header (e.g.
node/1.0.0). - Evaluation Counts: Total, first, and most recent evaluation timestamps per flag.
- Recent Errors: The most recent error state per project and environment (e.g. flag not found, quota exceeded).
Retrieve Health Logs
curl -X GET https://api.tryflagpilot.com/v1/flags/checkout-redesign/sdk-health \ -H "Authorization: Bearer fk_secret_xxxxxxxx"
Returns status (active, no_evaluations, or recent_error), lastEvaluation, firstEvaluation, and totalEvaluations.
FAQ
How does SDK Health & Telemetry interact with local caches?
Configurations are synced down using Edge Config or fallback REST triggers. The client automatically reads evaluations in-memory, resulting in sub-millisecond local evaluation times.
Where can I obtain support for SDK Health & Telemetry?
You can open a support ticket in your dashboard, check the community roadmap, or consult the FlagPilot Platform Status page.