influxdbreceiver

README

InfluxDB Receiver

Status
Stability	beta: metrics
Distributions	contrib
Issues
Code Owners	@jacobmarble

This receiver accepts metrics data as InfluxDB Line Protocol.

Write endpoints exist at /write (InfluxDB 1.x compatibility) and /api/v2/write (InfluxDB 2.x compatibility). Write query parameters db/rp (InfluxDB 1.x) and org/bucket (InfluxDB 2.x) are ignored. Write query parameter precision is optional, defaults to ns.

Write responses:

• 204: success, no further response needed (no content)
• 400: permanent failure; check response body for details
• 500: retryable error; check response body for details

Configuration

The following configuration options are supported:

• endpoint (default = localhost:8086) HTTP service endpoint for the line protocol receiver. See our security best practices doc to understand how to set the endpoint in different environments.

The full list of settings exposed for this receiver are documented in config.go.

Example:

receivers:
  influxdb:
    endpoint: 0.0.0.0:8080

Definitions

InfluxDB is an open-source time series database.

Telegraf is an open-source metrics agent, similar to the OpenTelemetry Collector. Telegraf has hundreds of plugins.

Line protocol is a textual HTTP payload format used to move metrics between Telegraf agents and InfluxDB instances.

Schema

The InfluxDB->OpenTelemetry conversion schema and implementation are hosted at https://github.com/influxdata/influxdb-observability . This receiver automatically detects schema at parse time.

Example: Metrics - prometheus-v1

cpu_temp,foo=bar gauge=87.332
http_requests_total,method=post,code=200 counter=1027
http_requests_total,method=post,code=400 counter=3
http_request_duration_seconds 0.05=24054,0.1=33444,0.2=100392,0.5=129389,1=133988,sum=53423,count=144320
rpc_duration_seconds 0.01=3102,0.05=3272,0.5=4773,0.9=9001,0.99=76656,sum=1.7560473e+07,count=2693

Example: Metrics - prometheus-v2

prometheus,foo=bar cpu_temp=87.332
prometheus,method=post,code=200 http_requests_total=1027
prometheus,method=post,code=400 http_requests_total=3
prometheus,le=0.05 http_request_duration_seconds_bucket=24054
prometheus,le=0.1  http_request_duration_seconds_bucket=33444
prometheus,le=0.2  http_request_duration_seconds_bucket=100392
prometheus,le=0.5  http_request_duration_seconds_bucket=129389
prometheus,le=1    http_request_duration_seconds_bucket=133988
prometheus         http_request_duration_seconds_count=144320,http_request_duration_seconds_sum=53423
prometheus,quantile=0.01 rpc_duration_seconds=3102
prometheus,quantile=0.05 rpc_duration_seconds=3272
prometheus,quantile=0.5  rpc_duration_seconds=4773
prometheus,quantile=0.9  rpc_duration_seconds=9001
prometheus,quantile=0.99 rpc_duration_seconds=76656
prometheus               rpc_duration_seconds_count=1.7560473e+07,rpc_duration_seconds_sum=2693

Documentation

Index

• func NewFactory() receiver.Factory
• type Config

Functions

func NewFactory

func NewFactory() receiver.Factory

Types

type Config

type Config struct {
	confighttp.ServerConfig `mapstructure:",squash"`
}

Config defines configuration for the InfluxDB receiver.