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 idővonala nem garantált.
Feljegyzés
Javasoljuk, hogy a Storage Analytics-naplók helyett az Azure Storage-naplókat használja az Azure Monitorban. 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 az Azure Portalon vagy a PowerShell vagy az Azure CLI használatával engedélyezheti. Részletes útmutatásért tekintse meg az Azure Storage Analytics-naplók engedélyezése és kezelése (klasszikus) című témakört.
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 Várólista-szolgáltatás tulajdonságainak lekérése és a Táblaszolgáltatás tulajdonságainak lekérése művelettel engedélyezheti a Storage Analytics szolgáltatást az egyes szolgáltatásokhoz. Ha egy példát szeretne látni, amely engedélyezi a Storage Analytics-naplókat a .NET használatával, olvassa el 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égpontra irányuló kérések történnek. Ha például egy tárfiók tevékenységekkel rendelkezik a Blob-végponton, de a Tábla vagy a Várólista végpontja nem, akkor csak a Blob szolgáltatáshoz kapcsolódó naplók jönnek létre.
Feljegyzés
A Storage Analytics-naplózás jelenleg csak a Blob, a Queue és a Table szolgáltatás esetében érhető el. A Storage Analytics naplózása prémium teljesítményű BlockBlobStorage-fiókokhoz is elérhető. Ez azonban nem érhető el az általános célú, prémium teljesítményű v2-fiókokhoz.
Naplózott kérések
Hitelesített kérések naplózása
A hitelesített kérések alábbi típusai vannak rögzítve:
Sikeres kérelmek
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ók létrehozása vagy törlése nem naplózhatók. A naplózott adatok teljes listáját a Storage Analytics naplózott műveletek és állapotüzenetek, valamint a Storage Analytics naplóformátum témakörei dokumentálják.
Névtelen kérések naplózása
A rendszer a névtelen kérések alábbi típusait naplózza:
Sikeres kérelmek
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 Storage Analytics naplózott műveletek és állapotüzenetek, valamint a Storage Analytics naplóformátum témakörei dokumentálják.
Feljegyzés
A Storage Analytics naplózza az adatsíkra irányuló összes belső hívást. Az Azure Storage-erőforrás-szolgáltató hívásait is naplózza a rendszer. 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ása
Minden napló blokkblobokban van tárolva egy nevű $logstárolóban, amely automatikusan létrejön, ha a 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ő a Storage Analytics engedélyezése után, bár tartalma törölhető. Ha a tároló böngészési eszközével közvetlenül a tárolóra navigál, a naplózási adatokat tartalmazó összes blob megjelenik.
Feljegyzés
A $logs tároló nem jelenik meg tárolólistaművelet végrehajtásakor, például a Tárolók listázása művelet végrehajtásakor. 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ásakor a Storage Analytics blokkként tölti fel a köztes eredményeket. A Storage Analytics rendszeresen véglegesíti ezeket a blokkokat, és blobként teszi elérhetővé őket. A naplóadatok akár egy órát is igénybe vehetnek 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 nagy mennyiségű naplóadattal rendelkezik, és óránként több fájllal rendelkezik, a blob metaadataival meghatározhatja, hogy a napló milyen adatokat tartalmaz a blob metaadatainak mezőinek vizsgálatával. Ez azért is hasznos, mert előfordulhat, hogy az adatok naplófájlba írása késéssel 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ő megadásához, valamint metaadatok alapján az írási műveleteket tartalmazó naplók azonosítására.
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
}
A blobok programozott felsorolásáról további információt a Blob-erőforrások számbavétele, valamint a Blob-erőforrások tulajdonságainak és metaadatainak beállítása és lekérése című témakörben talál.
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év minden attribútumát 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 jelenlegi verziójában, és az értéke mindig az lesz 00. |
<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őpontban 000000kezdődik: . Például: 000001 |
A következő egy teljes mintanapló neve, amely egyesíti a fenti példákat:
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 2011.07.31-én 18:30-kor befejeződött egy GetBlob-kérés, a napló a következő előtaggal lesz megírva: blob/2011/07/31/1800/
Metaadatok naplózása
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 |
Azt ismerteti, 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: write2. példa: read,write3. 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 a teljes metaadatokat jeleníti meg a fenti példák használatával:
LogType=writeStartTime=2011-07-31T18:21:46ZEndTime=2011-07-31T18:22:09ZLogVersion=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;172.16.0.0: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 (a Data Lake Storage engedélyezve van)
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;172.16.0.0;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;172.16.0.0: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;172.16.0.0: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"