Futtatókörnyezeti kivételek keresése és diagnosztizálása az Application Insights használatával

Az Application Insights telemetriát gyűjt az alkalmazásból a futtatókörnyezeti kivételek azonosításához és diagnosztizálásához. Ez az oktatóanyag ismerteti a folyamatot az alkalmazására vonatkozóan. Az alábbiak végrehajtásának módját ismerheti meg:

  • Módosítsa a projektet a kivételkövetés engedélyezéséhez.
  • Az alkalmazás különböző összetevőinek kivételeinek azonosítása.
  • Kivétel részleteinek megtekintése.
  • A hibakereséshez töltse le a kivétel pillanatképét a Visual Studióba.
  • A sikertelen kérések részleteinek elemzése lekérdezési nyelv használatával.
  • Hozzon létre egy új munkaelemet a hibás kód kijavításához.

Előfeltételek

Az oktatóanyag elvégzéséhez:

  • Telepítse a Visual Studio 2019-et a következő számítási feladatokkal:
    • ASP.NET és webfejlesztés
    • Azure-fejlesztés
  • Töltse le és telepítse a Visual Studio Snapshot Debugger alkalmazást.
  • A Visual Studio Snapshot Debugger engedélyezése
  • .NET-alkalmazás üzembe helyezése az Azure-ban, és az Application Insights SDK engedélyezése
  • Módosítsa a kódot a fejlesztési vagy tesztelési környezetben, hogy kivételt hozzon létre, mert az oktatóanyag nyomon követi egy kivétel azonosítását az alkalmazásban.

Bejelentkezés az Azure-ba

Jelentkezzen be az Azure Portalra.

Hibák elemzése

Az Application Insights begyűjti az alkalmazás hibáit. Lehetővé teszi a különböző műveletek gyakoriságának megtekintését, hogy az erőfeszítéseit a legnagyobb hatással járó problémákra összpontosíthassa. Ezután részletezheti ezeknek a hibáknak a részleteit a kiváltó ok azonosításához.

  1. Válassza ki az Application Insights elemet, majd az előfizetését.

  2. A Hibák panel megnyitásához válassza a Hibák lehetőséget a Vizsgálat menüben, vagy válassza a Sikertelen kérések gráfot .

    A sikertelen kéréseket bemutató képernyőkép.

  3. A Sikertelen kérések panelen a sikertelen kérelmek száma és az alkalmazás egyes műveleteihez érintett felhasználók száma látható. Ha ezeket az információkat felhasználó szerint rendezi, azonosíthatja azokat a hibákat, amelyek a leginkább érintik a felhasználókat. Ebben a példában a GET Employees/Create and GET Customers/Details valószínű, hogy a pályázók nagy számú hiba és érintett felhasználó miatt fognak kivizsgálni. Ha kiválaszt egy műveletet, a jobb oldali panelen további információ jelenik meg erről a műveletről.

    Képernyőkép a Sikertelen kérelmek panelről.

  4. Az időtartomány csökkentésével ráközelíthet arra az időszakra, amelyben a hibák száma kiugróan magas.

    Képernyőkép a Sikertelen kérelmek ablakról.

  5. A kapcsolódó mintákat a szűrt eredmények számát tartalmazó gombra kattintva tekintheti meg. A javasolt minták az összes összetevőből származó kapcsolódó telemetriával rendelkeznek, még akkor is, ha a mintavételezés bármelyikben érvényben volt. Válassza ki a találatot a hiba részleteinek megtekintéséhez.

    Képernyőkép a Sikertelen kérelmek mintáiról.

  6. A sikertelen kérelem részletei a Gantt-diagramot mutatják, amely azt mutatja, hogy a tranzakcióban két függőségi hiba történt, ami a tranzakció teljes időtartamának több mint 50%-ához is hozzájárult. Ez a felület egy elosztott alkalmazás minden olyan összetevőjére kiterjedő telemetriát mutat be, amely ehhez a műveletazonosítóhoz kapcsolódik. Bármelyik elemet kiválaszthatja a jobb oldalon lévő részletek megtekintéséhez.

    Képernyőkép a Sikertelen kérés részleteiről.

  7. A műveletek részletei egy formátumkivételt is mutatnak, amely úgy tűnik, hogy a hibát okozta. Láthatja, hogy érvénytelen irányítószám miatt van. A hibakeresési pillanatképet megnyitva megtekintheti a kódszintű hibakeresési információkat a Visual Studióban.

    Képernyőkép a kivétel részleteiről.

Sikertelen kód azonosítása

A Snapshot Debugger az alkalmazásában leggyakrabban előforduló kivételekről gyűjt pillanatfelvételeket, hogy segítsen éles környezetben diagnosztizálni azok alapvető okát. A portálon a hibakeresési pillanatfelvételeket megtekintve láthatja a hívásvermet és megvizsgálhatja a változókat az egyes hívásveremkeretekre vonatkozóan. Ezt követően a pillanatkép letöltésével és a Visual Studio 2019 Enterprise-ban való megnyitásával hibakeresést végezhet a forráskódban.

  1. A kivétel tulajdonságai között válassza a Hibakeresési pillanatkép megnyitása lehetőséget.

  2. Megnyílik a Pillanatkép hibakeresése panel a kérés hívási vermével. Válasszon ki egy metódust az összes helyi változó értékének megtekintéséhez a kérés időpontjában. A példában szereplő legfelső módszertől kezdve olyan helyi változókat láthat, amelyek nem rendelkeznek értékkel.

    Képernyőkép a Hibakeresési pillanatkép panelről.

  3. Az első érvényes értékeket tartalmazó hívás a ValidZipCode. Láthatja, hogy az irányítószámot olyan betűkkel adták meg, amelyek nem fordíthatók le egész számmá. Úgy tűnik, hogy ez a hiba a kijavítandó kódban található hiba.

    Képernyőkép a kijavítandó kódban lévő hibáról.

  4. Ezután letöltheti ezt a pillanatképet a Visual Studióba, ahol megtalálhatja a kijavítandó tényleges kódot. Ehhez válassza a Pillanatkép letöltése lehetőséget.

  5. A rendszer betölti a pillanatfelvételt a Visual Studióba.

  6. Most már futtathat egy hibakeresési munkamenetet a Visual Studio Enterprise-ban, amely gyorsan azonosítja a kivételt okozó kódsort.

    Képernyőkép a kód kivételéről.

Elemzési adatok használata

Az Application Insights által gyűjtött összes adatot az Azure Log Analytics tárolja, amely gazdag lekérdezési nyelvet biztosít, amellyel különböző módokon elemezheti az adatokat. Ezekkel az adatokkal elemezheti a vizsgált kivételt létrehozó kéréseket.

  1. Az Application Insights által biztosított telemetriai adatok megtekintéséhez válassza ki a kód fölötti CodeLens-információkat.

    Képernyőkép a CodeLensben lévő kódról.

  2. Válassza a Hatás elemzése lehetőséget az Application Insights Analytics megnyitásához. Több lekérdezéssel van feltöltve, amelyek a sikertelen kérések részleteit adják meg, például az érintett felhasználókat, böngészőket és régiókat.

    Képernyőkép az Application Insights ablakról, amely több lekérdezést is tartalmaz.

Munkaelem hozzáadása

Ha az Application Insightst egy nyomkövetési rendszerhez, például az Azure DevOpshoz vagy a GitHubhoz csatlakoztatja, létrehozhat egy munkaelemet közvetlenül az Application Insightsból.

  1. Térjen vissza az Application Insights Kivétel tulajdonságai paneljére.

  2. Válassza az Új munkaelem lehetőséget.

  3. Megnyílik az Új munkaelem panel, amelyen a kivétel részletei már ki van töltve. A mentés előtt további információkat is hozzáadhat.

    Képernyőkép az Új munkaelem panelről.

Következő lépések

Most, hogy megtanulta, hogyan azonosíthatja a futtatókörnyezeti kivételeket, lépjen tovább a következő oktatóanyagra, amelyből megtudhatja, hogyan azonosíthatja és diagnosztizálhatja a teljesítményproblémákat.