Loki 2.3 版本特性深度解析流级保留策略、日志删除、Pattern 解析器与 LogQL IP 过滤【免费下载链接】lokiLike Prometheus, but for logs.项目地址: https://gitcode.com/GitHub_Trending/lok/lokiLoki 2.3 是 Grafana Loki 在 AGPLv3 许可下发布的首个版本也是 2.2 之后时隔约 6 个月的一次大版本更新。本篇文章以 v2-3 发布说明 为骨架结合当前仓库源码系统梳理 2.3 引入的流级自定义保留、日志流删除、Pattern 解析器、Recording Rules、LogQL IP 过滤、Index Gateway 等关键能力并给出升级到 2.3 时必须了解的行为变更与安全修复细节。读完本文你将掌握 2.3 各核心特性的原理、用法与升级注意事项可以直接在真实环境中规划采用。2.3 版本总览Loki 2.3 是 2.2 发布后近 6 个月工作的集中落地其改进方向非常明确数据生命周期管理不再依赖对象存储配置来控制日志保留时间而是由 Loki 自身基于 stream selector 提供更精细的自定义保留策略数据治理支持提交日志删除请求初步实现对已写入日志流的删除查询性能引入全新的 Pattern 解析器当前 Loki 最快的解析器、支持 IP 地址过滤、ingester querier 可分片、Instant 查询可拆分与分片指标能力支持 Recording Rules把日志转换为指标并写入 Prometheus 或任意兼容 remote_write 的端点运维易用性新增 Index Gateway让 querier 摆脱本地磁盘依赖。此外2.3 也是 Loki 在AGPLv3 许可下发布的第一个版本。仓库中部分内容主要是 clients 和部分工具仍保持 Apache-2.0 许可详细划分见 LICENSING.mdApache-2.0 部分的许可声明见 clients/LICENSE_APACHE2。流级自定义保留Custom Retention2.3 之前日志保留retention主要通过对象存储的 bucket 生命周期配置完成粒度粗、且不受 Loki 控制。2.3 之后Loki 自身可以根据stream selector对不同的日志流应用不同的保留时长实现细粒度保留控制。其核心用法是在 runtime config 中为某个租户定义retention_streamoverrides: fake: retention_stream: - selector: {namespaceprod} priority: 1 period: 24h - selector: {namespacedev} priority: 2 period: 720hselector一条 LogQL 流选择器匹配需要应用该保留策略的日志流priority当一条流同时命中多条规则时按 priority 决定采用哪条数字越小优先级越高具体以文档为准period该流允许保留的时长超过后由 compactor 在压缩过程中删除。该能力与 compactor 的保留删除机制协同工作相关实现集中在 pkg/compactor/retention 目录下compactor 会在表table处理阶段按 selector 匹配并裁剪过期块。与整体保留策略叠加使用时流级保留提供了更细的控制手段例如为高频噪声流设置短保留为审计类流设置长保留而无需为每个流单独配置对象存储生命周期。日志流删除Log Deletion与存得更久配套的是删得掉。2.3 引入了日志删除的初始实现用户可以提交删除请求任务Loki 会在请求提交24 小时后开始处理。删除请求通过 HTTP API 提交例如curl -X POST \ -H Content-Type: application/json \ -H X-Scope-OrgID: fake \ http://localhost:3100/loki/api/v1/delete?start1624000000000000000end1625000000000000000 \ -d {query:{namespace\dev\} |~ \error\}要点query使用 LogQL 流选择器可叠加过滤表达式指定要删除的日志start/end为纳秒时间戳划定删除的时间范围删除请求会在 24 小时后由 compactor 的删除处理机制真正执行pkg/compactor/deletion 目录承载了请求存储与执行逻辑如需确认删除请求状态可查询/loki/api/v1/delete接口。删除能力与保留策略共同构成 2.3 的完整数据治理方案保留决定默认能存多久删除决定主动清掉哪些。更完整的 API 与限制说明见 logs-deletion.md。Pattern 解析器Loki 最快的解析器2.3 引入了一个全新的 LogQL 解析器——Pattern 解析器用于处理有一定结构的日志行例如 Common Log FormatCLF这类访问日志。相比正则表达式Pattern 解析器语法更简单、执行更快被官方定义为Loki 最快的解析器。基本语法Pattern 解析器使用| pattern表达式以和括起来的占位符捕获字段{jobaccesslog} | pattern ip - - _ method path _ statusname捕获并命名为name的字段_下划线表示丢弃该捕获不生成标签捕获的字段会作为解析标签parsed label附加到日志行可用于后续过滤、label_format等操作。源码实现从源码看Pattern 解析器的入口在 pkg/logql/log/parser.goNewPatternParser调用pattern.New编译模式串并校验捕获名是否满足合法的标签名规则model.UTF8Validation.IsValidLabelNameProcess方法对每一行执行matcher.Matches(line)把匹配到的字段写入LabelsBuilder的 parsed label 类别遇到与已有标签重名的字段会自动添加去重后缀duplicateSuffix。语法层面对应 pkg/logql/syntax/ast.go 中NewPatternParser的调用LogQL 词法/语法定义位于 pkg/logql/syntax/syntax.y。Pattern 匹配器的具体实现位于 pkg/pattern 包含 drain 状态机等子目录大量单测见 pkg/logql/log/parser_test.go 与 pkg/logql/syntax/ast_test.go。与正则、logfmt、JSON 的取舍在 LogQL 中解析一条结构化日志通常有四种选择解析器适用场景特点\| jsonJSON 格式日志键值语义清晰字段即 JSON key\| logfmtlogfmt 键值格式适合keyvalue风格日志\| regexp任意格式最灵活但编写成本与 CPU 开销最高\| pattern有一定结构、分隔符固定的日志语法简单、速度最快如 CLF 访问日志对 CLF 这类固定分隔符 可变字段值的日志Pattern 解析器在可读性和性能上都优于等价正则是 2.3 起处理访问日志的首选方案。完整的解析器用法见 log_queries 文档。Recording Rules把日志变成指标在 Alerting Rules 的基础上2.3 支持了Recording Rules可以周期性对日志执行 LogQL 指标查询把结果作为时间序列写入 Prometheus 或任意兼容 Prometheus remote_write 的端点从而把日志转换为指标。典型配置ruler 配置中定义 rule groupgroups: - name: log_metrics rules: - record: job:error_count:rate5m expr: | sum( rate({jobmyapp} |~ error[5m]) ) by (job)record生成的时间序列名称exprLogQL 指标查询表达式ruler 会按评估周期执行该查询并通过 remote_write 推送结果。Recording Rules 让运维可以从海量日志中提炼出稳定、可告警的指标曲线减少为了一个指标而额外埋点的成本。ruler 模块实现见 pkg/ruler告警与规则相关文档见 alert 文档。LogQL 支持 IP 地址过滤2.3 为 LogQL 增加了IP 地址语义可以直接对 IP 字段进行过滤、匹配子网范围。{jobfirewall} | pattern ip - - _ | ip(ip) ~ 10.0.0.0/8ip(field)将字段转换为 IP 类型支持、!、~、!~等比较操作符匹配值可以是一个 IP 地址也可以是 CIDR 子网如上例的10.0.0.0/8。这使得这个 IP 是否来自内网网段请求源是否在指定 CIDR 内这类网络运维问题可以直接在查询层解决无需正则手写网段匹配。详细语法见 ip.md。面向微服务部署的性能优化对于以微服务方式运行 Loki 的用户2.3 带来三项显著影响性能与运维的改进Index Gatewayquerier 零本地磁盘此前 boltdb-shipper 模式下每个 querier 需要自行下载 index 文件因而要求本地磁盘通常只能以 StatefulSet 部署。2.3 的Index Gateway承担了下载 boltdb-shipper index 文件的职责querier 通过 gRPC 向 Index Gateway 请求索引从而完全不需要本地磁盘。这意味着在 Kubernetes 中querier 可以从 StatefulSet 降级回 Deployment节省大量 PVC 成本与运维负担。实现见 pkg/indexgateway部署与配置说明见 boltdb-shipper 文档。Ingester Querier 可分片ingester 上的查询覆盖近期数据的热路径现在支持分片sharding对高吞吐日志流查询近期数据时性能提升显著对应 PR #3852。分片相关逻辑可参考 pkg/logql/shardmapper.go 与 pkg/querier 中的相关实现。Instant 查询可拆分与分片此前只有 range 查询支持拆分splitting与分片2.3 之后instant瞬时查询同样支持 split 与 shard对应 PR #3984使瞬时查询的性能与 range 查询看齐。相关实现见 pkg/logql/shardmapper.go 及测试 pkg/logql/rangemapper_test.go。备受期待的社区功能ingester 自动遗忘针对ingester 异常unhealthy后如何处理这一长期存在争议的行为2.3 提供了可选的自动处理能力PR #3919由社区贡献者 github-vincent-miszczak 实现新增配置项ingester.autoforget-unhealthy-timeout设置该超时时间后ingester 在超过该时长仍处于 unhealthy 状态时会被自动 forget无需人工介入不设置时保持 2.2 的默认行为由运维手动处理。这给集群运维提供了一条自动剔除故障 ingester的出路同时保留了对这一行为有争议的用户的既有选择。配置入口见 cmd/loki/loki-local-config.yaml 等示例配置完整参数定义见 pkg/ingester 相关配置结构。LogQL 模板与数学函数增强2.3 对label_format和line_format的模板能力做了两处增强更多 text/template 函数PR #3515label_format与line_format可用的 Go 模板函数集合大幅扩充便于在展示层做字符串拼接、条件判断等处理函数清单见 template_functions 文档数学函数支持PR #3434模板表达式中可以直接进行数学运算例如{jobapp} | line_format {{ .duration | div 1000 }}ms这减少了先解析、再在模板里手写算术的繁琐步骤。新增指标函数first_over_time 与 last_over_time2.3 新增两个指标查询函数PR #3050用于在 range 聚合中选取第一个或最后一个样本而不是求平均/最大/最小first_over_time({jobapp} | pattern ts level msg [5m]) last_over_time({jobapp} | pattern ts level msg [5m])典型的应用是降采样down sampling在把长窗口日志聚合成指标曲线时可以用窗口内第一条或最后一条日志对应的值作为该点的采样值而不是平均值。这在状态机类、游标类日志如当前版本号最后心跳时间场景下尤其有用。从源码看这两个函数的聚合语义由 pkg/logql/first_last_over_time.go 实现firstWithTimestampBatchRangeVectorIterator的agg直接返回窗口内第一个样本samples[0]lastWithTimestampBatchRangeVectorIterator返回最后一个样本samples[len(samples)-1]语法侧在 pkg/logql/syntax/ast.go 定义为OpRangeTypeFirst first_over_time与OpRangeTypeLast last_over_time并配套了分片合并逻辑mergeFirstOverTime/mergeLastOverTime保证分片查询下仍能选出全局第一个/最后一个样本。相关测试见 pkg/logql/syntax/ast_test.go 与 pkg/logql/internal/logqltest/testdata/range_aggregations.logqltest。升级到 2.3 的注意事项从 2.2.1 升级到 2.3.0 总体平滑但有一个行为变更需要特别关注所有查询必须包含至少一个等值匹配器equality matcherPR #3216。变更内容此前合法的查询{namespace~.*}在 2.3 之后会被拒绝。合法化它的方式有两种增加至少一个等值标签匹配器{clusterus-east-1,namespace~.*}把.*改为.排除空值{namespace~.}为什么这么改关键在于.*与.的语义差异.匹配任意字符*表示匹配前一个字符零次或多次表示匹配一次或多次。因此.*会匹配空值{namespace}也是非法请求除非像示例那样附带另一个等值匹配器而.不会。更深层的原因是 Loki 的索引查询机制如果查询中没有至少一个等值匹配器Loki 只能对索引表做全表扫描complete index table scan这是代价高昂且缓慢的操作。强制等值匹配器存在可以保证索引查询始终有一个明确的入口点避免全表扫描的性能陷阱。完整的升级指引见 upgrade 文档 的 2.3.0 小节。2.3 安全修复2.3.0 包含一项重要的安全修复PR #4020simonswine限制 TenantID 中的路径段对应 CVE-2021-36156 与 CVE-2021-36157。需要强调的是该漏洞的利用前提是攻击者能够构造并直接向 Loki 发送X-Scope-OrgID头。该头控制租户访问普通终端用户不应具备直接构造并发送此头的能力否则会破坏租户隔离。官方建议始终由代理或网关负责设置X-Scope-OrgID这是保证租户隔离与安全的关键实践。2.3 Bug 修复2.3.0 的 bug 修复主要包含两项值得注意的内容PR #3733资源泄漏修复此前当查询被取消时会遗留一个正在运行的 goroutine 持续占用内存资源造成内存泄漏2.3.0 修复了该问题PR #3686frontend panic 修复修复了前端query-frontend与 downstream URL 配合使用时的 panic 问题。官方同时建议采用GRPC Pull ModelgRPC 拉取模式运行查询前端该模式具有更好的性能并且能在租户之间实现公平调度。相关说明见 query-frontend 配置文档。总结Loki 2.3 是一次以数据生命周期治理 查询性能为核心的版本升级流级自定义保留与日志删除补全了数据治理闭环Pattern 解析器与 IP 过滤让 LogQL 更强大Index Gateway 与查询分片优化了微服务部署的成本和性能Recording Rules 打通了日志到指标的通道。对升级用户而言务必先处理至少一个等值匹配器的查询行为变更并按官方建议通过代理/网关设置X-Scope-OrgID。更多细节可继续查阅 release-notes 目录以及上文提到的各功能文档与源码路径。【免费下载链接】lokiLike Prometheus, but for logs.项目地址: https://gitcode.com/GitHub_Trending/lok/loki创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Loki 2.3 版本特性深度解析流级保留策略、日志删除、Pattern 解析器与 LogQL IP 过滤【免费下载链接】lokiLike Prometheus, but for logs.项目地址: https://gitcode.com/GitHub_Trending/lok/lokiLoki 2.3 是 Grafana Loki 在 AGPLv3 许可下发布的首个版本也是 2.2 之后时隔约 6 个月的一次大版本更新。本篇文章以 v2-3 发布说明 为骨架结合当前仓库源码系统梳理 2.3 引入的流级自定义保留、日志流删除、Pattern 解析器、Recording Rules、LogQL IP 过滤、Index Gateway 等关键能力并给出升级到 2.3 时必须了解的行为变更与安全修复细节。读完本文你将掌握 2.3 各核心特性的原理、用法与升级注意事项可以直接在真实环境中规划采用。2.3 版本总览Loki 2.3 是 2.2 发布后近 6 个月工作的集中落地其改进方向非常明确数据生命周期管理不再依赖对象存储配置来控制日志保留时间而是由 Loki 自身基于 stream selector 提供更精细的自定义保留策略数据治理支持提交日志删除请求初步实现对已写入日志流的删除查询性能引入全新的 Pattern 解析器当前 Loki 最快的解析器、支持 IP 地址过滤、ingester querier 可分片、Instant 查询可拆分与分片指标能力支持 Recording Rules把日志转换为指标并写入 Prometheus 或任意兼容 remote_write 的端点运维易用性新增 Index Gateway让 querier 摆脱本地磁盘依赖。此外2.3 也是 Loki 在AGPLv3 许可下发布的第一个版本。仓库中部分内容主要是 clients 和部分工具仍保持 Apache-2.0 许可详细划分见 LICENSING.mdApache-2.0 部分的许可声明见 clients/LICENSE_APACHE2。流级自定义保留Custom Retention2.3 之前日志保留retention主要通过对象存储的 bucket 生命周期配置完成粒度粗、且不受 Loki 控制。2.3 之后Loki 自身可以根据stream selector对不同的日志流应用不同的保留时长实现细粒度保留控制。其核心用法是在 runtime config 中为某个租户定义retention_streamoverrides: fake: retention_stream: - selector: {namespaceprod} priority: 1 period: 24h - selector: {namespacedev} priority: 2 period: 720hselector一条 LogQL 流选择器匹配需要应用该保留策略的日志流priority当一条流同时命中多条规则时按 priority 决定采用哪条数字越小优先级越高具体以文档为准period该流允许保留的时长超过后由 compactor 在压缩过程中删除。该能力与 compactor 的保留删除机制协同工作相关实现集中在 pkg/compactor/retention 目录下compactor 会在表table处理阶段按 selector 匹配并裁剪过期块。与整体保留策略叠加使用时流级保留提供了更细的控制手段例如为高频噪声流设置短保留为审计类流设置长保留而无需为每个流单独配置对象存储生命周期。日志流删除Log Deletion与存得更久配套的是删得掉。2.3 引入了日志删除的初始实现用户可以提交删除请求任务Loki 会在请求提交24 小时后开始处理。删除请求通过 HTTP API 提交例如curl -X POST \ -H Content-Type: application/json \ -H X-Scope-OrgID: fake \ http://localhost:3100/loki/api/v1/delete?start1624000000000000000end1625000000000000000 \ -d {query:{namespace\dev\} |~ \error\}要点query使用 LogQL 流选择器可叠加过滤表达式指定要删除的日志start/end为纳秒时间戳划定删除的时间范围删除请求会在 24 小时后由 compactor 的删除处理机制真正执行pkg/compactor/deletion 目录承载了请求存储与执行逻辑如需确认删除请求状态可查询/loki/api/v1/delete接口。删除能力与保留策略共同构成 2.3 的完整数据治理方案保留决定默认能存多久删除决定主动清掉哪些。更完整的 API 与限制说明见 logs-deletion.md。Pattern 解析器Loki 最快的解析器2.3 引入了一个全新的 LogQL 解析器——Pattern 解析器用于处理有一定结构的日志行例如 Common Log FormatCLF这类访问日志。相比正则表达式Pattern 解析器语法更简单、执行更快被官方定义为Loki 最快的解析器。基本语法Pattern 解析器使用| pattern表达式以和括起来的占位符捕获字段{jobaccesslog} | pattern ip - - _ method path _ statusname捕获并命名为name的字段_下划线表示丢弃该捕获不生成标签捕获的字段会作为解析标签parsed label附加到日志行可用于后续过滤、label_format等操作。源码实现从源码看Pattern 解析器的入口在 pkg/logql/log/parser.goNewPatternParser调用pattern.New编译模式串并校验捕获名是否满足合法的标签名规则model.UTF8Validation.IsValidLabelNameProcess方法对每一行执行matcher.Matches(line)把匹配到的字段写入LabelsBuilder的 parsed label 类别遇到与已有标签重名的字段会自动添加去重后缀duplicateSuffix。语法层面对应 pkg/logql/syntax/ast.go 中NewPatternParser的调用LogQL 词法/语法定义位于 pkg/logql/syntax/syntax.y。Pattern 匹配器的具体实现位于 pkg/pattern 包含 drain 状态机等子目录大量单测见 pkg/logql/log/parser_test.go 与 pkg/logql/syntax/ast_test.go。与正则、logfmt、JSON 的取舍在 LogQL 中解析一条结构化日志通常有四种选择解析器适用场景特点\| jsonJSON 格式日志键值语义清晰字段即 JSON key\| logfmtlogfmt 键值格式适合keyvalue风格日志\| regexp任意格式最灵活但编写成本与 CPU 开销最高\| pattern有一定结构、分隔符固定的日志语法简单、速度最快如 CLF 访问日志对 CLF 这类固定分隔符 可变字段值的日志Pattern 解析器在可读性和性能上都优于等价正则是 2.3 起处理访问日志的首选方案。完整的解析器用法见 log_queries 文档。Recording Rules把日志变成指标在 Alerting Rules 的基础上2.3 支持了Recording Rules可以周期性对日志执行 LogQL 指标查询把结果作为时间序列写入 Prometheus 或任意兼容 Prometheus remote_write 的端点从而把日志转换为指标。典型配置ruler 配置中定义 rule groupgroups: - name: log_metrics rules: - record: job:error_count:rate5m expr: | sum( rate({jobmyapp} |~ error[5m]) ) by (job)record生成的时间序列名称exprLogQL 指标查询表达式ruler 会按评估周期执行该查询并通过 remote_write 推送结果。Recording Rules 让运维可以从海量日志中提炼出稳定、可告警的指标曲线减少为了一个指标而额外埋点的成本。ruler 模块实现见 pkg/ruler告警与规则相关文档见 alert 文档。LogQL 支持 IP 地址过滤2.3 为 LogQL 增加了IP 地址语义可以直接对 IP 字段进行过滤、匹配子网范围。{jobfirewall} | pattern ip - - _ | ip(ip) ~ 10.0.0.0/8ip(field)将字段转换为 IP 类型支持、!、~、!~等比较操作符匹配值可以是一个 IP 地址也可以是 CIDR 子网如上例的10.0.0.0/8。这使得这个 IP 是否来自内网网段请求源是否在指定 CIDR 内这类网络运维问题可以直接在查询层解决无需正则手写网段匹配。详细语法见 ip.md。面向微服务部署的性能优化对于以微服务方式运行 Loki 的用户2.3 带来三项显著影响性能与运维的改进Index Gatewayquerier 零本地磁盘此前 boltdb-shipper 模式下每个 querier 需要自行下载 index 文件因而要求本地磁盘通常只能以 StatefulSet 部署。2.3 的Index Gateway承担了下载 boltdb-shipper index 文件的职责querier 通过 gRPC 向 Index Gateway 请求索引从而完全不需要本地磁盘。这意味着在 Kubernetes 中querier 可以从 StatefulSet 降级回 Deployment节省大量 PVC 成本与运维负担。实现见 pkg/indexgateway部署与配置说明见 boltdb-shipper 文档。Ingester Querier 可分片ingester 上的查询覆盖近期数据的热路径现在支持分片sharding对高吞吐日志流查询近期数据时性能提升显著对应 PR #3852。分片相关逻辑可参考 pkg/logql/shardmapper.go 与 pkg/querier 中的相关实现。Instant 查询可拆分与分片此前只有 range 查询支持拆分splitting与分片2.3 之后instant瞬时查询同样支持 split 与 shard对应 PR #3984使瞬时查询的性能与 range 查询看齐。相关实现见 pkg/logql/shardmapper.go 及测试 pkg/logql/rangemapper_test.go。备受期待的社区功能ingester 自动遗忘针对ingester 异常unhealthy后如何处理这一长期存在争议的行为2.3 提供了可选的自动处理能力PR #3919由社区贡献者 github-vincent-miszczak 实现新增配置项ingester.autoforget-unhealthy-timeout设置该超时时间后ingester 在超过该时长仍处于 unhealthy 状态时会被自动 forget无需人工介入不设置时保持 2.2 的默认行为由运维手动处理。这给集群运维提供了一条自动剔除故障 ingester的出路同时保留了对这一行为有争议的用户的既有选择。配置入口见 cmd/loki/loki-local-config.yaml 等示例配置完整参数定义见 pkg/ingester 相关配置结构。LogQL 模板与数学函数增强2.3 对label_format和line_format的模板能力做了两处增强更多 text/template 函数PR #3515label_format与line_format可用的 Go 模板函数集合大幅扩充便于在展示层做字符串拼接、条件判断等处理函数清单见 template_functions 文档数学函数支持PR #3434模板表达式中可以直接进行数学运算例如{jobapp} | line_format {{ .duration | div 1000 }}ms这减少了先解析、再在模板里手写算术的繁琐步骤。新增指标函数first_over_time 与 last_over_time2.3 新增两个指标查询函数PR #3050用于在 range 聚合中选取第一个或最后一个样本而不是求平均/最大/最小first_over_time({jobapp} | pattern ts level msg [5m]) last_over_time({jobapp} | pattern ts level msg [5m])典型的应用是降采样down sampling在把长窗口日志聚合成指标曲线时可以用窗口内第一条或最后一条日志对应的值作为该点的采样值而不是平均值。这在状态机类、游标类日志如当前版本号最后心跳时间场景下尤其有用。从源码看这两个函数的聚合语义由 pkg/logql/first_last_over_time.go 实现firstWithTimestampBatchRangeVectorIterator的agg直接返回窗口内第一个样本samples[0]lastWithTimestampBatchRangeVectorIterator返回最后一个样本samples[len(samples)-1]语法侧在 pkg/logql/syntax/ast.go 定义为OpRangeTypeFirst first_over_time与OpRangeTypeLast last_over_time并配套了分片合并逻辑mergeFirstOverTime/mergeLastOverTime保证分片查询下仍能选出全局第一个/最后一个样本。相关测试见 pkg/logql/syntax/ast_test.go 与 pkg/logql/internal/logqltest/testdata/range_aggregations.logqltest。升级到 2.3 的注意事项从 2.2.1 升级到 2.3.0 总体平滑但有一个行为变更需要特别关注所有查询必须包含至少一个等值匹配器equality matcherPR #3216。变更内容此前合法的查询{namespace~.*}在 2.3 之后会被拒绝。合法化它的方式有两种增加至少一个等值标签匹配器{clusterus-east-1,namespace~.*}把.*改为.排除空值{namespace~.}为什么这么改关键在于.*与.的语义差异.匹配任意字符*表示匹配前一个字符零次或多次表示匹配一次或多次。因此.*会匹配空值{namespace}也是非法请求除非像示例那样附带另一个等值匹配器而.不会。更深层的原因是 Loki 的索引查询机制如果查询中没有至少一个等值匹配器Loki 只能对索引表做全表扫描complete index table scan这是代价高昂且缓慢的操作。强制等值匹配器存在可以保证索引查询始终有一个明确的入口点避免全表扫描的性能陷阱。完整的升级指引见 upgrade 文档 的 2.3.0 小节。2.3 安全修复2.3.0 包含一项重要的安全修复PR #4020simonswine限制 TenantID 中的路径段对应 CVE-2021-36156 与 CVE-2021-36157。需要强调的是该漏洞的利用前提是攻击者能够构造并直接向 Loki 发送X-Scope-OrgID头。该头控制租户访问普通终端用户不应具备直接构造并发送此头的能力否则会破坏租户隔离。官方建议始终由代理或网关负责设置X-Scope-OrgID这是保证租户隔离与安全的关键实践。2.3 Bug 修复2.3.0 的 bug 修复主要包含两项值得注意的内容PR #3733资源泄漏修复此前当查询被取消时会遗留一个正在运行的 goroutine 持续占用内存资源造成内存泄漏2.3.0 修复了该问题PR #3686frontend panic 修复修复了前端query-frontend与 downstream URL 配合使用时的 panic 问题。官方同时建议采用GRPC Pull ModelgRPC 拉取模式运行查询前端该模式具有更好的性能并且能在租户之间实现公平调度。相关说明见 query-frontend 配置文档。总结Loki 2.3 是一次以数据生命周期治理 查询性能为核心的版本升级流级自定义保留与日志删除补全了数据治理闭环Pattern 解析器与 IP 过滤让 LogQL 更强大Index Gateway 与查询分片优化了微服务部署的成本和性能Recording Rules 打通了日志到指标的通道。对升级用户而言务必先处理至少一个等值匹配器的查询行为变更并按官方建议通过代理/网关设置X-Scope-OrgID。更多细节可继续查阅 release-notes 目录以及上文提到的各功能文档与源码路径。【免费下载链接】lokiLike Prometheus, but for logs.项目地址: https://gitcode.com/GitHub_Trending/lok/loki创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
技术解析与实践指南)
)
)
