Menu

Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current version.

Open source

otelcol.receiver.loki

otelcol.receiver.loki receives Loki log entries, converts them to the OpenTelemetry logs format, and forwards them to other otelcol.* components.

Multiple otelcol.receiver.loki components can be specified by giving them different labels.

Usage

river
otelcol.receiver.loki "LABEL" {
  output {
    logs = [...]
  }
}

Arguments

otelcol.receiver.loki doesn’t support any arguments and is configured fully through inner blocks.

Blocks

The following blocks are supported inside the definition of otelcol.receiver.loki:

HierarchyBlockDescriptionRequired
outputoutputConfigures where to send converted telemetry data.yes

output block

The output block configures a set of components to forward resulting telemetry data to.

The following arguments are supported:

NameTypeDescriptionDefaultRequired
metricslist(otelcol.Consumer)List of consumers to send metrics to.[]no
logslist(otelcol.Consumer)List of consumers to send logs to.[]no
traceslist(otelcol.Consumer)List of consumers to send traces to.[]no

The output block must be specified, but all of its arguments are optional. By default, telemetry data is dropped. To send telemetry data to other components, configure the metrics, logs, and traces arguments accordingly.

Exported fields

The following fields are exported and can be referenced by other components:

NameTypeDescription
receiverLogsReceiverA value that other components can use to send Loki logs to.

Component health

otelcol.receiver.loki is only reported as unhealthy if given an invalid configuration.

Debug information

otelcol.receiver.loki does not expose any component-specific debug information.

Example

This example uses the otelcol.receiver.loki component as a bridge between the Loki and OpenTelemetry ecosystems. The component exposes a receiver which the loki.source.file component uses to send Loki log entries to. The logs are converted to the OTLP format before they are forwarded to the otelcol.exporter.otlp component to be sent to an OTLP-capable endpoint:

river
loki.source.file "default" {
  targets = [
    {__path__ = "/tmp/foo.txt", "loki.format" = "logfmt"},
    {__path__ = "/tmp/bar.txt", "loki.format" = "json"},
  ]
  forward_to = [otelcol.receiver.loki.default.receiver]
}

otelcol.receiver.loki "default" {
  output {
    logs = [otelcol.exporter.otlp.default.input] 
  } 
}

otelcol.exporter.otlp "default" {
  client {
    endpoint = env("OTLP_ENDPOINT")
  }
}