Naplóadatok küldése a Log Analyticsbe a HTTP Data Collector API-val
Az Azure Log Analytics HTTP Data Collector API lehetővé teszi JSON-adatok közzétételét egy Log Analytics-munkaterületre bármely olyan ügyfélről, amely meghívhatja a REST API-t. Ezzel a módszerrel adatokat küldhet külső alkalmazásokból vagy szkriptekből, például egy Azure Automation
Kérés URI-ja
A Log Analytics-munkaterület megadásához cserélje le a(z) {CustomerID} kifejezést a munkaterület azonosítójára.
| Metódus | Kérés URI-ja |
|---|---|
| Közzététel | https://{CustomerID}.ods.opinsights.azure.com/< Resource>?api-version=2016-04-01 |
| Kérés | URI-paraméterek |
|---|---|
| Paraméter | Leírás |
| CustomerID | A Log Analytics-munkaterület egyedi azonosítója |
| Erőforrás | API-erőforrás neve. /api/logs |
| API-verzió | A kéréshez használni kívánt API verziója. Jelenleg 2016-04-01 |
Kérésfejlécek
Az alábbi táblázatban található kérelemfejlécekre van szükség.
| Fejléc | Description |
|---|---|
| Engedélyezés | További információ a HMAC-SHA256 fejléc létrehozásáról |
| Content-Type | Kötelező. Állítsa be ezt application/json értékre |
| Log-Type | Lehetővé teszi a beküldött üzenet nevének megadását. A naplótípus jelenleg csak az alfa karaktereket támogatja. Nem támogatja a numerikus vagy speciális karaktereket |
| x-ms-date | A kérelem RFC 1123 formátumú feldolgozásának dátuma |
| time-generated-field | Lehetővé teszi az üzenet időbélyegző mezőjének megadását, amelyet a TimeGenerated mezőként használ. Ez lehetővé teszi a TimeGenerated konfigurálását úgy, hogy az tükrözze az üzenetadatok tényleges időbélyegét. Ha ez a mező nincs megadva, az üzenet betöltésekor a TimeGenerated alapértelmezett értéke. A megadott üzenetmezőnek az YYYY-MM-DDThh:mm:ssZ ISO 8601 szabványát kell követnie |
Engedélyezési fejléc
A Log Analytics HTTP Data Collector API-nak küldött kérésnek tartalmaznia kell az Engedélyezési fejlécet. A kérés hitelesítéséhez alá kell írnia a kérést a kérelmet küldő munkaterület elsődleges vagy másodlagos kulcsával, és a kérés részeként át kell adnia az aláírást.
Az Engedélyezési fejléc formátuma a következő:
Authorization: SharedKey <WorkspaceID>:<Signature>
A WorkspaceID a Log Analytics-munkaterület egyedi azonosító azonosítója, az Aláírás pedig egy kivonatalapú üzenethitelesítési kód (HMAC), amely a kérelemből lett létrehozva, és az SHA256 algoritmus használatával lett kiszámítva, majd Base64 kódolással kódolva.
Az aláírási sztring létrehozása
A megosztott kulcs aláírási sztringjének kódolásához használja a következő formátumot:
StringToSign = VERB + "\n" +
Content-Length + "\n" +
Content-Type + "\n" +
x-ms-date + "\n" +
"/api/logs";
Az alábbi példa egy aláírási sztringet mutat be:
POST \n1024\napplication/json\nx-ms-date:Mon, 04 Apr 2016 08:00:00 GMT\n/api/logs
Ezután kódolja ezt a sztringet a HMAC-SHA256 algoritmussal az UTF-8 kódolású aláírási sztringen keresztül, hozza létre az Engedélyezési fejlécet, és adja hozzá a fejlécet a kérelemhez.
Az aláírás kódolása
Az aláírás kódolásához hívja meg a HMAC-SHA256 algoritmust az UTF-8 kódolású aláírási sztringen, és kódolja az eredményt Base64-ként. Használja a következő formátumot (pszeudokódként jelenik meg):
Signature=Base64(HMAC-SHA256(UTF8(StringToSign)))
A kérés törzse
A végpontra küldött üzenet törzse.
{
"key1": "value1",
"key2": "value2",
"key3": "value3",
"key4": "value4"
}
Több, azonos típusú üzenetet egyetlen kérelemtörzsbe köthet.
[
{
"key1": "value1",
"key2": "value2",
"key3": "value3",
"key4": "value4"
},
{
"key1": "value5",
"key2": "value6",
"key3": "value7",
"key4": "value8"
}
]
Adatkorlátok
A Log Analytics adatgyűjtési API-nak közzétett adatokra bizonyos korlátozások vannak kitéve.
- A Log Analytics Data Collector API-nak küldött bejegyzésenként legfeljebb 30 MB. Ez egy bejegyzés méretkorlátja. Ha egy 30 MB-ot meghaladó bejegyzésből származó adatok, az adatokat kisebb méretű adattömbökre kell felosztani, és egyidejűleg elküldeni őket.
- A mezőértékek maximális mérete 32 kB. Ha a mezőérték nagyobb 32 kB-nál, az adatok csonkolva lesznek.
- Egy adott típushoz tartozó mezők ajánlott maximális száma 50. Ez az észszerű korlát a használati és keresési teljesítmény szempontjából.