Atatus accepts telemetry directly from OpenTelemetry code instrumentation or collectors.

You can retrieve the following metrics through Atatus by utilizing OpenTelemetry.

  • Traces
  • Logs
  • Metrics

Our OpenTelemetry HTTP endpoint is hosted at https://otel-rx.atatus.com, and requires the api-key header to be set to your API key.

OTel Collector Configuration

  1. Install the OpenTelemetry Collector by following the official installation guide

  2. Navigate to Atatus Dashboard --> Settings --> Account Settings --> API Keys. You can either generate a new API key or copy an existing one with write permission. After obtaining the API key, you'll need to set it in the configuration file under the exporter otlphttp header (see step 3).

  3. Write the collector configuration to /etc/otelcol/config.yaml:

    # /etc/otelcol/config.yaml

receivers:
  otlp:
    protocols:
      grpc:
      http:

exporters:
  otlphttp/atatus:
    endpoint: 'https://otel-rx.atatus.com'
    headers:
      api-key: <YOUR_ATATUS_API_KEY>

processors:
  batch:

  # You can optionally set resource attributes (env and version - Optional).
  resource:
    attributes:
      - key: env
        value: "prod"
        action: upsert
      - key: version
        value: "1.0.0"
        action: upsert

service:
  pipelines:
    traces:
      receivers: [otlp]
      processors: [resource, batch]
      exporters: [otlphttp/atatus]
    metrics:
      receivers: [otlp]
      processors: [resource, batch]
      exporters: [otlphttp/atatus]
    logs:
      receivers: [otlp]
      processors: [resource, batch]
      exporters: [otlphttp/atatus]

  4. Start the OTel Collector

    When installed via the .deb or .rpm package, the Collector is automatically registered as a systemd service:

    # Start the service
sudo systemctl start otelcol

# Enable it to start on boot
sudo systemctl enable otelcol

# Restart after config changes
sudo systemctl restart otelcol

# Check status
sudo systemctl status otelcol

# View logs
sudo journalctl -u otelcol -f

    If running the binary directly (without systemd):

    /usr/bin/otelcol --config /etc/otelcol/config.yaml