sentry-otel-exporter-setup

Configure the OpenTelemetry Collector to send traces and logs to Sentry.

246|29|Updated Nov 10, 2025
One-click install
npx skills add https://github.com/getsentry/sentry-for-ai --skill sentry-otel-exporter-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sentry-otel-exporter-setup
Source: https://github.com/getsentry/sentry-for-ai/tree/main/skills/sentry-otel-exporter-setup
Command: npx skills add https://github.com/getsentry/sentry-for-ai --skill sentry-otel-exporter-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Configure the OpenTelemetry Collector to forward traces and logs to Sentry using the Sentry Exporter, enabling multi-project telemetry routing and automated project creation.

Core Features & Use Cases

  • Multi-project routing: route traces and logs from many services to corresponding Sentry projects.
  • Optional automatic project creation: create missing projects on first telemetry arrival.
  • Config generation and validation: assist in generating and validating collector-config.yaml, supporting both modifying an existing config or creating a new one.
  • Environment placeholders and secure handling: placeholders for SENTRY_ORG_SLUG and SENTRY_AUTH_TOKEN with clear steps to obtain real values.
  • Debug/export: include a debug path to troubleshoot and verify telemetry flow.

Quick Start

Follow the setup steps to configure the Sentry Exporter and start collecting traces and logs in Sentry.

Frequently Asked Questions about sentry-otel-exporter-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure the OpenTelemetry Collector to send traces to Sentry?

To send traces to Sentry, configure the OpenTelemetry Collector using the Sentry Exporter. This involves generating a collector-config.yaml file that includes environment placeholders for your Sentry organization slug and authentication token to route telemetry data.

Can I route telemetry from multiple services to different Sentry projects automatically?

Yes, you can route telemetry from multiple services to corresponding Sentry projects automatically. The Sentry Exporter configuration supports multi-project environments, enabling automatic project creation when missing projects receive their first telemetry data.

How do I set up environment placeholders for Sentry authentication in an OpenTelemetry config?

You set up environment placeholders by defining variables like SENTRY_ORG_SLUG and SENTRY_AUTH_TOKEN in your collector-config.yaml. The setup steps provide clear instructions on obtaining these real values to ensure secure handling of your Sentry credentials.

Does the OpenTelemetry Collector support a debug pipeline for troubleshooting Sentry telemetry routing?

Yes, the configuration includes a debug and logging pipeline to troubleshoot Sentry telemetry routing. This debug path allows you to verify telemetry flow and validate the collector-config.yaml before running the full export operation.

What is the best way to validate a collector-config.yaml before sending logs to Sentry?

The best way to validate the collector-config.yaml is by using the built-in validation steps provided during configuration. This ensures your Sentry Exporter setup is correct and verifies the telemetry flow before you run the collector.