Motivations for Restructure📜
The original Loki BigBang chart referenced Grafana’s Loki monolith chart as its upstream source. It was restructured to support two main goals.
* Support Loki’s multiple architectures with a consistent interface for chart consumers
* Support Grafana Enterprise Logs, Grafana’s enterprise functionality as an optional additional component
Migrating from 2.x.x📜
Previous values passed into values.yaml should be nested under loki: which should remain consistent with the previous top level values.
The main caveat to that is the previous implementation included .Values.config.existingSecret which allowed you to use a specified secret for a config. This value has been replaced with .Values.global.existingSecretForConfig which behaves the same way but was relocated to provide an option that was consistent for all architecture modes.
Previous values.yaml
replicas: 3
extraArgs:
# https://github.com/grafana/loki/issues/5021
target: all,table-manager
config:
auth_enabled: false
ingester:
chunk_target_size: 196608
lifecycler:
ring:
kvstore:
store: inmemory
replication_factor: 1
...
values.yaml
loki:
replicas: 3
extraArgs:
# https://github.com/grafana/loki/issues/5021
target: all,table-manager
config:
auth_enabled: false
ingester:
chunk_target_size: 196608
lifecycler:
ring:
kvstore:
store: inmemory
replication_factor: 1
...
Using Simple Scalable Architecture📜
To opt for the simple scalable architecture enable loki-simple-scalable and disable loki
See Configuration for options building the Loki config for the simple-scalable architecture
loki-simple-scalable:
enabled: true
loki:
enabled: false
Loki Config Options📜
To specify a config file for Loki you can either:
* Leverage the respective config object in either the loki and loki-simple-scalable subchart depending on which architecture you choose.
* Specify a secret to use with global.existingSecretForConfig
* Use the secret generated in the parent chart, by setting .Values.global.createGlobalConfig: true and .Values.global.existingSecretForConfig: loki-config
Loki📜
.Values.loki.config
Loki Simple Scalable📜
.Values.loki-simple-scalable.loki.config
Existing Secret📜
.Values.global.existingSecretForConfig
Refactored Structure (3.x.x)📜
The updated design includes the additional upstream of simple-scalable chart, as well as components from the enterprise logs chart.
The previous chart implementation (Loki 2.x.x-bb.x), referenced the loki monolith chart exclusively as its upstream.
flowchart TD
subgraph chart[Loki 3.x.x Chart]
et[./templates/enterprise/*]
loki-restructured[Chart] -- conditional dependency --> oss-loki[./charts/loki]
loki-restructured[Chart] -- conditional dependency --> oss-scalable[./charts/loki-simple-scalable]
loki-restructured[Chart] -- conditional dependency --> et
end
et --> upstream-loki-el[https://github.com/grafana/helm-charts/tree/main/charts/enterprise-logs]
oss-loki -- kpt upstream --> upstream-loki[https://github.com/grafana/helm-charts/tree/main/charts/loki]
oss-scalable -- kpt upstream --> upstream-loki-ss[https://github.com/grafana/helm-charts/tree/main/charts/loki-simple-scalable]Monolith📜
flowchart TD
S3[(S3)]
Promtail--> Loki
Grafana --> Loki --> S3Monolith with Grafana Enterprise Logging (GEL)📜
flowchart TD
subgraph Enterprise
g[GEL Gateway] --> a[Admin API]
a[Admin API]
end
Promtail--> g[GEL Gateway] --> Loki --> S3
Grafana --> g[GEL Gateway]Simple Scalable📜
flowchart TD
S3[(S3)]
read[Loki Read] --> S3
write[Loki Write]
Promtail--> write --> S3
Grafana --> readSimple Scalable Enterprise with Grafana Enterprise Logging (GEL)📜
flowchart TD
subgraph Enterprise
g[GEL Gateway] --> a[Admin API]
a[Admin API]
end
S3[(S3)]
read[Loki Read] --> S3
write[Loki Write]
Logs--> g[GEL Gateway] --> gateway
gateway[Loki Gateway] --> read
gateway --> write --> S3
Grafana --> g[GEL Gateway]