tracing-filter

结构化跟踪记录的过滤/查询系统。

仍在开发中。 功能状态各不相同。

目前仅针对收集的事件进行过滤。然而，我 希望 也支持过滤记录的事件。

过滤器

当你构建一个 Filter 类型时，你确定它支持哪种类型的过滤器。你不能在一个过滤层中混合不同类型的过滤器。

请注意，复杂的过滤器可能会降低你的跟踪性能，因此通常不建议使用不受信任（即用户）来源的过滤器。这对于旧版和查询过滤器尤为重要；因为它们使用 regex-automata 来实现无缓冲的正则表达式过滤，因此容易受到无界正则表达式编译时间的影响，类似于 CVE-20222-24713。简单的过滤器不进行无缓冲的正则表达式评估，因此直接使用正则表达式crate，这已经缓解了这个问题。

简单过滤器

tracing-filter与env_logger的过滤器语法99.999%兼容。因此，你可以像以前一样编写简单的过滤器

• warn — 过滤出级别为 WARN 或 ERROR 的事件
• my_app=debug — 仅过滤出来自 my_app 的 DEBUG 或更高级别的事件
• warn,my_app::module=trace — 获取警告事件并跟踪 my_app::module
• off — 禁用所有日志
• debug/foo — 过滤出包含 "foo" 的 DEBUG 或更高级别的事件

通常，语法是 target=level/regex。如果一个事件的目标 以 列出的 target 开头，其级别通过了 level 过滤器，并且其消息与 regex 匹配，则该事件将被包含。使用 env_logger crate 时，如果不启用 regex 功能，正则表达式字符串是简单的子字符串匹配；使用我们简单的过滤器，

这应该在 tracing_filter::simple 模块中达到 99% 的功能性。

^†：tracing 还不允许根据事件字段的内容进行过滤 目前还不允许。tracing-filter 选择暂时静默忽略正则表达式过滤器（但确实验证了过滤器）。

旧版过滤器

[email protected] 的 EnvFilter 支持的过滤器语法，包括其所有独特的 "peculiarites"（特性）；100% 的 bug-for-bug 兼容。

因此，您可以继续使用所有之前使用的过滤器

• warn — 过滤出级别为 WARN 或 ERROR 的事件
• my_app=debug — 仅过滤出来自 my_app 的 DEBUG 或更高级别的事件
• warn,my_app::module=trace — 获取警告事件并跟踪 my_app::module
• off — 禁用所有日志
• [span]=debug — 在名为 span 的跨度内过滤 DEBUG 或更高的事件
• [{field}] — 过滤具有字段 field 或在具有名称 field 的跨度内的事件
• [{key=val}] — 过滤具有字段 key 且与正则表达式 val 匹配的事件
• [{key=0}] — 过滤具有字段 key 且记录的数字等于 0
• [{key=true}] — 过滤具有字段 key 且记录的布尔值为 true
• target[span] — 过滤具有目标 target 和名称 span 的跨度内的事件