Loki Receiver

Status
Stability	alpha: logs
Distributions	contrib
Issues
Code Owners	@mar4uk

The Loki receiver implements the Loki push api as specified in Loki HTTP API: Ingest logs. It allows Promtail instances to specify the open telemetry collector as their lokiAddress.

This receiver runs HTTP and GRPC servers to ingest log entries in Loki format.

Getting Started

The settings are:

• endpoint (required, default = localhost:3500 for HTTP protocol, localhost:3600 gRPC protocol): host:port to which the receiver is going to receive data. See our security best practices doc to understand how to set the endpoint in different environments.
• use_incoming_timestamp (optional, default = false) if set true the timestamp from Loki log entry is used

Example:

receivers:
  loki:
    protocols:
      http:
        endpoint: 0.0.0.0:3500
      grpc:
        endpoint: 0.0.0.0:3600
    use_incoming_timestamp: true

Advanced Configuration

Several helper files are leveraged to provide additional capabilities automatically:

• gRPC settings including CORS
• HTTP settings
• TLS and mTLS settings
• Auth settings