Skip to content

Latest commit

 

History

History
 
 

influxdbreceiver

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

InfluxDB Receiver

Status
Stability beta
Supported pipeline types metrics
Distributions contrib

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 = 0.0.0.0:8086) HTTP service endpoint for the line protocol receiver

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