关于Ballerina HTTP访问日志格式及请求ID获取的技术咨询

默认日志格式 #

Ballerina HTTP访问日志默认采用Common Log Format（CLF），具体格式为：

%h %l %u %t \"%r\" %>s %b

各字段对应含义：

• %h：发起请求的客户端IP地址
• %l：客户端标识信息（多数场景下为-，因为客户端不会主动提供）
• %u：经过认证的用户名称（未认证时显示-）
• %t：请求处理的时间戳，格式为[dd/MMM/yyyy:HH:mm:ss Z]
• "%r"：完整的HTTP请求行，包含请求方法、目标URL和协议版本
• %>s：最终返回给客户端的HTTP响应状态码
• %b：响应体的字节大小（无响应体时显示-）

提取特定Header中的请求ID #

Ballerina支持自定义访问日志格式，你可以通过配置日志模式直接包含指定HTTP Header的值，以此提取请求ID。

比如你的请求ID通过X-Request-ID Header传递，只需在日志配置的pattern中添加%{X-Request-ID}i即可捕获该Header的值。示例代码如下：

import ballerina/http;

listener http:Listener ep = new (9090, accessLog = {
    pattern: "%h %l %u %t \"%r\" %>s %b %{X-Request-ID}i"
});

service / on ep {
    resource function get hello() returns string {
        return "Hello World!";
    }
}

配置后生成的访问日志会包含X-Request-ID的取值，后续可直接从日志行中提取这个字段作为请求ID。

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