This is documentation for the next version of Alloy. For the latest stable release, go to the latest version.
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
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
:
Hierarchy | Block | Description | Required |
---|---|---|---|
output | output | Configures 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:
Name | Type | Description | Default | Required |
---|---|---|---|---|
logs | list(otelcol.Consumer) | List of consumers to send logs to. | [] | no |
metrics | list(otelcol.Consumer) | List of consumers to send metrics to. | [] | no |
traces | list(otelcol.Consumer) | List of consumers to send traces to. | [] | no |
You must specify the output
block, but all its arguments are optional.
By default, telemetry data is dropped.
Configure the metrics
, logs
, and traces
arguments accordingly to send telemetry data to other components.
Exported fields
The following fields are exported and can be referenced by other components:
Name | Type | Description |
---|---|---|
receiver | LogsReceiver | A 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:
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 = sys.env("OTLP_ENDPOINT")
}
}
Compatible components
otelcol.receiver.loki
can accept arguments from the following components:
- Components that export OpenTelemetry
otelcol.Consumer
otelcol.receiver.loki
has exports that can be consumed by the following components:
- Components that consume Loki
LogsReceiver
Note
Connecting some components may not be sensible or components may require further configuration to make the connection work correctly. Refer to the linked documentation for more details.