Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current version.

Installation

Deploy on Kubernetes

Install Loki

Open source

Install the Helm Chart

You can use Grafana Cloud to avoid installing, maintaining, and scaling your own instance of Grafana Loki. Create a free account to get started, which includes free forever access to 10k metrics, 50GB logs, 50GB traces, 500VUh k6 testing & more.

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

If object storage is configured, this chart configures Loki to run read and write targets in a scalable mode, highly available architecture (3 replicas of each) designed to work with AWS S3 object storage. It will also configure meta-monitoring of metrics and logs.

It is not possible to run the scalable mode with the filesystem storage.

Before you begin:

Helm 3 or above. See Installing Helm.
A running Kubernetes cluster.
A Prometheus operator installation in case meta-monitoring should be used.

To deploy Loki in scalable mode:

Add Grafana’s chart repository to Helm:

helm repo add grafana https://grafana.github.io/helm-charts

Update the chart repository:
bash
```
helm repo update
```

Configure the object storage:

Create the configuration file values.yaml:

storage:
  bucketNames:
    chunks: chunks
    ruler: ruler
    admin: admin
  type: s3
  s3:
    s3: <WHAT SHOULD GO HERE?>
    endpoint: <endpoint>
    region: <AWS region>
    secretAccessKey: <AWS secret access key>
    accessKeyId: <AWS access key ID>
    s3ForcePathStyle: false
    insecure: false

Consult the Reference for configuring other storage providers.