---
title: "Single binary meta-monitoring | Grafana Loki documentation"
description: "Describes how to deploy Meta Monitoring for single binary"
---

# Single binary meta-monitoring

Meta monitoring for [monolithic mode](/docs/loki/next/get-started/deployment-modes/#monolithic-mode) deployments involves some additional configuration. This approach does not use the Kubernetes Monitoring Helm chart.

## Metrics

Configure Alloy or Prometheus to scrape the Loki metrics endpoint, adding the additional labels that are expected by the [mixin](/docs/loki/next/operations/meta-monitoring/mixins/) dashboards, alerts, and recording rules:

### Alloy

Alloy ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy

```alloy
prometheus.scrape "loki" {
  targets = [{
    __address__ = "localhost:3100",
    cluster     = "prod",
    namespace   = "default",
    job         = "default/loki-single-binary",
    pod         = "loki-single-binary",
    container   = "loki",
  }]
  forward_to = [prometheus.remote_write.default.receiver]
}

prometheus.remote_write "default" {
  endpoint {  
    url = "<PROMETHEUS_REMOTE_WRITE_URL>"
  }  
}
```

### Prometheus

YAML ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy

```yaml
scrape_configs:
  - job_name: loki
    static_configs:
      - targets: ['localhost:3100']
        labels:
          cluster: prod
          namespace: default
          job: default/loki-single-binary
          pod: loki-single-binary
          container: loki
```

## Mixins

To generate the [mixins](/docs/loki/next/operations/meta-monitoring/mixins/):

01. Install [jb](https://github.com/jsonnet-bundler/jsonnet-bundler).
02. Install [mixtool](https://github.com/monitoring-mixins/mixtool).
03. Clone the Loki repository from Github.
    
    Bash ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
    
    ```bash
    git clone https://github.com/grafana/loki
    cd loki
    ```
04. Create the output directory.
    
    Bash ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
    
    ```bash
    mkdir loki/production/loki-mixin-compiled-single-binary
    ```
05. Navigate to the mixin directory.
    
    Bash ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
    
    ```bash
    cd loki/production/loki-mixin
    ```
06. Use `jb` to install mixin dependencies and generate the `vender` directory.
    
    Bash ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
    
    ```bash
    jb install
    ```
07. Create the mixin configuration file `single-binary.libsonnet`.
    
    Bash ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
    
    ```bash
    cat <<EOF > single-binary.libsonnet
    local loki = import 'mixin.libsonnet';
    
    loki + {
      _config+:: {
        meta_monitoring: {
          enabled: true,
        },
        canary+: {
          // Whether or not to include the loki-canary dashboard
          enabled: true
        },
        promtail: {
          // Whether or not to include promtail specific dashboards
          enabled: false,
        },
        // Tunes histogram recording rules to aggregate over this interval.
        // Set to at least twice the scrape interval; otherwise, recording rules will output no data.
        // Set to four times the scrape interval to account for edge cases: https://www.robustperception.io/what-range-should-i-use-with-rate/        
        recording_rules_range_interval: '5m'
      }  
    }
    EOF
    ```
08. Generate dashboards, alerts, and recording rules.
    
    Bash ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
    
    ```bash
    mixtool generate all \
      --output-alerts ../loki-mixin-compiled-single/alerts.yaml \
      --output-rules ../loki-mixin-compiled-single/rules.yaml \
      --directory ../loki-mixin-compiled-single/dashboards \
      single-binary.libsonnet
    ```
09. See the generated dashboards, alerts, and recording rules in the `loki/production/loki-mixin-compiled-single-binary` directory.
10. Follow the instructions in the [Install Mixins](/docs/loki/next/operations/meta-monitoring/mixins/) documentation to set up the dashboards, alerts, and recordings.