Memecahkan masalah aplikasi App Service menggunakan Azure SRE Agent (pratinjau)

Nota

Azure SRE Agent dalam tahap pratinjau. Dengan menggunakan Agen SRE, Anda menyetujui Ketentuan Penggunaan Pratinjau khusus produk.

Rekayasa Keandalan Situs (SRE) berfokus pada pembuatan sistem yang andal dan dapat diskalakan melalui otomatisasi dan manajemen proaktif. Agen SRE membawa 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. Tersedia sebagai chatbot, Anda dapat mengajukan pertanyaan dan memberikan perintah bahasa alami untuk mempertahankan aplikasi dan layanan Anda. Untuk memastikan akurasi dan kontrol, setiap tindakan agen yang diambil atas nama Anda memerlukan persetujuan Anda.

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

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

Dalam tutorial ini, Anda akan:

• Buat aplikasi App Service 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 Azure SRE untuk memantau aplikasi.
• Memicu kegagalan dengan bertukar ke slot yang rusak.
• Gunakan obrolan berbasis AI untuk mendiagnosis dan menyelesaikan masalah dengan mengembalikan pertukaran.

Jika Anda tidak memiliki akun Azure, buat akun gratis sebelum memulai.

Prasyarat

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

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

• Namespace: Menggunakan cloud shell di portal Microsoft Azure, jalankan perintah berikut:

  az provider register --namespace "Microsoft.App"
  

• Akses ke wilayah Swedia Tengah: Selama pratinjau, satu-satunya wilayah yang diizinkan untuk Agen SRE adalah Swedia Tengah. Pastikan akun pengguna Anda memiliki izin dan izin pemilik atau admin untuk membuat sumber daya di wilayah Swedia Tengah.

1. Membuat aplikasi App Service

Mulailah dengan membuat aplikasi web yang dapat dipantau oleh Agen SRE.

1. Masuk ke https://portal.azure.com.

2. Di bilah pencarian atas, cari App Services, lalu pilih dari hasil.

3. Pilih + Buat dan pilih Aplikasi Web.

Konfigurasikan tab Dasar

Di tab Dasar , berikan detail berikut ini:

Detail proyek

Pengaturan	Nilai
Langganan	Langganan Azure Anda
Grup sumber daya	Buat barumy-app-service-group

Rincian contoh

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

1. Pilih tab Penyebaran .

2. Di bawah Pengaturan autentikasi, aktifkan Autentikasi dasar.

   Nota

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

3. Pilih Tinjau dan buat, lalu Buat saat validasi lolos.

4. Setelah penyebaran selesai, Anda akan melihat Penyebaran Anda selesai.

2. Sebarkan aplikasi sampel

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

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

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

3. Di tab Pengaturan , konfigurasikan:

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

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 App Service Anda, pilih Gambaran Umum.

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

3. Aplikasi ini menampilkan penghitung besar dan dua tombol:

   

4. 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 dari App Service Anda, di bagian Penyebaran, pilih Slot Penyebaran.

2. Pilih Tambahkan slot.

3. Masukkan nilai berikut:

   Harta benda	Nilai	Komentar
   Nama	broken	Skenario kesalahan dipicu di slot ini.
   Klon pengaturan dari	my-sre-app	Menyalin konfigurasi dari aplikasi utama.

4. Gulir ke bagian bawah jendela dialog 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 dari daftar.

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

3. Di tab Pengaturan , konfigurasikan:

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

4. Pilih Simpan untuk menerapkan pengaturan penyebaran.

Menambahkan pengaturan aplikasi untuk mengaktifkan simulasi kesalahan

Untuk mengontrol simulasi kesalahan, konfigurasikan aplikasi yang mengatur pemeriksaan aplikasi Anda saat runtime.

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

2. Di bagian atas, pastikan Anda telah memilih slot yang benar (misalnya, rusak).

3. Di bawah tab Pengaturan aplikasi , pilih + Tambahkan.

4. Masukkan nilai berikut:

   Harta benda	Nilai	Komentar
   Nama	INJECT_ERROR	Harus tepat INJECT_ERROR (semua huruf besar, tidak ada spasi).
   Nilai	1	Mengaktifkan simulasi kesalahan di aplikasi.

5. Pastikan kotak Pengaturan slot penyebarantidak dicentang.

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. Buat Agen Azure SRE

Sekarang, buat Agen Azure SRE untuk memantau aplikasi App Service Anda.

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

2. Pilih + Buat.

3. Di jendela Buat agen , masukkan nilai berikut ini:

   Harta benda	Nilai	Komentar
   Langganan	Langganan Azure Anda
   Grup sumber daya	my-sre-agent-group	Grup baru untuk Agen Azure SRE
   Nama	my-sre-agent
   Wilayah	Swedia Tengah	Diperlukan selama pratinjau; dapat memantau sumber daya di wilayah Azure mana pun
   Pilih peran	Kontributor	Memberikan izin kepada agen untuk mengambil tindakan atas nama Anda

4. Pilih Pilih grup sumber daya.

5. Di jendela Grup sumber daya yang dipilih untuk dipantau , cari dan pilih my-app-service-group.

6. Pilih Simpan.

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

6. Mengobrol dengan agen Anda

Setelah Agen SRE Anda disebarkan dan terhubung ke grup sumber daya, Anda dapat berinteraksi dengannya menggunakan bahasa alami untuk memantau dan memecahkan masalah aplikasi Anda.

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

2. Dari 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 tersebut mengirimkan respon berupa daftar aplikasi App Service yang disebarkan dalam 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

Sekarang simulasikan skenario kegagalan dengan beralih ke slot penempatan yang rusak.

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

2. Pilih Tukar.

3. Dalam dialog Tukar , konfigurasikan:

   Harta benda	Nilai	Komentar
   Sumber	my-sre-app-broken	Slot dengan versi yang rusak
   Sasaran	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.

   

6. Pilih tombol "Kenaikan" enam kali.

7. Anda akan melihat aplikasi gagal dan mengembalikan kesalahan HTTP 500.

8. Refresh halaman (dengan menekan Command-R atau F5) beberapa kali untuk menghasilkan lebih banyak kesalahan HTTP 500, yang 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. Dari 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 Anda akan melihat pesan yang mirip dengan:

   "Saya sekarang akan melaksanakan mitigasi untuk my-sre-app dengan mengembalikan slot agar aplikasi dapat kembali ke kondisi semula." Harap dicatat bahwa bertukar slot kembali mungkin tidak selalu segera memulihkan kesehatan. Saya akan terus memberi Anda kabar terbaru tentang kemajuan."

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 rollback 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 dari halaman Gambaran Umum .

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

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

Membersihkan sumber daya

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

Ulangi langkah-langkah berikut untuk kedua grup sumber daya ini:

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

1. Di portal Azure, navigasikan ke Grup sumber daya.

2. Pilih grup sumber daya yang ingin Anda hapus.

3. Dari 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

• Gambaran umum Agen SRE
• Penggunaan Agen Azure SRE