本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

使用 HLC 端點傳送日誌 (HLC 日誌）

HLC Logs 端點 (/services/collector/event) 是以 HTTP Log Collector (HLC) 格式為基礎。

如果您使用承載字符身分驗證，請先完成 中的設定步驟，設定承載字符身分驗證再繼續。

輸入模式

每個事件都是具有必要"event"欄位的 JSON 物件。選用中繼資料欄位："time"、"host"、"source"、"sourcetype"、"index"。

單一事件：

{"event":"Hello world!","time":1486683865.0}

事件的 JSON 陣列：

[
  {"event":"msg1","time":1486683865.0},
  {"event":"msg2","time":1486683866.0}
]

串連/批次事件 （無陣列包裝函式）：

{"event":"msg1","time":1486683865.0}{"event":"msg2","time":1486683866.0}

事件欄位 （必要）

欄位為必要"event"欄位。其值可以是任何 JSON 類型：

{"event":"a string message"}
{"event":{"message":"structured data","severity":"INFO"}}
{"event":42}
{"event":true}

無 "event" 欄位的物件會無提示地略過：

{"message":"this is skipped — no event field"}

時間欄位 （選用）

"time" 欄位以 epoch 秒 （非毫秒） 為單位，選用小數表示次秒精確度。

內容類型

僅接受 application/json 。

接受的 JSON 值類型

端點格式

HLC 端點 URL 遵循此格式：

https://logs.<region>.amazonaws.com/services/collector/event?logGroup=<name>&logStream=<name>[&entityName=<name>&entityEnvironment=<environment>]

必要參數：

選用參數：

您可以選擇性地將日誌事件與Service實體建立關聯，方法是包含下列查詢參數。由於透過 HLC 端點傳送的日誌是自訂遙測，因此不會自動與實體建立關聯。透過提供這些參數，CloudWatch Logs 會建立將 KeyAttributes.Type 設定為 的實體，Service並將其與您的日誌事件建立關聯。這可讓 CloudWatch 中的探索相關功能將這些日誌與來自相同服務的其他遙測 （指標、追蹤和日誌） 建立關聯，讓您更輕鬆地疑難排解和監控不同訊號類型的應用程式。如需實體和相關遙測的詳細資訊，請參閱將相關資訊新增至自訂遙測。

要求格式

使用 HTTP POST 搭配下列標頭和內文來傳送日誌：

標頭：

內文格式：

請求內文應為 JSON 格式，其中包含一系列事件：

{
    "event": [
        {
            "time": 1730141374.001,
            "event": "Application started successfully",
            "host": "web-server-1",
            "source": "application.log",
            "severity": "info"
        },
        {
            "time": 1730141374.457,
            "event": "User login successful",
            "host": "web-server-1",
            "source": "auth.log",
            "user": "john.doe"
        }
    ]
}

欄位描述：

您可以視需要包含其他自訂欄位。

範例請求

curl -X POST "https://logs.<region>.amazonaws.com/services/collector/event?logGroup=MyLogGroup&logStream=MyStream" \
  -H "Authorization: Bearer ACWL<token>" \
  -H "Content-Type: application/json" \
  -d '{"event":{"message":"User logged in","user_id":"u-123"},"time":1486683865.0,"host":"web-01","source":"auth-service"}'

最佳實務

批次處理事件

為了獲得更好的效能和效率：

錯誤處理

在應用程式中實作適當的錯誤處理。常見的 HTTP 狀態碼：

限制