使用 Loki Overrides Exporter 监控租户限额:将多租户 Limits 暴露为 Prometheus 指标

发布时间:2026/9/12 8:45:12

使用 Loki Overrides Exporter 监控租户限额:将多租户 Limits 暴露为 Prometheus 指标 使用 Loki Overrides Exporter 监控租户限额将多租户 Limits 暴露为 Prometheus 指标【免费下载链接】lokiLike Prometheus, but for logs.项目地址: https://gitcode.com/GitHub_Trending/lok/lokiLoki 是一个支持多租户multi-tenant的日志系统通过为每个租户tenant施加资源限额limits来实现资源管理与隔离。overrides-exporter是 Loki 内置的一个模块它把这些租户限额以 Prometheus 指标loki_overrides、loki_overrides_defaults的形式暴露出来帮助运维人员直观掌握每个租户的配额配置与使用余量。读完本文你将掌握如何启用该模块、解读其指标含义并基于这些指标建立限额预警机制。Context为什么需要暴露租户限额Loki 的租户限额limits可以通过runtime_config特性在不重启 Loki 的情况下动态更新这对于在线调整租户配额非常方便。但动态配置也带来了新的运维挑战限额分散在配置文件中缺少一个统一的观测视角——哪些租户被设置了哪些覆盖项覆盖值与默认值相差多少哪些租户已经逼近限额上限overrides-exporter正是为解决这个问题而设计它把每个租户的限额覆盖项以及全局限额默认值转换成 Prometheus gauge 指标使运维人员可以通过 Prometheus 查询、可视化并在限额被突破之前收到告警。overrides-exporter 模块是什么从源码角度看overrides-exporter是 Loki 的一个独立 target模块定义于 pkg/loki/modules.goOverridesExporter overrides-exporter它的核心实现位于 pkg/validation/exporter.go其中定义了OverridesExporter结构与两个指标描述符loki_overrides标签为limit_name、user语义为 Resource limit overrides applied to tenants即每个租户实际被覆盖的限额项loki_overrides_defaults标签为limit_name语义为 Default values for resource limit overrides applied to tenants即加载 Loki 配置后各限额字段的默认值。模块初始化与前置条件在 pkg/loki/modules.go 的initOverridesExporter中可以看到启用该模块的关键逻辑func (t *Loki) initOverridesExporter() (services.Service, error) { if t.Cfg.isTarget(OverridesExporter) t.TenantLimits nil || t.Overrides nil { return nil, errors.New(overrides-exporter has been enabled, but no runtime configuration file was configured) } exporter : validation.NewOverridesExporter(t.Overrides) prometheus.MustRegister(exporter) // The overrides-exporter has no state and reads overrides for runtime configuration each time it // is collected so there is no need to return any service. return nil, nil }这里有几点值得注意该 target 默认不启用它不属于默认的 all target 集合需要显式指定-targetoverrides-exporter必须配置运行时配置文件如果启用该模块却没有配置runtime-config.file启动会直接报错 overrides-exporter has been enabled, but no runtime configuration file was configured无状态设计exporter 不维护任何运行状态每次被 Prometheus 抓取collect时都会实时读取 runtime configuration 中的最新覆盖值因此配置热更新后无需重启或重载 exporterexporter 通过prometheus.MustRegister注册到全局注册表随 Loki 的/metrics端点一同暴露。指标生成原理基于反射的字段遍历OverridesExporter的Collect方法见 pkg/validation/exporter.go是整个模块的“心脏”其实现思路如下使用 Go 的reflect包反射遍历Limits结构体的所有字段通过extract辅助函数将字段值统一转换为float64int、time.Duration、model.Duration、uint、flagext.ByteSize、float64直接转换bool转换为0.0/1.0其余无法转换的字段类型如字符串、切片则跳过指标标签名取自字段的yamltag即配置文件中对应的字段名例如ingestion_rate_mb、max_streams_per_user默认值指标遍历所有字段因此loki_overrides_defaults的序列数量等于Limits结构中全部标量字段的数量租户覆盖指标则遍历AllByUserID()返回的每个租户的限额并且仅当该字段与默认值不同时才输出见if !ok || rv.Field(i).Interface() defs.Field(i).Interface()的判断从而保证loki_overrides只包含“真正被覆盖”的项控制指标基数。测试用例佐证pkg/validation/exporter_test.go 中有两个直接相关的测试TestOverridesExporter_noConfig没有任何租户覆盖时loki_overrides指标数量为 0而loki_overrides_defaults数量大于 0TestOverridesExporter_withConfig为tenant-a设置MaxQueriersPerTenant: 5和BloomCreationEnabled: true两个覆盖项后loki_overrides指标数量恰为 2。这两个用例验证了“只为差异字段输出覆盖指标”与“默认值全量输出”的核心行为。启用与启动示例overrides-exporter模块默认关闭。官方建议每个集群只运行单个实例以避免指标基数cardinality问题——因为每个租户的每个差异字段都会产生一条独立的时序序列。以一个runtime.yaml为例overrides: tenant_1: ingestion_rate_mb: 10 max_streams_per_user: 100000 max_chunks_per_query: 100000启动一个overrides-exporter实例loki -targetoverrides-exporter -runtime-config.fileruntime.yaml -config.filebasic_schema_config.yaml -server.http-listen-port8080参数说明参数作用-targetoverrides-exporter以 overrides-exporter 模式运行仅启动该模块及其依赖-runtime-config.fileruntime.yaml指定运行时配置文件路径租户覆盖项从此文件加载支持热更新-config.filebasic_schema_config.yaml指定 Loki 主配置文件路径其中包含limits_config等基础配置用于确定默认值-server.http-listen-port8080指定 HTTP 监听端口用于暴露/metrics注意runtime-config.file是启用该模块的硬性前置条件如initOverridesExporter中的错误分支所示config.file中的limits_config则决定了loki_overrides_defaults的默认值来源。查看租户限额覆盖指标启动后通过 curl 抓取指标并过滤override关键字$ curl -sq localhost:8080/metrics | grep override # HELP loki_overrides Resource limit overrides applied to tenants # TYPE loki_overrides gauge loki_overrides{limit_nameingestion_rate_mb,usertenant_1} 10 loki_overrides{limit_namemax_chunks_per_query,usertenant_1} 100000 loki_overrides{limit_namemax_streams_per_user,usertenant_1} 100000 # HELP loki_overrides_defaults Default values for resource limit overrides applied to tenants # TYPE loki_overrides_defaults gauge loki_overrides_defaults{limit_nameblock_ingestion_status_code} 260 loki_overrides_defaults{limit_namecardinality_limit} 100000 loki_overrides_defaults{limit_namecreation_grace_period} 6e11 loki_overrides_defaults{limit_nameingestion_burst_size_mb} 6 loki_overrides_defaults{limit_nameingestion_rate_mb} 4 loki_overrides_defaults{limit_namemax_cache_freshness_per_query} 6e11 loki_overrides_defaults{limit_namemax_chunks_per_query} 2e06 loki_overrides_defaults{limit_namemax_concurrent_tail_requests} 10 loki_overrides_defaults{limit_namemax_entries_limit_per_query} 5000 loki_overrides_defaults{limit_namemax_global_streams_per_user} 5000 loki_overrides_defaults{limit_namemax_label_name_length} 1024 loki_overrides_defaults{limit_namemax_label_names_per_series} 15 loki_overrides_defaults{limit_namemax_label_value_length} 2048 loki_overrides_defaults{limit_namemax_line_size} 262144 loki_overrides_defaults{limit_namemax_metadata_cache_freshness} 8.64e13 loki_overrides_defaults{limit_namemax_queriers_per_tenant} 0 loki_overrides_defaults{limit_namemax_query_capacity} 0 loki_overrides_defaults{limit_namemax_query_length} 2.5956e15 loki_overrides_defaults{limit_namemax_query_lookback} 0 loki_overrides_defaults{limit_namemax_query_parallelism} 32 loki_overrides_defaults{limit_namemax_query_series} 500 loki_overrides_defaults{limit_namemax_streams_matchers_per_query} 1000 loki_overrides_defaults{limit_namemax_streams_per_user} 0 loki_overrides_defaults{limit_namemax_structured_metadata_size} 65536 loki_overrides_defaults{limit_namemin_sharding_lookback} 0 loki_overrides_defaults{limit_nameper_stream_rate_limit} 3.145728e06 loki_overrides_defaults{limit_nameper_stream_rate_limit_burst} 1.572864e07 loki_overrides_defaults{limit_nameper_tenant_override_period} 1e10 loki_overrides_defaults{limit_namequery_timeout} 6e10 loki_overrides_defaults{limit_namereject_old_samples_max_age} 6.048e14 loki_overrides_defaults{limit_nameretention_period} 0 loki_overrides_defaults{limit_nameruler_max_rule_groups_per_tenant} 0 loki_overrides_defaults{limit_nameruler_max_rules_per_rule_group} 0 loki_overrides_defaults{limit_nameruler_remote_write_queue_batch_send_deadline} 0 loki_overrides_defaults{limit_nameruler_remote_write_queue_capacity} 0 loki_overrides_defaults{limit_nameruler_remote_write_queue_max_backoff} 0 loki_overrides_defaults{limit_nameruler_remote_write_queue_max_samples_per_send} 0 loki_overrides_defaults{limit_nameruler_remote_write_queue_max_shards} 0 loki_overrides_defaults{limit_nameruler_remote_write_queue_min_backoff} 0 loki_overrides_defaults{limit_nameruler_remote_write_queue_min_shards} 0 loki_overrides_defaults{limit_nameruler_remote_write_timeout} 0 loki_overrides_defaults{limit_namesplit_queries_by_interval} 3.6e12 loki_overrides_defaults{limit_nametsdb_max_bytes_per_shard} 6.291456e08 loki_overrides_defaults{limit_nametsdb_max_query_parallelism} 128 loki_overrides_defaults{limit_namevolume_enabled} 1 loki_overrides_defaults{limit_namevolume_max_series} 1000输出解读loki_overrides的每条序列都带user标签如tenant_1表示该租户显式覆盖了某个限额字段且只输出与默认值不同的字段——这与Collect方法中的差异比较逻辑一致loki_overrides_defaults不区分租户为全局限额默认值指标数量等于Limits结构中所有标量字段的总数数值单位遵循对应配置字段的定义时长类字段如creation_grace_period、query_timeout以纳秒计如6e11纳秒即 10 分钟字节类字段如max_line_size以字节计速率类字段如ingestion_rate_mb以 MB/s 计布尔类字段映射为 0/1如volume_enabled。注意以上输出仅为部分示例。loki_overrides_defaults的指标集合取决于你的 Loki 版本——limits_config配置块会随每个版本发布而不断扩充字段因此指标序列也会随之增加。请以你自己的实例/metrics端点返回的实际列表为准不要依赖固定示例。基于指标建立限额告警overrides-exporter的最终价值在于告警。基于这些 gauge 指标可以建立 Prometheus 告警规则当租户接近其限额上限时通知运维人员从而在限额被突破之前及时扩容或调高配额。一个典型的告警思路是将loki_overrides或默认值中的限额项与实际的租户用量指标做比值例如对max_streams_per_user与当前租户流数量做对比当使用率超过阈值如 80%时触发告警groups: - name: loki-tenant-limits rules: - alert: TenantCloseToStreamLimit expr: | loki_overrides{limit_namemax_streams_per_user} / 100 0.8 or (loki_overrides_defaults{limit_namemax_streams_per_user} 0 and on() loki_overrides{limit_namemax_streams_per_user} 0) 0 for: 15m labels: severity: warning annotations: summary: Tenant {{ $labels.user }} is close to its stream limit实际告警表达式的编写需要结合你所在集群暴露的租户用量指标如 ingester 上报的 per-tenant 流数量一起设计这里仅示意数据来源与思路。运维注意事项与最佳实践单实例运行官方明确建议每个集群只运行一个overrides-exporter实例多个实例会重复暴露相同的指标放大基数与存储成本指标基数控制loki_overrides的序列数 租户数 × 每个租户被覆盖的差异字段数。字段覆盖得越细、租户越多基数越大因此应避免为大量租户无意义地覆盖大量字段必须配置 runtime config该模块依赖runtime-config.file提供租户覆盖数据未配置时无法启动参见 pkg/loki/modules.go 的报错逻辑实时反映配置变更由于Collect每次抓取时实时读取运行时配置源码注释明确 reads overrides for runtime configuration each time it is collected通过runtime_config热更新的限额会立即反映在指标中无需重启无独立运行状态该模块不是常驻服务initOverridesExporter返回nilservice它只是向 Loki 的 Prometheus 注册表注册了一个 collector因此以-targetoverrides-exporter启动的进程实际上是一个轻量级指标导出器。参考与延伸阅读本文档原文docs/sources/operations/overrides-exporter.md模块注册与初始化逻辑pkg/loki/modules.go指标导出核心实现反射遍历、默认值比较pkg/validation/exporter.go导出行为测试用例pkg/validation/exporter_test.go租户限额定义与Overrides结构pkg/validation/limits.go运行时配置runtime_config说明docs/sources/configure/_index.md【免费下载链接】lokiLike Prometheus, but for logs.项目地址: https://gitcode.com/GitHub_Trending/lok/loki创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
延伸阅读

更多相关文章

2026/9/12 8:45:12

医疗实体识别与知识图谱驱动的智能医生推荐系统实践

简介:一套融合领域知识图谱与医疗实体识别的医生推荐系统完整工程文件,面向自然语言处理、知识图谱方向的学习者与医疗信息化开发者,解决医疗实体识别、知识抽取及智能问答落地问题。资源采用BERTCRFBiLSTM实现医疗实体识别,并构建…

2026/9/12 8:40:12

AI Agent全栈开发指南:从基础原理到生产级项目实战

1. 先弄清楚 AI Agent 到底在解决什么问题去年这个时候,还有人在群里问 AI Agent 是不是又一个概念泡沫。到了 2026 年,这个问题基本没人问了——招聘平台上挂着「agent 开发」字样的岗位翻了不止一倍,面试里开始出现「你怎么设计一个多智能体…

2026/9/12 9:40:20

配套C++代码实现(完全符合GESP四级考纲,零基础友好)

所有代码都只用四级要求的基础语法(数组、循环、cin/cout),没有任何超纲内容,注释全是大白话,孩子照着敲就能直接运行出正确结果。 1. 编程题1:3行3列矩阵主对角线求和 #include using namespace std;in…

2026/9/12 9:40:20

TensorRT-LLM Qwen3 三步提速实测

TensorRT-LLM Qwen3 三步提速实测 【免费下载链接】TensorRT-LLM TensorRT LLM provides users with an easy-to-use Python API to define Large Language Models (LLMs) and supports state-of-the-art optimizations to perform inference efficiently on NVIDIA GPUs. Tens…

2026/9/12 9:40:19

SpringBoot+Vue智能健康管理系统设计与实现

1. 项目概述:企业级智能推荐卫生健康系统这个基于SpringBootVueMyBatis的卫生健康管理系统,本质上是一个融合了医疗健康数据管理与智能推荐算法的综合平台。我在实际医疗信息化项目实施中发现,传统健康管理系统最大的痛点在于:它们…

2026/9/12 9:35:19

PICO XR渲染报错renderPassIndex越界解决方案

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/9/12 2:05:33

超人会飞不算本事:系统稳定依赖清晰规则与边界设计

开头先不绕弯子。“#斯坦李吐槽dc 所以超人是无缘无故会飞的嘛哈哈哈哈哈哈哈锤哥真是技术人才啊!#雷神 #复联”这类调侃式短标题,第一波冲击力在于它把两个宇宙的角色塞进同一个吐槽箱里,但细想一下就能发现,它真正碰到的根本不是…

2026/9/12 3:55:12

超人VS蜘蛛侠:拆解超级IP的影响力与传播方法论

把“蜘蛛侠 vs 超人”放在 CSDN 上聊,可能很多人第一反应是走错片场了。但如果把这两个角色看成“两个持续运营了 80 多年的文化产品”,你会发现,这场比较本质上是两个不同 IP 策略的长期结果对比:超人赢在定义了整个超级英雄题材…

2026/9/9 16:31:09

基于CNN的调制信号识别:MATLAB实现时频图分类实战

简介:本资源是一套面向通信工程与信号处理方向学习者、研究者的深度学习实践方案,聚焦调制信号自动检测与识别这一典型无线通信任务,解决传统方法依赖人工特征、低信噪比下性能下降等痛点。压缩包共12个文件(10.73MB)&…

2026/9/12 0:04:17

MATLAB仿生优化框架:长鼻浣熊算法多策略融合实现

简介:本资源是一份面向智能优化算法研究者与MATLAB初学者的仿生智能算法实践代码包,聚焦于长鼻浣熊优化算法(COA)的多策略改进与性能验证。针对传统COA易陷局部最优、收敛精度不足等问题,作者融合Circle映射初始化提升…

2026/9/12 0:04:17

【JAVA毕设源码分享】基于 JavaWeb 的校园一卡通管理系统的设计与实现 基于 JavaWeb 的校园卡业务管理系统(程序+文档+代码讲解+一条龙定制)

博主介绍:✌️码农一枚 ,专注于大学生项目实战开发、讲解和毕业🚢文撰写修改等。全栈领域优质创作者,博客之星、掘金/华为云/阿里云/InfoQ等平台优质作者、专注于Java、小程序技术领域和毕业项目实战 ✌️技术范围:&am…

2026/9/12 0:04:17

【JAVA毕设源码分享】基于 Java 的图书馆借阅管理平台的搭建与实现 基于 Java 的图书馆综合管理系统(程序+文档+代码讲解+一条龙定制)

博主介绍:✌️码农一枚 ,专注于大学生项目实战开发、讲解和毕业🚢文撰写修改等。全栈领域优质创作者,博客之星、掘金/华为云/阿里云/InfoQ等平台优质作者、专注于Java、小程序技术领域和毕业项目实战 ✌️技术范围:&am…

2026/9/12 6:29:36

USB Type-C PCB布局分区设计:电源、高速信号与PD协议全攻略

做硬件这行,Type-C接口算是典型的“看着简单,做起来全坑”的东西。光引脚就24个,高低速信号、电源、控制线全部塞在一个小小的连接器里,如果PCB布局不做规划,打样回来基本就是“插上没反应”、“高速掉线”、“静电一打…

2026/9/10 15:19:50

系统编程学习原型如何补齐稳定性边界

系统编程学习原型如何补齐稳定性边界预算有限时&#xff0c;我先优化明显多余的复制&#xff0c;而不是猜测性地换容器。用借用传递只读数据通常就能减少分配&#xff1a; fn parse(line: &str) -> Result<Item, Error> { /* ... */ }用基准确认热点确实在分配&am…

2026/9/12 6:37:43

雨花区哪家财务公司代理记账比较好?

在雨花区&#xff0c;企业处理财税事务常常面临诸多挑战&#xff0c;选择一家靠谱的财务公司至关重要。湖南巨勤财务管理咨询有限公司就是本地正规实体财税服务机构&#xff0c;深耕本地工商财税行业多年&#xff0c;熟悉当地工商局、税务局最新政策与申报流程。主营公司注册、…

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
咨询二维码