Skip to main content

​
Sematext Exporter

Status Maintainers: @AkhigbeEromo Source: opentelemetry-collector-contrib

​
Supported Telemetry

Logs Metrics

​
Overview

This exporter supports sending metrics to Sematext Cloud in Influx line protocol format and logs using the Bulk Index Api format.

​
Configuration

The following configuration options are supported:
  • timeout (default = 5s) Timeout for requests
  • sending_queue details here
    • enabled (default = true)
    • num_consumers (default = 10) The number of consumers from the queue
    • queue_size (default = 1000) Maximum number of batches allowed in queue at a given time
  • retry_on_failure details here
    • enabled (default = true)
    • initial_interval (default = 5s) Time to wait after the first failure before retrying
    • max_interval (default = 30s) Upper bound on backoff interval
    • max_elapsed_time (default = 120s) Maximum amount of time (including retries) spent trying to send a request/batch
  • region (required) Region specifies the Sematext region the user is operating in; must be one of:
    • US
    • EU
  • metrics.app_token (required if sending metrics) Token of the Sematext Monitoring App to which metrics data will be sent. Must be a valid UUID string in the format xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. For example: 2046e37c-4fac-45f6-831d-922d43fde759.
  • metrics.payload_max_lines (default = 1_000) Maximum number of lines allowed per HTTP POST request
  • metrics.payload_max_bytes (default = 300_000) Maximum number of bytes allowed per HTTP POST request
  • logs.app_token (required if sending logs) Token of the Sematext Logs App to which logs data will be sent. Must be a valid UUID string in the format xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. For example: 6272eba4-b878-4606-aaef-6b11b9fa5810. Note: At least one of metrics.app_token or logs.app_token must be provided.
The full list of settings exposed for this exporter are documented in config.go. Example: 
timeout: 500ms
sending_queue:
  enabled: true
  num_consumers: 3
  queue_size: 10
retry_on_failure:
  enabled: true
  initial_interval: 1s
  max_interval: 3s
  max_elapsed_time: 10s
region: US  
metrics:
  app_token: 2064e37c-4fac-45f6-831d-922d43fde759
  payload_max_lines: 100
  payload_max_bytes: 1000
logs:
  app_token: 6272eba4-b878-4606-aaef-6b11b9fa5810

​
Configuration

​
Example Configuration

sematext/default-config:
  region: us
  metrics:
    app_token: "<METRICS_APP_TOKEN>"
sematext/override-config:
  timeout: 500ms
  sending_queue:
    enabled: true
    num_consumers: 3
    queue_size: 10
  retry_on_failure:
    enabled: true
    initial_interval: 1s
    max_interval: 3s
    max_elapsed_time: 10s
  region: us  
  metrics:
    app_token: "<METRICS_APP_TOKEN>"
    payload_max_lines: 72
    payload_max_bytes: 27
  logs:
    app_token: "<LOGS_APP_TOKEN>"
Last generated: 2026-04-13