Naplók monitorozása az Azure Container Appsben a Log Analytics használatával
Az Azure Container Apps integrálva van az Azure Monitor Log Analyticsszel a tárolóalkalmazás naplóinak monitorozásához és elemzéséhez. Ha a naplómonitorozási megoldásként van kiválasztva, a Container Apps-környezet tartalmaz egy Log Analytics-munkaterületet, amely a környezetben futó összes tárolóalkalmazás rendszer- és alkalmazásnapló-adatainak tárolására szolgál.
A naplóbejegyzések a Log Analytics-táblák Azure Portalon vagy parancshéjon keresztüli lekérdezésével érhetők el az Azure CLI használatával.
A Container Apps kétféle naplót biztosít.
- Az alkalmazás által kibocsátott konzolnaplók.
- A Container Apps szolgáltatás által kibocsátott rendszernaplók.
Rendszernaplók
A Container Apps szolgáltatás rendszernapló-üzeneteket biztosít a tárolóalkalmazás szintjén. A rendszernaplók a következő üzeneteket bocsátják ki:
| Forrás | Típus | Üzenet |
|---|---|---|
| Dapr | Info | Sikeresen létrehozta a dapr összetevő <összetevő nevét> a hatókör <dapr-component-scope használatával> |
| Dapr | Info | A dapr összetevő <összetevőjének neve> sikeresen frissítve a hatókör <összetevőtípusával> |
| Dapr | Hiba | Hiba történt a dapr-összetevő <összetevőnevének létrehozásakor> |
| Kötet csatlakoztatása | Info | A kötet kötetének <sikeres> csatlakoztatása a változatváltozat <hatóköréhez> |
| Kötet csatlakoztatása | Hiba | Hiba történt a kötet <kötetnevének csatlakoztatása közben> |
| Tartománykötés | Info | Sikeresen kötötte a tartomány <tartományát> a tárolóalkalmazás tárolóalkalmazásának <nevéhez> |
| Hitelesítés | Info | A hitelesítés engedélyezve van az alkalmazásban. Hitelesítési konfiguráció létrehozása |
| Hitelesítés | Info | A hitelesítési konfiguráció létrehozása sikeresen megtörtént |
| Forgalom súlya | Info | Százalékos forgalmi súly <>beállítása a korrektúra-névhez<\> |
| Változatkiépítés | Info | Új változat létrehozása: <változat neve> |
| Változatkiépítés | Info | Sikeresen kiépített változat <neve> |
| Változatkiépítés | Info | Régi változatok inaktiválása az "ActiveRevisionsMode=Single" óta |
| Változatkiépítés | Hiba | Hiba történt a változat <változatánaknév> kiépítésekor. ErrorCode: <[ErrImagePull]|[ Időtúllépés]|[ContainerCrashing]> |
A rendszernapló adatai a tábla lekérdezésével ContainerAppSystemLogs_CL érhetők el. A táblázat leggyakrabban használt Container Apps-oszlopai a következők:
| Oszlop | Leírás |
|---|---|
ContainerAppName_s |
Tárolóalkalmazás neve |
EnvironmentName_s |
Container Apps-környezet neve |
Log_s |
Naplóüzenet |
RevisionName_s |
Változat neve |
Konzolnaplók
A konzolnaplók a stderr tárolóalkalmazásban és stdout a Dapr-oldalkocsikban található tárolókból és üzenetekből származnak. A konzolnaplókat a ContainerAppConsoleLogs_CL tábla lekérdezésével tekintheti meg.
Tipp.
A kód jól definiált naplóüzenetekkel való kialakításával könnyebben megértheti a kód működését, és elháríthatja a hibákat. Az ajánlott eljárásokkal kapcsolatos további információkért tekintse meg a Tervezés műveletekhez című témakört.
Az ContainerAppConsoleLogs_CL leggyakrabban használt Container Apps-specifikus oszlopai a következők:
| Oszlop | Leírás |
|---|---|
ContainerAppName_s |
Tárolóalkalmazás neve |
ContainerGroupName_g |
Replika neve |
ContainerId_s |
Tárolóazonosító |
ContainerImage_s |
Tárolórendszerkép neve |
EnvironmentName_s |
Container Apps-környezet neve |
Log_s |
Naplóüzenet |
RevisionName_s |
Változat neve |
Napló lekérdezése a naplóelemzéssel
A Log Analytics egy eszköz az Azure Portalon, amellyel megtekintheti és elemezheti a naplóadatokat. A Log Analytics használatával Kusto-lekérdezéseket írhat, majd rendezheti, szűrheti és vizualizálhatja az eredményeket diagramokban a trendek észlelése és a problémák azonosítása érdekében. Interaktívan dolgozhat a lekérdezés eredményeivel, vagy használhatja őket más funkciókkal, például riasztásokkal, irányítópultokkal és munkafüzetekkel.
Azure Portal
Indítsa el a Log Analyticst a naplókból a tárolóalkalmazás oldalának oldalsáv menüjében. A Log Analyticset a monitorozási>naplókból is elindíthatja.
A naplókat a CustomLogs kategória Táblák lapján felsorolt táblák használatával kérdezheti le. Ebben a kategóriában a táblák a ContainerAppSystemlogs_CL ContainerAppConsoleLogs_CL táblák.
Az alábbiakban egy Kusto-lekérdezés látható, amely megjeleníti az album-api nevű tárolóalkalmazás konzolnapló-bejegyzéseit.
ContainerAppConsoleLogs_CL
| where ContainerAppName_s == 'album-api'
| project Time=TimeGenerated, AppName=ContainerAppName_s, Revision=RevisionName_s, Container=ContainerName_s, Message=Log_s
| take 100
Az alábbiakban egy Kusto-lekérdezés látható, amely megjeleníti az album-api nevű tárolóalkalmazás rendszernapló-bejegyzéseit.
ContainerAppSystemLogs_CL
| where ContainerAppName_s == 'album-api'
| project Time=TimeGenerated, EnvName=EnvironmentName_s, AppName=ContainerAppName_s, Revision=RevisionName_s, Message=Log_s
| take 100
A Log Analytics és a napló lekérdezésekkel kapcsolatos további információkért tekintse meg a Log Analytics oktatóanyagát.
Azure CLI/PowerShell
A Container Apps-naplók lekérdezhetők az Azure CLI használatával.
Ezek az Azure CLI-lekérdezések egy táblát adnak ki, amely naplórekordokat tartalmaz a tárolóalkalmazás neve album-api számára. A táblaoszlopokat az operátor utáni project paraméterek határozzák meg. A $WORKSPACE_CUSTOMER_ID változó a Log Analytics-munkaterület GUID azonosítóját tartalmazza.
Ez a példa lekérdezi a táblát ContainerAppConsoleLogs_CL :
az monitor log-analytics query --workspace $WORKSPACE_CUSTOMER_ID --analytics-query "ContainerAppConsoleLogs_CL | where ContainerAppName_s == 'album-api' | project Time=TimeGenerated, AppName=ContainerAppName_s, Revision=RevisionName_s, Container=ContainerName_s, Message=Log_s, LogLevel_s | take 5" --out table
Ez a példa lekérdezi a táblát ContainerAppSystemLogs_CL :
az monitor log-analytics query --workspace $WORKSPACE_CUSTOMER_ID --analytics-query "ContainerAppSystemLogs_CL | where ContainerAppName_s == 'album-api' | project Time=TimeGenerated, AppName=ContainerAppName_s, Revision=RevisionName_s, Message=Log_s, LogLevel_s | take 5" --out table