Table of contents

Coralogix

Checkly deeply integrates with Coralogix in three ways:

1. Checkly can automatically instrument all check executions with Open Telemetry tracing and send the data to Coralogix as traces.
2. Checkly can automatically instrument your Browser checks with Coralogix RUM (Real User Monitoring).
3. Checkly can send alert notifications when checks pass and/or fail to Coralogix Logs.

To set up the Open Telemetry tracing integration, first enable the Coralogix integration in your Checkly account in the integrations section.

1. Pick the region of your tenant and enter the team name. We use this to determine the correct trace ingest endpoint for Coralogix.
2. Create a “Send Your Data” API key in your Coralogix account, you can find these in the Data Flow > API Keys section of your Coralogix dashboard. Copy and paste the API key.

The integration is now active and Checkly will start doing two things

1. Send a trace for every check run to Coralogix.
2. Instrument all HTTP requests generated by the check with the following headers:

Moreover, it will show a trace ID and a permalink to the recorded trace in the check result page, so you can easily correlate the check run with the trace in Coralogix.

Each trace will have the following metadata added to it as tags:

Using these tags, you can create filters, dashboards and slice & dice your Checkly data as your runs are executed and ingested into Coralogix as traces.

If you are using a different trace header than the standard traceparent, you can configure this header in the custom trace header field in the integration settings.

In addition to the Open Telemetry tracing, Checkly can also send RUM data to Coralogix for all Browser checks. This enables tracking your Playwright-powered checks to be recorded as (semi) real users, so you can compare and contrast the performance between synthetic and real users.

1. Click Enable Coralogix RUM and pick the region of your tenant.
2. Set the global name of the application you will be targeting with your checks, e.g. “Acme webshop”.
3. Create a new RUM integration in your Coralogix account, you can find these in the Data Flow > Integrations > Real User Monitoring section of your Coralogix dashboard. Copy and paste the integration API key.

If you are targeting multiple applications with your checks, you can override the global application name by adding the environment variable CORALOGIX_RUM_APP_NAME to your Browser check. You can find the Browser check specific environment variables under “Settings” > “Environment variables” in the Browser check editor.

After enabling the RUM integration, Checkly will start sending RUM data to Coralogix for all Browser checks.

You can set up Coralogix as an alert channel destination, so Coralogix receives any alert notifications you have set up as logs. Note that you can use this integration separately from the other two integrations mentioned above.

1. In Checkly, navigate to alert settings. Click the Add more channels button, find Coralogix on the list, and click Add channel.

2. Create a “Send Your Data” API key in your Coralogix account, you can find these in the Data Flow > API Keys section of your Coralogix dashboard. Copy and paste the API key.

3. Give your channel a name, and provide the correct Coralogix Logs API endpoint for the appropriate region, e.g. https://ingress.eu2.coralogix.com/logs/v1/singles Make sure that the right checks are subscribing to the channel and that the Send when rules are correctly set, then hit Save Coralogix Webhook.

FireHydrant ilert

Last updated on April 12, 2024. You can contribute to this documentation by editing this page on Github