理解本地日志与Azure Pipelines日志的差异
在使用logback等日志框架时，开发者通常通过在logback.xml配置文件中定义patternlayoutencoder来控制日志的输出格式，包括使用ansi转义码实现控制台颜色高亮。例如，%blue()、%highlight()、%green()等模式能够使日志在本地开发环境（如intellij idea控制台）中呈现出丰富的颜色。
然而，Azure Pipelines的控制台环境与本地终端有所不同。它并非完全支持标准的ANSI转义码来渲染颜色。Azure Pipelines有其自身的日志处理机制，通过特定的命令前缀来识别并渲染日志的颜色、分组、警告或错误信息。这意味着，直接将本地带有ANSI颜色模式的Logback配置应用到Azure Pipelines中，将无法看到预期的颜色效果，但布局结构可能仍会被保留。
Azure Pipelines的特殊日志命令
为了在Azure Pipelines控制台中实现颜色、分组和结构化输出，我们需要利用其内置的日志命令。这些命令通过特定的前缀标记日志行，Azure Pipelines会根据这些前缀自动进行解析和渲染。以下是一些常用的Azure Pipelines日志命令：
- ##[group]: 标记一个日志组的开始，可用于将相关日志消息分组折叠。
- ##[endgroup]: 标记一个日志组的结束。
- ##[warning]: 将日志行标记为警告信息，通常会以黄色显示。
- ##[error]: 将日志行标记为错误信息，通常会以红色显示。
- ##[section]: 标记一个新部分的开始，有助于组织构建或部署流程中的不同阶段。
- ##[debug]: 将日志行标记为调试信息。
- ##[command]: 用于显示正在执行的命令行命令。
这些命令是Azure Pipelines特有的，它们提供了一种标准化的方式来控制控制台的视觉呈现，而不是依赖于通用的ANSI转义码。
Logback配置适配：实现环境差异化输出
为了兼顾本地开发环境的颜色需求和Azure Pipelines的结构化输出需求，我们可以利用Logback的条件配置功能。通过在logback.xml中使用
以下是一个示例logback.xml配置，它根据LOG_ENV环境变量的值来决定使用哪种日志模式：
INFO ACCEPT DENY %blue([%d{ISO8601}]) %highlight(%green(%-5level)) %blue([%logger{100}]:) %green(%msg%n%throwable) ##[section][%d{ISO8601}] [%logger{100}]: %msg%n%throwable WARN ACCEPT DENY %blue([%d{ISO8601}]) [%t] %blue([%logger{100}]:) %yellow(%msg%n%throwable) ##[warning][%d{ISO8601}] [%t] [%logger{100}]: %msg%n%throwable ERROR ACCEPT DENY %blue([%d{ISO8601}]) [%t] %blue([%logger{100}]:) %red(%msg%n%throwable) ##[error][%d{ISO8601}] [%t] [%logger{100}]: %msg%n%throwable
如何设置LOG_ENV环境变量：
本地开发环境： 可以在运行应用程序时通过JVM参数设置，例如：-DLOG_ENV=LOCAL。
-
Azure Pipelines环境： 在Pipeline定义（azure-pipelines.yml）中设置一个环境变量。例如：
variables: LOG_ENV: 'AZURE' # 或者其他非"LOCAL"的值 steps: - script: | echo "Starting application..." java -jar your-app.jar displayName: 'Run Application with Azure Log Config' env: LOG_ENV: $(LOG_ENV) # 将变量传递给脚本或者直接在任务中设置：
steps: - script: | echo "Starting application..." java -DLOG_ENV=AZURE -jar your-app.jar displayName: 'Run Application with Azure Log Config'
核心依赖
要使用Logback进行日志记录，你需要添加以下Maven依赖：
ch.qos.logback logback-classic 1.4.4 org.slf4j slf4j-api 2.0.3 ch.qos.logback logback-core 1.4.4
确保slf4j-api和logback-classic、logback-core的版本兼容。
注意事项与总结
- 环境识别的可靠性： 确保用于区分本地和Azure环境的属性（如LOG_ENV）在两种环境中都能被准确设置和识别。
- 日志级别映射： 在Azure Pipelines中，虽然有##[warning]和##[error]等前缀，但并没有严格的日志级别过滤机制（如DEBUG、INFO）。这意味着，所有带有这些前缀的日志都会被Azure Pipelines处理，而不会像Logback那样根据配置的级别进行过滤。因此，在Logback配置中，我们仍然使用LevelFilter来控制哪些级别的日志会被相应的Appender处理。
- 可读性优先： 在设计Azure Pipelines的日志模式时，应优先考虑清晰度和可读性，利用其分组和颜色功能来突出关键信息和流程阶段。
- 持续集成/持续部署（CI/CD）的日志价值： 结构化的日志输出对于CI/CD管道的故障排查、进度监控和审计至关重要。通过利用Azure Pipelines的日志命令，可以大大提高管道日志的可用性。
通过上述方法，你可以在本地开发环境中享受彩色日志带来的便利，同时确保在Azure Pipelines中输出符合其规范的、具有结构和视觉提示的日志，从而提升开发和运维效率。
