Polly日志级别优化：执行尝试日志的严重性探讨

背景介绍

在分布式系统开发中，Polly作为.NET生态中广泛使用的弹性策略库，其日志输出配置直接影响着应用程序的性能表现。近期有团队反馈在迁移到Polly v8后，由于日志量增加导致CPU利用率上升的问题，这引发了我们对Polly默认日志级别的深入思考。

问题现象

当开发者将最小日志级别设置为Information时，Polly会记录每个执行尝试（如重试、对冲策略）的信息。这些日志以Information级别输出，在频繁调用的场景下会产生大量日志条目。通过以下示例代码可以复现此现象：

var services = new ServiceCollection();
services.AddLogging(builder => builder.AddConsole().SetMinimumLevel(LogLevel.Debug));

var pipeline = services
    .AddResiliencePipeline("my-pipeline", builder => builder.AddRetry(new()))
    .BuildServiceProvider()
    .GetRequiredKeyedService<ResiliencePipeline>("my-pipeline");

await pipeline.ExecuteAsync(async token => true);

执行后控制台输出显示，执行尝试日志被标记为Information级别，而其他如管道开始/结束的日志则使用Debug级别。

技术分析

Polly v8引入的遥测系统默认将执行尝试事件归类为Information级别，这主要基于以下考虑：

1. 执行尝试信息对运维人员监控系统行为具有实际价值
2. 在故障排查时，这些日志能清晰展示策略的执行路径
3. Information级别确保这些重要信息不会被常规的Debug过滤设置屏蔽

然而，这种设计在高频调用场景下确实会产生性能开销：

• 日志序列化和I/O操作消耗CPU资源
• 日志存储系统可能面临压力
• 网络带宽使用增加

解决方案探讨

对于此问题，开发团队提出了几种解决思路：

1. 默认级别调整：将执行尝试日志降级为Debug，但这属于破坏性变更，可能影响依赖当前行为的用户

2. 全局日志级别覆盖：在应用配置中直接设置Polly的日志级别为Warning及以上

3. 自定义严重性提供程序：利用现有的SeverityProvider功能动态调整特定事件的日志级别

4. 性能优化开关：引入配置选项来批量降低高频日志的级别，但这可能带来API复杂度和维护成本

最佳实践建议

基于当前Polly v8的实现，我们推荐以下优化方案：

1. 针对性调整：对于高频调用且对执行细节不敏感的场景，使用SeverityProvider将ExecutionAttempt降级为Debug

builder.ConfigureTelemetry(options =>
{
    options.SeverityProvider = eventType => 
        eventType == TelemetryEventType.ExecutionAttempt ? LogLevel.Debug : LogLevel.Information;
});

2. 全局过滤：在应用启动时设置Polly的默认日志级别

builder.AddFilter("Polly", LogLevel.Warning);

3. 日志采样：结合日志框架的采样功能，只记录部分执行尝试

架构思考

这个案例反映了弹性库设计中一个典型的权衡问题：可观测性 vs 性能。Polly团队的选择倾向于提供详细的运行时信息，这符合云原生应用对可观测性的高要求。开发者需要根据具体场景：

• 调试阶段：保持Information级别以获取完整执行轨迹
• 生产环境：适当调高级别阈值或使用采样策略
• 性能关键路径：考虑完全禁用特定策略的日志

未来版本可能会引入更细粒度的日志控制机制，但当前的设计已经通过可扩展性提供了足够的灵活性。

总结

Polly的日志级别设计体现了"默认详细"的哲学，确保开发者不会错过重要信息。虽然这可能在极端情况下带来性能开销，但通过现有的配置选项完全可以实现优化。理解这一设计理念后，开发者可以更自信地在可观测性和性能之间找到适合自己应用的平衡点。