Like Prometheus, but for logs.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
loki/docs/sources/setup/install/helm/install-monolithic/_index.md

2.6 KiB

title menuTitle description aliases weight
Install the monolithic Helm chart Install monolithic Loki Installing Loki in monolithic, single binary mode using the Helm chart. [../../../installation/helm/monolithic ../../../installation/helm/install-monolithic/] 100

Install the monolithic Helm chart

This Helm Chart installation runs the Grafana Loki single binary within a Kubernetes cluster.

If you set the singleBinary.replicas value to 1, this chart configures Loki to run the all target in a [monolithic mode]({{< relref "../../../../get-started/deployment-modes#monolithic-mode" >}}), designed to work with a filesystem storage. It will also configure meta-monitoring of metrics and logs. If you set the singleBinary.replicas value to 2 or more, this chart configures Loki to run a single binary in a replicated, highly available mode. When running replicas of a single binary, you must configure object storage.

Before you begin: Software Requirements

To deploy Loki in monolithic mode:

  1. Add Grafana's chart repository to Helm:

    helm repo add grafana https://grafana.github.io/helm-charts
    
  2. Update the chart repository:

    helm repo update
    
  3. Create the configuration file values.yaml:

    • If running a single replica of Loki, configure the filesystem storage:

      loki:
        commonConfig:
          replication_factor: 1
        storage:
          type: 'filesystem'
      singleBinary:
        replicas: 1
      
    • If running Loki with a replication factor greater than 1, set the desired number replicas and provide object storage credentials:

      loki:
        commonConfig:
          replication_factor: 3
        storage:
          bucketNames:
            chunks: loki-chunks
            ruler: loki-ruler
            admin: loki-admin
          type: 's3'
          s3:
            endpoint: foo.aws.com
            secretAccessKey: supersecret
            accessKeyId: secret
      singleBinary:
        replicas: 3
      
  4. Deploy the Loki cluster using one of these commands.

    • Deploy with the defined configuration:

      helm install --values values.yaml loki grafana/loki
      
    • Deploy with the defined configuration in a custom Kubernetes cluster namespace:

      helm install --values values.yaml loki --namespace=loki grafana/loki