> ## Documentation Index
> Fetch the complete documentation index at: https://otel.fyi/llms.txt
> Use this file to discover all available pages before exploring further.

# Sematext

> OpenTelemetry exporter for Sematext

# Sematext Exporter

![Status](https://img.shields.io/badge/status-development-orange)

**Maintainers:** [@AkhigbeEromo](https://github.com/AkhigbeEromo)

**Source:** [opentelemetry-collector-contrib](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/exporter/sematextexporter)

## Supported Telemetry

![Logs](https://img.shields.io/badge/logs-development-blue) ![Metrics](https://img.shields.io/badge/metrics-development-green)

## Overview

This exporter supports sending metrics to [Sematext Cloud](https://sematext.com/) 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](https://github.com/open-telemetry/opentelemetry-collector/blob/v0.25.0/exporter/exporterhelper/README.md#configuration)
  * `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](https://github.com/open-telemetry/opentelemetry-collector/blob/v0.25.0/exporter/exporterhelper/README.md#configuration)
  * `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](config.go).

Example:

```yaml theme={null}
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

```yaml theme={null}
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-07-06*