Tárolócsoport- és példánynaplózás Azure Monitor-naplókkal

A Log Analytics-munkaterületek központi helyet biztosítanak a naplóadatok tárolásához és lekérdezéséhez nemcsak az Azure-erőforrásokból, hanem a helyszíni erőforrásokból és más felhőkben lévő erőforrásokból is. Azure Container Instances beépített támogatást nyújt a naplók és az eseményadatok Azure Monitor-naplókba való küldéséhez.

A tárolócsoport naplóinak és eseményadatainak Azure Monitor-naplókba való küldéséhez adjon meg egy meglévő Log Analytics-munkaterület-azonosítót és munkaterületkulcsot egy tárolócsoport konfigurálásakor.

Az alábbi szakaszok bemutatják, hogyan hozhat létre naplózással kompatibilis tárolócsoportot, és hogyan kérdezheti le a naplókat. A naplózás engedélyezéséhez egy tárolócsoportot is frissíthet munkaterület-azonosítóval és munkaterület-kulccsal.

Megjegyzés

Ez a cikk nemrég frissült, hogy a Log Analytics helyett az Azure Monitor-naplók kifejezést használja. A naplóadatok továbbra is egy Log Analytics-munkaterületen tárolódnak, és ugyanazon Log Analytics-szolgáltatás gyűjti és elemzi azokat. Frissítjük a terminológiát, hogy jobban tükrözze a naplók szerepét az Azure Monitorban. A részletekért lásd az Azure Monitor terminológiai módosításait ismertető cikket.

Előfeltételek

A tárolópéldányokban való naplózás engedélyezéséhez a következőkre van szükség:

• Log Analytics-munkaterület
• Azure CLI (vagy Cloud Shell)

A Log Analytics hitelesítő adatainak lekérése

Az Azure Container Instancesnek engedélyre van szüksége ahhoz, hogy adatokat küldhessen a Log Analytics-munkaterületre. Ennek az engedélynek a megadásához és a naplózás engedélyezéséhez a tárolócsoport létrehozásakor meg kell adnia a Log Analytics-munkaterület azonosítóját és egy ahhoz tartozó kulcsot (az elsődleges vagy a másodlagos kulcsot).

A Log Analytics-munkaterület azonosítójának és elsődleges kulcsának beszerzése:

1. Az Azure Portalon lépjen a saját Log Analytics-munkaterületére
2. A Beállítások területen válassza az Ügynökök kezelése lehetőséget
3. Jegyezze fel a következőket:
   • Munkaterület azonosítója
   • Elsődleges kulcs

Tárolócsoport létrehozása

Most, hogy rendelkezik a Log Analytics-munkaterület azonosítójával és az elsődleges kulccsal, készen áll egy naplózásra képes tárolócsoport létrehozására.

Az alábbi példák két módszert mutatnak be egy olyan tárolócsoport létrehozására, amely egyetlen fluentd tárolóból áll: az Azure CLI-ből és az Azure CLI-ből yaML-sablonnal. A fluentd tároló több sor kimenetet állít elő az alapértelmezett konfigurációban. Mivel ez a kimenet a Log Analytics-munkaterületre lesz elküldve, jól használható a naplók megtekintésének és lekérdezésének bemutatásához.

Üzembe helyezés az Azure CLI-n keresztül

Az Azure CLI üzembe helyezéséhez adja meg a --log-analytics-workspace és a --log-analytics-workspace-key paramétereket az az container create parancsban. Cserélje le a két munkaterület-értéket az előző lépésben lekért értékekre (és frissítse az erőforráscsoport nevét) a következő parancs futtatása előtt.

Megjegyzés

Az alábbi példa egy nyilvános tárolórendszerképet kér le Docker Hub. Javasoljuk, hogy állítson be egy lekéréses titkos kulcsot a hitelesítéshez egy Docker Hub-fiókkal a névtelen lekéréses kérések helyett. A nyilvános tartalommal végzett munka megbízhatóságának javítása érdekében importálja és kezeli a lemezképet egy privát Azure-tárolóregisztrációs adatbázisban. További információ a nyilvános rendszerképek használatával kapcsolatban.

az container create \
    --resource-group myResourceGroup \
    --name mycontainergroup001 \
    --image fluent/fluentd \
    --log-analytics-workspace <WORKSPACE_ID> \
    --log-analytics-workspace-key <WORKSPACE_KEY>

Üzembe helyezés a YAML használatával

Ezt a módszert akkor használja, ha a YAML használatával szeretne tárolócsoportokat üzembe helyezni. Az alábbi YAML egy tárolócsoportot határoz meg, benne egyetlen tárolóval. Másolja a YAML-t egy új fájlba, majd cserélje le a LOG_ANALYTICS_WORKSPACE_ID és LOG_ANALYTICS_WORKSPACE_KEY helyőrzőket az előző lépésben lekért értékekre. Mentse a fájlt deploy-aci.yaml néven.

Megjegyzés

Az alábbi példa egy nyilvános tárolórendszerképet kér le Docker Hub. Javasoljuk, hogy állítson be egy lekéréses titkos kulcsot a hitelesítéshez egy Docker Hub-fiókkal a névtelen lekéréses kérések helyett. A nyilvános tartalommal végzett munka megbízhatóságának javítása érdekében importálja és kezeli a lemezképet egy privát Azure-tárolóregisztrációs adatbázisban. További információ a nyilvános rendszerképek használatával kapcsolatban.

apiVersion: 2019-12-01
location: eastus
name: mycontainergroup001
properties:
  containers:
  - name: mycontainer001
    properties:
      environmentVariables: []
      image: fluent/fluentd
      ports: []
      resources:
        requests:
          cpu: 1.0
          memoryInGB: 1.5
  osType: Linux
  restartPolicy: Always
  diagnostics:
    logAnalytics:
      workspaceId: LOG_ANALYTICS_WORKSPACE_ID
      workspaceKey: LOG_ANALYTICS_WORKSPACE_KEY
tags: null
type: Microsoft.ContainerInstance/containerGroups

Ezután hajtsa végre a következő parancsot a tárolócsoport üzembe helyezéséhez. Cserélje le a elemet myResourceGroup egy erőforráscsoportra az előfizetésben (vagy először hozzon létre egy "myResourceGroup" nevű erőforráscsoportot):

az container create --resource-group myResourceGroup --name mycontainergroup001 --file deploy-aci.yaml

Röviddel a parancs kiadását követően választ kell kapnia az Azure-tól, amely az üzemelő példány részleteit taglalja.

Naplók megtekintése

A tárolócsoport üzembe helyezése után néhány percbe telik (legfeljebb 10 percbe), hogy az Azure Portalon megjelenjenek az első naplóbejegyzések.

A tárolócsoport naplóinak megtekintése a ContainerInstanceLog_CL táblában:

1. Az Azure Portalon lépjen a saját Log Analytics-munkaterületére
2. Az Általános területen válassza a Naplók lehetőséget
3. Írja be a következő lekérdezést: ContainerInstanceLog_CL | limit 50
4. Válassza a Futtatás lehetőséget

A lekérdezés több eredményt is megjelenít. Ha először nem látja az eredményeket, várjon néhány percet, majd a Futtatás gombra kattintva hajtsa végre újra a lekérdezést. A naplóbejegyzések alapértelmezés szerint Táblázat formátumban jelennek meg. Ezután a sorokat kibontva tekintheti meg az egyes naplóbejegyzések tartalmát.

Események megtekintése

A tárolópéldányok eseményeit a Azure Portal is megtekintheti. Az események közé tartozik a példány létrehozásának és elindításának időpontja. Az eseményadatok megtekintése a ContainerEvent_CL táblában:

1. Az Azure Portalon lépjen a saját Log Analytics-munkaterületére
2. Az Általános területen válassza a Naplók lehetőséget
3. Írja be a következő lekérdezést: ContainerEvent_CL | limit 50
4. Válassza a Futtatás lehetőséget

A lekérdezés több eredményt is megjelenít. Ha először nem látja az eredményeket, várjon néhány percet, majd a Futtatás gombra kattintva hajtsa végre újra a lekérdezést. Alapértelmezés szerint a bejegyzések táblaformátumban jelennek meg. Ezután kibonthat egy sort az egyes bejegyzések tartalmának megtekintéséhez.

Tárolónaplók lekérdezése

Az Azure Monitor-naplók széles körű lekérdezési nyelvet tartalmaznak az információk több ezer sornyi naplókimenetből való lekéréséhez.

A lekérdezések alapstruktúrája a forrástábla (ebben a cikkben ContainerInstanceLog_CL vagy ContainerEvent_CL) után a cső karakterrel elválasztott operátorok sorozata (|). Több operátor sorba állításával finomíthatja az eredményeket, és speciális funkciókat végezhet el.

A példa lekérdezési eredmények megtekintéséhez illessze be a következő lekérdezést a lekérdezés szövegmezőjébe, és válassza a Futtatás gombot a lekérdezés végrehajtásához. Ez a lekérdezés megjeleníti az összes olyan naplóbejegyzést, amelynek „Message” (Üzenet) mezője tartalmazza a „warn” (figyelmeztetés) szót:

ContainerInstanceLog_CL
| where Message contains "warn"

Összetettebb lekérdezések használata is támogatott. Például ez a lekérdezés csak a „mycontainergroup001” tárolócsoporthoz az elmúlt egy órában létrejött naplóbejegyzéseket jeleníti meg:

ContainerInstanceLog_CL
| where (ContainerGroup_s == "mycontainergroup001")
| where (TimeGenerated > ago(1h))

Naplóséma

Megjegyzés

Az alább felsorolt oszlopok némelyike csak a séma részeként létezik, és nem lesznek kibocsátva adatok a naplókban. Ezek az oszlopok alább az "Üres" leírással vannak jelölve.

ContainerInstanceLog_CL

Oszlop	Típus	Description
Computer	sztring	Üres
ContainerGroup_s	sztring	A rekordhoz társított tárolócsoport neve
ContainerID_s	sztring	A rekordhoz társított tároló egyedi azonosítója
ContainerImage_s	sztring	A rekordhoz társított tárolórendszerkép neve
Location_s	sztring	A rekordhoz társított erőforrás helye
Üzenet	sztring	Ha van ilyen, a tároló üzenete
OSType_s	sztring	Annak az operációs rendszernek a neve, amelyre a tároló épül
RawData	sztring	Üres
ResourceGroup	sztring	Annak az erőforráscsoportnak a neve, amelyhez a rekord társítva van
Source_s	sztring	A naplózási összetevő neve, "LoggingAgent"
SubscriptionId	sztring	Annak az előfizetésnek az egyedi azonosítója, amelyhez a rekord társítva van
TimeGenerated	dátum/idő	Időbélyeg, amikor az eseményt az Azure-szolgáltatás hozta létre, és feldolgozta az eseménynek megfelelő kérést
Típus	sztring	A tábla neve
_ResourceId	sztring	Annak az erőforrásnak az egyedi azonosítója, amelyhez a rekord társítva van
_SubscriptionId	sztring	Annak az előfizetésnek az egyedi azonosítója, amelyhez a rekord társítva van

ContainerEvent_CL

Oszlop	Típus	Description
Computer	sztring	Üres
ContainerGroupInstanceId_g	sztring	A rekordhoz társított tárolócsoport egyedi azonosítója
ContainerGroup_s	sztring	A rekordhoz társított tárolócsoport neve
ContainerName_s	sztring	A rekordhoz társított tároló neve
Count_d	valós szám	Hányszor fordult elő az esemény a legutóbbi szavazás óta
FirstTimestamp_t	dátum/idő	Az esemény első előfordulásának időbélyege
Location_s	sztring	A rekordhoz társított erőforrás helye
Üzenet	sztring	Ha van ilyen, a tároló üzenete
OSType_s	sztring	Annak az operációs rendszernek a neve, amelyre a tároló épül
RawData	sztring	Üres
Reason_s	sztring	A tárolócsoport aktuális állapota
ResourceGroup	sztring	Annak az erőforráscsoportnak a neve, amelyhez a rekord társítva van
SubscriptionId	sztring	Annak az előfizetésnek az egyedi azonosítója, amelyhez a rekord társítva van
TimeGenerated	dátum/idő	Időbélyeg, amikor az eseményt az Azure-szolgáltatás hozta létre, és feldolgozta az eseménynek megfelelő kérést
Típus	sztring	A tábla neve
_ResourceId	sztring	Annak az erőforrásnak az egyedi azonosítója, amelyhez a rekord társítva van
_SubscriptionId	sztring	Annak az előfizetésnek az egyedi azonosítója, amelyhez a rekord társítva van

Következő lépések

Azure Monitor-naplók

A naplók lekérdezésével és a riasztások Azure Monitor-naplókban való konfigurálásával kapcsolatos további információkért lásd:

• Az Azure Monitor-naplók naplókereséseinek ismertetése
• Egyesített riasztások az Azure Monitorban

Tárolók processzor- és memóriahasználatának monitorozása

A tárolópéldányok processzor- és memória-erőforrásainak monitorozásával kapcsolatos bővebb információkért lásd:

• Tárolóerőforrások monitorozása Azure Container Instances.