› Clients › Promtail › Stages › labelallow

labelallow stage

The labelallow stage is an action stage that allows only the provided labels to be included in the label set that is sent to Loki with the log entry.

Schema

labelallow:
  - [<string>]
  ...

Examples

For the given pipeline:

kubernetes_sd_configs:
 - role: pod 
pipeline_stages:
- docker: {}    
- labelallow:
    - kubernetes_pod_name
    - kubernetes_container_name

Given the following incoming labels:

  • kubernetes_pod_name: "loki-pqrs"
  • kubernetes_container_name: "loki"
  • kubernetes_pod_template_hash: "79f5db67b"
  • kubernetes_controller_revision_hash: "774858987d"

Only the below labels would be sent to loki

  • kubernetes_pod_name: "loki-pqrs"
  • kubernetes_container_name: "loki"
Related Loki resources
Getting started with logging and Grafana Loki (APAC timezone)

Join this webinar to learn why correlating metrics and logs is critical across the development lifecycle, and how Loki helps reduce logging costs and operations overhead.

Logging with Loki: Essential configuration settings

This webinar focuses on Grafana Loki configuration including agents Promtail and Docker; the Loki server; and Loki storage for popular backends.

Observability with logs & Grafana

Discover how you can utilize, manage, and visualize log events with Grafana and Grafana’s logging application Loki.