Samouczek: rozwiązywanie problemów z aplikacją usługi App Service przy użyciu wersji zapoznawczej agenta usługi Azure SRE

Uwaga / Notatka

Agent usługi Azure SRE jest już dostępny. Korzystając z agenta SRE, wyrażasz zgodę na uzupełniające warunki użytkowania specyficzne dla produktu dla platformy Microsoft Azure.

Inżynieria niezawodności lokacji (SRE) koncentruje się na tworzeniu niezawodnych, skalowalnych systemów dzięki automatyzacji i proaktywnego zarządzania. Agent usługi Azure SRE wprowadza te zasady do środowiska chmury, zapewniając funkcje monitorowania, rozwiązywania problemów i korygowania oparte na sztucznej inteligencji.

Agent SRE automatyzuje rutynowe zadania operacyjne i udostępnia uzasadnione szczegółowe informacje ułatwiające utrzymanie niezawodności aplikacji przy jednoczesnym zmniejszeniu interwencji ręcznej. Agent SRE jest dostępny jako czatbot, dzięki czemu możesz zadawać pytania i udzielać poleceń języka naturalnego w celu obsługi aplikacji i usług. Aby zapewnić dokładność i kontrolę, każda akcja wykonywana przez agenta w Twoim imieniu wymaga zatwierdzenia.

Przykładowa aplikacja w tym samouczku demonstruje wykrywanie błędów przez symulowanie błędów HTTP 500 w kontrolowany sposób. Te scenariusze można bezpiecznie przetestować przy użyciu miejsc wdrożenia usługi Azure App Service, aby uruchamiać różne konfiguracje aplikacji obok siebie.

Symulacja błędów jest włączana przez ustawienie aplikacji INJECT_ERROR na 1. Po włączeniu tego ustawienia aplikacja zgłasza błąd HTTP 500 po wybraniu przycisku kilka razy. Następnie możesz zobaczyć, jak agent SRE reaguje na błędy aplikacji.

W tym samouczku nauczysz się następujących rzeczy:

• Utwórz aplikację usługi App Service przy użyciu witryny Azure Portal.
• Wdrażanie przykładowej aplikacji z usługi GitHub.
• Skonfiguruj aplikację za pomocą polecenia uruchamiania i włącz rejestrowanie.
• Utwórz slot wdrożeniowy w celu symulowania awarii.
• Skonfiguruj agenta do monitorowania aplikacji.
• Spowoduj awarię, przełączając się na uszkodzony slot.
• Użyj czatu opartego na sztucznej inteligencji, aby zdiagnozować i rozwiązać problem, cofając zamianę.

Wymagania wstępne

Aby utworzyć agenta, musisz przyznać agentowi odpowiednie uprawnienia, skonfigurować odpowiednie ustawienia i udzielić dostępu do odpowiednich zasobów:

• Konto platformy Azure: potrzebujesz konta platformy Azure z aktywną subskrypcją. Jeśli jeszcze go nie masz, możesz założyć konto za darmo.

• Kontekst zabezpieczeń: upewnij się, że twoje konto użytkownika ma uprawnienia Microsoft.Authorization/roleAssignments/write na rolach lub administratora dostępu użytkowników.

• Ustawienia zapory: dodaj *.azuresre.ai do listy dozwolonych w ustawieniach zapory. Niektóre profile sieciowe mogą domyślnie blokować dostęp do *.azuresre.ai domeny.

1. Utwórz aplikację App Service

Zacznij od utworzenia aplikacji internetowej, którą agent SRE może monitorować:

1. Zaloguj się do witryny Azure Portal.

2. Na pasku wyszukiwania wyszukaj pozycję App Services, a następnie wybierz ją w wynikach.

3. Wybierz pozycję + Utwórz>aplikację internetową.

4. Na karcie Podstawy podaj następujące szczegóły.

   W obszarze Szczegóły projektu wprowadź następujące wartości:

   Ustawienia	Wartość
   Subscription	Twoja subskrypcja platformy Azure
   Grupa zasobów	Utwórz nową>my-app-service-group

   Aby uzyskać szczegółowe informacje o wystąpieniu, wprowadź następujące wartości:

   Ustawienia	Wartość
   Nazwa	my-sre-app
   Publikowanie	Kod
   Stos wykonawczy	.NET 9 (STS)
   System operacyjny	Windows
   Region	Region blisko Ciebie

5. Wybierz kartę Wdrożenie .

6. W obszarze Ustawienia uwierzytelniania włącz uwierzytelnianie podstawowe.

   Uwaga / Notatka

   Uwierzytelnianie podstawowe jest używane później na potrzeby jednorazowego wdrożenia z usługi GitHub. Wyłącz uwierzytelnianie podstawowe w środowisku produkcyjnym.

7. Wybierz pozycję Przejrzyj i utwórz, a następnie wybierz pozycję Utwórz po zakończeniu walidacji.

   Po zakończeniu wdrażania zostanie wyświetlony komunikat Wdrożenie zostało ukończone .

2. Wdrażanie przykładowej aplikacji

Po utworzeniu aplikacji usługi App Service wdróż przykładową aplikację z usługi GitHub:

1. W witrynie Azure Portal przejdź do nowo utworzonej aplikacji usługi App Service, wybierając pozycję Przejdź do zasobu.

2. W menu po lewej stronie w sekcji Wdrażanie wybierz pozycję Centrum wdrażania.

3. Na karcie Ustawienia skonfiguruj następujące wartości:

   Majątek	Wartość
   Źródło	Zewnętrzne narzędzie Git
   Repozytorium	https://github.com/Azure-Samples/app-service-dotnet-agent-tutorial
   Gałąź	główny

4. Wybierz pozycję Zapisz , aby zastosować ustawienia wdrożenia.

3. Weryfikowanie przykładowej aplikacji

Po wdrożeniu upewnij się, że przykładowa aplikacja działa zgodnie z oczekiwaniami:

1. W menu po lewej stronie aplikacji usługi App Service wybierz pozycję Przegląd.

2. Wybierz pozycję Przeglądaj , aby otworzyć aplikację na nowej karcie przeglądarki. (Ładowanie może potrwać minutę).

3. Aplikacja wyświetla duży licznik i dwa przyciski.

   

   Wybierz przycisk Przyrostu kilka razy, aby zaobserwować wzrost licznika.

4. Konfigurowanie miejsca wdrożenia na potrzeby symulacji błędów

Aby zasymulować scenariusz awarii aplikacji, dodaj pomocnicze miejsce wdrożenia:

1. W menu po lewej stronie aplikacji usługi App Service w sekcji Wdrażanie wybierz pozycję Miejsca wdrożenia.

2. Wybierz Dodaj slot.

3. Wprowadź następujące wartości:

   Majątek	Wartość	Uwagi
   Nazwa	Złamane	Scenariusz błędu jest wyzwalany w tym miejscu.
   Klonowanie ustawień z	my-sre-app	Ta właściwość kopiuje konfigurację z głównej aplikacji.

4. Przewiń do dołu okienka i wybierz pozycję Dodaj. Tworzenie slotu może potrwać minutę.

Wdróż przykładową aplikację na gniazdo

1. Po utworzeniu miejsca wybierz uszkodzone miejsce na liście.

2. W menu po lewej stronie w sekcji Wdrażanie wybierz pozycję Centrum wdrażania.

3. Na karcie Ustawienia skonfiguruj następujące wartości:

   Majątek	Wartość
   Źródło	Zewnętrzne narzędzie Git
   Repozytorium	https://github.com/Azure-Samples/app-service-dotnet-agent-tutorial
   Gałąź	główny

4. Wybierz pozycję Zapisz , aby zastosować ustawienia wdrożenia.

Dodawanie ustawienia aplikacji w celu włączenia symulacji błędów

Aby kontrolować symulację błędów, skonfiguruj ustawienie aplikacji sprawdzane przez aplikację w czasie wykonywania:

1. W menu po lewej stronie aplikacji usługi App Service w sekcji Ustawienia wybierz pozycję Zmienne środowiskowe.

2. W górnej części upewnij się, że wybrano prawidłowe miejsce (na przykład przerwane).

3. Na karcie Ustawienia aplikacji wybierz pozycję + Dodaj.

4. Wprowadź następujące wartości:

   Majątek	Wartość	Uwagi
   Nazwa	INJECT_ERROR	Musi być dokładnie INJECT_ERROR (wszystkie limity, bez spacji)
   Wartość	1	Włącza symulację błędów w aplikacji

5. Upewnij się, że pole Ustawienia miejsca wdrożenianie jest zaznaczone.

6. Wybierz pozycję Zastosuj , aby dodać ustawienie.

7. W dolnej części strony Zmienne środowiskowe wybierz pozycję Zastosuj , aby zastosować zmiany.

8. Po wyświetleniu monitu wybierz pozycję Potwierdź , aby potwierdzić i ponownie uruchomić aplikację w wybranym miejscu.

5. Tworzenie agenta

Teraz utwórz agenta do monitorowania aplikacji usługi App Service:

1. Postępuj zgodnie z linkiem podanym w wiadomości e-mail dotyczącej dołączania, aby uzyskać dostęp do agenta SRE w witrynie Azure Portal.

2. Wybierz + Utwórz.

3. W okienku Tworzenie agenta wprowadź następujące wartości:

   Majątek	Wartość	Uwagi
   Subscription	Twoja subskrypcja platformy Azure
   Grupa zasobów	my-sre-agent-group	Nowa grupa agenta.
   Nazwa	my-sre-agent
   Region	Wschodnie stany USA 2

4. Wybierz pozycję Wybierz grupy zasobów.

5. W okienku Wybrane grupy zasobów do monitorowania zaznacz pole wyboru obok pozycji my-app-service-group.

6. Wybierz Zapisz.

7. Po powrocie do okienka Tworzenie agenta wybierz pozycję Utwórz. Proces tworzenia agenta trwa kilka minut.

6. Porozmawiaj z agentem

Po wdrożeniu agenta i połączeniu z grupą zasobów możesz z nim korzystać przy użyciu języka naturalnego, aby monitorować aplikację i rozwiązywać problemy z nią:

1. W portalu Azure wyszukaj i wybierz Azure SRE Agent.

2. Na liście agentów wybierz pozycję my-app-service-sre-agent.

3. Wybierz pozycję Czat z agentem.

4. W polu czatu wprowadź następujące polecenie:

   List my App Service apps
   

5. Agent odpowiada za pomocą listy aplikacji usługi App Service wdrożonych w grupie zasobów my-app-service-group .

Teraz, gdy agent może zobaczyć aplikację, możesz zasymulować awarię i pozwolić agentowi rozwiązać ten problem.

7. Przerwanie aplikacji

Symulowanie scenariusza awarii przez zamianę na uszkodzone miejsce wdrożenia:

1. W menu po lewej stronie aplikacji usługi App Service w sekcji Wdrażanie wybierz pozycję Miejsca wdrożenia.

2. Wybierz pozycję Zamień.

3. W okienku Zamiana skonfiguruj następujące wartości:

   Majątek	Wartość	Uwagi
   Źródło	my-sre-app-broken	Miejsce z wadliwą wersją
   Cel	my-sre-app	Slot produkcyjny

4. Przewiń do dołu i wybierz pozycję Rozpocznij zamianę. Operacja zamiany może potrwać minutę.

5. Po zakończeniu zamiany przejdź do adresu URL aplikacji.

   

6. Wybierz przycisk Increment sześć razy.

7. Aplikacja powinna zakończyć się niepowodzeniem i zwrócić błąd HTTP 500.

8. Odśwież stronę (naciskając Command+R lub F5) kilka razy, aby wygenerować więcej błędów HTTP 500. Te błędy pomagają agentowi SRE wykrywać i diagnozować problem.

8. Napraw aplikację

Teraz, gdy w aplikacji występują błędy, użyj agenta SRE, aby zdiagnozować i rozwiązać problem:

1. W portalu Azure wyszukaj i wybierz Azure SRE Agent.

2. Na liście agentów wybierz pozycję my-app-service-sre-agent.

3. Wybierz pozycję Czat z agentem.

4. W polu czatu wprowadź następujące polecenie:

   What's wrong with my-sre-app?
   

5. Agent zaczyna analizować kondycję aplikacji. Powinny zostać wyświetlone komunikaty diagnostyczne związane z dostępnością, użyciem procesora i pamięci oraz niedawną zamianą slotów.

   Każda sesja może się różnić, ale powinien zostać wyświetlony komunikat podobny do poniższego przykładu:

   Teraz wykonam ograniczenie ryzyka dla aplikacji my-sre-app, zamieniając gniazda z powrotem w celu odzyskania aplikacji do stanu dobrej kondycji. Należy pamiętać, że zamiana slotów z powrotem nie zawsze natychmiast przywraca zdrowie. Będę cię aktualizował na temat postępu.

6. Po wstrzymaniu agent wyświetli monit o zatwierdzenie wycofania:

   Wycofywanie zamiany miejsc w celu przywrócenia dostępności aplikacji dla aplikacji my-sre-app

   [Zatwierdź][Odmów]

7. Wybierz pozycję Zatwierdź , aby zainicjować wycofanie.

8. Po zakończeniu wycofywania agent potwierdza:

   Wymiana slotu dla aplikacji my-sre-app została ukończona pomyślnie. Slot produkcyjny został przywrócony. Teraz będę kontynuować kroki po zredukowaniu skutków:

   Poprosim Cię o prawidłowy adres URL repozytorium GitHub, aby zgłosić problem dotyczący przestoju związanego z zamianą.Będę monitorować aplikację i zapewnić aktualizację dostępności w ciągu 5 minut.

   Podaj adres URL repozytorium GitHub, pod którym ma zostać zgłoszony problem.

9. Sprawdź poprawkę

Po wycofaniu zamiany miejsca agentA SRE upewnij się, że aplikacja działa prawidłowo:

1. Otwórz aplikację usługi App Service w przeglądarce, wybierając pozycję Przeglądaj na stronie Przegląd .

2. Zwróć uwagę, że tekst WŁĄCZONA INIEKCJA BŁĘDU nie jest już wyświetlany, potwierdzając, że aplikacja została przywrócona do pierwotnego stanu.

3. Wybierz przycisk Przyrostek sześć razy, aby upewnić się, że nie są wyświetlane żadne błędy.

Uprzątnij zasoby

Jeśli nie potrzebujesz już aplikacji i agenta utworzonego w tym samouczku, możesz usunąć skojarzone grupy zasobów, aby uniknąć naliczania opłat.

W tym samouczku utworzono następujące grupy zasobów:

• my-app-service-group (grupa zasobów usługi App Service)
• my-sre-agent-group (grupa zasobów agenta SRE)

Wykonaj następujące kroki dla każdej grupy zasobów:

1. W witrynie Azure Portal przejdź do pozycji Grupy zasobów.

2. Wybierz grupę zasobów, którą chcesz usunąć.

3. Na karcie Przegląd wybierz pozycję Usuń grupę zasobów.

4. W oknie dialogowym potwierdzenia wprowadź nazwę grupy zasobów.

5. Wybierz Usuń. Usunięcie trwa kilka minut.

Treści powiązane

• Omówienie agenta usługi Azure SRE
• Użycie agenta usługi Azure SRE