Oktatóanyag: App Service-alkalmazás hibaelhárítása az Azure SRE-ügynökkel

A helymegbízhatósági mérnöki (SRE) a megbízható, méretezhető rendszerek létrehozására összpontosít az automatizálás és a proaktív felügyelet révén. Az Azure SRE-ügynök ezeket az alapelveket az AI-alapú monitorozási, hibaelhárítási és szervizelési képességek biztosításával hozza a felhőkörnyezetbe.

Az SRE-ügynök automatizálja a rutinszerű üzemeltetési feladatokat, és ésszerű elemzéseket biztosít az alkalmazások megbízhatóságának fenntartásához, miközben csökkenti a manuális beavatkozást. Az SRE-ügynök csevegőrobotként érhető el, így kérdéseket tehet fel, és természetes nyelvi parancsokat adhat az alkalmazások és szolgáltatások karbantartásához. A pontosság és az ellenőrzés biztosítása érdekében az ügynök által az Ön nevében végzett műveletekhez az Ön jóváhagyására van szükség.

Az oktatóanyagban szereplő mintaalkalmazás a HTTP 500-hibák szabályozott módon történő szimulálásával mutatja be a hibaészlelést. Ezeket a forgatókönyveket biztonságosan tesztelheti az Azure App Service üzembehelyezési pontok használatával különböző alkalmazáskonfigurációk egymás mellett történő futtatásához.

A hibaszimuláció engedélyezéséhez állítsa a INJECT_ERRORalkalmazásbeállítást 1-re. Ha ez a beállítás engedélyezve van, az alkalmazás HTTP 500-hibát jelez, miután néhány alkalommal kiválasztotta a gombot. Ezután láthatja, hogyan reagál az SRE-ügynök az alkalmazáshibákra.

Ebben az útmutatóban Ön:

• App Service-alkalmazás létrehozása az Azure Portal használatával.
• Mintaalkalmazás üzembe helyezése a GitHubról.
• Konfigurálja az alkalmazást egy indítási paranccsal, és engedélyezze a naplózást.
• Hozzon létre egy üzembehelyezési pontot a hiba szimulálásához.
• Állítson be egy ügynököt az alkalmazás figyeléséhez.
• Hiba kiváltása a hibás helyre való átállással.
• AI-alapú csevegéssel diagnosztizálhatja és megoldhatja a problémát a csere visszaállításával.

Előfeltételek

Ügynök létrehozásához meg kell adnia az ügynöknek a megfelelő engedélyeket, konfigurálnia kell a megfelelő beállításokat, és hozzáférést kell adnia a megfelelő erőforrásokhoz:

• Azure-fiók: Aktív előfizetéssel rendelkező Azure-fiókra van szüksége. Ha még nem rendelkezik ilyen fiókkal, ingyenesen létrehozhat egy fiókot.

• Biztonsági környezet: Győződjön meg arról, hogy a felhasználói fiók Microsoft.Authorization/roleAssignments/write vagy felhasználói hozzáférés-rendszergazdaként rendelkezik az engedélyekkel.

• Tűzfalbeállítások: Adja hozzá *.azuresre.ai az engedélyezési listához a tűzfalbeállítások között. Egyes hálózati profilok alapértelmezés szerint blokkolhatják a tartományhoz *.azuresre.ai való hozzáférést.

1. App Service-alkalmazás létrehozása

Először hozzon létre egy webalkalmazást, amelyet az SRE-ügynök figyelhet:

1. Jelentkezzen be a Azure portalra.

2. A keresősávon keresse meg az App Servicest, majd jelölje ki az eredmények között.

3. Válassza a + Létrehozás>Webalkalmazás lehetőséget.

4. Az Alapismeretek lapon adja meg az alábbi adatokat.

   A Project részleteihez adja meg az alábbi értékeket:

   Beállítás	Érték
   Subscription	Az Ön Azure-előfizetése
   Erőforráscsoport	Új>my-app-service-group létrehozása

   A példány részleteihez adja meg az alábbi értékeket:

   Beállítás	Érték
   Név	my-sre-app
   Közzététel	Kód
   Futtatókörnyezeti verem	.NET 9 (STS)
   Operációs rendszer	Windows
   Régió	Az Önhöz közeli régió

5. Válassza az Üzembe helyezés lapot.

6. A Hitelesítési beállítások területen engedélyezze az alapszintű hitelesítést.

   Megjegyzés:

   Az alapszintű hitelesítést később a GitHub egyszeri üzembe helyezéséhez használják. Tiltsa le az alapszintű hitelesítést az éles környezetben.

7. Válassza a Véleményezés és létrehozás lehetőséget, majd válassza a Létrehozás lehetőséget, amikor az ellenőrzés sikeres.

   Amikor az üzembe helyezés befejeződik, megjelenik egy Teljes üzembe helyezés üzenet.

2. A mintaalkalmazás üzembe helyezése

Az App Service-alkalmazás létrehozása után telepítse a mintaalkalmazást a GitHubról:

1. Az Azure Portalon nyissa meg az újonnan létrehozott App Service-alkalmazást az Erőforrás megnyitása gombra kattintva.

2. A bal oldali menü Üzembe helyezés szakaszában válassza az Üzembe helyezési központ lehetőséget.

3. A Beállítások lapon konfigurálja az alábbi értékeket:

   Ingatlan	Érték
   Forrás	Külső Git
   Raktár	https://github.com/Azure-Samples/app-service-dotnet-agent-tutorial
   Fiók	fő

4. Válassza a Mentés lehetőséget az üzembehelyezési beállítások alkalmazásához.

3. A mintaalkalmazás ellenőrzése

Az üzembe helyezés után győződjön meg arról, hogy a mintaalkalmazás a várt módon fut:

1. Az App Service-alkalmazás bal oldali menüjében válassza az Áttekintés lehetőséget.

2. A Tallózás gombra kattintva megnyithatja az alkalmazást egy új böngészőlapon. (A betöltés eltarthat egy percig.)

3. Az alkalmazás egy nagy számlálót és két gombot jelenít meg.

   

   A számláló növekedésének megfigyeléséhez többször válassza a Növekmény gombot.

4. Üzembehelyezési pont beállítása hibaszimulációhoz

Alkalmazás meghibásodási forgatókönyv szimulálásához adjon hozzá egy másodlagos üzembe helyezési lehetőséget:

1. Az App Service-alkalmazás bal oldali menüjében, az Üzembe helyezés szakaszban válassza az Üzembehelyezési pontok lehetőséget.

2. Válassza a Pont hozzáadása lehetőséget.

3. Adja meg a következő értékeket:

   Ingatlan	Érték	Megjegyzések
   Név	törött	A hibaforgatókönyv ebben a pontban aktiválódik.
   Klónozza a beállításokat innen:	my-sre-app	Ez a tulajdonság átmásolja a konfigurációt a fő alkalmazásból.

4. Görgessen a panel aljára, és válassza a Hozzáadás lehetőséget. A pontlétrehozás akár egy percet is igénybe vehet.

A mintaalkalmazás üzembe helyezése a tárhelyre

1. A foglalat létrehozása után válassza ki a hibás foglalatot a listában.

2. A bal oldali menü Üzembe helyezés szakaszában válassza az Üzembe helyezési központ lehetőséget.

3. A Beállítások lapon konfigurálja az alábbi értékeket:

   Ingatlan	Érték
   Forrás	Külső Git
   Raktár	https://github.com/Azure-Samples/app-service-dotnet-agent-tutorial
   Fiók	fő

4. Válassza a Mentés lehetőséget az üzembehelyezési beállítások alkalmazásához.

Alkalmazásbeállítás hozzáadása a hibaszimuláció engedélyezéséhez

A hibaszimuláció szabályozásához konfiguráljon egy alkalmazásbeállítást, amelyet az alkalmazás futásidőben ellenőriz:

1. Az App Service-alkalmazás bal oldali menüjében, a Beállítások szakaszban válassza a Környezeti változók lehetőséget.

2. Győződjön meg arról, hogy felül a megfelelő rés van kiválasztva (például hibás).

3. Az Alkalmazásbeállítások lapon válassza a + Hozzáadás lehetőséget.

4. Adja meg a következő értékeket:

   Ingatlan	Érték	Megjegyzések
   Név	INJECT_ERROR	Pontosan INJECT_ERROR kell lennie (nagybetűvel, szóköz nélkül)
   Érték	1	Hibaszimuláció engedélyezése az alkalmazásban

5. Győződjön meg arról, hogy az Üzembehelyezési pont beállításmezőnincs bejelölve.

6. Válassza az Alkalmaz lehetőséget a beállítás hozzáadásához.

7. A Környezeti változók lap alján válassza az Alkalmaz elemet a módosítások alkalmazásához.

8. Amikor a rendszer kéri, válassza a Megerősítés lehetőséget az alkalmazás megerősítéséhez és újraindításához a kijelölt ponton.

5. Ügynök létrehozása

Most hozzon létre egy ügynököt az App Service-alkalmazás figyeléséhez:

1. Az Azure portálon elérhető SRE-ügynök eléréséhez kövesse az előkészítési e-mailben megadott hivatkozást.

2. Válassza a -t, majd hozza létre a-et.

3. Az Ügynök létrehozása panelen adja meg az alábbi értékeket:

   Ingatlan	Érték	Megjegyzések
   Subscription	Az Ön Azure-előfizetése
   Erőforráscsoport	my-sre-agent-group	Új csoport az ügynök számára.
   Név	my-sre-agent
   Régió	USA 2. keleti régiója

4. Válassza az Erőforráscsoportok kiválasztása lehetőséget.

5. A figyelendő kijelölt erőforráscsoportok panelen jelölje be a my-app-service-group melletti jelölőnégyzetet.

6. Válassza az Mentésgombot.

7. Az Ügynök létrehozása felületen válassza a Létrehozás lehetőséget. Az ügynöklétrehozás folyamata néhány percet vesz igénybe.

6. Csevegés az ügynökével

Az ügynök üzembe helyezése és az erőforráscsoporthoz való csatlakoztatása után természetes nyelv használatával kezelheti az alkalmazást az alkalmazás monitorozásához és hibaelhárításához:

1. Az Azure Portalon keresse meg és válassza ki az Azure SRE-ügynököt.

2. Az ügynökök listájában válassza a my-app-service-sre-agent elemet.

3. Válassza az Ügynökkel folytatott csevegés lehetőséget.

4. A csevegőablakban adja meg a következő parancsot:

   List my App Service apps
   

5. Az ügynök a my-app-service-group erőforráscsoportban üzembe helyezett App Service-alkalmazások listájával válaszol.

Most, hogy az ügynök láthatja az alkalmazást, készen áll arra, hogy szimuláljon egy hibát, és hagyja, hogy az ügynök segítsen megoldani.

7. Az alkalmazás megszakítása

Hibaforgatókönyv szimulálása a hibás üzembehelyezési pontra való felcseréléssel:

1. Az App Service-alkalmazás bal oldali menüjében, az Üzembe helyezés szakaszban válassza az Üzembehelyezési pontok lehetőséget.

2. Válassza a Felcserélés lehetőséget.

3. A Felcserélés panelen konfigurálja az alábbi értékeket:

   Ingatlan	Érték	Megjegyzések
   Forrás	my-sre-app-broken	A hibás verzióval rendelkező hely
   Cél	my-sre-app	A gyártási időablak

4. Görgessen az aljára, és válassza a Felcserélés indítása lehetőséget. A felcserélési művelet végrehajtása eltarthat egy percig.

5. A felcserélés befejezése után keresse meg az alkalmazás URL-címét.

   

6. Kattintson hatszor a Növekmény gombra.

7. Az alkalmazásnak sikertelennek kell lennie, és HTTP 500-ra vonatkozó hibát kell visszaadnia.

8. Frissítse a lapot többször (a Command+R vagy az F5 billentyűkombináció lenyomásával) további HTTP 500-hibák generálásához. Ezek a hibák segítenek az SRE-ügynöknek a probléma észlelésében és diagnosztizálásában.

8. Az alkalmazás javítása

Most, hogy az alkalmazás hibákat tapasztal, használja az SRE-ügynököt a probléma diagnosztizálásához és megoldásához:

1. Az Azure Portalon keresse meg és válassza ki az Azure SRE-ügynököt.

2. Az ügynökök listájában válassza a my-app-service-sre-agent elemet.

3. Válassza az Ügynökkel folytatott csevegés lehetőséget.

4. A csevegőablakban adja meg a következő parancsot:

   What's wrong with my-sre-app?
   

5. Az ügynök megkezdi az alkalmazás állapotának elemzését. Látnia kell a rendelkezésre állással, a processzor- és memóriahasználattal, valamint a legutóbbi pontcserével kapcsolatos diagnosztikai üzeneteket.

   Az egyes munkamenetek eltérőek lehetnek, de az alábbi példához hasonló üzenetnek kell megjelennie:

   Most elvégzem a helyreállítást a my-sre-app számára úgy, hogy visszacserélem a helyeket, hogy az alkalmazás ismét egészséges állapotba kerüljön. Vegye figyelembe, hogy előfordulhat, hogy a pontok visszacserélése nem mindig állítja vissza azonnal az állapotot. Folyamatosan tájékoztatom az előrehaladásról.

6. Szünet után az ügynök a visszaállítás jóváhagyását kéri:

   A Slot Swap visszagörgetése a my-sre-app alkalmazás rendelkezésre állásának helyreállítása érdekében

   [Jóváhagyás][Megtagadás]

7. Válassza a Jóváhagyás lehetőséget a visszaállítás elindításához.

8. A visszaállítás befejezése után az ügynök megerősíti:

   A my-sre-app helycseréje sikeresen befejeződött (időbélyeg). A gyártási időablak vissza lett állítva. Most folytatom a kockázatcsökkentés utáni lépéseket:

   Megkérem a megfelelő GitHub-adattár URL-címét, hogy jelenthessem a swap miatti állásidőt.Figyelni fogom az alkalmazást, és 5 percen belül állapotfrissítést adok.

   Adja meg a GitHub-adattár URL-címét a probléma felmerüléséhez.

9. Ellenőrizze a javítást

Miután az SRE-ügynök visszaállította a pontcserét, ellenőrizze, hogy az alkalmazás megfelelően működik-e:

1. Nyissa meg az App Service-alkalmazást egy böngészőben az Áttekintés lapon a Tallózás gombra kattintva.

2. Figyelje meg, hogy a HIBAINJEKTÁLÁS ENGEDÉLYEZVE szöveg már nem jelenik meg, megerősítve, hogy az alkalmazás visszaállt az eredeti állapotára.

3. A Növekmény gomb hatszor történő kiválasztásával győződjön meg arról, hogy nem jelennek meg hibák.

Erőforrások tisztítása

Ha már nincs szüksége az oktatóanyagban létrehozott alkalmazásra és ügynökre, törölheti a társított erőforráscsoportokat a költségek elkerülése érdekében.

Ebben az oktatóanyagban a következő erőforráscsoportokat hozta létre:

• my-app-service-group (App Service-erőforráscsoport)
• my-sre-agent-group (SRE-ügynök erőforráscsoport)

Az egyes erőforráscsoportokhoz kövesse az alábbi lépéseket:

1. Az Azure Portalon lépjen az Erőforráscsoportok elemre.

2. Jelölje ki a törölni kívánt erőforráscsoportot.

3. Az Áttekintés lapon válassza az Erőforráscsoport törlése lehetőséget.

4. A megerősítést kérő párbeszédpanelen adja meg az erőforráscsoport nevét.

5. Válassza a Törlés lehetőséget. A törlés néhány percet vesz igénybe.

Következő lépés

Diagnosztizálás Azure megfigyelhetőséggel

Kapcsolódó tartalom

• Az Azure SRE-ügynök áttekintése
• Azure SRE-ügynök használata