数据路径日志转发

数据和运行状况检查日志对于调试和维护非常有用。 启用数据路径日志功能后，IBM Cloud® Virtual Private Cloud Application Load Balancer for VPC (ALB) 会将这些日志转发到您账户的 IBM Cloud Logs 仪表板。

要启用或禁用数据路径日志记录功能，您可以:

  • 创建负载均衡器并启用或禁用切换按钮。

  • 对于现有负载均衡器，请使用 CLI 将 --logging-datapath-active 属性设置为 true。

  • 使用 API 来启用数据路径日志记录。

如果您没有 Log Analysis 实例，那么必须先创建一个实例，然后才能启用数据路径日志记录。

日志输出示例

以下输出是 IBM Cloud Application Load Balancer for VPC 数据路径日志记录的示例:

Sep 28 11:25:04 is-load-balancer crn:v1:bluemix:public:is:us-south:a/a1234567::load-balancer:r006-6ba32c0e-830c-483c-871a-0240c10662cf
{"PRIORITY":"info", "MSG_timestamp":"2020-09-28T03:25:03.136101+00:00", "SentByHost":"150.238.66.162", "MESSAGE":" Connect from 222.72.143.92:38605 to 10.240.128.5:62776 (r006-6ba32c0e-830c-483c-871a-0240c10662cf/HTTP)", "logSourceCRN":"crn:v1:bluemix:public:is:us-south:a/a1234567::load-balancer:r006-6ba32c0e-830c-483c-871a-0240c10662cf", "saveServiceCopy":false}

日志包含日志头和 JSON 字符串。

日志头是使用日期时间 (Sep 28 11:25:04)，日志源 (is-load-balancer) 和日志源 CRN (crn:v1:bluemix:public:is:us-south...) 构建的。

数据路径日志是 JSON 字符串，包含以下字段:

数据路径日志字段
字段名称 类型 描述
优先级 string 与日志严重性上的每条消息关联的日志级别。
MSG_timestamp string 指示生成日志的时间的时间戳记。
SentByHost string 主机的 IP 地址。
消息 string 有关日志文件的描述。
logSourceCRN string 其中日志文件保存在 CRN 中指示的帐户的 Log Analysis 实例中。
saveServiceCopy 布尔值 指示是否在 Log Analysis STS 中保存日志; 缺省值为 false。

以下是数据路径日志的 JSON 模式示例:

{
    "type": "object",
    "properties": {
        "PRIORITY": {
            "type": "string"
        },
        "MSG_timestamp": {
            "type": "string"
        },
        "SentByHost": {
            "type": "string"
        },
        "MESSAGE": {
            "type": "string"
        },
        "logSourceCRN": {
            "type": "string"
        },
        "saveServiceCopy": {
            "type": "boolean"
        }
    }
}

请注意：

  • PRIORITY 是与日志严重性上的每条消息相关联的日志级别。 目前，唯一的选择是 info。
  • MSG_timestamp 是全球标准时间中的时间戳记。
  • SentByHost 是设备的 VIP。 对于公共负载均衡器，这是浮动 IP; 对于专用负载均衡器，这是专用 IP。
  • MESSAGE 是日志消息的内容。
  • logSourceCRN 指示要用于保存帐户日志的 Log Analysis 实例。
  • saveServiceCopy 是 false (缺省情况下)，无法更改。

日志的格式可能会受到内部升级的影响。 建议仅将这些消息用于调试目的，而不用于构建自动化。