Sdílet prostřednictvím

Odesílání dat protokolu do Log Analytics pomocí rozhraní API kolekce dat HTTP

Rozhraní API kolekce dat HTTP služby Azure Log Analytics umožňuje odesílat data JSON do pracovního prostoru služby Log Analytics z libovolného klienta, který může volat rozhraní REST API. Pomocí této metody můžete odesílat data z aplikací třetích stran nebo ze skriptů, například z runbooku v Azure Automation

Požadavek na URI

Pokud chcete zadat pracovní prostor služby Log Analytics, nahraďte {CustomerID} ID vašeho pracovního prostoru.

Metoda Požadavek na URI
Příspěvek https://{CustomerID}.ods.opinsights.azure.com/< Resource>?api-version=2016-04-01
Žádost Parametry identifikátoru URI
Parameter Popis
identifikátor zákazníka Jedinečný identifikátor pracovního prostoru služby Log Analytics
Zdroj Název prostředku rozhraní API. /api/logs
Verze rozhraní API Verze rozhraní API, které má být použito s tímto požadavkem. Aktuálně 2016-04-01

Hlavičky žádosti

Hlavičky požadavku v následující tabulce jsou povinné.

Záhlaví Popis
Autorizace Další informace o vytvoření záhlaví HMAC-SHA256 naleznete níže
Typ obsahu Povinné. Nastavte na application/json
Typ protokolu Umožňuje zadat název odesílané zprávy. V současné době typ protokolu podporuje pouze znaky alfa. Nepodporuje číslice ani speciální znaky
x-ms-datum Datum, kdy byla žádost zpracována ve formátu RFC 1123
pole vygenerované časem Umožňuje určit pole časového razítka zprávy, které se použije jako pole TimeGenerated. To vám umožní nakonfigurovat TimeGenerated tak, aby odrážel skutečné časové razítko z dat zprávy. Pokud toto pole není zadané, použije se výchozí hodnota TimeGenerated při ingestování zprávy. Zadané pole zprávy by mělo odpovídat normě ISO 8601 z RRRR-MM-DDThh:mm:ssZ

Autorizační hlavička

Každý požadavek na rozhraní API kolekce dat HTTP služby Log Analytics musí obsahovat hlavičku Authorization. Chcete-li ověřit požadavek, musíte požadavek podepsat buď primárním, nebo sekundárním klíčem pro pracovní prostor, který požadavek vytváří, a předat tento podpis jako součást žádosti.

Formát hlavičky Authorization je následující:

Authorization: SharedKey <WorkspaceID>:<Signature>

WorkspaceID je jedinečný identifikátor pro pracovní prostor služby Log Analytics a podpis je ověřovací kód zprávy založený na hodnotě hash (HMAC) vytvořený z požadavku a vypočítaný pomocí algoritmu SHA256 a poté zakódovaný pomocí kódování Base64.

Vytvoření řetězce podpisu

Chcete-li zakódovat řetězec podpisu sdíleného klíče, použijte následující formát:

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

Následující příklad ukazuje řetězec podpisu:

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

Dále tento řetězec zakódujte pomocí algoritmu HMAC-SHA256 přes řetězec podpisu s kódováním UTF-8, vytvořte hlavičku Authorization a přidejte hlavičku do požadavku.

Kódování podpisu

Chcete-li podpis zakódovat, zavolejte algoritmus HMAC-SHA256 na řetězec podpisu s kódováním UTF-8 a výsledek zakódujte jako Base64. Použijte následující formát (zobrazený jako pseudokód):

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

Obsah požadavku

Text zprávy odeslané do koncového bodu.

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

Můžete dávkovat více zpráv stejného typu do jednoho textu požadavku.

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

Omezení dat

Data publikovaná do rozhraní API pro shromažďování dat Log Analytics mají určitá omezení.

  • Maximálně 30 MB na příspěvek do rozhraní API kolekce dat Log Analytics. Toto je limit velikosti pro jeden příspěvek. Pokud jsou data z jednoho příspěvku větší než 30 MB, měli byste data rozdělit na menší části a odeslat je souběžně.
  • Maximální limit pro hodnoty polí je 32 kB. Pokud je hodnota pole větší než 32 kB, data budou zkrácena.
  • Doporučený maximální počet polí daného typu je 50. Jedná se o praktický limit z hlediska použitelnosti a vyhledávání.

Viz také

  • Last updated on