Azure Storage Analytics-naplózás

  • Cikk

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:

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ű $logstá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 000000kezdő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&amp;sig=XXXXX&amp;sp=rwl&amp;sr=c&amp;sv=2020-04-08&amp;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==";"&quot;0x8D9CEF88004E296&quot;";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&amp;peekonly=true&amp;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"

Következő lépések