Skip to main content

​
Faro Exporter

Status Available in: contrib Maintainers: @dehaansa, @rlankfo, @mar4uk Source: opentelemetry-collector-contrib

​
Supported Telemetry

Logs Traces

​
Overview

The Faro exporter sends telemetry data to a Faro endpoint.

​
Configuration

The following settings are required: The following settings can be optionally configured:
  • sending_queue
    • enabled (default = true)
    • num_consumers (default = 10)
    • queue_size (default = 1000)
  • retry_on_failure
    • enabled (default = true)
    • initial_interval (default = 5s): Time to wait after the first failure before retrying.
    • max_interval (default = 30s): Upper bound on backoff.
    • max_elapsed_time (default = 300s): Maximum amount of time spent trying to send a batch.
  • timeout (default = 5s): HTTP request timeout when sending data.
  • read_buffer_size (default = 0): Size of the buffer used to read the response body.
  • write_buffer_size (default = 512 KiB): Size of the buffer used to write the request body.
  • headers (default = {}): Additional headers to send with the request.
  • compression (default = none): Compression method to use for the request body. Supported values: none, gzip.
Example: 
exporters:
  faro:
    endpoint: https://faro.example.com/collect
    timeout: 10s
    headers:
      X-API-Key: "my-api-key"
The full list of settings exposed for this exporter are documented here with detailed sample configurations here.

​
Getting Started

The following settings are required:
  • endpoint (no default): URL to which the exporter is going to send Faro telemetry data. For example: https://faro.example.com/collect.
To use TLS, specify https:// as the protocol scheme in the URL passed to the endpoint property. See Advanced Configuration for more TLS options. Example: 
exporters:
  faro:
    endpoint: "https://faro.example.com/collect"

  faro/tlsnoverify:
    endpoint: "https://faro.example.com/collect"
    tls:
      insecure_skip_verify: true

​
Advanced Configuration

Several helper files are leveraged to provide additional capabilities automatically:

​
Configuration

​
Example Configuration

receivers:
  nop:

processors:
  nop:

exporters:
  faro:
    endpoint: https://faro.example.com/collect
    timeout: 10s
    headers:
      X-API-Key: "my-api-key"

  faro/with_queue_settings:
    endpoint: https://faro.example.com/collect
    sending_queue:
      enabled: true
      num_consumers: 2
      queue_size: 10

  faro/with_retry_settings:
    endpoint: https://faro.example.com/collect
    retry_on_failure:
      enabled: true
      initial_interval: 10s
      max_interval: 60s
      max_elapsed_time: 10m

  faro/with_compression:
    endpoint: https://faro.example.com/collect
    compression: gzip

service:
  pipelines:
    traces:
      receivers: [nop]
      processors: [nop]
      exporters: [faro]
    metrics:
      receivers: [nop]
      processors: [nop]
      exporters: [faro]
    logs:
      receivers: [nop]
      processors: [nop]
      exporters: [faro]
Last generated: 2026-04-13