共用方式為


使用 HTTP 資料收集器 API 將記錄資料傳送至 Log Analytics

Azure Log Analytics HTTP 資料收集器 API 可讓您從任何可呼叫 REST API 的用戶端將 JSON 資料 POST 至 Log Analytics 工作區。 透過使用此方法,您可以從協力廠商應用程式或腳本傳送資料,例如從 Azure 自動化 中的 Runbook

要求 URI

若要指定 Log Analytics 工作區,請將 {CustomerID} 取代為您工作區的識別碼。

方法 要求 URI
郵寄 HTTPs://{CustomerID}.ods.opinsights.azure.com/ < Resource > ?api-version=2016-04-01
要求 URI 參數
參數 描述
CustomerID Log Analytics 工作區的唯一識別碼
資源 API 資源名稱。 /api/logs
API 版本 要與此要求搭配使用的 API 版本。 目前 2016-04-01

要求標頭

下表列出必要的要求標頭。

標頭 描述
授權 請參閱下列有關建立 HMAC-SHA256 標頭的其他資訊
Content-Type 必要。 將此設定為 application/json
Log-Type 可讓您指定正在提交之訊息的名稱。 目前,記錄類型僅支援 Alpha 字元。 它不支援數值或特殊字元
x-ms-date 要求以 RFC 1123 格式處理的日期
time-generated-field 可讓您指定訊息的時間戳記欄位,以做為 TimeGenerated 欄位。 這可讓您設定 TimeGenerated,以反映來自訊息資料的實際時間戳。 如果未指定此欄位,則擷取訊息時,TimeGenerated 的預設值。 指定的訊息欄位應遵循 YYYY-MM-DDThh:mm:ssZ 的 ISO 8601

驗證標頭

對 Log Analytics HTTP 資料收集器 API 的任何要求都必須包含授權標頭。 若要驗證要求,您必須使用發出要求之工作區的主要或次要金鑰簽署要求,並在要求中傳遞該簽章。

授權標頭的格式如下所示:

Authorization: SharedKey <WorkspaceID>:<Signature>

WorkspaceID 是 Log Analytics 工作區的唯一識別碼, 而 Signature 是雜湊型訊息驗證碼 (HMAC) 使用 SHA256 演算法建構,然後使用 SHA256 演算法來計算,然後使用 Base64 編碼進行編碼。

建構簽章字串

若要編碼共用金鑰簽章字串,請使用下列格式:

	StringToSign = VERB + "\n" +
	Content-Length + "\n" +
	Content-Type + "\n" +
	x-ms-date + "\n" +
	"/api/logs";

下列範例顯示簽章字串:

POST \n1024\napplication/json\nx-ms-date:Mon, 04 Apr 2016 08:00:00 GMT\n/api/logs

接下來,透過 UTF-8 編碼簽章字串使用 HMAC-SHA256 演算法來編碼此字串、建構授權標頭,並將標頭新增至要求。

對簽章進行編碼

若要對簽章進行編碼,請對 UTF-8 編碼的簽章字串呼叫 HMAC-SHA256 演算法,並將結果編碼為 Base64。 請使用下列格式 (顯示為虛擬程式碼):

Signature=Base64(HMAC-SHA256(UTF8(StringToSign)))

要求本文

提交至端點之訊息的本文。

	{
	  "key1": "value1",
	  "key2": "value2",
	  "key3": "value3",
	  "key4": "value4"
	}

您可以將相同類型的多個訊息批次處理成單一要求本文。

	[
	  {
	    "key1": "value1",
	    "key2": "value2",
	    "key3": "value3",
	    "key4": "value4"
	  },
	  {
	    "key1": "value5",
	    "key2": "value6",
	    "key3": "value7",
	    "key4": "value8"
	  }
	]

資料限制

在張貼至 Log Analytics 資料收集 API 的資料上有一些限制。

  • 可張貼至 Log Analytics 資料收集 API 的每個張貼項目大小上限為 30 MB。 這是單一張貼項目的大小限制。 如果資料是來自超出 30 MB 的單一張貼項目,您應該將資料分割成較小區塊,然後同時傳送它們。
  • 欄位值的大小上限為 32 KB。 如果欄位值大於 32 KB,資料將會被截斷。
  • 指定類型欄位的建議數目上限為 50。 對於使用性和搜尋體驗觀點而言,這是一個實際的限制。

另請參閱