Skip to main content

Documentation Index

Fetch the complete documentation index at: https://otel.fyi/llms.txt

Use this file to discover all available pages before exploring further.

​
Honeycombmarker Exporter

Status Available in: contrib Maintainers: @TylerHelmuth, @fchikwekwe Source: opentelemetry-collector-contrib

​
Supported Telemetry

Logs

​
Overview

This exporter allows creating markers, via the Honeycomb Markers API, based on the look of incoming telemetry. The following configuration options are supported:
  • api_key (Required): This is the API key for your Honeycomb account.
  • api_url (Optional): This sets the hostname to send marker data to. If not set, will default to https://api.honeycomb.io/
  • markers (Required): This is a list of configurations to create an event marker.
    • type (Required): Specifies the marker type.
    • rules (Required): This is a list of OTTL rules that determine when to create an event marker.
      • log_conditions (Required): A list of OTTL log conditions that determine a match. The marker will be created if ANY condition matches.
    • dataset_slug (Optional): The dataset in which to create the marker. If not set, will default to __all__.
    • message_key (Optional): The key of the attribute whose value will be used as the marker’s message. If necessary the value will be converted to a string.
    • url_key (Optional): The key of the attribute whose value will be used as the marker’s url. If necessary the value will be converted to a string.
Example: 
exporters:
  honeycombmarker:
    api_key: {{env:HONEYCOMB_API_KEY}}
    markers:
      # Creates a new marker anytime the exporter sees a k8s event with a reason of Backoff
      - type: k8s-backoff-events
        rules:
          log_conditions:
            - IsMap(body) and IsMap(body["object"]) and body["object"]["reason"] == "Backoff"

​
Configuration

​
Example Configuration

honeycombmarker:
  api_key: "test-apikey"
  markers:
    - type: "fooType"
      rules:
        log_conditions:
          - body == "test"
honeycombmarker/all_fields:
  api_key: "test-apikey"
  api_url: "https://api.testhost.io"
  sending_queue:
    enabled: true
    num_consumers: 10
    queue_size: 1000
    sizer: requests
  retry_on_failure:
    enabled: true
    initial_interval: 5000000000
    randomization_factor: 0.5
    multiplier: 1.5
    max_interval: 30000000000
    max_elapsed_time: 300000000000
  markers:
    - type: "fooType"
      message_key: "test message"
      url_key: "https://api.testhost.io"
      dataset_slug: "testing"
      rules:
        log_conditions:
          - body == "test"

honeycombmarker/bad_syntax_log:
  api_key: "test-apikey"
  api_url: "https://api.testhost.io"
  markers:
    - type: "fooType"
      message_key: "test message"
      url_key: "https://api.testhost.io"
      dataset_slug: "__all__"
      rules:
        log_conditions:
          - body == "test"
          - set(attributes["body"], body)

honeycombmarker/no_conditions:
  api_key: "test-apikey"
  api_url: "https://api.testhost.io"
  markers:
    - type: "test-apikey"
      message_key: "test message"
      url_key: "https://api.testhost.io"
      dataset_slug: "__all__"
      rules:

honeycombmarker/no_api_key:
  api_key: ""
  api_url: "https://api.testhost.io"
  markers:
    - type: "fooType"
      message_key: "test message"
      url_key: "https://api.testhost.io"
      dataset_slug: "__all__"
      rules:
        log_conditions:
          - body == "test"

honeycombmarker/no_markers_supplied:
  api_key: "test-apikey"
  api_url: "https://api.testhost.io"
  markers:

honeycombmarker/no_dataset_slug:
  api_key: "test-apikey"
  api_url: "https://api.testhost.io"
  markers:
    - type: "fooType"
      message_key: "test message"
      url_key: "https://api.testhost.io"
      rules:
        log_conditions:
          - body == "test"
Last generated: 2026-04-20