datadog

Documentation

Overview

Package datadog provides a telemetry backend that sends events to Datadog's HTTP Logs Intake API. It maps telemetry.Event to Datadog's native log format with region-aware endpoint resolution.

Index

• func NewBackend(apiKey string, log logger.Logger, opts ...Option) telemetry.Backend
• type Option
  • func WithEndpoint(url string) Option
  • func WithRegion(region Region) Option
  • func WithSource(source string) Option
• type Region

Functions

func NewBackend

func NewBackend(apiKey string, log logger.Logger, opts ...Option) telemetry.Backend

NewBackend creates a Datadog telemetry backend. apiKey is the Datadog API key (not an application key).

Types

type Option

type Option func(*config)

Option configures the Datadog backend.

func WithEndpoint

func WithEndpoint(url string) Option

WithEndpoint overrides the ingest URL. Used by tests pointing at a local httptest server, and by deployments that proxy Datadog traffic. Takes precedence over WithRegion when both are set.

func WithRegion

func WithRegion(region Region) Option

WithRegion sets the Datadog region. Default: RegionUS1.

func WithSource

func WithSource(source string) Option

WithSource overrides the ddsource tag. Default: "gtb".

type Region

type Region string

Region identifies a Datadog data center region.

const (
	RegionUS1 Region = "us1" // default
	RegionUS3 Region = "us3"
	RegionUS5 Region = "us5"
	RegionEU1 Region = "eu1"
	RegionAP1 Region = "ap1"
	RegionAP2 Region = "ap2"
	RegionGOV Region = "gov"
)