Event markers

Open in ChatGPTOpen in Claude

When a metric shifts on a service page (error rate climbs, latency drifts, throughput drops) the next question is always "what changed?" Event markers put every dated change on the same timeline as your metrics: deployments, feature-flag changes, incidents, marketing campaigns, or any other event you send to Coralogix. The markers that landed around the shift tell you which change to investigate, on the chart itself, without switching tools.

Note

Annotations work across APM, Explore, and Custom Dashboards. For the cross-product overview, see Annotations.

What you need

• Access to APM and the service page for the service you want to analyze.
• Event markers ingested through the Coralogix ops-events ingest API. See Send events to Coralogix.

Turn on event markers

You turn on event markers per service page or from the Service Catalog. The setting persists across sessions.

1. In your Coralogix toolbar, select APM, then Service Catalog.
2. Select the service you want to analyze.
3. In the header at the top of the service page, select the Chart settings button next to the time range picker.
4. In the Chart settings panel, turn on Event markers.

Markers appear as vertical annotations across every chart on the service page, aligned to event timestamps. Hover a marker to see its details, the source system, the event description, and the service and environment it applies to.

Deployment markers line up across every chart on the service page. Hovering a marker shows its details, here, a product-catalog deployment to the otel-demo environment.

Filter which events appear

Under Event markers, select which markers to show:

• Service events (default): markers linked to this service.
• Service and related events: markers linked to this service and its related services. See Related services.
• All events: every event marker in your account. Events without a service.name (for example, account-wide incidents, marketing campaigns, or feature-flag changes) appear only under All events, alongside every service's deployment events.

Next to Service and related events, an N services link shows the count of related services included in the filter. Select it to open Analyze, where you can inspect the services in the filter.

Show or hide marker categories

On the chart, Coralogix groups markers by category and draws each in its own color, with a matching dashed entry in the chart legend. Deployment events sent as cdEvent appear under Deployments. Only categories that have events in the current time range appear in the legend. Select a category's legend entry to hide its markers, and select it again to show them.

Send events to Coralogix

Event markers come from the Coralogix ops-events ingest API. For the endpoints, authentication, the full field reference, and the per-platform CI/CD guides, see Send events to Coralogix in the Annotations guide.

Related services

A related service is a service that sends requests to the current service or receives requests from it. Coralogix derives the set from the Service Map.

When you select Service and related events, the filter includes:

• The current service: the service the page is for.
• Every service in that service's Service Map neighborhood.

Limitations

• Event markers support two event kinds today: cdEvent for continuous-delivery events (with pipeline and VCS metadata) and customEvent for generic markers. Both appear on charts; only cdEvent carries the CD-specific fields. More structured kinds are added over time.
• The N services link next to Service and related events opens Analyze in a new tab. A later release deep-links directly to the Service Map section within Analyze.

Related resources

• Service Map: how Coralogix builds the service dependency graph that defines related services.
• Group by service version: compare metrics across the deployments an event marker represents.
• OpenTelemetry CI/CD semantic conventions: the OTel conventions that inspired the cdEvent field names.