Grafana Loki Helm 安装完全指南三种部署模式、存储配置与监控实践【免费下载链接】lokiLike Prometheus, but for logs.项目地址: https://gitcode.com/GitHub_Trending/lok/lokiHelm 图表Chart是在 Kubernetes 集群中配置、安装与升级 Grafana Loki 的标准方式。本文以当前仓库中 docs/sources/setup/install/helm/_index.md 为主线系统讲解 Loki 的 Monolithic单二进制、Simple Scalable简单可扩展与 Microservices微服务三种部署形态并结合 concepts.md 与各安装子页面完整给出可复制的values.yaml示例、对象存储配置、Gateway API 接入与监控告警实践。读完本文你将能够根据业务规模选择正确的部署模式并用 Helm 在 Kubernetes 上交付一套生产可用的 Loki。Helm 图表概述Helm 图表让你可以用声明式的方式在 Kubernetes 集群中配置、安装与升级 Grafana Loki。本文所述内容基于 Loki 社区维护的 Helm 图表Loki Community Helm Chart该图表现已由 Grafana 社区 Champion 在 grafana-community/helm-charts 仓库中维护Loki 图表相关的 issue 与 Pull Request 应提交到该社区仓库。关于图表的核心概念与组件说明可参考 Helm chart components关于所有配置项的完整字段级说明可参考 Helm chart values 参考文档。部署模式选型Loki 被设计为可以以两种主要状态运行详细差异见 Loki 部署模式Monolithic单体模式推荐在将 Loki 作为小型 meta 监控栈的一部分时使用。所有组件运行在单个进程中部署简单适合小规模场景每天数十 GB 以内的日志量。Microservices微服务模式适用于需要高可用与高可扩展性的工作负载。Loki 在 Grafana Labs 内部即以该模式部署。每个组件作为独立进程运行架构最复杂但能力最强适合大规模场景通常每天超过 1 TB 的日志量。此外 Loki 还支持Simple Scalable简单可扩展模式它将运行路径拆分为 read、write、backend 三个目标。但需要注意Simple Scalable DeploymentSSD模式将在 Loki 4.0 中被弃用并移除。为了获得最佳的生产体验官方推荐在生产环境以microservices微服务模式部署 Loki。三种模式在 Helm 图表中通过顶层deploymentMode字段切换默认值为Monolithic。该字段的取值与迁移模式在 reference.md 中有完整定义deploymentMode 取值说明Monolithic单二进制模式单副本即可运行适合小规模安装通常无 HA 需求每天数十 GB 以内SimpleScalableread / write / backend 三目标模式已弃用Loki 4 中移除适合中等规模每天约 1 TB 以内Distributed微服务模式各组件独立运行最复杂但能力最强适合大规模场景通常每天超过 1 TBMonolithic-SimpleScalable用于在两种模式之间迁移的特殊模式SimpleScalable-Distributed用于在两种模式之间迁移的特殊模式注意SimpleScalable与Distributed模式必须使用对象存储filesystem 存储不支持。图表默认安装的组件无论哪种模式图表默认都会安装以下通用组件详见 concepts.mdGateway网关默认启用gateway.enabled: true是一个 NGINX负责暴露 Loki API 并自动将请求代理到正确的 Loki 组件读或写组件使用 filesystem 存储时则代理到单实例。可以通过gateway.ingress需gateway.enabled: true或顶层ingress需gateway.enabled: false暴露 Loki但二者不可同时使用。网关启用后Grafana 与日志采集 Agent如 Grafana Alloy都应配置为使用网关。Loki Canary默认安装lokiCanary.enabled: true用于持续向 Loki 写入并查询日志以验证部署健康状态可通过lokiCanary.enabledfalse关闭。Caching缓存默认部署基于 Memcached 的 chunks cachechunksCache.enabled: true与 results cacheresultsCache.enabled: true。若要使用外部托管的 Memcached可禁用内置缓存并将chunksCache.addresses/resultsCache.addresses指向你的服务。可选组件Pattern ingester模式摄取器用于检测与提取日志模式默认关闭patternIngester.enabled: falsereplicas: 0。在 Distributed 模式下启用独立工作负载deploymentMode: Distributed patternIngester: enabled: true replicas: 1 loki: pattern_ingester: enabled: true在 Monolithic 或 SimpleScalable 模式下只需通过 Loki 配置启用loki: pattern_ingester: enabled: trueOverrides exporter可选组件将每个租户的配置覆盖overrides以 Prometheus 指标形式暴露默认关闭overridesExporter.enabled: false。需要观测租户级 limit 设置时可启用。Bloom filters实验性图表提供三个实验性组件——bloomGateway服务 bloom filter 查询、bloomPlanner规划 bloom filter 构建任务、bloomBuilder构建 bloom filter。三者默认关闭replicas 为 0。启用时需要在 Loki 配置中开启loki.bloom_build.enabled: true、loki.bloom_gateway.enabled: true并为对应组件设置非零副本数。Zone-aware replication可用区感知复制在微服务模式下图表默认启用 ingest 的zone-aware replicationingester.zoneAwareReplication.enabled: true。这会创建三个 ingester StatefulSetzone-a、zone-b、zone-c并要求启用rollout-operator子图表rollout_operator.enabled: true以协调跨可用区的滚动发布。可用区感知复制允许在滚动期间同时关闭并重启单个可用区内的多个 ingester而其余两个可用区保证数据至少有一份副本。在开发或测试环境中可关闭ingester: zoneAwareReplication: enabled: falseMonolithic 模式安装单二进制模式部署对应文档 Install the monolithic Helm chart将 Loki 以单进程方式部署。前置要求Helm 3 及以上、Kubernetes 1.25 及以上、一个可用的 Kubernetes 集群。单副本部署单副本模式适合测试、开发或作为 meta-monitoring 系统。单副本部署会安装Loki1 副本、Loki Canary1 DaemonSet、Loki Gateway1 个 NGINX 副本、Chunks cache1 个 StatefulSet、Results cache1 个 StatefulSet以及可选的 MinIO。创建values.yamlloki: commonConfig: replication_factor: 1 schemaConfig: configs: - from: 2024-04-01 store: tsdb object_store: s3 schema: v13 index: prefix: loki_index_ period: 24h pattern_ingester: enabled: true limits_config: allow_structured_metadata: true volume_enabled: true rulerConfig: enable_api: true ignoreMinioDeprecation: true # 临时方案 —— MinIO 将于 2026-10-31 移除 minio: enabled: true deploymentMode: Monolithic singleBinary: replicas: 1 # 将其他部署模式的副本数清零 backend: replicas: 0 read: replicas: 0 write: replicas: 0 ingester: replicas: 0 querier: replicas: 0 queryFrontend: replicas: 0 queryScheduler: replicas: 0 distributor: replicas: 0 compactor: replicas: 0 indexGateway: replicas: 0 bloomPlanner: replicas: 0 bloomBuilder: replicas: 0 bloomGateway: replicas: 0注意如果只使用 1 个副本必须设置commonConfig.replication_factor: 1否则请求会失败。多副本高可用部署将singleBinary.replicas设置为 2 及以上时图表会以高可用方式部署复制的单二进制运行。多副本部署安装Loki3 副本、Loki Canary1 DaemonSet、Loki Gateway1 个 NGINX 副本、Chunks cache1 个 StatefulSet、Results cache1 个 StatefulSet与可选 MinIO。官方建议高可用至少运行 3 个副本。多副本运行必须配置对象存储。将上述配置中的commonConfig.replication_factor与singleBinary.replicas均改为3即可。这种方式比微服务模式更省成本但运营更简单。执行部署# 1. 添加 Grafana Community 图表仓库 helm repo add grafana-community https://grafana-community.github.io/helm-charts # 2. 更新图表仓库 helm repo update # 3. 安装首次部署 helm install --values values.yaml loki grafana-community/loki -n loki --create-namespace # 4. 升级 helm upgrade --values values.yaml loki grafana-community/loki -n loki # 5. 验证 kubectl get pods -n loki注意自图表迁移到社区仓库后图表编号规则已改变——大版本号更新代表图表发生破坏性变更。另外自社区图表 12.0.0 起SingleBinary更名为Monolithic请显式设置deploymentMode: Monolithic旧值SingleBinary仍被接受但已弃用。Simple Scalable 模式安装简单可扩展模式对应文档 Install the simple scalable Helm chart将执行路径拆分为 read、write、backend 三个目标。该模式必须使用对象存储loki.storage.type必须为s3、gcs、azure或其他受支持的对象存储类型不支持 filesystem。默认副本配置Read3 副本、Write3 副本、Backend3 副本、Loki Canary1 DaemonSet、Gateway1 个 NGINX 副本、Chunks cache1 副本、Results cache1 副本与可选 MinIO。前置要求Kubernetes 集群至少 3 个节点。开发测试用values.yaml使用内置 MinIOloki: schemaConfig: configs: - from: 2024-04-01 store: tsdb object_store: s3 schema: v13 index: prefix: loki_index_ period: 24h ingester: chunk_encoding: snappy querier: # 默认为 4内存和 CPU 充足可调高OOM 时调低 max_concurrent: 4 pattern_ingester: enabled: true limits_config: allow_structured_metadata: true volume_enabled: true deploymentMode: SimpleScalable backend: replicas: 2 read: replicas: 2 write: replicas: 3 # 保证复制后的数据持久性 ignoreMinioDeprecation: true # 临时方案 —— MinIO 将于 2026-10-31 移除 minio: enabled: true gateway: service: type: LoadBalancerMicroservicesDistributed模式安装微服务模式对应文档 Install the microservice Helm chart将 Loki 的各个组件作为独立进程运行。使用deploymentMode: Distributed并配合下文的副本设置时图表会部署以下组件Compactor1 副本压缩并处理已存储的数据Distributor3 副本分发写入请求IndexGateway2 副本处理索引Ingester3 副本启用 zone awareness 时每 zone 1 个处理数据摄取Querier3 副本处理查询QueryFrontend2 副本管理前端查询QueryScheduler2 副本调度查询Gateway1 个 NGINX 副本暴露 Loki API 并代理请求到正确的组件Loki Canary1 DaemonSet验证部署健康Chunks cache1 副本用 memcached 缓存 chunk 数据Results cache1 副本用 memcached 缓存查询结果前置要求Helm 3 及以上、Kubernetes 1.25 及以上、至少 3 个节点的集群因为默认启用了 zone-aware replication。官方不推荐在微服务模式下使用 filesystem 存储下面的示例使用已弃用的内置 MinIO 子图表提供完整自包含示例生产环境应配置独立的外部对象存储后端。开发测试用values.yamlloki: schemaConfig: configs: - from: 2024-04-01 store: tsdb object_store: s3 schema: v13 index: prefix: loki_index_ period: 24h ingester: chunk_encoding: snappy querier: max_concurrent: 4 pattern_ingester: enabled: true limits_config: allow_structured_metadata: true volume_enabled: true deploymentMode: Distributed ingester: replicas: 3 # 结合复制保证数据持久性 zoneAwareReplication: enabled: false querier: replicas: 3 # 通过并行提升查询性能 maxUnavailable: 2 queryFrontend: replicas: 2 maxUnavailable: 1 queryScheduler: replicas: 2 distributor: replicas: 3 maxUnavailable: 2 compactor: replicas: 1 indexGateway: replicas: 2 maxUnavailable: 1 patternIngester: enabled: true replicas: 1 bloomPlanner: replicas: 0 bloomBuilder: replicas: 0 bloomGateway: replicas: 0 backend: replicas: 0 read: replicas: 0 write: replicas: 0 singleBinary: replicas: 0 # 将 Loki gateway 暴露为 LoadBalancer便于外部写入与查询 gateway: service: type: LoadBalancer ignoreMinioDeprecation: true # 临时方案 —— MinIO 将于 2026-10-31 移除 minio: enabled: true安装完成后kubectl get pods -n loki的输出应类似loki-canary-8thrx 1/1 Running 0 167m loki-chunks-cache-0 2/2 Running 0 167m loki-compactor-0 1/1 Running 0 167m loki-distributor-7c9bb8f4dd-bcwc5 1/1 Running 0 167m loki-distributor-7c9bb8f4dd-jh9h8 1/1 Running 0 167m loki-distributor-7c9bb8f4dd-np5dw 1/1 Running 0 167m loki-gateway-77bc447887-qgc56 1/1 Running 0 167m loki-index-gateway-0 1/1 Running 0 167m loki-index-gateway-1 1/1 Running 0 166m loki-ingester-0 1/1 Running 0 167m loki-ingester-1 1/1 Running 0 167m loki-ingester-2 1/1 Running 0 167m loki-minio-0 1/1 Running 0 167m loki-querier-bb8695c6d-bv9x2 1/1 Running 0 167m loki-querier-bb8695c6d-bz2rw 1/1 Running 0 167m loki-querier-bb8695c6d-z9qf8 1/1 Running 0 167m loki-query-frontend-6659566b49-528j5 1/1 Running 0 167m loki-query-frontend-6659566b49-84jtx 1/1 Running 0 167m loki-query-scheduler-f6dc4b949-fknfk 1/1 Running 0 167m loki-query-scheduler-f6dc4b949-h4nwh 1/1 Running 0 167m loki-results-cache-0 2/2 Running 0 167m优雅的 Distributor 关闭在滚动发布或缩容时可设置distributor.shutdownDelay例如90s实现优雅关闭。收到 SIGTERM 后distributor 会在该时长内对/ready返回 503以便负载均衡器在断连前完成排空。请保持distributor.terminationGracePeriodSeconds大于shutdownDelay加上loki.server.graceful_shutdown_timeout默认5sdistributor: shutdownDelay: 90s terminationGracePeriodSeconds: 120通过 Gateway API 暴露服务除了传统的 Kubernetes IngressLoki Helm 图表还支持 Gateway API 路由有两种独立选项。选项 1通过 Gateway API 暴露 nginx gateway——用gateway.route替代gateway.ingress保留 nginx 作为代理但通过 Gateway API 资源暴露gateway: ingress: enabled: false # 关闭传统 Ingress route: main: enabled: true kind: HTTPRoute parentRefs: - name: my-gateway namespace: gateway-namespace hostnames: - loki.example.com选项 2绕过 nginx 直接路由到 Loki 服务——使用顶层route:键与顶层ingress:互斥将 Gateway API 流量直接路由到 Loki 服务。设置deploymentMode: Distributed时图表会自动生成基于路径的规则将请求路由到正确的微服务组件distributor、query-frontend、ruler、compactorgateway: enabled: false route: main: enabled: true kind: HTTPRoute parentRefs: - name: my-gateway namespace: gateway-namespace hostnames: - loki.example.com两种选项下若未设置apiVersion图表会自动探测集群中已安装的最新 Gateway API 版本。支持的路由类型包括HTTPRoute、GRPCRoute、TCPRoute、TLSRoute与UDPRoute。对象存储配置scalable 安装必须使用托管对象存储如 AWS S3、Google Cloud Storage或自托管存储如 MinIOsingle binary 安装可以使用 filesystem但官方仍建议在生产环境通过云厂商或 MinIO 配置对象存储。通用配置步骤详见 Configure storage在values.yaml中设置loki.storage.type为azure、gcs或s3在loki.storage.azure、loki.storage.gcs或loki.storage.s3下配置存储客户端设置loki.storage.bucketNames.chunks与loki.storage.bucketNames.ruler为你的桶名或容器名。安全警告使用 S3 存储部署 Loki 时不要使用默认桶名chunk、ruler、admin请为每个桶选择唯一名称以避免向他人 S3 桶发起意外写入。该警告不适用于 MinIO——使用 MinIO 时推荐使用默认桶名。注意自图表 18.3.0 起singleBinary.persistence.enableStatefulSetAutoDeletePVC默认值为false此前为true即单二进制 StatefulSet 被删除或缩容时 PVC 会被保留而非自动删除。如需恢复旧行为请显式设置singleBinary.persistence.enableStatefulSetAutoDeletePVC: true。S3 存储配置示例loki: schemaConfig: configs: - from: 2024-04-01 store: tsdb object_store: s3 schema: v13 index: prefix: loki_index_ period: 24h storage_config: aws: region: AWS region your bucket is in, for example, eu-west-2 bucketnames: Your AWS bucket for chunk, for example, aws-loki-dev-chunk s3forcepathstyle: false pattern_ingester: enabled: true limits_config: allow_structured_metadata: true volume_enabled: true retention_period: 672h # 28 天保留期 querier: max_concurrent: 4 storage: type: s3 bucketNames: chunks: Your AWS bucket for chunk, for example, aws-loki-dev-chunk ruler: Your AWS bucket for ruler, for example, aws-loki-dev-ruler admin: Your AWS bucket for admin, for example, aws-loki-dev-admin s3: # s3 URL 可用于指定 endpoint、access key、secret key 与桶名 # 适合 S3 兼容存储或本地托管 Loki 时使用。 # 要么使用 s3 URL要么使用下面的各个独立字段AWS endpoint、region、secret。 s3: s3://access_key:secret_access_keycustom_endpoint/bucket_name endpoint: your-endpoint # AWS endpoint URL region: your-region # S3 桶所在的 AWS 区域 secretAccessKey: your-secret-access-key accessKeyId: your-access-key-id signatureVersion: your-signature-version # AWS 签名版本例如 v2 或 v4 s3ForcePathStyle: false # 是否强制 path style insecure: false # 是否允许不安全的 HTTP 连接 http_config: {} # HTTP 配置 # 关闭 minio 存储 minio: enabled: false deploymentMode: Monolithic singleBinary: replicas: 3 persistence: storageClass: gp2 accessModes: - ReadWriteOnce size: 30GiAzure Blob Storage 配置示例loki: schemaConfig: configs: - from: 2024-04-01 store: tsdb object_store: azure schema: v13 index: prefix: loki_index_ period: 24h ingester: chunk_encoding: snappy storage: type: azure azure: accountName: your-account-name # Azure Blob Storage 账户名 accountKey: your-account-key # 账户密钥 connectionString: your-connection-string # 完整连接串可替代 endpoint、accountName、accountKey useManagedIdentity: false # 是否使用 Azure 托管身份 useFederatedToken: false # 是否使用联合令牌 userAssignedId: your-user-assigned-id # 用户分配的托管身份 Client ID requestTimeout: your-request-timeout # 请求超时秒 endpointSuffix: your-endpoint-suffix # 服务端点域名后缀如 core.windows.net bucketNames: chunks: chunks ruler: ruler admin: admin minio: enabled: false deploymentMode: Monolithic singleBinary: replicas: 3 persistence: storageClass: managed-csi accessModes: - ReadWriteOnce size: 30Gi使用 Thanos 对象存储客户端Loki 4.0 默认使用基于 Thanos Object Storage Client 的对象存储客户端旧的 legacy 客户端已弃用。但 Helm 图表是个例外它默认将loki.storage.use_thanos_objstore设为false。要使用基于 Thanos 的客户端需要手动将其设为trueloki: storage: use_thanos_objstore: true bucketNames: chunks: YOUR_CHUNKS_BUCKET ruler: YOUR_RULER_BUCKET object_store: type: s3 # 可选值s3、gcs、azure s3: endpoint: YOUR_ENDPOINT region: YOUR_REGION然后在loki.storage.object_store.s3、loki.storage.object_store.gcs或loki.storage.object_store.azure下配置存储客户端。通过 IAM Role 访问 S3免密钥按存储文档中的 AWS 单存储部署说明创建 IAM role、policy 与 S3 桶在values.yaml中为 ServiceAccount 添加 IAM role 注解serviceAccount: annotations: eks.amazonaws.com/role-arn: arn:aws:iam::account id:role/role name配置存储注意省略endpoint、secretAccessKey与accessKeyIdloki: storage: type: s3 s3: region: eu-central-1 bucketNames: chunks: bucket name ruler: bucket name admin: bucket name # 仅 GEL 安装需要MinIO 子图表弃用说明内置 MinIO 子图表已弃用并将在2026-10-31移除。在图表 v17 中若不设置ignoreMinioDeprecation: true而直接设置minio.enabledtrue图表渲染会失败。上述开发测试示例中的ignoreMinioDeprecation: true仅用于临时测试生产环境应配置独立的外部对象存储后端。监控与告警Loki Helm 图表内置了可选的 Prometheus Operator 监控资源详见 Monitoring默认全部关闭可通过monitoring.*开启monitoring: serviceMonitor: enabled: true rules: enabled: true # 仅录制规则recording rules alerts: enabled: true # 告警规则自图表 18.0.0 起与 rules 分离 dashboards: enabled: true这些资源由上游 loki-mixin 渲染而来ServiceMonitormonitoring.serviceMonitor.enabled为抓取 Loki 指标创建 Prometheus Operator ServiceMonitor 资源Recording rulesmonitoring.rules.enabled创建包含 loki-mixin 录制规则的 PrometheusRule 资源Alert rulesmonitoring.alerts.enabled创建包含LokiRequestErrors、LokiRequestPanics、LokiRequestLatency等告警的 PrometheusRule 资源Dashboardsmonitoring.dashboards.enabled创建包含 Grafana 监控仪表盘的 ConfigMap。自图表 18.0.0 起告警规则由monitoring.alerts管理monitoring.rules现在只控制录制规则标识发布实例的指标标签默认为app_instancemonitoring.appInstanceLabelName。如需将仪表盘以 Grafana Operator 自定义资源方式交付而非 ConfigMap可启用monitoring: dashboards: enabled: true grafanaOperator: enabled: true instanceSelector: matchLabels: dashboards: grafana folder: LokiinstanceSelector是 Grafana Operator 用来匹配 Grafana 自定义资源标签的选择器空选择器默认会匹配所有 Grafana 实例。folder、folderUID与folderRef都是将仪表盘放入 Grafana 的某个文件夹三者只设置其一。注意图表 9.0.0 起移除了原来的monitoring.selfMonitoring/ Grafana Agent 集成。对于集群级综合可观测性官方推荐使用 Kubernetes monitoring Helm 图表k8s-monitoring-helm而不是使用 meta-monitoring 图表来监控 Loki。Helm 图表配置参考Loki Helm 图表暴露了大量配置项reference.md 按顶层配置键分组列出了每个键的类型、描述与默认值主要分组包括顶层键说明backend/read/writeSimpleScalable 模式的三种目标 Pod 配置singleBinaryMonolithic 模式单二进制节点配置distributor/ingester/querier/queryFrontend/queryScheduler微服务模式的读写路径组件compactor/indexGateway压缩与索引网关组件bloomGateway/bloomPlanner/bloomBuilder实验性 Bloom Filter 组件patternIngester模式摄取器overridesExporter租户配置覆盖指标导出器gatewayNGINX 反向代理网关路由读写请求到正确的 Loki 组件ingress/routeIngress 或 Gateway API 路由二选一chunksCache/resultsCache/memcached/memcachedExporter基于 Memcached 的缓存体系monitoringServiceMonitor、录制规则、告警规则与仪表盘lokiLoki 运行配置loki.commonConfig、loki.schemaConfig、loki.limits_config、loki.storage等lokiCanary持续验证 Loki 部署健康的 Canary 应用memberlist基于 gossip 的哈希环服务发现rollout_operatorGrafana Rollout Operator 子图表设置networkPolicy控制 Loki 组件出入站流量的 Kubernetes NetworkPolicyrbac/serviceAccount权限与身份相关配置tableManager已弃用的 table-manager 配置minio已弃用的 MinIO 子图表2026-10-31 移除global/defaults全局与组件级默认值镜像仓库、DNS、环境变量、GOMEMLIMIT/GOGC 注入等该参考文档适用于 Loki Helm 图表 3.0 及以上版本。若使用旧版grafana/loki-stack图表则应参考其对应仓库的values.yaml。云平台部署指南以下指南提供了在云厂商上逐步部署 Loki 的说明见 Cloud Deployment GuidesAmazon EKS 部署Azure AKS 部署Google GKE 部署这些指南演示如何在 AWS、Azure 或 GCP 等云环境中部署最小可行的生产环境建议大规模运行 Loki 时使用。安装后的下一步完成安装后建议继续配置采集 Agent如 Grafana Alloy、Promtail 等向 Loki 发送日志数据参见 send-data 文档使用推荐的 Kubernetes monitoring 图表监控 Loki 部署参见 monitor-and-alert 文档。结语本文围绕 Loki 社区 Helm 图表完整梳理了 Monolithic、Simple Scalable 与 Microservices 三种部署模式的适用场景、values.yaml配置模板与安装命令并深入讲解了对象存储S3 / Azure / Thanos 客户端 / IAM Role、Gateway API 暴露、优雅关闭、监控告警与图表组件体系。核心要点总结如下生产环境优先选择deploymentMode: Distributed微服务模式SimpleScalable将在 Loki 4.0 移除小规模场景使用MonolithicSimpleScalable与Distributed必须配合对象存储使用S3 桶名务必使用唯一名称避免默认桶名带来的安全风险微服务模式默认启用 zone-aware replication需要 rollout-operator 支撑跨可用区滚动内置 MinIO 子图表已弃用2026-10-31 移除新部署请配置独立对象存储后端图表内置的monitoring.*资源默认关闭集群级监控建议使用 Kubernetes monitoring 图表。如需查阅全部配置字段的默认值与类型定义可随时对照仓库内的 Helm chart values 参考 进行定制。【免费下载链接】lokiLike Prometheus, but for logs.项目地址: https://gitcode.com/GitHub_Trending/lok/loki创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Grafana Loki Helm 安装完全指南三种部署模式、存储配置与监控实践【免费下载链接】lokiLike Prometheus, but for logs.项目地址: https://gitcode.com/GitHub_Trending/lok/lokiHelm 图表Chart是在 Kubernetes 集群中配置、安装与升级 Grafana Loki 的标准方式。本文以当前仓库中 docs/sources/setup/install/helm/_index.md 为主线系统讲解 Loki 的 Monolithic单二进制、Simple Scalable简单可扩展与 Microservices微服务三种部署形态并结合 concepts.md 与各安装子页面完整给出可复制的values.yaml示例、对象存储配置、Gateway API 接入与监控告警实践。读完本文你将能够根据业务规模选择正确的部署模式并用 Helm 在 Kubernetes 上交付一套生产可用的 Loki。Helm 图表概述Helm 图表让你可以用声明式的方式在 Kubernetes 集群中配置、安装与升级 Grafana Loki。本文所述内容基于 Loki 社区维护的 Helm 图表Loki Community Helm Chart该图表现已由 Grafana 社区 Champion 在 grafana-community/helm-charts 仓库中维护Loki 图表相关的 issue 与 Pull Request 应提交到该社区仓库。关于图表的核心概念与组件说明可参考 Helm chart components关于所有配置项的完整字段级说明可参考 Helm chart values 参考文档。部署模式选型Loki 被设计为可以以两种主要状态运行详细差异见 Loki 部署模式Monolithic单体模式推荐在将 Loki 作为小型 meta 监控栈的一部分时使用。所有组件运行在单个进程中部署简单适合小规模场景每天数十 GB 以内的日志量。Microservices微服务模式适用于需要高可用与高可扩展性的工作负载。Loki 在 Grafana Labs 内部即以该模式部署。每个组件作为独立进程运行架构最复杂但能力最强适合大规模场景通常每天超过 1 TB 的日志量。此外 Loki 还支持Simple Scalable简单可扩展模式它将运行路径拆分为 read、write、backend 三个目标。但需要注意Simple Scalable DeploymentSSD模式将在 Loki 4.0 中被弃用并移除。为了获得最佳的生产体验官方推荐在生产环境以microservices微服务模式部署 Loki。三种模式在 Helm 图表中通过顶层deploymentMode字段切换默认值为Monolithic。该字段的取值与迁移模式在 reference.md 中有完整定义deploymentMode 取值说明Monolithic单二进制模式单副本即可运行适合小规模安装通常无 HA 需求每天数十 GB 以内SimpleScalableread / write / backend 三目标模式已弃用Loki 4 中移除适合中等规模每天约 1 TB 以内Distributed微服务模式各组件独立运行最复杂但能力最强适合大规模场景通常每天超过 1 TBMonolithic-SimpleScalable用于在两种模式之间迁移的特殊模式SimpleScalable-Distributed用于在两种模式之间迁移的特殊模式注意SimpleScalable与Distributed模式必须使用对象存储filesystem 存储不支持。图表默认安装的组件无论哪种模式图表默认都会安装以下通用组件详见 concepts.mdGateway网关默认启用gateway.enabled: true是一个 NGINX负责暴露 Loki API 并自动将请求代理到正确的 Loki 组件读或写组件使用 filesystem 存储时则代理到单实例。可以通过gateway.ingress需gateway.enabled: true或顶层ingress需gateway.enabled: false暴露 Loki但二者不可同时使用。网关启用后Grafana 与日志采集 Agent如 Grafana Alloy都应配置为使用网关。Loki Canary默认安装lokiCanary.enabled: true用于持续向 Loki 写入并查询日志以验证部署健康状态可通过lokiCanary.enabledfalse关闭。Caching缓存默认部署基于 Memcached 的 chunks cachechunksCache.enabled: true与 results cacheresultsCache.enabled: true。若要使用外部托管的 Memcached可禁用内置缓存并将chunksCache.addresses/resultsCache.addresses指向你的服务。可选组件Pattern ingester模式摄取器用于检测与提取日志模式默认关闭patternIngester.enabled: falsereplicas: 0。在 Distributed 模式下启用独立工作负载deploymentMode: Distributed patternIngester: enabled: true replicas: 1 loki: pattern_ingester: enabled: true在 Monolithic 或 SimpleScalable 模式下只需通过 Loki 配置启用loki: pattern_ingester: enabled: trueOverrides exporter可选组件将每个租户的配置覆盖overrides以 Prometheus 指标形式暴露默认关闭overridesExporter.enabled: false。需要观测租户级 limit 设置时可启用。Bloom filters实验性图表提供三个实验性组件——bloomGateway服务 bloom filter 查询、bloomPlanner规划 bloom filter 构建任务、bloomBuilder构建 bloom filter。三者默认关闭replicas 为 0。启用时需要在 Loki 配置中开启loki.bloom_build.enabled: true、loki.bloom_gateway.enabled: true并为对应组件设置非零副本数。Zone-aware replication可用区感知复制在微服务模式下图表默认启用 ingest 的zone-aware replicationingester.zoneAwareReplication.enabled: true。这会创建三个 ingester StatefulSetzone-a、zone-b、zone-c并要求启用rollout-operator子图表rollout_operator.enabled: true以协调跨可用区的滚动发布。可用区感知复制允许在滚动期间同时关闭并重启单个可用区内的多个 ingester而其余两个可用区保证数据至少有一份副本。在开发或测试环境中可关闭ingester: zoneAwareReplication: enabled: falseMonolithic 模式安装单二进制模式部署对应文档 Install the monolithic Helm chart将 Loki 以单进程方式部署。前置要求Helm 3 及以上、Kubernetes 1.25 及以上、一个可用的 Kubernetes 集群。单副本部署单副本模式适合测试、开发或作为 meta-monitoring 系统。单副本部署会安装Loki1 副本、Loki Canary1 DaemonSet、Loki Gateway1 个 NGINX 副本、Chunks cache1 个 StatefulSet、Results cache1 个 StatefulSet以及可选的 MinIO。创建values.yamlloki: commonConfig: replication_factor: 1 schemaConfig: configs: - from: 2024-04-01 store: tsdb object_store: s3 schema: v13 index: prefix: loki_index_ period: 24h pattern_ingester: enabled: true limits_config: allow_structured_metadata: true volume_enabled: true rulerConfig: enable_api: true ignoreMinioDeprecation: true # 临时方案 —— MinIO 将于 2026-10-31 移除 minio: enabled: true deploymentMode: Monolithic singleBinary: replicas: 1 # 将其他部署模式的副本数清零 backend: replicas: 0 read: replicas: 0 write: replicas: 0 ingester: replicas: 0 querier: replicas: 0 queryFrontend: replicas: 0 queryScheduler: replicas: 0 distributor: replicas: 0 compactor: replicas: 0 indexGateway: replicas: 0 bloomPlanner: replicas: 0 bloomBuilder: replicas: 0 bloomGateway: replicas: 0注意如果只使用 1 个副本必须设置commonConfig.replication_factor: 1否则请求会失败。多副本高可用部署将singleBinary.replicas设置为 2 及以上时图表会以高可用方式部署复制的单二进制运行。多副本部署安装Loki3 副本、Loki Canary1 DaemonSet、Loki Gateway1 个 NGINX 副本、Chunks cache1 个 StatefulSet、Results cache1 个 StatefulSet与可选 MinIO。官方建议高可用至少运行 3 个副本。多副本运行必须配置对象存储。将上述配置中的commonConfig.replication_factor与singleBinary.replicas均改为3即可。这种方式比微服务模式更省成本但运营更简单。执行部署# 1. 添加 Grafana Community 图表仓库 helm repo add grafana-community https://grafana-community.github.io/helm-charts # 2. 更新图表仓库 helm repo update # 3. 安装首次部署 helm install --values values.yaml loki grafana-community/loki -n loki --create-namespace # 4. 升级 helm upgrade --values values.yaml loki grafana-community/loki -n loki # 5. 验证 kubectl get pods -n loki注意自图表迁移到社区仓库后图表编号规则已改变——大版本号更新代表图表发生破坏性变更。另外自社区图表 12.0.0 起SingleBinary更名为Monolithic请显式设置deploymentMode: Monolithic旧值SingleBinary仍被接受但已弃用。Simple Scalable 模式安装简单可扩展模式对应文档 Install the simple scalable Helm chart将执行路径拆分为 read、write、backend 三个目标。该模式必须使用对象存储loki.storage.type必须为s3、gcs、azure或其他受支持的对象存储类型不支持 filesystem。默认副本配置Read3 副本、Write3 副本、Backend3 副本、Loki Canary1 DaemonSet、Gateway1 个 NGINX 副本、Chunks cache1 副本、Results cache1 副本与可选 MinIO。前置要求Kubernetes 集群至少 3 个节点。开发测试用values.yaml使用内置 MinIOloki: schemaConfig: configs: - from: 2024-04-01 store: tsdb object_store: s3 schema: v13 index: prefix: loki_index_ period: 24h ingester: chunk_encoding: snappy querier: # 默认为 4内存和 CPU 充足可调高OOM 时调低 max_concurrent: 4 pattern_ingester: enabled: true limits_config: allow_structured_metadata: true volume_enabled: true deploymentMode: SimpleScalable backend: replicas: 2 read: replicas: 2 write: replicas: 3 # 保证复制后的数据持久性 ignoreMinioDeprecation: true # 临时方案 —— MinIO 将于 2026-10-31 移除 minio: enabled: true gateway: service: type: LoadBalancerMicroservicesDistributed模式安装微服务模式对应文档 Install the microservice Helm chart将 Loki 的各个组件作为独立进程运行。使用deploymentMode: Distributed并配合下文的副本设置时图表会部署以下组件Compactor1 副本压缩并处理已存储的数据Distributor3 副本分发写入请求IndexGateway2 副本处理索引Ingester3 副本启用 zone awareness 时每 zone 1 个处理数据摄取Querier3 副本处理查询QueryFrontend2 副本管理前端查询QueryScheduler2 副本调度查询Gateway1 个 NGINX 副本暴露 Loki API 并代理请求到正确的组件Loki Canary1 DaemonSet验证部署健康Chunks cache1 副本用 memcached 缓存 chunk 数据Results cache1 副本用 memcached 缓存查询结果前置要求Helm 3 及以上、Kubernetes 1.25 及以上、至少 3 个节点的集群因为默认启用了 zone-aware replication。官方不推荐在微服务模式下使用 filesystem 存储下面的示例使用已弃用的内置 MinIO 子图表提供完整自包含示例生产环境应配置独立的外部对象存储后端。开发测试用values.yamlloki: schemaConfig: configs: - from: 2024-04-01 store: tsdb object_store: s3 schema: v13 index: prefix: loki_index_ period: 24h ingester: chunk_encoding: snappy querier: max_concurrent: 4 pattern_ingester: enabled: true limits_config: allow_structured_metadata: true volume_enabled: true deploymentMode: Distributed ingester: replicas: 3 # 结合复制保证数据持久性 zoneAwareReplication: enabled: false querier: replicas: 3 # 通过并行提升查询性能 maxUnavailable: 2 queryFrontend: replicas: 2 maxUnavailable: 1 queryScheduler: replicas: 2 distributor: replicas: 3 maxUnavailable: 2 compactor: replicas: 1 indexGateway: replicas: 2 maxUnavailable: 1 patternIngester: enabled: true replicas: 1 bloomPlanner: replicas: 0 bloomBuilder: replicas: 0 bloomGateway: replicas: 0 backend: replicas: 0 read: replicas: 0 write: replicas: 0 singleBinary: replicas: 0 # 将 Loki gateway 暴露为 LoadBalancer便于外部写入与查询 gateway: service: type: LoadBalancer ignoreMinioDeprecation: true # 临时方案 —— MinIO 将于 2026-10-31 移除 minio: enabled: true安装完成后kubectl get pods -n loki的输出应类似loki-canary-8thrx 1/1 Running 0 167m loki-chunks-cache-0 2/2 Running 0 167m loki-compactor-0 1/1 Running 0 167m loki-distributor-7c9bb8f4dd-bcwc5 1/1 Running 0 167m loki-distributor-7c9bb8f4dd-jh9h8 1/1 Running 0 167m loki-distributor-7c9bb8f4dd-np5dw 1/1 Running 0 167m loki-gateway-77bc447887-qgc56 1/1 Running 0 167m loki-index-gateway-0 1/1 Running 0 167m loki-index-gateway-1 1/1 Running 0 166m loki-ingester-0 1/1 Running 0 167m loki-ingester-1 1/1 Running 0 167m loki-ingester-2 1/1 Running 0 167m loki-minio-0 1/1 Running 0 167m loki-querier-bb8695c6d-bv9x2 1/1 Running 0 167m loki-querier-bb8695c6d-bz2rw 1/1 Running 0 167m loki-querier-bb8695c6d-z9qf8 1/1 Running 0 167m loki-query-frontend-6659566b49-528j5 1/1 Running 0 167m loki-query-frontend-6659566b49-84jtx 1/1 Running 0 167m loki-query-scheduler-f6dc4b949-fknfk 1/1 Running 0 167m loki-query-scheduler-f6dc4b949-h4nwh 1/1 Running 0 167m loki-results-cache-0 2/2 Running 0 167m优雅的 Distributor 关闭在滚动发布或缩容时可设置distributor.shutdownDelay例如90s实现优雅关闭。收到 SIGTERM 后distributor 会在该时长内对/ready返回 503以便负载均衡器在断连前完成排空。请保持distributor.terminationGracePeriodSeconds大于shutdownDelay加上loki.server.graceful_shutdown_timeout默认5sdistributor: shutdownDelay: 90s terminationGracePeriodSeconds: 120通过 Gateway API 暴露服务除了传统的 Kubernetes IngressLoki Helm 图表还支持 Gateway API 路由有两种独立选项。选项 1通过 Gateway API 暴露 nginx gateway——用gateway.route替代gateway.ingress保留 nginx 作为代理但通过 Gateway API 资源暴露gateway: ingress: enabled: false # 关闭传统 Ingress route: main: enabled: true kind: HTTPRoute parentRefs: - name: my-gateway namespace: gateway-namespace hostnames: - loki.example.com选项 2绕过 nginx 直接路由到 Loki 服务——使用顶层route:键与顶层ingress:互斥将 Gateway API 流量直接路由到 Loki 服务。设置deploymentMode: Distributed时图表会自动生成基于路径的规则将请求路由到正确的微服务组件distributor、query-frontend、ruler、compactorgateway: enabled: false route: main: enabled: true kind: HTTPRoute parentRefs: - name: my-gateway namespace: gateway-namespace hostnames: - loki.example.com两种选项下若未设置apiVersion图表会自动探测集群中已安装的最新 Gateway API 版本。支持的路由类型包括HTTPRoute、GRPCRoute、TCPRoute、TLSRoute与UDPRoute。对象存储配置scalable 安装必须使用托管对象存储如 AWS S3、Google Cloud Storage或自托管存储如 MinIOsingle binary 安装可以使用 filesystem但官方仍建议在生产环境通过云厂商或 MinIO 配置对象存储。通用配置步骤详见 Configure storage在values.yaml中设置loki.storage.type为azure、gcs或s3在loki.storage.azure、loki.storage.gcs或loki.storage.s3下配置存储客户端设置loki.storage.bucketNames.chunks与loki.storage.bucketNames.ruler为你的桶名或容器名。安全警告使用 S3 存储部署 Loki 时不要使用默认桶名chunk、ruler、admin请为每个桶选择唯一名称以避免向他人 S3 桶发起意外写入。该警告不适用于 MinIO——使用 MinIO 时推荐使用默认桶名。注意自图表 18.3.0 起singleBinary.persistence.enableStatefulSetAutoDeletePVC默认值为false此前为true即单二进制 StatefulSet 被删除或缩容时 PVC 会被保留而非自动删除。如需恢复旧行为请显式设置singleBinary.persistence.enableStatefulSetAutoDeletePVC: true。S3 存储配置示例loki: schemaConfig: configs: - from: 2024-04-01 store: tsdb object_store: s3 schema: v13 index: prefix: loki_index_ period: 24h storage_config: aws: region: AWS region your bucket is in, for example, eu-west-2 bucketnames: Your AWS bucket for chunk, for example, aws-loki-dev-chunk s3forcepathstyle: false pattern_ingester: enabled: true limits_config: allow_structured_metadata: true volume_enabled: true retention_period: 672h # 28 天保留期 querier: max_concurrent: 4 storage: type: s3 bucketNames: chunks: Your AWS bucket for chunk, for example, aws-loki-dev-chunk ruler: Your AWS bucket for ruler, for example, aws-loki-dev-ruler admin: Your AWS bucket for admin, for example, aws-loki-dev-admin s3: # s3 URL 可用于指定 endpoint、access key、secret key 与桶名 # 适合 S3 兼容存储或本地托管 Loki 时使用。 # 要么使用 s3 URL要么使用下面的各个独立字段AWS endpoint、region、secret。 s3: s3://access_key:secret_access_keycustom_endpoint/bucket_name endpoint: your-endpoint # AWS endpoint URL region: your-region # S3 桶所在的 AWS 区域 secretAccessKey: your-secret-access-key accessKeyId: your-access-key-id signatureVersion: your-signature-version # AWS 签名版本例如 v2 或 v4 s3ForcePathStyle: false # 是否强制 path style insecure: false # 是否允许不安全的 HTTP 连接 http_config: {} # HTTP 配置 # 关闭 minio 存储 minio: enabled: false deploymentMode: Monolithic singleBinary: replicas: 3 persistence: storageClass: gp2 accessModes: - ReadWriteOnce size: 30GiAzure Blob Storage 配置示例loki: schemaConfig: configs: - from: 2024-04-01 store: tsdb object_store: azure schema: v13 index: prefix: loki_index_ period: 24h ingester: chunk_encoding: snappy storage: type: azure azure: accountName: your-account-name # Azure Blob Storage 账户名 accountKey: your-account-key # 账户密钥 connectionString: your-connection-string # 完整连接串可替代 endpoint、accountName、accountKey useManagedIdentity: false # 是否使用 Azure 托管身份 useFederatedToken: false # 是否使用联合令牌 userAssignedId: your-user-assigned-id # 用户分配的托管身份 Client ID requestTimeout: your-request-timeout # 请求超时秒 endpointSuffix: your-endpoint-suffix # 服务端点域名后缀如 core.windows.net bucketNames: chunks: chunks ruler: ruler admin: admin minio: enabled: false deploymentMode: Monolithic singleBinary: replicas: 3 persistence: storageClass: managed-csi accessModes: - ReadWriteOnce size: 30Gi使用 Thanos 对象存储客户端Loki 4.0 默认使用基于 Thanos Object Storage Client 的对象存储客户端旧的 legacy 客户端已弃用。但 Helm 图表是个例外它默认将loki.storage.use_thanos_objstore设为false。要使用基于 Thanos 的客户端需要手动将其设为trueloki: storage: use_thanos_objstore: true bucketNames: chunks: YOUR_CHUNKS_BUCKET ruler: YOUR_RULER_BUCKET object_store: type: s3 # 可选值s3、gcs、azure s3: endpoint: YOUR_ENDPOINT region: YOUR_REGION然后在loki.storage.object_store.s3、loki.storage.object_store.gcs或loki.storage.object_store.azure下配置存储客户端。通过 IAM Role 访问 S3免密钥按存储文档中的 AWS 单存储部署说明创建 IAM role、policy 与 S3 桶在values.yaml中为 ServiceAccount 添加 IAM role 注解serviceAccount: annotations: eks.amazonaws.com/role-arn: arn:aws:iam::account id:role/role name配置存储注意省略endpoint、secretAccessKey与accessKeyIdloki: storage: type: s3 s3: region: eu-central-1 bucketNames: chunks: bucket name ruler: bucket name admin: bucket name # 仅 GEL 安装需要MinIO 子图表弃用说明内置 MinIO 子图表已弃用并将在2026-10-31移除。在图表 v17 中若不设置ignoreMinioDeprecation: true而直接设置minio.enabledtrue图表渲染会失败。上述开发测试示例中的ignoreMinioDeprecation: true仅用于临时测试生产环境应配置独立的外部对象存储后端。监控与告警Loki Helm 图表内置了可选的 Prometheus Operator 监控资源详见 Monitoring默认全部关闭可通过monitoring.*开启monitoring: serviceMonitor: enabled: true rules: enabled: true # 仅录制规则recording rules alerts: enabled: true # 告警规则自图表 18.0.0 起与 rules 分离 dashboards: enabled: true这些资源由上游 loki-mixin 渲染而来ServiceMonitormonitoring.serviceMonitor.enabled为抓取 Loki 指标创建 Prometheus Operator ServiceMonitor 资源Recording rulesmonitoring.rules.enabled创建包含 loki-mixin 录制规则的 PrometheusRule 资源Alert rulesmonitoring.alerts.enabled创建包含LokiRequestErrors、LokiRequestPanics、LokiRequestLatency等告警的 PrometheusRule 资源Dashboardsmonitoring.dashboards.enabled创建包含 Grafana 监控仪表盘的 ConfigMap。自图表 18.0.0 起告警规则由monitoring.alerts管理monitoring.rules现在只控制录制规则标识发布实例的指标标签默认为app_instancemonitoring.appInstanceLabelName。如需将仪表盘以 Grafana Operator 自定义资源方式交付而非 ConfigMap可启用monitoring: dashboards: enabled: true grafanaOperator: enabled: true instanceSelector: matchLabels: dashboards: grafana folder: LokiinstanceSelector是 Grafana Operator 用来匹配 Grafana 自定义资源标签的选择器空选择器默认会匹配所有 Grafana 实例。folder、folderUID与folderRef都是将仪表盘放入 Grafana 的某个文件夹三者只设置其一。注意图表 9.0.0 起移除了原来的monitoring.selfMonitoring/ Grafana Agent 集成。对于集群级综合可观测性官方推荐使用 Kubernetes monitoring Helm 图表k8s-monitoring-helm而不是使用 meta-monitoring 图表来监控 Loki。Helm 图表配置参考Loki Helm 图表暴露了大量配置项reference.md 按顶层配置键分组列出了每个键的类型、描述与默认值主要分组包括顶层键说明backend/read/writeSimpleScalable 模式的三种目标 Pod 配置singleBinaryMonolithic 模式单二进制节点配置distributor/ingester/querier/queryFrontend/queryScheduler微服务模式的读写路径组件compactor/indexGateway压缩与索引网关组件bloomGateway/bloomPlanner/bloomBuilder实验性 Bloom Filter 组件patternIngester模式摄取器overridesExporter租户配置覆盖指标导出器gatewayNGINX 反向代理网关路由读写请求到正确的 Loki 组件ingress/routeIngress 或 Gateway API 路由二选一chunksCache/resultsCache/memcached/memcachedExporter基于 Memcached 的缓存体系monitoringServiceMonitor、录制规则、告警规则与仪表盘lokiLoki 运行配置loki.commonConfig、loki.schemaConfig、loki.limits_config、loki.storage等lokiCanary持续验证 Loki 部署健康的 Canary 应用memberlist基于 gossip 的哈希环服务发现rollout_operatorGrafana Rollout Operator 子图表设置networkPolicy控制 Loki 组件出入站流量的 Kubernetes NetworkPolicyrbac/serviceAccount权限与身份相关配置tableManager已弃用的 table-manager 配置minio已弃用的 MinIO 子图表2026-10-31 移除global/defaults全局与组件级默认值镜像仓库、DNS、环境变量、GOMEMLIMIT/GOGC 注入等该参考文档适用于 Loki Helm 图表 3.0 及以上版本。若使用旧版grafana/loki-stack图表则应参考其对应仓库的values.yaml。云平台部署指南以下指南提供了在云厂商上逐步部署 Loki 的说明见 Cloud Deployment GuidesAmazon EKS 部署Azure AKS 部署Google GKE 部署这些指南演示如何在 AWS、Azure 或 GCP 等云环境中部署最小可行的生产环境建议大规模运行 Loki 时使用。安装后的下一步完成安装后建议继续配置采集 Agent如 Grafana Alloy、Promtail 等向 Loki 发送日志数据参见 send-data 文档使用推荐的 Kubernetes monitoring 图表监控 Loki 部署参见 monitor-and-alert 文档。结语本文围绕 Loki 社区 Helm 图表完整梳理了 Monolithic、Simple Scalable 与 Microservices 三种部署模式的适用场景、values.yaml配置模板与安装命令并深入讲解了对象存储S3 / Azure / Thanos 客户端 / IAM Role、Gateway API 暴露、优雅关闭、监控告警与图表组件体系。核心要点总结如下生产环境优先选择deploymentMode: Distributed微服务模式SimpleScalable将在 Loki 4.0 移除小规模场景使用MonolithicSimpleScalable与Distributed必须配合对象存储使用S3 桶名务必使用唯一名称避免默认桶名带来的安全风险微服务模式默认启用 zone-aware replication需要 rollout-operator 支撑跨可用区滚动内置 MinIO 子图表已弃用2026-10-31 移除新部署请配置独立对象存储后端图表内置的monitoring.*资源默认关闭集群级监控建议使用 Kubernetes monitoring 图表。如需查阅全部配置字段的默认值与类型定义可随时对照仓库内的 Helm chart values 参考 进行定制。【免费下载链接】lokiLike Prometheus, but for logs.项目地址: https://gitcode.com/GitHub_Trending/lok/loki创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
