Az Azure Stream Analytics hibaelhárítása erőforrásnaplók használatával
Az Azure Stream Analytics-feladat feldolgozása néha váratlanul leáll. Fontos, hogy ilyen esetekben hibaelhárítást tudjon végezni. A hibákat váratlan lekérdezési eredmény, az eszközök kapcsolata vagy váratlan szolgáltatásleállás okozhatja. A Stream Analytics erőforrásnaplói segíthetnek azonosítani a problémák okait, ha előfordulnak, és csökkentheti a helyreállítási időt.
Erősen ajánlott minden feladathoz engedélyezni az erőforrásnaplókat, mivel ez nagyban segít a hibakeresésben és a monitorozásban.
Naplótípusok
A Stream Analytics kétféle naplót kínál:
Tevékenységnaplók (mindig bekapcsolva), amelyek betekintést nyújtanak a feladatokon végrehajtott műveletekbe.
Erőforrásnaplók (konfigurálhatók), amelyek részletesebb betekintést nyújtanak a feladatokkal kapcsolatos dolgokba. Az erőforrásnaplók a feladat létrehozásakor kezdődnek, és a feladat törlésekor fejeződnek be. A feladat frissítésekor és futása közben bekövetkező eseményeket fedik le.
Feljegyzés
Az olyan szolgáltatások, mint az Azure Storage, az Azure Event Hubs és az Azure Monitor-naplók a nem konkonformáló adatok elemzéséhez használhatók. A díjak az adott szolgáltatások díjszabási modellje alapján kerülnek felszámításra.
Feljegyzé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 lesznek tárolva, és ugyanazon Log Analytics-szolgáltatás gyűjti és elemzi őket. Frissítjük a terminológiát, hogy jobban tükrözzük a naplók szerepét az Azure Monitorban. Részletekért tekintse meg az Azure Monitor terminológiájának változásait .
Hibakeresés tevékenységnaplók használatával
A tevékenységnaplók alapértelmezés szerint be vannak kapcsolva, és magas szintű betekintést nyújtanak a Stream Analytics-feladat által végrehajtott műveletekbe. A tevékenységnaplókban található információk segíthetnek megtalálni a feladatot érintő problémák kiváltó okát. Végezze el a következő lépéseket a tevékenységnaplók Stream Analyticsben való használatához:
Jelentkezzen be az Azure Portalra, és válassza a Tevékenységnapló lehetőséget az Áttekintés területen.
Megtekintheti a végrehajtott műveletek listáját. Minden olyan művelet, amely miatt a feladat meghiúsult, piros információs buborékot kapott.
Válasszon ki egy műveletet az összefoglaló nézet megtekintéséhez. Az itt található információk gyakran korlátozottak. A művelettel kapcsolatos további részletekért válassza a JSON lehetőséget.
Görgessen le a JSON Tulajdonságok szakaszához, amely a sikertelen műveletet okozó hiba részleteit tartalmazza. Ebben a példában a hiba oka egy futásidejű hiba volt a kötött szélességi értékekből. A Stream Analytics-feladat által feldolgozott adatok eltérése adathibát okoz. Megismerheti a különböző bemeneti és kimeneti adathibákat, valamint azok előfordulásának okát.
A JSON-ban megjelenő hibaüzenet alapján korrekciós műveleteket hajthat végre. Ebben a példában ellenőrizni kell, hogy a szélességi érték -90 fok és 90 fok között van-e, hozzá kell adni a lekérdezéshez.
Ha a tevékenységnaplókban megjelenő hibaüzenet nem segít azonosítani a kiváltó okot, engedélyezze az erőforrásnaplókat, és használja az Azure Monitor-naplókat.
Diagnosztikák küldése az Azure Monitor-naplókba
Erősen ajánlott bekapcsolni az erőforrásnaplókat, és elküldeni őket az Azure Monitor-naplókba. Alapértelmezés szerint ki vannak kapcsolva . A bekapcsoláshoz hajtsa végre az alábbi lépéseket:
Hozzon létre egy Log Analytics-munkaterületet, ha még nincs ilyenje. Javasoljuk, hogy a Log Analytics-munkaterület ugyanabban a régióban legyen, mint a Stream Analytics-feladat.
Jelentkezzen be az Azure Portalra, és lépjen a Stream Analytics-feladathoz. A Figyelés csoportban válassza a Diagnosztikai naplók lehetőséget. Ezután válassza a Diagnosztikák bekapcsolása lehetőséget.
Adjon meg egy nevet a diagnosztikai beállítások nevében, és jelölje be a végrehajtás és a létrehozás mezőit a naplóban, az AllMetrics pedig a metrika alatt. Ezután válassza a Küldés a Log Analyticsbe lehetőséget, és válassza ki a munkaterületet. Válassza a Mentés lehetőséget.
A Stream Analytics-feladat indításakor az erőforrásnaplók a Log Analytics-munkaterületre lesznek irányítva. A feladat erőforrásnaplóinak megtekintéséhez válassza a Figyelés szakasz Naplók elemét.
A Stream Analytics előre definiált lekérdezéseket biztosít, amelyekkel egyszerűen keresheti meg az önt érdeklő naplókat. A bal oldali panelen kiválaszthatja az előre definiált lekérdezéseket, majd a Futtatás lehetőséget. A lekérdezés eredményeit az alsó panelen láthatja.
Erőforrásnapló-kategóriák
Az Azure Stream Analytics az erőforrásnaplók két kategóriáját rögzíti:
Létrehozás: Rögzíti a feladatkészítési műveletekhez kapcsolódó naplóeseményeket, például a feladatok létrehozását, a bemenetek és kimenetek hozzáadását és törlését, a lekérdezés hozzáadását és frissítését, valamint a feladat elindítását vagy leállítását.
Végrehajtás: Rögzíti a feladat végrehajtása során előforduló eseményeket.
- Csatlakozási hibák
- Adatfeldolgozási hibák, például:
- A lekérdezésdefiníciónak nem megfelelő események (eltérő mezőtípusok és értékek, hiányzó mezők stb.)
- Kifejezésértékelési hibák
- Egyéb események és hibák
Erőforrásnaplók sémája
Minden napló JSON formátumban van tárolva. Minden bejegyzéshez a következő gyakori sztringmezők vannak befűzve:
| Név | Leírás |
|---|---|
| time | A napló időbélyege (UTC-ben). |
| resourceId | Annak az erőforrásnak az azonosítója, amelyen a műveletet végrehajtották, nagybetűvel. Tartalmazza az előfizetés azonosítóját, az erőforráscsoportot és a feladat nevét. Például: /SUBSCRIPTIONS/6503D296-DAC1-4449-9B03-609A1F4A1C87/RESOURCEGROUPS/MY-RESOURCE-GROUP/PROVIDERS/MICROSOFT. STREAMANALYTICS/STREAMINGJOBS/MYSTREAMINGJOB. |
| kategória | Naplókategória, végrehajtás vagy létrehozás. |
| operationName | A naplózott művelet neve. Például: Események küldése: SQL-kimenet írási hibája a mysqloutputba. |
| status | A művelet állapota. Például sikertelen vagy sikeres. |
| szint | Naplószint. Például hiba, figyelmeztetés vagy tájékoztató. |
| tulajdonságok | Naplóbejegyzés-specifikus részletek JSON-sztringként szerializálva. További információkért tekintse meg a cikk következő szakaszait. |
Végrehajtási napló tulajdonságainak sémája
A végrehajtási naplók információkat tartalmaznak a Stream Analytics-feladat végrehajtása során történt eseményekről. A tulajdonságok sémája attól függően változik, hogy az esemény adathiba vagy általános esemény-e.
Adathibák
Minden olyan hiba, amely akkor fordul elő, amikor a feladat adatokat dolgoz fel, a naplók ebbe a kategóriába tartozik. Ezek a naplók leggyakrabban adatolvasási, szerializálási és írási műveletek során jönnek létre. Ezek a naplók nem tartalmaznak csatlakozási hibákat. A csatlakozási hibák általános eseményekként vannak kezelve. További információ a különböző bemeneti és kimeneti adathibák okáról.
| Név | Leírás |
|---|---|
| Forrás | Annak a feladat-bemenetnek vagy kimenetnek a neve, ahol a hiba történt. |
| Üzenet | A hibához társított üzenet. |
| Típus | A hiba típusa. Például DataConversionError, CsvParserError vagy ServiceBusPropertyColumnMissingError. |
| Adatok | Olyan adatokat tartalmaz, amelyek hasznosak a hiba forrásának pontos megkereséséhez. A mérettől függően csonkolásnak kell alávetni. |
Az operationName értéktől függően az adathibák a következő sémával rendelkeznek:
Események szerializálása az eseményolvasási műveletek során történik. Ezek akkor fordulnak elő, ha a bemeneti adatok nem felelnek meg a lekérdezési sémának az alábbi okok valamelyike miatt:
Típuseltérés az esemény szerializálása/deszerializálása során: Azonosítja a hibát okozó mezőt.
Nem olvasható egy esemény, érvénytelen szerializálás: A bemeneti adatok azon helyével kapcsolatos információkat sorolja fel, ahol a hiba történt. Blobnevet tartalmaz a blobbemenethez, az eltoláshoz és az adatok mintájához.
Az írási műveletek során események küldése történik. Azonosítják a hibát okozó streames eseményt.
Általános események
Az általános események minden mást lefednek.
| Név | Leírás |
|---|---|
| Hiba | (nem kötelező) Hibainformációk. Általában ez a kivétel információ, ha elérhető. |
| Üzenet | Naplóüzenet. |
| Típus | Üzenet típusa. A hibák belső kategorizálásának leképezése. Például : JobValidationError vagy BlobOutputAdapterInitializationFailure. |
| Korrelációs azonosító | GUID, amely egyedileg azonosítja a feladat végrehajtását. A végrehajtási napló összes bejegyzése attól az időponttól kezdve, amikor a feladat elindul, amíg a feladat leáll, ugyanazzal a korrelációs azonosítóval rendelkezik. |
Referenciaként tekintse meg az Azure Monitorban támogatott összes erőforrásnapló-kategóriatípus vagy az Azure Stream Analyticshez gyűjtött összes erőforrásnapló-kategóriatípus listáját.