Destinations
Checkly
This feature is currently in beta.
If you would like early access, please reach out to us.
Send OpenTelemetry trace spans resulting from synthetic tests to Checkly.
Overview
The Checkly destination integrates Streamfold with the Checkly synthetic monitoring platform. This destination forwards OpenTelemetry trace spans to Checkly, utilizing their OpenTelemetry tracing support, currently in beta. By connecting an OpenTelemetry source in Streamfold to the Checkly destination, you can automatically send relevant trace spans.
With Streamfold, you can route OpenTelemetry trace spans to both your observability vendor and Checkly simultaneously. This allows you to observe complete application performance in a platform like Honeycomb while also having full trace data for your Checkly synthetic test reports.
The destination only routes trace spans resulting from synthetic tests initiated by Checkly, which limits the telemetry exposure. It filters trace spans that contain the trace state of checkly=true, the identifier used by Checkly to flag test trace spans.
Configuration
Configuration is straightforward and requires only two options. To get started, head over to the traces integration page in your account settings.
In Streamfold, create a new Checkly destination and enter the following:
- Endpoint: This is the endpoint listed under Endpoints in the Checkly settings.
- API Key: Create a new OTel API key and enter its value here.
Checkly trace export
If you are using Checkly’s OpenTelemetry tracing support, you should enable trace export from Checkly. This will export the parent trace spans created by Checkly when a synthetic test is executed. Streamfold will route these parent spans to your observability vendor, ensuring full visibility of Checkly-initiated requests.
To enable, make sure you've added an OpenTelemetry source to your Streamfold account. On the Checkly Traces Integration page under Export traces, enter the following:
- Enable exporting traces:
https://ingress.streamfold.com/v1/traces - Headers:
x-streamfold-tokenand the value should be a saved environment variable containing the Streamfold ingress token.