Azure Storage Analytics-naplózás
A Storage Analytics naplózza a tárolási szolgáltatásoknak elküldött sikeres és sikertelen kérelmek részletes információit. Ezekkel az információkkal monitorozhatók az egyes kérelmek és diagnosztizálhatók a tárolási szolgáltatások problémái. A kérések naplózása a legjobb munkamennyiség alapján történik. Ez azt jelenti, hogy a legtöbb kérés naplórekordot eredményez, de a Storage Analytics naplók teljessége és ütemterve nem garantált.
Megjegyzés
Javasoljuk, hogy az Azure Storage-naplókat az Azure Monitorban használja Storage Analytics naplók helyett. További információért tekintse meg az alábbi cikkek bármelyikét:
A Storage Analytics-naplózás alapértelmezés szerint nincs engedélyezve a Storage-fiókjához. Ezt a Azure Portal vagy a PowerShell vagy az Azure CLI használatával engedélyezheti. Részletes útmutatásért lásd: Azure-Storage Analytics-naplók (klasszikus) engedélyezése és kezelése.
A Storage Analytics naplókat programozott módon is engedélyezheti a REST API-val vagy az ügyfélkódtár használatával. A Blob szolgáltatás tulajdonságainak lekérése, a Queue Szolgáltatás tulajdonságainak lekérése és a Table Service tulajdonságainak lekérése művelettel engedélyezheti az egyes szolgáltatások Storage Analytics. Ha egy példát szeretne látni, amely engedélyezi Storage Analytics naplókat a .NET használatával, tekintse meg a Naplók engedélyezése című témakört.
A naplóbejegyzések csak akkor jönnek létre, ha a szolgáltatásvégponton kérések vannak. Ha például egy tárfiók tevékenységgel rendelkezik a blobvégpontján, de a tábla- vagy üzenetsorvégpontokban nem, akkor csak a Blob szolgáltatáshoz tartozó naplók jönnek létre.
Megjegyzés
A Storage Analytics-naplózás jelenleg csak a Blob, a Queue és a Table szolgáltatás esetében érhető el. Storage Analytics naplózás prémium szintű BlockBlobStorage-fiókokhoz is elérhető. Ez azonban nem érhető el a prémium teljesítményű, általános célú v2-fiókokhoz.
Bejelentkezett kérések naplózása
Hitelesített kérések naplózása
A hitelesített kérések alábbi típusai vannak rögzítve:
Sikeres kérések
Sikertelen kérések, köztük az időtúllépések, torlódások, valamint a hálózati, hitelesítési és egyéb hibák
Közös hozzáférésű jogosultságkódot vagy OAuth-hitelesítést használó sikertelen és sikeres kérések
Elemzési adatokhoz kapcsolódó kérelmek
A Storage Analytics által küldött kérések, például a napló létrehozása vagy törlése, nincsenek naplózva. A naplózott adatok teljes listáját a naplózott műveletek és állapotüzenetek Storage Analytics és Storage Analytics Naplóformátum témakörökben találja.
Névtelen kérések naplózása
A rendszer a következő típusú névtelen kéréseket naplózza:
Sikeres kérések
Kiszolgálóhibák
Időtúllépési hibák az ügyfél és a kiszolgáló esetében
304-es (Nincs módosítva) hibakóddal ellátott sikertelen GET-kérések
A rendszer nem naplózza az összes többi sikertelen névtelen kérést. A naplózott adatok teljes listáját a naplózott műveletek és állapotüzenetek Storage Analytics és Storage Analytics Naplóformátum témakörökben találja.
Megjegyzés
Storage Analytics naplózza az adatsíkra irányuló összes belső hívást. A rendszer az Azure Storage erőforrás-szolgáltatótól érkező hívásokat is naplózza. A kérések azonosításához keresse meg a lekérdezési sztringet <sk=system-1>
a kérelem URL-címében.
A naplók tárolási módja
A rendszer minden naplót blokkblobokban tárol egy nevű $logs
tárolóban, amely automatikusan létrejön, ha Storage Analytics engedélyezve van egy tárfiókhoz. A $logs
tároló a tárfiók blobnévterében található, például: http://<accountname>.blob.core.windows.net/$logs
. Ez a tároló nem törölhető Storage Analytics engedélyezése után, bár tartalma törölhető. Ha a tárolóböngésző eszközzel közvetlenül navigál a tárolóhoz, akkor az összes olyan blobot látni fogja, amely tartalmazza a naplózási adatokat.
Megjegyzés
A $logs
tároló nem jelenik meg tárolólista-művelet végrehajtásakor, például a Tárolók listázása művelet végrehajtásakor. Ezt közvetlenül kell elérni. A Blobok listázása művelettel például elérheti a tárolóban lévő $logs
blobokat.
A kérések naplózása közben a Storage Analytics blokkként tölti fel a köztes eredményeket. A Storage Analytics rendszeres időközönként véglegesíti ezeket a blokkokat, és blobként elérhetővé teszi őket. Akár egy órát is igénybe vehet, hogy a naplóadatok megjelenjenek a $logs tároló blobjaiban, mivel a tárolási szolgáltatás kiüríti a naplóírókat. Ismétlődő rekordok létezhetnek az ugyanabban az órában létrehozott naplókhoz. A RequestId és a Művelet számának ellenőrzésével megállapíthatja, hogy egy rekord duplikált-e.
Ha óránként több fájllal rendelkező nagy mennyiségű naplóadattal rendelkezik, a blob metaadataival a blob metaadatainak vizsgálatával megállapíthatja, hogy a napló milyen adatokat tartalmaz. Ez azért is hasznos, mert az adatok naplófájlokba való írása néha késéssel is jár: a blob metaadatai pontosabban jelzik a blob tartalmát, mint a blob nevét.
A legtöbb tárolóböngésző eszköz lehetővé teszi a blobok metaadatainak megtekintését; Ezeket az információkat a PowerShell használatával vagy programozott módon is elolvashatja. Az alábbi PowerShell-kódrészlet egy példa a naplóblobok listájának név szerinti szűrésére egy időpont megadásához, valamint metaadatok alapján, hogy csak az írási műveleteket tartalmazó naplókat azonosítsák.
Get-AzStorageBlob -Container '$logs' |
Where-Object {
$_.Name -match 'blob/2014/05/21/05' -and
$_.ICloudBlob.Metadata.LogType -match 'write'
} |
ForEach-Object {
"{0} {1} {2} {3}" -f $_.Name,
$_.ICloudBlob.Metadata.StartTime,
$_.ICloudBlob.Metadata.EndTime,
$_.ICloudBlob.Metadata.LogType
}
További információ a blobok programozott módon történő listázásáról: Bloberőforrások számbavétele és Tulajdonságok és metaadatok beállítása és lekérése bloberőforrásokhoz.
Naplóelnevezési konvenciók
Minden napló a következő formátumban lesz megírva:
<service-name>/YYYY/MM/DD/hhmm/<counter>.log
Az alábbi táblázat a naplónévben szereplő attribútumokat ismerteti:
Attribútum | Leírás |
---|---|
<service-name> |
A tárolási szolgáltatás neve. Például: blob , table , vagy queue |
YYYY |
A napló négyjegyű éve. Például: 2011 |
MM |
A napló kétjegyű hónapja. Például: 07 |
DD |
A napló kétjegyű napja. Például: 31 |
hh |
A naplók kezdő óráját jelző kétjegyű óra 24 órás UTC formátumban. Például: 18 |
mm |
A naplók kezdő percét jelző kétjegyű szám.
Megjegyzés: Ez az érték nem támogatott a Storage Analytics aktuális verziójában, és az értéke mindig a lesz00 . |
<counter> |
Nulla alapú számláló hat számjegyből, amely a tárolási szolgáltatáshoz egy óra alatt létrehozott naplóblobok számát jelzi. Ez a számláló a következő időponttól 000000 kezdődik: . Például: 000001 |
Az alábbiakban egy teljes mintanapló-nevet láthat, amely a fenti példákat egyesíti:
blob/2011/07/31/1800/000001.log
Az alábbiakban egy minta URI-t talál, amely a fenti napló eléréséhez használható:
https://<accountname>.blob.core.windows.net/$logs/blob/2011/07/31/1800/000001.log
A tárolási kérelem naplózásakor az eredményül kapott naplónév a kért művelet befejezésének órájával egybeesik. Ha például egy GetBlob-kérés 2011. 07. 31-én 18:30-kor fejeződött be, a napló a következő előtaggal lesz megírva: blob/2011/07/31/1800/
Napló metaadatai
Minden naplóblob metaadatokkal van tárolva, amelyek segítségével azonosíthatók a blob által tartalmazott naplózási adatok. Az alábbi táblázat az egyes metaadat-attribútumokat ismerteti:
Attribútum | Leírás |
---|---|
LogType |
Leírja, hogy a napló tartalmaz-e olvasási, írási vagy törlési műveletekkel kapcsolatos információkat. Ez az érték tartalmazhat egy típust vagy mindhárom kombinációját, vesszővel elválasztva. 1. példa: write 2. példa: read,write 3. példa: read,write,delete |
StartTime |
A naplóban szereplő bejegyzés legkorábbi időpontja a következő formában YYYY-MM-DDThh:mm:ssZ : . Például: 2011-07-31T18:21:46Z |
EndTime |
A naplóban szereplő bejegyzés legutóbbi időpontja a következő formában YYYY-MM-DDThh:mm:ssZ : . Például: 2011-07-31T18:22:09Z |
LogVersion |
A naplóformátum verziója. |
Az alábbi lista teljes metaadatokat jelenít meg a fenti példák alapján:
LogType=write
StartTime=2011-07-31T18:21:46Z
EndTime=2011-07-31T18:22:09Z
LogVersion=1.0
Naplóbejegyzések
Az alábbi szakaszok egy példanapló-bejegyzést mutatnak be az egyes támogatott Azure Storage-szolgáltatásokhoz.
Példanapló-bejegyzés a Blob Storage-hoz
2.0;2022-01-03T20:34:54.4617505Z;PutBlob;SASSuccess;201;7;7;sas;;logsamples;blob;https://logsamples.blob.core.windows.net/container1/1.txt?se=2022-02-02T20:34:54Z&sig=XXXXX&sp=rwl&sr=c&sv=2020-04-08&timeout=901;"/logsamples/container1/1.txt";xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx;0;71.197.193.44:53371;2019-12-12;654;13;337;0;13;"xxxxxxxxxxxxxxxxxxxxx==";"xxxxxxxxxxxxxxxxxxxxx==";""0x8D9CEF88004E296"";Monday, 03-Jan-22 20:34:54 GMT;;"Microsoft Azure Storage Explorer, 1.20.1, win32, azcopy-node, 2.0.0, win32, AzCopy/10.11.0 Azure-Storage/0.13 (go1.15; Windows_NT)";;"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx";;;;;;;;
Példanapló-bejegyzés a Blob Storage-hoz (Data Lake Storage Gen2 engedélyezve)
2.0;2022-01-04T22:50:56.0000775Z;RenamePathFile;Success;201;49;49;authenticated;logsamples;logsamples;blob;"https://logsamples.dfs.core.windows.net/my-container/myfileorig.png?mode=legacy";"/logsamples/my-container/myfilerenamed.png";xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx;0;73.157.16.8;2020-04-08;591;0;224;0;0;;;;Friday, 11-Jun-21 17:58:15 GMT;;"Microsoft Azure Storage Explorer, 1.19.1, win32 azsdk-js-storagedatalake/12.3.1 (NODE-VERSION v12.16.3; Windows_NT 10.0.22000)";;"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx";;;;;;;;
Példanapló-bejegyzés a Queue Storage-hoz
2.0;2022-01-03T20:35:04.6097590Z;PeekMessages;Success;200;5;5;authenticated;logsamples;logsamples;queue;https://logsamples.queue.core.windows.net/queue1/messages?numofmessages=32&peekonly=true&timeout=30;"/logsamples/queue1";xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx;0;71.197.193.44:53385;2020-04-08;536;0;232;62;0;;;;;;"Microsoft Azure Storage Explorer, 1.20.1, win32 azsdk-js-storagequeue/12.3.1 (NODE-VERSION v12.16.3; Windows_NT 10.0.22000)";;"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx";;;;;;;;
Példanapló-bejegyzés a Table Storage-hoz
1.0;2022-01-03T20:35:13.0719766Z;CreateTable;Success;204;30;30;authenticated;logsamples;logsamples;table;https://logsamples.table.core.windows.net/Tables;"/logsamples/Table1";xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx;0;71.197.193.44:53389;2018-03-28;601;22;339;0;22;;;;;;"Microsoft Azure Storage Explorer, 1.20.1, win32, Azure-Storage/2.10.3 (NODE-VERSION v12.16.3; Windows_NT 10.0.22000)";;"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx"