Tutorial: Memecahkan masalah aplikasi App Service dengan menggunakan Azure SRE Agent

Rekayasa keandalan situs (SRE) berfokus pada pembuatan sistem yang andal dan dapat diskalakan melalui otomatisasi dan manajemen proaktif. Azure SRE Agent menghadirkan prinsip-prinsip ini ke lingkungan cloud Anda dengan menyediakan kemampuan pemantauan, pemecahan masalah, dan remediasi yang didukung AI.

Agen SRE mengotomatiskan tugas operasional rutin dan memberikan wawasan beralasan untuk membantu Anda mempertahankan keandalan aplikasi sambil mengurangi intervensi manual. Agen SRE tersedia sebagai chatbot, sehingga Anda dapat mengajukan pertanyaan dan memberikan perintah bahasa alami untuk mempertahankan aplikasi dan layanan Anda. Untuk memastikan akurasi dan kontrol, tindakan apa pun yang dilakukan agen atas nama Anda memerlukan persetujuan Anda.

Aplikasi sampel dalam tutorial ini menunjukkan deteksi kesalahan dengan mensimulasikan kegagalan HTTP 500 dengan cara yang terkontrol. Anda dapat menguji skenario ini dengan aman dengan menggunakan slot penyebaran Azure App Service untuk menjalankan berbagai konfigurasi aplikasi secara berdampingan.

Anda mengaktifkan simulasi kesalahan dengan mengatur pengaturan aplikasi INJECT_ERROR ke 1. Ketika pengaturan ini diaktifkan, aplikasi melemparkan kesalahan HTTP 500 setelah Anda memilih tombol beberapa kali. Anda kemudian dapat melihat bagaimana Agen SRE merespons kegagalan aplikasi.

Di tutorial ini, Anda akan:

  • Buat aplikasi App Service dengan menggunakan portal Microsoft Azure.
  • Sebarkan aplikasi sampel dari GitHub.
  • Konfigurasikan aplikasi dengan perintah startup dan aktifkan pengelogan.
  • Buat slot penyebaran untuk mensimulasikan suatu kegagalan.
  • Siapkan agen untuk memantau aplikasi.
  • Memicu kegagalan dengan bertukar ke slot yang rusak.
  • Gunakan obrolan berbasis AI untuk mendiagnosis dan mengatasi masalah dengan mengembalikan pertukaran.

Prasyarat

Untuk membuat agen, Anda perlu memberi agen Anda izin yang benar, mengonfigurasi pengaturan yang benar, dan memberikan akses ke sumber daya yang tepat:

  • Akun Azure: Anda memerlukan akun Azure dengan langganan aktif. Jika Anda belum memilikinya, Anda dapat membuat akun secara gratis.

  • Konteks keamanan: Pastikan akun pengguna Anda memiliki Microsoft.Authorization/roleAssignments/write izin sebagai Administrator Kontrol Akses Berbasis Peran atau Administrator Akses Pengguna.

  • Pengaturan firewall: Tambahkan *.azuresre.ai ke daftar yang diizinkan di pengaturan firewall Anda. Beberapa profil jaringan mungkin memblokir akses ke *.azuresre.ai domain secara default.

1. Membuat aplikasi App Service

Mulailah dengan membuat aplikasi web yang dapat dipantau agen SRE:

  1. Masuk ke portal Azure.

  2. Pada bilah pencarian, cari App Services, lalu pilih di hasilnya.

  3. Pilih + Buat>Aplikasi Web.

  4. Pada tab Dasar , berikan detail berikut ini.

    Untuk detail Proyek, masukkan nilai-nilai ini:

    Pengaturan Nilai
    Subscription Langganan Azure Anda
    grup Sumber Daya Buat baru>my-app-service-group

    Untuk Detail instance, masukkan nilai-nilai ini:

    Pengaturan Nilai
    Nama my-sre-app
    Menerbitkan Kode
    Tumpukan waktu jalan .NET 9 (STS)
    Sistem operasi Windows
    Wilayah Wilayah di dekat Anda

  5. Pilih tab Penyebaran .

  6. Di bawah Pengaturan autentikasi, aktifkan Autentikasi dasar.

    Nota

    Autentikasi dasar digunakan nanti untuk satu kali penerapan dari GitHub. Nonaktifkan autentikasi dasar dalam produksi.

  7. Pilih Tinjau dan buat, lalu pilih Buat saat validasi lolos.

    Setelah penyebaran selesai, pesan Penyebaran Anda selesai muncul.

2. Sebarkan aplikasi sampel

Sekarang setelah aplikasi App Service Anda dibuat, sebarkan aplikasi sampel dari GitHub:

  1. Di portal Microsoft Azure, buka aplikasi App Service yang baru dibuat dengan memilih Buka sumber daya.

  2. Di menu sebelah kiri, di bagian Penyebaran , pilih Pusat Penyebaran.

  3. Pada tab Pengaturan , konfigurasikan nilai-nilai ini:

    Harta benda Nilai
    Sumber Git Eksternal
    Repositori https://github.com/Azure-Samples/app-service-dotnet-agent-tutorial
    Cabang utama

  4. Pilih Simpan untuk menerapkan pengaturan penyebaran.

3. Verifikasi aplikasi sampel

Setelah penyebaran, konfirmasikan bahwa aplikasi sampel berjalan seperti yang diharapkan:

  1. Di menu sebelah kiri aplikasi App Service Anda, pilih Gambaran Umum.

  2. Pilih Telusuri untuk membuka aplikasi pada tab browser baru. (Mungkin perlu waktu satu menit untuk memuat.)

  3. Aplikasi ini menampilkan penghitung besar dan dua tombol.

    Cuplikan layar sampel .NET di slot utama.

    Pilih tombol Tambah beberapa kali untuk mengamati peningkatan angka.

Siapkan slot peluncuran untuk simulasi kegagalan

Untuk mensimulasikan skenario kegagalan aplikasi, tambahkan slot penyebaran sekunder:

  1. Di menu sebelah kiri aplikasi App Service Anda, di bagian Penyebaran , pilih Slot penyebaran.

  2. Pilih Tambahkan slot.

  3. Masukkan nilai berikut:

    Harta benda Nilai Komentar
    Nama rusak Skenario kesalahan dipicu di slot ini.
    Mengkloning pengaturan dari my-sre-app Properti ini menyalin konfigurasi dari aplikasi utama.

  4. Gulir ke bagian bawah panel dan pilih Tambahkan. Pembuatan slot mungkin membutuhkan waktu satu menit untuk diselesaikan.

Sebarkan aplikasi contoh ke slot

  1. Setelah slot dibuat, pilih slot yang rusak dalam daftar.

  2. Di menu sebelah kiri, di bagian Penyebaran , pilih Pusat Penyebaran.

  3. Pada tab Pengaturan , konfigurasikan nilai-nilai ini:

    Harta benda Nilai
    Sumber Git Eksternal
    Repositori https://github.com/Azure-Samples/app-service-dotnet-agent-tutorial
    Cabang utama

  4. Pilih Simpan untuk menerapkan pengaturan penyebaran.

Menambahkan pengaturan aplikasi untuk mengaktifkan simulasi kesalahan

Untuk mengontrol simulasi kesalahan, konfigurasikan pengaturan aplikasi yang diperiksa aplikasi Anda saat runtime:

  1. Di menu sebelah kiri aplikasi App Service Anda, di bagian Pengaturan , pilih Variabel lingkungan.

  2. Di bagian atas, pastikan bahwa slot yang benar dipilih (misalnya, rusak).

  3. Pada tab Pengaturan aplikasi , pilih + Tambahkan.

  4. Masukkan nilai berikut:

    Harta benda Nilai Komentar
    Nama INJECT_ERROR Harus persis INJECT_ERROR (semua huruf besar, tanpa spasi)
    Nilai 1 Mengaktifkan simulasi kesalahan di aplikasi

  5. Pastikan bahwa kotak Pengaturan slot penyebarantidak dipilih.

  6. Pilih Terapkan untuk menambahkan pengaturan.

  7. Di bagian bawah halaman Variabel lingkungan , pilih Terapkan untuk menerapkan perubahan.

  8. Saat diminta, pilih Konfirmasi untuk mengonfirmasi dan memulai ulang aplikasi di slot yang dipilih.

5. Membuat agen

Sekarang, buat agen untuk memantau aplikasi App Service Anda:

  1. Ikuti tautan yang disediakan dalam email onboarding Anda untuk mengakses Agen SRE di portal Microsoft Azure.

  2. Pilih + Buat.

  3. Pada panel Buat agen , masukkan nilai-nilai ini:

    Harta benda Nilai Komentar
    Subscription Langganan Azure Anda
    grup Sumber Daya my-sre-agent-group Grup baru untuk agen.
    Nama my-sre-agent
    Wilayah US Timur 2

  4. Pilih Pilih grup sumber daya.

  5. Pada panel Grup sumber daya yang dipilih untuk dipantau , pilih kotak centang di samping my-app-service-group.

  6. Pilih Simpan.

  7. Kembali ke panel Buat agen , pilih Buat. Proses pembuatan agen membutuhkan waktu beberapa menit untuk diselesaikan.

6. Mengobrol dengan agen Anda

Setelah agen Anda disebarkan dan terhubung ke grup sumber daya, Anda dapat berinteraksi dengannya dengan menggunakan bahasa alami untuk memantau dan memecahkan masalah aplikasi Anda:

  1. Di portal Microsoft Azure, cari dan pilih Agen Azure SRE.

  2. Dalam daftar agen, pilih my-app-service-sre-agent.

  3. Pilih Obrolan dengan agen.

  4. Dalam kotak obrolan, masukkan perintah berikut:

    List my App Service apps

  5. Agen merespons dengan daftar aplikasi App Service yang disebarkan di grup sumber daya my-app-service-group .

Setelah agen dapat melihat aplikasi, Anda siap untuk mensimulasikan kegagalan dan membiarkan agen membantu Anda mengatasinya.

7. Putuskan aplikasi

Simulasikan skenario kegagalan dengan mengganti ke slot penerapan yang rusak.

  1. Di menu sebelah kiri aplikasi App Service Anda, di bagian Penyebaran , pilih Slot penyebaran.

  2. Pilih Tukar.

  3. Pada panel Swap , konfigurasikan nilai-nilai ini:

    Harta benda Nilai Komentar
    Sumber my-sre-app-broken Slot dengan versi yang rusak
    Target my-sre-app Slot produksi

  4. Gulir ke bawah dan pilih Mulai Pertukaran. Operasi pertukaran mungkin membutuhkan waktu satu menit untuk diselesaikan.

  5. Setelah pertukaran selesai, telusuri KE URL aplikasi.

    Cuplikan layar sampel .NET di slot yang rusak.

  6. Pilih tombol Kenaikan enam kali.

  7. Aplikasi harus gagal dan mengembalikan kesalahan HTTP 500.

  8. Refresh halaman (dengan menekan Command+R atau F5) beberapa kali untuk menghasilkan lebih banyak kesalahan HTTP 500. Kesalahan ini membantu Agen SRE mendeteksi dan mendiagnosis masalah.

8. Perbaiki aplikasi

Sekarang setelah aplikasi mengalami kegagalan, gunakan Agen SRE untuk mendiagnosis dan menyelesaikan masalah:

  1. Di portal Microsoft Azure, cari dan pilih Agen Azure SRE.

  2. Dalam daftar agen, pilih my-app-service-sre-agent.

  3. Pilih Obrolan dengan agen.

  4. Dalam kotak obrolan, masukkan perintah berikut:

    What's wrong with my-sre-app?

  5. Agen mulai menganalisis kesehatan aplikasi. Anda akan melihat pesan diagnostik yang terkait dengan ketersediaan, penggunaan CPU dan memori, dan pertukaran slot baru-baru ini.

    Setiap sesi dapat bervariasi, tetapi pesan yang mirip dengan contoh berikut akan muncul:

    Saya sekarang akan melakukan mitigasi untuk my-sre-app dengan menukar slot kembali untuk memulihkan aplikasi ke keadaan sehat. Harap dicatat bahwa bertukar slot kembali mungkin tidak selalu segera memulihkan kesehatan. Aku akan terus memberimu kabar terbaru tentang kemajuannya.

  6. Setelah jeda, agen meminta Anda untuk menyetujui pemutaran kembali:

    Melakukan rollback pada Slot Swap untuk mengembalikan ketersediaan aplikasi my-sre-app

    [Setujui][Tolak]

  7. Pilih Setujui untuk memulai pembatalan.

  8. Setelah pemutaran kembali selesai, agen mengonfirmasi:

    Pertukaran slot untuk my-sre-app telah berhasil diselesaikan (tanda waktu). Slot produksi telah dipulihkan. Saya sekarang akan melanjutkan dengan langkah-langkah pasca-mitigasi:

    Saya akan meminta ANDA untuk URL repositori GitHub yang benar untuk mengajukan masalah untuk waktu henti terkait pertukaran.Saya akan memantau aplikasi dan memberikan pembaruan ketersediaan dalam 5 menit.

    Harap berikan URL repositori GitHub tempat Anda ingin masalah dimunculkan.

9. Verifikasi perbaikan

Setelah Agen SRE mengembalikan pertukaran slot, konfirmasikan bahwa aplikasi Anda berfungsi dengan benar:

  1. Buka aplikasi App Service Anda di browser dengan memilih Telusuri di halaman Gambaran Umum .

  2. Perhatikan bahwa teks INJEKSI KESALAHAN DIAKTIFKAN tidak lagi muncul, mengonfirmasi bahwa aplikasi kembali ke status aslinya.

  3. Pilih tombol Kenaikan enam kali untuk memastikan bahwa tidak ada kesalahan yang muncul.

Membersihkan sumber daya

Jika Anda tidak lagi memerlukan aplikasi dan agen yang Anda buat dalam tutorial ini, Anda dapat menghapus grup sumber daya terkait untuk menghindari dikenakan biaya.

Anda membuat grup sumber daya berikut dalam tutorial ini:

  • my-app-service-group (grup sumber daya App Service)
  • my-sre-agent-group (grup sumber daya SRE Agent)

Gunakan langkah-langkah berikut untuk setiap grup sumber daya:

  1. Di portal Microsoft Azure, buka Grup sumber daya.

  2. Pilih grup sumber daya yang ingin Anda hapus.

  3. Pada tab Gambaran Umum , pilih Hapus grup sumber daya.

  4. Dalam dialog konfirmasi, masukkan nama grup sumber daya.

  5. Pilih Hapus. Penghapusan membutuhkan waktu beberapa menit untuk diselesaikan.

Langkah selanjutnya

Mendiagnosis dengan observabilitas Azure

Konten terkait

  • Last updated on