Skip to main content
Bronto accepts OpenTelemetry traces over OTLP. You can export traces directly from an OpenTelemetry SDK, or route them through an OpenTelemetry Collector before forwarding them to Bronto.
For complete runtime setup and working examples, use the language guides: Python and Node.js / JavaScript.

​
Prerequisites

Before you begin, make sure you have:
  • a Bronto API key
  • an application instrumented with an OpenTelemetry SDK, or an OpenTelemetry Collector receiving traces
  • network access to the Bronto ingestion endpoint for your region

​
Endpoint and authentication

Use the trace endpoint that matches your Bronto region:
RegionTrace endpoint
EUhttps://ingestion.eu.bronto.io/v1/traces
UShttps://ingestion.us.bronto.io/v1/traces
Every request must include this header: 
x-bronto-api-key: <BRONTO_API_KEY>

​
Supported protocols

Bronto supports OTLP using:
  • gRPC on port 4317
  • HTTP on port 4318
  • HTTP OTLP on port 443
For most direct application-to-Bronto setups, OTLP/HTTP on port 443 is the simplest option.

​
Send traces through an OpenTelemetry Collector

If you are using an OpenTelemetry Collector, configure an OTLP receiver and an OTLP/HTTP exporter that targets the Bronto trace endpoint.
otel-config.yaml
receivers:
  otlp:
    protocols:
      grpc:
        endpoint: 0.0.0.0:4317
      http:
        endpoint: 0.0.0.0:4318

processors:
  batch:

exporters:
  otlphttp/brontotraces:
    traces_endpoint: https://ingestion.eu.bronto.io/v1/traces
    compression: none
    headers:
      x-bronto-api-key: <BRONTO_API_KEY>

service:
  pipelines:
    traces/bronto:
      receivers: [otlp]
      processors: [batch]
      exporters: [otlphttp/brontotraces]
Replace the endpoint with your region and replace <BRONTO_API_KEY> with your Bronto API key.
If your Collector also sends logs, keep traces and logs in separate exporters and pipelines. Traces use traces_endpoint; logs use logs_endpoint.

​
Send traces directly from an SDK

If you do not need a Collector, configure your application’s OpenTelemetry SDK to export traces directly to Bronto over OTLP/HTTP. For direct trace export, point your SDK at the regional traces endpoint and include the Bronto API key header: 
export OTEL_EXPORTER_OTLP_TRACES_ENDPOINT="https://ingestion.<region>.bronto.io/v1/traces"
export OTEL_EXPORTER_OTLP_TRACES_HEADERS="x-bronto-api-key=<BRONTO_API_KEY>"
export OTEL_TRACES_EXPORTER="otlp"

​
Minimal working examples

Bronto has OpenTelemetry setup guides for several languages. If you want a quick starting point, the Python and Node.js guides include complete working examples for logs and traces, including SDK setup, resource attributes, exporter configuration, and direct export to Bronto.

Python

Configure the OpenTelemetry Python SDK, create spans, and export traces to Bronto.

Node.js / JavaScript

Configure the OpenTelemetry JS SDK, create spans, and export traces to Bronto.

​
Verify trace delivery

After configuration, verify trace delivery with these checks:
  1. Confirm that you are sending traces to the correct regional endpoint.
  2. Confirm every request includes x-bronto-api-key.
  3. Run your application and trigger an operation that creates a span.
  4. Check Bronto for the expected service.name.
  5. Confirm new traces are visible and spans include the attributes you expect.

​
Troubleshooting

If you do not see traces:
  • verify the ingestion URL matches your region
  • verify the x-bronto-api-key header is present and valid
  • confirm your process flushes spans before exit
  • confirm your exporter is configured for traces, not logs or metrics
  • check network egress rules for ports 4317, 4318, or 443

​
Next steps

Once trace ingestion is working, you can:
  • add auto-instrumentation for your framework or runtime
  • route telemetry through a shared OpenTelemetry Collector
  • enrich spans with standard resource attributes
  • standardize exporter configuration across services
To inspect incoming trace data, see Explore Traces.