Grafana Loki destination plugin
Grafana Loki is a horizontally scalable, highly available, multi-tenant log aggregation system inspired by Prometheus. It allows you to store and query logs using labels to filter and aggregate log data, helping you explore and visualize your logs in Grafana. The Grafana Loki Destination Plugin in Calyptia Core allows you to seamlessly integrate your telemetry data with Grafana Loki, enabling you to store, analyze, and visualize your log data using Grafana. With the Grafana Loki destination plugin, you can configure your Calyptia Core pipeline to send your log data to Grafana Loki,
Configuration parameters
The Grafana Loki destination plugin provides these configuration parameters.
General
| Key | Description |
|---|---|
| Host | Loki hostname or IP address. Do not include the sub path, such as loki/api/v1/push. Include only the base hostname / URL. |
| Port | TCP port of the target Loki service. |
Basic authentication
| Key | Description |
|---|---|
| HTTP Username | Basic Auth Username. |
| HTTP Password | Basic Auth Password. Requires HTTP_User to be set. |
Advanced
| Key | Description |
|---|---|
| Tenant ID | Tenant ID used by default to push logs to Loki. If omitted or empty it assumes Loki is running in single-tenant mode and no X-Scope-OrgID header is sent. |
| Tenant ID Key | If set, X-Scope-OrgID will be the value of the key from incoming record. It is useful to set X-Scode-OrgID dynamically. |
| Labels | labels for API requests, If no value is set the default label is job=fluent-bit. |
| Label Keys | Comma-separated list of keys to use as stream labels. |
| Enable Auto Kubernetes Labels | If set to true, it will add all Kubernetes labels to Loki labels. |
| Drop Single Key | If set to true and only a single key remains, the log line sent to Loki will be the value of that key. |
| Remove Keys | Comma separated list of keys to remove. |
| Line Format | Format to use when flattening the record to a log line. Valid values are json or key_value. If set to jso the log line sent to Loki will be the Fluent Bit record dumped as JSON. If set to key_value, the log line will be each item in the record concatenated together (separated by a single space) in the format =. |
Security and TLS
| Key | Description |
|---|---|
| TLS | Enable or disable TLS/SSL support. |
| TLS Certificate Validation | Turn TLS/SSL certificate validation on or off. TLS must be on for this setting to be enabled. |
| TLS Debug Level | Set TLS debug verbosity level. Accepts these values: 0 (No debug), 1 (Error), 2 (State change), 3 (Informational), 4 (Verbose). |
| CA Certificate File Path | Absolute path to CA certificate file. |
| Certificate File Path | Absolute path to certificate file. |
| Private key File Path | Absolute path to private key file. |
| Private Key Path Password | Optional password for tls.key_file file. |
| TLS SNI Hostname Extension | Hostname to be used for TLS SNI extension. |
Advanced networking
| Key | Description |
|---|---|
| DNS Mode | Select the primary DNS connection type (TCP or UDP). |
| DNS Resolver | Select the primary DNS connection type (TCP or UDP). |
| Prefer IPv4 | Prioritize IPv4 DNS results when trying to establish a connection. |
| Keepalive | Enable or disable Keepalive support. |
| Keepalive Idle Timeout | Set maximum time allowed for an idle Keepalive connection. |
| Max Connect Timeout | Set maximum time allowed to establish a connection, this time includes the TLS handshake. |
| Max Connect Timeout Log Error | On connection timeout, specify if it should log an error. When disabled, the timeout is logged as a debug message. |
| Max Keepalive Recycle | Set maximum number of times a keepalive connection can be used before it is retired. |
| Source Address | Specify network address to bind for data traffic. |