Log4j2与Micrometer异步Appender指标计数异常问题求助

环境与问题描述 #

• 环境：Azure上运行的Spring Boot应用，使用Azure监控JavaAgent（内部自动创建AzureMonitorMeterRegistry），通过Log4j2结合Micrometer采集日志事件指标。
• 问题：使用异步Appender时，日志指标计数远低于实际产生的日志量（StepCounter显示无持续增长趋势）；切换为同步Logger后，计数恢复正常。

问题代码分析 #

问题出在MeterBinder实现类Log4j2Metrics的filter方法中：

@Override
public Result filter(LogEvent event) {

    if (!isAsyncLogger || isAsyncLoggerAndEndOfBatch(event)) {
      // increments by 1
      incrementCounter(event); // shouldn't this be incremented by "batch size" in case of async logger ?
    }

    return Result.NEUTRAL;
}

Log4j2异步Logger采用批量处理日志的机制，但当前逻辑仅在批次结束时才调用计数方法，且每次只累加1，相当于只统计了批次的数量，而非批次内真实的日志事件总数，这直接导致指标计数严重偏低。

解决方案 #

方案1：直接统计每个日志事件 #

去掉批次判断逻辑，对每个经过Filter的日志事件直接计数，确保不遗漏任何一条日志：

@Override
public Result filter(LogEvent event) {
    // 同步/异步场景下，每条日志事件都单独计数
    incrementCounter(event);
    return Result.NEUTRAL;
}

这种方式最简单直接，能保证计数完全匹配实际日志量，适合对指标实时性要求较高的场景。

方案2：按批次批量计数（优化性能） #

如果担心频繁更新指标影响性能，可以保留批次结束的判断，同时获取批次大小进行批量累加：

@Override
public Result filter(LogEvent event) {
    if (!isAsyncLogger) {
        // 同步Logger，单条计数
        incrementCounter(event);
    } else if (isAsyncLoggerAndEndOfBatch(event)) {
        // 异步批次结束时，按批次大小批量计数
        int batchSize = event.getBatchSize();
        // 若incrementCounter支持批量参数，直接传入更高效
        // incrementCounter(event, batchSize);
        // 若无批量参数，循环累加对应次数
        for (int i = 0; i < batchSize; i++) {
            incrementCounter(event);
        }
    }
    return Result.NEUTRAL;
}

注意：需确认LogEvent.getBatchSize()能正确返回当前批次的日志数量（Log4j2的异步日志实现类如AsyncLogEvent已支持该方法）。

验证调整效果 #

部署修改后的代码后，通过StepCounter观察指标趋势，确认计数与实际日志生成量一致；同时检查Azure监控平台中的日志指标是否正常上报。

内容的提问来源于stack exchange，提问作者Kumar Sambhav