mezmoexporter

README

Mezmo Exporter

Status
Stability	beta: logs
Distributions	contrib
Issues
Code Owners	@dashpole, @billmeyer, @gjanco

This exporter supports sending OpenTelemetry log data to Mezmo.

Note: Mezmo logs ingestion requires a hostname field to be present. When logs are sent via this exporter, and hostname metadata is not added, the Mezmo ingestion API will set hostname=otel. To provide the hostname information, we recommend adding a Resource Detection Processor to the collector configuration. Doing so will cause this exporter to automatically add the hostname metadata to the outgoing log data whenever it is available. See the below example configuration for a basic configuration that adds hostname detection support.

Configuration options:

• ingest_url (optional): Specifies the URL to send ingested logs to. If not specified, will default to https://logs.mezmo.com/otel/ingest/rest.
• ingest_key (required): Ingestion key used to send log data to Mezmo. See Ingestion Keys for more details.

Example:

Simple Log Data

receivers:
  otlp:
    protocols:
      grpc:
        endpoint: ":4317"

processors:
  resourcedetection:
    detectors:
      - system
    system:
      hostname_sources:
        - os

exporters:
  mezmo:
    ingest_url: "https://logs.mezmo.com/otel/ingest/rest"
    ingest_key: "00000000000000000000000000000000"

service:
  pipelines:
    logs:
      receivers: [ otlp ]
      processors: [ resourcedetection ]
      exporters: [ mezmo ]

Documentation

Overview

Package mezmoexporter implements an exporter that sends data to Mezmo.

Index

• func NewFactory() exporter.Factory
• type Config
  • func (c *Config) Validate() error

Functions

func NewFactory

func NewFactory() exporter.Factory

NewFactory creates a factory for Mezmo exporter.

Types

type Config

type Config struct {
	confighttp.ClientConfig      `mapstructure:",squash"` // squash ensures fields are correctly decoded in embedded struct.
	exporterhelper.QueueSettings `mapstructure:"sending_queue"`
	configretry.BackOffConfig    `mapstructure:"retry_on_failure"`

	// IngestURL is the URL to send telemetry to.
	IngestURL string `mapstructure:"ingest_url"`

	// Token is the authentication token provided by Mezmo.
	IngestKey configopaque.String `mapstructure:"ingest_key"`
}

Config defines configuration for Mezmo exporter.

func (*Config) Validate

func (c *Config) Validate() error