資料路徑日誌轉遞

資料日誌及性能檢查日誌對於除錯及維護用途非常重要。 啟用資料路徑記錄功能後，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...) 建置。

datapath 日誌是 JSON 字串，包含下列欄位:

資料路徑日誌字段
欄位名稱 類型 說明
優先順序 字串 與日誌嚴重性上每一則訊息相關聯的記載層次。
MSG_timestamp 字串 指出產生日誌的時間戳記。
SentByHost 字串 主機的 IP 位址。
訊息 字串 日誌檔的相關說明。
logSourceCRN 字串 日誌檔儲存在 CRN 中所指出帳戶的 Log Analysis 實例中。
saveServiceCopy bool 指出是否在 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 是以世界標準時間 (UTC) 表示的時間戳記。
  • SentByHost 是應用裝置的 VIP。 對於公用負載平衡器，這是浮動 IP; 對於專用負載平衡器，這是專用 IP。
  • MESSAGE 是日誌訊息的內容。
  • logSourceCRN 指出要使用哪個 Log Analysis 實例來儲存帳戶的日誌。
  • saveServiceCopy 是 false (依預設)，無法變更。

日誌的格式可能會受到內部升級的影響。 建議只將這些訊息用於除錯目的，而不用於建置自動化。