Storage Analytics-naplóformátum
Storage Analytics naplózása a tárfiók sikeres és sikertelen kéréseinek adatait is rögzíti. Storage Analytics naplók lehetővé teszik az Azure-táblákon, üzenetsorokon és blobokon végzett olvasási, írási és törlési műveletek részleteit. Emellett lehetővé teszik a sikertelen kérések okainak, például az időtúllépések, a szabályozás és az engedélyezési hibák kivizsgálását.
Minden naplóbejegyzés egy szabványos naplóformátumnak felel meg, amelyet a használatban Storage Analytics naplózási verziója szabályoz. Az 1.0-s verzió tartalmazza az 1.0-s naplóbejegyzési formátumban leírt összes mezőt. A 2.0-s verzió mezőket ad a kérelmek naplózásához az OAuth 2.0-jogkivonattal engedélyezett Blob- és Queue-szolgáltatásokhoz. Ezeket a további mezőket a 2.0-s naplóbejegyzési formátum ismerteti.
A naplóbejegyzés első mezője mindig megadja a verziószámot. A naplózási adatok felhasználói ezen a mezőn, valamint a naplóbejegyzések következő aspektusaitól függhetnek:
A kitöltött vagy üres mezőket pontosvessző választja el egymástól: ";"
Minden naplóbejegyzést egy "\n" karakter választ el egymástól
A bejegyzés utolsó mezője nem végződik pontosvesszővel (;)
Naplóbejegyzés feldolgozása előtt mindig ellenőrizze a verziót.
Megjegyzés
Minden olyan mező, amely idézőjelet ("), pontosvesszőt (;) vagy új vonalat (\n) tartalmaz, HTML kódolású és idézőjeles.
Naplózási verzió beállítása
A naplózási verzió beállításához hívja meg a szolgáltatásnak megfelelő műveletet:
- Blobszolgáltatás:Blobszolgáltatás tulajdonságainak beállítása (az 1.0-s és a 2.0-s verziót is támogatja)
- Üzenetsor-szolgáltatás:Várólista-szolgáltatás tulajdonságainak beállítása (az 1.0-s és a 2.0-s verziót is támogatja)
- Table service:Táblaszolgáltatás tulajdonságainak beállítása (csak az 1.0-s verziót támogatja)
Naplóbejegyzés formátuma 1.0
Minden 1.0-s verziójú naplóbejegyzés a következő formátumhoz igazodik:
<version-number>;<request-start-time>;<operation-type>;<request-status>;<http-status-code>;<end-to-end-latency-in-ms>;<server-latency-in-ms>;<authentication-type>;<requester-account-name>;<owner-account-name>;<service-type>;<request-url>;<requested-object-key>;<request-id-header>;<operation-count>;<requester-ip-address>;<request-version-header>;<request-header-size>;<request-packet-size>;<response-header-size>;<response-packet-size>;<request-content-length>;<request-md5>;<server-md5>;<etag-identifier>;<last-modified-time>;<conditions-used>;<user-agent-header>;<referrer-header>;<client-request-id>
Az 1.0-s verzió naplóbejegyzési mezői
Az alábbi táblázat egy 1.0-s verziójú naplóbejegyzés mezőit sorolja fel és határozza meg.
| Mezőnév | Mező típusa | Definíció | Példa |
|---|---|---|---|
<version-number> |
sztring | A bejegyzés rögzítéséhez használt Storage Analytics naplózás verziója. | 1.0 |
<request-start-time> |
időbélyeg | A kérelem Storage Analytics által történő fogadásának időpontja UTC-ben. | 2011-08-09T21:44:36.2481552Z |
<operation-type> |
sztring | A végrehajtott REST-művelet típusa. A lehetséges műveletek listáját a naplózott műveletek és állapotüzenetek Storage Analytics témakörében találja. | GetBlob |
<request-status> |
sztring | A kért művelet állapota. A lehetséges állapotüzenetek listáját a naplózott műveletek és állapotüzenetek Storage Analytics témakörben találja. A 2017-04-17-es és újabb ClientOtherError verziókban nem használatos. Ehelyett ez a mező tartalmazza a hibakódot. |
Success |
<http-status-code> |
sztring | A kérelem HTTP-állapotkódja. Ha a kérés megszakad, ez az érték a következőre állítható be Unknown: . |
200 |
<end-to-end-latency-in-ms> |
duration | A kért művelet végrehajtásához szükséges teljes idő ezredmásodpercben, beleértve a bejövő kérés olvasásának és a válasznak a kérelmezőnek való elküldéséhez szükséges időt. | 39 |
<server-latency-in-ms> |
duration | A kért művelet végrehajtásához szükséges teljes idő ezredmásodpercben. Ez az érték nem tartalmazza a hálózati késést (a bejövő kérés olvasásának és a válasz kérésének elküldéséhez szükséges idő). | 22 |
<authentication-type> |
sztring | Azt jelzi, hogy a kérelem engedélyezett, névtelen vagy használt megosztott hozzáférésű jogosultságkód (SAS) volt-e. | authenticated |
<requester-account-name> |
sztring | Ugyanaz, mint a tárfiók neve, ha a kérés engedélyezve van. Ez a mező üres lesz névtelen és SAS-kérések esetén. | myaccount |
<owner-account-name> |
sztring | A szolgáltatástulajdonos fiókneve. | myaccount |
<service-type> |
sztring | A kért tárolási szolgáltatás: blob, tábla vagy üzenetsor. | blob |
<request-url> |
sztring | A kérelem teljes URL-címe idézőjelek között. | "https://myaccount.blob.core.windows.net/mycontainer/2025c44c-d25e-42bf-8507-7a5ca4faa034?timeout=30000" |
<requested-object-key> |
sztring | A kért objektum kulcsa idézőjelekben. Ez a mező mindig a fiók nevét fogja használni, még akkor is, ha egyéni tartománynév van konfigurálva. | "/myaccount/mycontainer/2025c44c-d25e-42bf-8507-7a5ca4faa034" |
<request-id-header> |
guid | A tárolási szolgáltatás által hozzárendelt kérelemazonosító. Ez egyenértékű a fejléc értékével x-ms-request-id . |
668a4744-7eb3-4e8f-b8d3-fbfd3829715b |
<operation-count> |
int | A kérések naplózott műveleteinek száma nulla index használatával. Egyes kérések több műveletet igényelnek, például a Blob másolása műveletet, bár a legtöbben csak egy műveletet hajtanak végre. | 0 |
<requester-ip-address> |
sztring | A kérelmező IP-címe, a portszámmal együtt. | 192.100.0.102:4362 |
<request-version-header> |
sztring | A kéréskor megadott tárolási szolgáltatás verziója. Ez egyenértékű a fejléc értékével x-ms-version . |
2009-09-19 |
<request-header-size> |
hosszú | A kérelem fejlécének mérete bájtban. Ha egy kérés sikertelen, ez az érték üres lehet. | 280 |
<request-packet-size> |
hosszú | A társzolgáltatás által beolvasott kérelemcsomagok mérete bájtban. Ha egy kérés sikertelen, ez az érték üres lehet. | 0 |
<response-header-size> |
hosszú | A válaszfejléc mérete bájtban. Ha egy kérés sikertelen, ez az érték üres lehet. | 216 |
<response-packet-size> |
hosszú | A tárolási szolgáltatás által írt válaszcsomagok mérete bájtban. Ha egy kérés sikertelen, ez az érték üres lehet. | 0 |
<request-content-length> |
hosszú | A tárolási szolgáltatásnak küldött kérelem fejlécének értéke Content-Length . Ha a kérés sikeres volt, ez az érték egyenlő a következő értékkel <request-packet-size>: . Ha egy kérés sikertelen, akkor ez az érték nem lehet egyenlő a <request-packet-size>értékkel, vagy üres lehet. |
0 |
<request-md5> |
sztring | A Content-MD5 fejléc vagy az x-ms-content-md5 fejléc értéke a kérelemben, idézőjelekben. Az ebben a mezőben megadott MD5 kivonatérték a kérelem tartalmát jelöli. Ez a mező üres lehet. | "788815fd0198be0d275ad329cafd1830" |
<server-md5> |
sztring | A tárolási szolgáltatás által kiszámított MD5 kivonat értéke idézőjelekben. Ez a mező üres lehet. | "3228b3cf1069a5489b298446321f8521" |
<etag-identifier> |
sztring | A visszaadott objektum ETag-azonosítója idézőjelekben. | "0x8D101F7E4B662C4" |
<last-modified-time> |
dátum/idő | A visszaadott objektum utolsó módosítási időpontja (LMT) idézőjelekben. Ez a mező üres olyan műveleteknél, amelyek több objektumot is vissza tudnak adni. | Tuesday, 09-Aug-11 21:13:26 GMT |
<conditions-used> |
sztring | Pontosvesszővel tagolt lista idézőjelek formájában ConditionName=value.
ConditionName a következő feltételek egyike lehet:- If-Modified-Since- If-Unmodified-Since- If-Match- If-None-Match |
"If-Modified-Since=Friday, 05-Aug-11 19:11:54 GMT" |
<user-agent-header> |
sztring | A User-Agent fejléc értéke idézőjelekben. |
"Mozilla/5.0 (compatible; MSIE 9.0; Windows NT 6.1; WOW64; Trident/5.0)" |
<referrer-header> |
sztring | A Referer fejléc értéke idézőjelekben. |
"http://contoso.com/about.html" |
<client-request-id> |
sztring | A x-ms-client-request-id kérelemben szereplő fejlécérték idézőjelekben. |
"8/9/2011 9:44:36 PM 45ef1c0f-8c71-4153-bc88-38589f63fbfc" |
Mintanapló-bejegyzések az 1.0-s verzióhoz
Blob lekérése
A következő mintanapló-bejegyzés egy névtelen GetBlob-kérelemre vonatkozik:
1.0;2014-06-19T22:59:23.1967767Z;GetBlob;AnonymousSuccess;200;17;16;anonymous;;storagesample;blob;"https://storagesample.blob.core.windows.net/sample-container1/00001.txt";"/storagesample/sample-container1/00001.txt";61d2e3f6-bcb7-4cd1-a81e-4f8f497f0da2;0;192.100.0.102:4362;2014-02-14;283;0;354;23;0;;;""0x8D15A2913C934DE"";Thursday, 19-Jun-14 22:58:10 GMT;;"WA-Storage/4.0.1 (.NET CLR 4.0.30319.34014; Win32NT 6.3.9600.0)";;"44dfd78e-7288-4898-8f70-c3478983d3b6"
Put Blob
A következő mintanapló-bejegyzés egy engedélyezett PutBlob-kérelemre vonatkozik:
1.0;2014-06-19T01:33:54.0926521Z;PutBlob;Success;201;197;54;authenticated;storagesample;storagesample;blob;"https://storagesample.blob.core.windows.net/sample-container1/00001.txt";"/storagesample/sample-container1/00001.txt";a200be85-1c98-4dd9-918e-f13d8c0538e0;0;192.100.0.102:4362;2014-02-14;460;23;225;0;23;"DrPO6z1f00SCsomhaf+J/A==";"DrPO6z1f00SCsomhaf+J/A==";""0x8D15975AA456EA4"";Thursday, 19-Jun-14 01:33:53 GMT;;"WA-Storage/4.0.1 (.NET CLR 4.0.30319.34014; Win32NT 6.3.9600.0)";;"1fe6814a-e4cb-4195-a3cf-837dc7120f68"
Copy Blob
Az alábbi mintanapló-bejegyzések egy engedélyezett CopyBlob-kérelemre vonatkoznak . A Blob másolása művelet 3 műveletet naplóz: CopyBlob, CopyBlobSource és CopyBlobDestination. Vegye figyelembe, hogy a kérelemazonosító tulajdonság mindhárom művelet esetében azonos, de a műveletazonosító minden műveletnél növekszik.
2012-02-12-es és újabb verzió
A 2012-02-12-es és újabb verziókban az <requested-object-key> URL-cím helyettesíti a /accountname/containername/blobname 2012-02-12 előtti verziókban használt formátumot.
A kérelemazonosító és a műveletazonosító félkövér betűvel van meg összhangban az alábbi naplóbejegyzésekhez:
1.0;2014-06-19T23:31:36.5780954Z;CopyBlob;Success;202;13;13;authenticated;storagesample;storagesample;blob;"https://storagesample.blob.core.windows.net/sample-container/Copy-sample-blob.txt";"/storagesample/sample-container/Copy-sample-blob.txt";505fc366-688f-4622-bbb1-20e8fc26cffd;0;192.100.0.102:4362;2014-02-14;538;0;261;0;0;;;""0x8D15A2DBF11553E"";Thursday, 19-Jun-14 23:31:36 GMT;;"WA-Storage/4.0.1 (.NET CLR 4.0.30319.34014; Win32NT 6.3.9600.0)";;"dc00da87-5483-4524-b0dc-d1df025a6a9a"
1.0;2014-06-19T23:31:36.5780954Z;CopyBlobSource;Success;202;13;13;authenticated;storagesample;storagesample;blob;"https://storagesample.blob.core.windows.net/sample-container/Copy-sample-blob.txt";"https://storagesample.blob.core.windows.net/sample-container/sample-blob.txt";505fc366-688f-4622-bbb1-20e8fc26cffd;1;192.100.0.102:4362;2014-02-14;538;0;261;0;0;;;;;;"WA-Storage/4.0.1 (.NET CLR 4.0.30319.34014; Win32NT 6.3.9600.0)";;"dc00da87-5483-4524-b0dc-d1df025a6a9a"
1.0;2014-06-19T23:31:36.5780954Z;CopyBlobDestination;Success;202;13;13;authenticated;storagesample;storagesample;blob;"https://storagesample.blob.core.windows.net/sample-container/Copy-sample-blob.txt";"/storagesample/sample-container/Copy-sample-blob.txt";505fc366-688f-4622-bbb1-20e8fc26cffd;2;192.100.0.102:4362;2014-02-14;538;0;261;0;0;;;;;;"WA-Storage/4.0.1 (.NET CLR 4.0.30319.34014; Win32NT 6.3.9600.0)";;"dc00da87-5483-4524-b0dc-d1df025a6a9a"
Szolgáltatásverziók 2012-02-12 előtt
A kérelemazonosító és a műveletazonosító félkövér betűvel van meg összhangban az alábbi naplóbejegyzésekhez:
1.0;2011-08-09T18:02:40.6526789Z;CopyBlob;Success;201;28;28;authenticated;account8ce1b67a9e80b35;myaccount;blob;"https://myaccount.blob.core.windows.net/thumbnails/lake.jpg?timeout=30000";"/myaccount/thumbnails/lakebck.jpg";85ba10a5-b7e2-495e-8033-588e08628c5d;0;268.20.203.21:4362;2009-09-19;505;0;188;0;0;;;"0x8CE1B67AD473BC5";Friday, 09-Aug-11 18:02:40 GMT;;;;"8/9/2011 6:02:40 PM 683803d3-538f-4ba8-bc7c-24c83aca5b1a"
1.0;2011-08-09T18:02:40.6526789Z;CopyBlobSource;Success;201;28;28;authenticated;myaccount;myaccount;blob;"https://myaccount.blob.core.windows.net/thumbnails/lake.jpg?timeout=30000";"/myaccount/thumbnails/lake.jpg";85ba10a5-b7e2-495e-8033-588e08628c5d;1;268.20.203.21:4362;2009-09-19;505;0;188;0;0;;;;;;;;"8/9/2011 6:02:40 PM 683803d3-538f-4ba8-bc7c-24c83aca5b1a"
1.0;2011-08-09T18:02:40.6526789Z;CopyBlobDestination;Success;201;28;28;authenticated;myaccount;myaccount;blob;"https://myaccount.blob.core.windows.net/thumbnails/lake.jpg?timeout=30000";"/myaccount/thumbnails/lakebck.jpg";85ba10a5-b7e2-495e-8033-588e08628c5d;2;268.20.203.21:4362;2009-09-19;505;0;188;0;0;;;;;;;;"8/9/2011 6:02:40 PM 683803d3-538f-4ba8-bc7c-24c83aca5b1a"
Naplóbejegyzés formátuma 2.0
Storage Analytics naplóformátum 2.0-s verziója mezőket ad hozzá a Microsoft Entra ID által biztosított OAuth 2.0-jogkivonattal engedélyezett kérelmek naplózási információinak támogatásához. További információ: Hitelesítés Microsoft Entra ID.
Minden 2.0-s verziójú naplóbejegyzés a következő formátumnak felel meg:
<version-number>;<request-start-time>;<operation-type>;<request-status>;<http-status-code>;<end-to-end-latency-in-ms>;<server-latency-in-ms>;<authentication-type>;<requester-account-name>;<owner-account-name>;<service-type>;<request-url>;<requested-object-key>;<request-id-header>;<operation-count>;<requester-ip-address>;<request-version-header>;<request-header-size>;<request-packet-size>;<response-header-size>;<response-packet-size>;<request-content-length>;<request-md5>;<server-md5>;<etag-identifier>;<last-modified-time>;<conditions-used>;<user-agent-header>;<referrer-header>;<client-request-id>;<user-object-id>;<tenant-id>;<application-id>;<audience>;<issuer>;<user-principal-name>;<reserved-field>;<authorization-detail>
A 2.0-s verzió naplóbejegyzési mezői
Az alábbi táblázat felsorolja és meghatározza a 2.0-s verziójú naplóbejegyzésbe írt további mezőket. A 2.0-s verzió naplóbejegyzései az 1.0-s verzió összes mezőjét tartalmazzák.
| Mezőnév | Mező típusa | Definíció | Példa |
|---|---|---|---|
| UserObjectId | sztring | A hitelesítéshez használt objektumazonosító. Lehet bármilyen rendszerbiztonsági tag, beleértve a felhasználót, a felügyelt identitást vagy a szolgáltatásnevet. | 03124200-da00-4aa6-aa09-be77923d7870 |
| TenantId | sztring | A tulajdonos engedélyezéséhez használt bérlőazonosító. | 72f988bf-86f1-41af-91ab-2d7cd011db47 |
| ApplicationId | sztring | A tulajdonosi engedélyezéshez használt alkalmazásazonosító. | 2cd20493-fe97-42ef-9ace-ab95b63d82c4 |
| Erőforrás-azonosító | sztring | A tulajdonos engedélyezéséhez használt erőforrás-azonosító. | https://storage.azure.comhttps://storagesamples.blob.core.windows.net |
| Kiállító | sztring | A tulajdonosi engedélyezéshez használt kibocsátó. | https://sts.windows.net/72f988bf-86f1-41af-91ab-2d7cd011db47/ |
| UserPrincipalName | sztring | A tulajdonos engedélyezéséhez használt egyszerű felhasználónév. | testuser@azure.onmicrosoft.com |
| Fenntartva | sztring | Jövőbeli használatra fenntartva. Az érték egy üres sztring. | N/A |
| AuthorizationDetail | sztring | A kérelem engedélyezéséhez használt részletes szabályzatinformációk. | [{"action":"Microsoft.Storage/storageAccounts/blobServices/containers/read", "roleAssignmentId":"/subscriptions/5451a164-d870-4626-a64c-c38d62da20da/providers/Microsoft.Authorization/roleAssignments/6632a082-9b6a-486c-b296-f9d785d32800", "roleDefinitionId":"/subscriptions/5451a164-d870-4626-a64c-c38d62da20da/providers/Microsoft.Authorization/roleDefinitions/ba92f5b4-2d11-453d-a403-e96b0029c9fe", "principalId":"03124200-da00-4aa6-aa09-be77923d7870", "principalType":"ServicePrincipal"}] |
Mintanapló-bejegyzések a 2.0-s verzióhoz
Blobok listázása
2.0;2019-02-25T20:06:55.9794046Z;ListBlobs;OAuthSuccess;200;250;46;bearer;storagesamples;storagesamples;blob;"https://storagesamples.blob.core.windows.net/sample-container?restype=container&comp=list&prefix=&delimiter=/&marker=&maxresults=30&include=metadata&_=1551125215793";"/storagesamples/sample-container";470b9e55-201e-0137-5c45-cdd293000000;0;200.59.21.176:52659;2018-03-28;2682;0;295;5184;0;;;;;;"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/64.0.3282.140 Safari/537.36 Edge/18.17763";"blob:https://ms.portal.azure.com/cf576432-66ab-4ae6-9cb3-4852b1137a21";;"e5981635-dcf0-4279-ab7b-ca1cbdf4a5c7";"72f988bf-86f1-41af-91ab-2d7cd011db47";"691458b9-1327-4635-9f55-ed83a7f1b41c";"https://storage.azure.com/";"https://sts.windows.net/72f988bf-86f1-41af-91ab-2d7cd011db47/";;;"[{"action":"Microsoft.Storage/storageAccounts/blobServices/containers/blobs/read", "roleAssignmentId":"ca8af92a-6708-4cdf-a678-bb55d0ff7b80", "roleDefinitionId":"ba92f5b4-2d11-453d-a403-e96b0029c9fe", "principalId":"e5981635-dcf0-4279-ab7b-ca1cbdf4a5c7", "principalType":"User"}]"
Blokk elhelyezése
2.0;2019-02-25T20:06:55.9089848Z;PutBlock;OAuthSuccess;201;95;95;bearer;storagesamples;storagesamples;blob;"https://storagesamples.blob.core.windows.net/sample-container/blob1.txt?comp=block&blockid=YmxvY2stMDAwMDAwMDA=";"/storagesamples/sample-container/blob1.txt";5569fa10-e01e-00c0-2745-cdb22d000000;0;200.59.21.176:52665;2017-11-09;2581;9;365;0;9;;"tdzGO9AaJte/e2HJZLtXig==";;;;"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/64.0.3282.140 Safari/537.36 Edge/18.17763";"https://ms.portal.azure.com/";"c808142e-0393-4942-9001-af4833061026";"e5981635-dcf0-4279-ab7b-ca1cbdf4a5c7";"72f988bf-86f1-41af-91ab-2d7cd011db47";"691458b9-1327-4635-9f55-ed83a7f1b41c";"https://storage.azure.com/";"https://sts.windows.net/72f988bf-86f1-41af-91ab-2d7cd011db47/";;;"[{"action":"Microsoft.Storage/storageAccounts/blobServices/containers/blobs/write", "roleAssignmentId":"ca8af92a-6708-4cdf-a678-bb55d0ff7b80", "roleDefinitionId":"ba92f5b4-2d11-453d-a403-e96b0029c9fe", "principalId":"e5981635-dcf0-4279-ab7b-ca1cbdf4a5c7", "principalType":"User"}]"
Lásd még
Tudnivalók a Storage Analytics naplózásáról
naplózott műveletek és állapotüzenetek Storage Analytics