alibabacloud-sls-alerting adalah Agent Skill yang memungkinkan Anda mengelola aturan pemantauan peringatan Simple Log Service (SLS), mengonfigurasi notifikasi peringatan, dan menganalisis event peringatan melalui bahasa alami dalam agen AI. Setelah diinstal, agen akan menghasilkan konfigurasi berdasarkan permintaan Anda, menjalankan operasi melalui Alibaba Cloud CLI, lalu mengembalikan hasil verifikasi atau kesimpulan diagnosis.
Skenario
alibabacloud-sls-alerting mendukung skenario berikut:
| Skenario | Deskripsi | Contoh prompt | Panduan langkah demi langkah |
| Buat aturan pemantauan peringatan | Buat aturan pemantauan peringatan dan konfigurasikan kondisi evaluasi serta pemicunya berdasarkan metrik bisnis dan kebutuhan pemantauan. | Buat aturan pemantauan peringatan SLS untuk prod-web/nginx-access. Periksa log akses 5 menit terakhir setiap menit, dan picu peringatan ketika jumlah permintaan dengan kode status 500 mencapai 100. Kirim notifikasi ke grup DingTalk "Web Ops". | Skenario 1 |
| Kelola aturan pemantauan peringatan yang ada | Kueri dan perbarui aturan pemantauan peringatan yang ada, nonaktifkan sementara notifikasi peringatan, serta nonaktifkan, aktifkan ulang, atau hapus aturan pemantauan peringatan. | Nonaktifkan sementara notifikasi peringatan web-500-alert di prod-web selama 30 menit ke depan. | Skenario 2 dan Skenario 5 |
| Konfigurasi notifikasi peringatan | Konfigurasikan Penerima Notifikasi, kebijakan, dan konten untuk saluran notifikasi seperti email, SMS, panggilan telepon, dan DingTalk. | Tambahkan penerima notifikasi peringatan SLS dengan alamat email xxx@example.com, nama xxx, dan nomor ponsel xxx. Lalu tambahkan penerima ini ke aturan pemantauan peringatan xxx. | Skenario 3 |
| Kurangi kebisingan peringatan | Sesuaikan kebijakan pemicu dan notifikasi peringatan untuk mengurangi peringatan duplikat dan notifikasi yang tidak efektif. | web-500-alert di prod-web sering memicu peringatan akibat fluktuasi singkat dan mengirim terlalu banyak notifikasi. Ubah agar peringatan hanya dipicu setelah 3 pemeriksaan berturut-turut memenuhi kondisi, dan kirim pengingat setiap 30 menit selama masalah yang sama masih berlangsung. | — |
| Mendiagnosis event peringatan | Jalankan analisis akar penyebab pada riwayat peringatan dan log terkait untuk membantu menemukan penyebab kegagalan. | web-500-alert di prod-web terus-menerus memicu peringatan sepanjang pagi ini. Periksa log terkait untuk menemukan akar penyebabnya, jelaskan secara spesifik apa yang salah, dan beri tahu langkah selanjutnya. | Skenario 4 |
Prasyarat
Agen AI yang mendukung Agent Skills dan dapat menjalankan perintah lokal.
Sebelum membuat aturan pemantauan peringatan berbasis log di sistem pemantauan dan peringatan, pastikan Proyek dan LogStore standar sudah tersedia, log telah dikumpulkan, serta konfigurasi bidang mencakup indeks untuk bidang-bidang yang digunakan dalam kueri. Bidang yang digunakan dalam analisis SQL juga harus memenuhi persyaratan konfigurasi analisis yang sesuai. Untuk informasi lebih lanjut, lihat Buat aturan pemantauan peringatan untuk log.
Konfigurasikan kredensial Alibaba Cloud yang dapat mengakses resource target, dan berikan izin pada aturan pemantauan peringatan, resource notifikasi, atau LogSearch sesuai kebutuhan operasi.
Operasi cloud memerlukan Alibaba Cloud CLI versi 3.3.22 atau lebih baru dan plugin SLS. Skrip validasi konfigurasi lokal yang disertakan dalam skill ini memerlukan Python 3.7 atau lebih baru. Instalasi skill menggunakan npx memerlukan Node.js. Saat pertama kali digunakan, agen dapat memeriksa lingkungan dan memberikan panduan instalasi.
Untuk mengonfigurasi notifikasi peringatan, siapkan informasi penerima atau integrasi webhook yang tersedia. Untuk mendiagnosis event peringatan historis, pastikan riwayat peringatan atau data arsip dapat diakses.
Menampilkan aturan pemantauan peringatan, mengelola resource notifikasi, atau menjelaskan konfigurasi tidak memerlukan data log bisnis baru sebelumnya.
Jangan tempel ID AccessKey, Rahasia AccessKey, token Layanan Token Keamanan (token STS), kunci penandatanganan webhook, atau URL lengkap yang berisi token ke dalam percakapan agen. Kelola informasi ini melalui metode konfigurasi kredensial yang didukung oleh Alibaba Cloud CLI dan saluran konfigurasi aman di lingkungan Anda.
Instal skill
alibabacloud-sls-alerting termasuk dalam repositori skill resmi Alibaba Cloud. Instal dengan salah satu cara berikut:
Jika Node.js dan npx tersedia secara lokal, gunakan Metode 1 (direkomendasikan).
Jika Node.js tidak tersedia, gunakan Metode 2 yang tidak memerlukan Node.js.
Metode 1 (direkomendasikan): Instal dengan npx
Sebelum instalasi, jalankan perintah berikut untuk memastikan Node.js dan npx tersedia secara lokal:
node -v
npx -vJika salah satu perintah tidak ditemukan, instal Node.js terlebih dahulu.
Jalankan perintah berikut untuk menginstal skill:
npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-sls-alerting --full-depthPilih agen target dan cakupan instalasi sesuai petunjuk installer. Setelah instalasi, pastikan alibabacloud-sls-alerting ada di direktori skill yang sesuai, lalu muat ulang skill atau restart agen.
Metode 2: Unduh dan instal secara manual
Unduh paket alibabacloud-sls-alerting dari GitHub Release, ekstrak, lalu salin file-file tersebut ke direktori instalasi skill agen.
Setelah menyalin, pastikan direktori alibabacloud-sls-alerting ada di direktori skill, lalu restart agen untuk memuat skill tersebut.
Direktori instalasi skill untuk agen umum adalah sebagai berikut:
| Agen | Direktori instalasi tingkat proyek | Direktori instalasi tingkat pengguna |
| Claude Code | .claude/skills | ~/.claude/skills |
| Codex | .agents/skills | ~/.agents/skills |
| Qoder | .qoder/skills | ~/.qoder/skills |
| QwenCode | .qwen/skills | ~/.qwen/skills |
| OpenClaw | <workspace>/skills | ~/.openclaw/skills |
Di sini, ~ menunjukkan direktori home pengguna. Direktori workspace dan tingkat pengguna OpenClaw dapat disesuaikan melalui konfigurasi. Untuk informasi lebih lanjut, lihat Dokumentasi Skill OpenClaw.
(Direkomendasikan) Instal alibabacloud-sls-query bersamaan dengan skill peringatan. Skill kueri membantu menghasilkan dan mengoptimalkan pernyataan kueri peringatan, serta membantu diagnosis event peringatan dengan melakukan kueri dan analisis log terkait.
Kelola dan diagnosa peringatan
Setelah menginstal alibabacloud-sls-alerting, jelaskan kebutuhan peringatan Anda di agen. Agen akan memilih alur kerja berdasarkan tugas:
| Jenis tugas | Alur kerja utama |
| Buat atau modifikasi aturan pemantauan peringatan | Periksa lingkungan dan izin → identifikasi resource dan bidang → baca konfigurasi atau resource notifikasi yang ada → validasi kueri dan konfigurasi → kirim perubahan → baca hasil dan verifikasi. |
| Kelola resource notifikasi | Identifikasi penerima, saluran, dan kebijakan → periksa resource yang ada dan referensinya → buat atau perbarui resource yang diperlukan → verifikasi konfigurasi. |
| Diagnosa event peringatan | Identifikasi aturan pemantauan peringatan dan waktu event → kueri riwayat peringatan → bandingkan kondisi pemicu dengan jendela kueri aktual → kueri log sumber dan log terkait → keluarkan kesimpulan dan bukti. |
Pada eksekusi pertama, agen akan memeriksa Alibaba Cloud CLI dan plugin SLS. Jika komponen tidak tersedia atau versinya tidak memenuhi persyaratan, agen akan memberikan panduan instalasi atau peningkatan. Konfigurasikan kredensial di terminal lokal Anda. Untuk petunjuknya, lihat Konfigurasi dan kelola kredensial.
Praktik terbaik prompt
Saat membuat atau memodifikasi aturan pemantauan peringatan, berikan informasi berikut:
| Informasi | Contoh |
| Resource target | Aturan pemantauan peringatan termasuk dalam proyek prod-web di wilayah cn-hangzhou, dan LogStore sumber data adalah prod-web. |
| Identitas aturan pemantauan peringatan | ID aturan pemantauan peringatan adalah web-500-alert, dan nama tampilannya adalah "Peringatan Error 500 Layanan Web". |
| Kondisi pemicu peringatan | Jumlah permintaan dengan status 500 mencapai 100. |
| Satuan bidang | Satuan request_time adalah detik. |
| Pengaturan waktu | Periksa setiap menit, dan kueri 5 menit terakhir setiap kali. |
| Notifikasi peringatan | Beritahu penerima yang ditentukan melalui email dan SMS. |
| Tujuan eksekusi | Buat aturan pemantauan peringatan; perbarui aturan pemantauan peringatan yang ada; hasilkan hanya draf konfigurasi; hanya kueri dan diagnosa. |
Saat mendiagnosis event peringatan, berikan Proyek tempat aturan pemantauan peringatan berada, ID aturan pemantauan peringatan, rentang waktu event, dan zona waktu. Jika log diarsipkan di lokasi lain, berikan juga Proyek arsip, LogStore, dan bidang waktu.
Frekuensi pemeriksaan dan jendela waktu kueri mengontrol perilaku yang berbeda. Sebutkan keduanya secara eksplisit dalam prompt:
| Parameter | Tujuan | Contoh |
| Frekuensi pemeriksaan | Seberapa sering pemeriksaan peringatan dijalankan. | Jalankan sekali setiap 1 menit. |
| Jendela waktu kueri | Rentang data yang digunakan setiap pemeriksaan. | Kueri 5 menit terakhir. |
Misalnya, "periksa data 5 menit terakhir setiap menit" berarti pemeriksaan dijalankan sekali setiap 1 menit, dan setiap pemeriksaan menggunakan log 5 menit terakhir.
Skenario 1: Buat aturan pemantauan peringatan
Prompt
Buat aturan pemantauan peringatan SLS dengan ID web-500-alert di prod-web di wilayah cn-hangzhou.
Periksa log akses 5 menit terakhir di nginx-access setiap menit, dan picu peringatan ketika jumlah permintaan dengan status 500 mencapai 100.
Kirim notifikasi peringatan melalui email ke penerima yang sudah ada web-ops@example.com.Contoh output agen
Pernyataan kueri:
status : 500 | SELECT count(*) AS errorCount FROM log
Konfigurasi aturan pemantauan peringatan:
- ID aturan pemantauan peringatan: web-500-alert
- Sumber data: prod-web/nginx-access
- Frekuensi pemeriksaan: 1 menit
- Jendela kueri: 5 menit terakhir
- Kondisi pemicu: errorCount >= 100
- Notifikasi peringatan: email, web-ops@example.com
Hasil konfigurasi: aturan pemantauan peringatan berhasil dibuat. Kondisi pemicu dan konfigurasi notifikasi email telah diverifikasi.Skenario 2: Ubah kondisi pemicu aturan pemantauan peringatan yang ada
Prompt
Modifikasi aturan pemantauan peringatan SLS web-500-alert di prod-web di wilayah cn-hangzhou.
Ubah ambang batas peringatan untuk jumlah permintaan dengan kode status 500 dari 100 menjadi 200, dan pertahankan pengaturan lainnya.Contoh output agen
| Item konfigurasi | Sebelum | Sesudah |
| Kondisi pemicu peringatan | errorCount >= 100 | errorCount >= 200 |
| Frekuensi pemeriksaan | 1 menit | 1 menit |
| Jendela kueri | 5 menit terakhir | 5 menit terakhir |
Hasil pembaruan: aturan pemantauan peringatan berhasil diperbarui. Ambang batas peringatan diverifikasi sebagai 200, dan pengaturan lainnya tetap tidak berubah.Skenario 3: Konfigurasi notifikasi email dan SMS
Prompt
Tambahkan penerima notifikasi peringatan SLS dengan nama xxx, alamat email xxx@example.com, dan nomor ponsel xxx.
Lalu tambahkan notifikasi email dan SMS untuk aturan pemantauan peringatan web-500-alert di prod-web di wilayah cn-hangzhou,
dan kirim keduanya ke penerima ini.Contoh output agen
Penerima notifikasi peringatan ditambahkan:
- Nama: xxx
- Email: xxx@example.com
- Nomor ponsel: xxx
Konfigurasi notifikasi peringatan:
- Aturan pemantauan peringatan: prod-web/web-500-alert
- Penerima: xxx
- Saluran notifikasi: email, SMS
Hasil konfigurasi: notifikasi email dan SMS untuk penerima ini telah ditambahkan ke aturan pemantauan peringatan. Informasi penerima dan konfigurasi saluran telah diverifikasi.Skenario 4: Analisis penyebab peringatan dan durasinya
Prompt
Aturan pemantauan peringatan SLS web-500-alert di prod-web memicu beberapa kali pagi ini. Selidiki penyebabnya.Contoh output agen
Rentang event: 2026-09-10 09:00-10:00, waktu Beijing (UTC+8).
Aturan pemantauan peringatan: prod-web/web-500-alert.
Penyebab pemicu:
- Riwayat menunjukkan bahwa kondisi pemicu saat itu adalah errorCount >= 100.
- Catatan eksekusi pukul 09:10 menggunakan jendela log sumber 09:05-09:10, dan errorCount bernilai 186.
- Log sumber jendela tersebut dikueri ulang. Statistiknya sesuai dengan catatan dan memenuhi kondisi pemicu saat itu.
Frekuensi dan durasi:
- Setelah deduplikasi berdasarkan ID eksekusi, 6 eksekusi antara 09:10 dan 09:15 berada dalam status pemicu.
- Eksekusi ini termasuk dalam 1 peringatan berkelanjutan.
- Terdapat catatan pemulihan pada 09:16. Waktu dari pemicu pertama hingga pemulihan sekitar 6 menit.
- Jumlah eksekusi pemicu tidak sama dengan jumlah notifikasi. Pengiriman aktual mengikuti catatan notifikasi.
Bukti log sumber:
- Kueri yang dijalankan: status : 500 | SELECT count(*) AS errorCount FROM log
- Jendela kueri: 09:05-09:10, mengembalikan errorCount=186.
- Setelah drill-down berdasarkan request_uri, /api/order/create menyumbang 142 hit, sekitar 76,3%.
- Log error API ini berisi upstream connect timeout.
Kesimpulan: peringatan dipicu karena jumlah permintaan dengan kode status 500 mencapai ambang batas. Error terkonsentrasi pada /api/order/create.
Langkah selanjutnya: periksa status koneksi upstream dan log layanan. Bukti saat ini belum cukup untuk mengonfirmasi penyebab mendasar timeout tersebut.Dalam contoh ini, log sumber merupakan bagian dari bukti yang digunakan dalam diagnosis.
Skenario 5: Nonaktifkan sementara notifikasi peringatan
Prompt
Nonaktifkan sementara notifikasi peringatan SLS web-500-alert di prod-web selama 30 menit.Contoh output agen
Nonaktifkan sementara telah diatur:
- Aturan pemantauan peringatan: prod-web/web-500-alert
- Durasi: 30 menit mulai sekarang
- Cakupan: notifikasi peringatan yang dihasilkan oleh aturan pemantauan peringatan ini
Aturan pemantauan peringatan tetap menjalankan pemeriksaan, dan notifikasi peringatan dijeda selama periode nonaktif.
Nonaktif otomatis berakhir setelah 30 menit, dan notifikasi selanjutnya mengikuti konfigurasi asli.Batasan
| Batas | Deskripsi |
| Konfigurasi indeks | Sebelum membuat aturan pemantauan peringatan berdasarkan kueri log, indeks harus dikonfigurasi untuk LogStore target, dan tipe bidang serta konfigurasi analisis SQL harus memenuhi persyaratan kueri. |
| Timeout kueri | Kueri mungkin mengalami timeout saat agen memvalidasi kueri peringatan atau menganalisis log historis. Persempit rentang waktu kueri atau sederhanakan pernyataan kueri, lalu coba lagi. |
| Lingkungan waktu proses | Operasi peringatan dan validasi konfigurasi lokal memerlukan versi tool tertentu. Untuk persyaratan lingkungan lengkap, lihat Prasyarat. |
| Riwayat peringatan | Mendiagnosis event peringatan memerlukan riwayat peringatan yang diaktifkan dan dapat diakses. Rentang waktu yang dapat dianalisis dibatasi oleh periode retensi riwayat peringatan dan log sumber. |
FAQ
Apakah saya perlu menginstal Alibaba Cloud CLI dan plugin SLS secara manual?
Agen akan memeriksa lingkungan sebelum menjalankan operasi dan memberikan panduan instalasi atau peningkatan jika komponen tidak tersedia atau versinya tidak memenuhi persyaratan. Untuk memeriksa atau memperbarui lingkungan secara manual, lihat Alibaba Cloud CLI atau plugin SLS tidak tersedia atau usang.
Bagaimana cara menentukan akun Alibaba Cloud atau wilayah?
Profil yang saat ini dikonfigurasi di Alibaba Cloud CLI digunakan secara default. Untuk menggunakan profil lain, sebutkan namanya secara eksplisit dalam prompt, misalnya, "Gunakan Profile=prod untuk mengelola aturan pemantauan peringatan prod-web di cn-hangzhou."
Proyek tempat aturan pemantauan peringatan berada, sumber data kueri, dan riwayat peringatan mungkin berada di wilayah yang berbeda. Berikan atau verifikasi masing-masing secara terpisah. Untuk mengakses melalui jaringan internal, mintalah secara eksplisit titik akhir internal wilayah yang sesuai, misalnya, cn-hangzhou-intranet.log.aliyuncs.com.
Apakah saya dapat melakukan kueri data lintas proyek, wilayah, atau akun?
Proyek tempat aturan pemantauan peringatan berada dan sumber data kueri dapat berbeda. Tentukan Proyek, LogStore, dan wilayah sumber data, serta pastikan izin yang sesuai telah diberikan.
Kueri lintas akun juga memerlukan Peran RAM yang dapat diasumsikan oleh SLS, hubungan kepercayaannya, dan izin akses ke data sumber. Konfigurator mungkin juga memerlukan izin ram:PassRole. Kueri CLI manual yang berhasil tidak berarti identitas waktu proses aturan pemantauan peringatan sudah memiliki izin akses.
Pemecahan Masalah
Agen tidak mengenali skill setelah instalasi
Pastikan skill diinstal di direktori yang benar-benar dimuat oleh agen saat ini, dan direktori tersebut berisi SKILL.md, references, dan scripts. Periksa apakah instalasi tingkat proyek sesuai dengan direktori kerja saat ini, lalu muat ulang skill atau restart agen. Anda juga dapat menyebutkan alibabacloud-sls-alerting secara eksplisit dalam prompt.
Alibaba Cloud CLI atau plugin SLS tidak tersedia atau usang
Periksa Alibaba Cloud CLI dan plugin SLS di terminal Anda:
aliyun version
aliyun sls versionJika plugin SLS tidak tersedia, jalankan perintah berikut:
aliyun plugin install --names slsJika plugin sudah terinstal tetapi perintah atau parameter yang diperlukan tidak tersedia, jalankan perintah berikut:
aliyun plugin update --name slsError ProjectNotExist
Periksa nama Proyek, wilayahnya, dan titik akhirnya. Proyek tempat aturan pemantauan peringatan berada dan Proyek sumber data kueri dapat berbeda, jadi pastikan permintaan mana yang gagal. Jangan anggap hasil "tidak ditemukan" di wilayah yang salah sebagai bukti bahwa resource tidak ada.
Error IndexConfigNotExist atau bidang yang tidak dapat dianalisis
Pastikan indeks telah dikonfigurasi untuk LogStore target, dan tipe bidang serta pengaturan analisis SQL yang digunakan oleh kueri sudah benar. Misalnya, perhitungan latensi rata-rata harus menggunakan bidang numerik, dan satuannya harus diverifikasi. Setelah menyesuaikan indeks, validasi ulang kueri dalam cakupan efektif indeks tersebut.
Aturan pemantauan peringatan berhasil dibuat tetapi tidak ada notifikasi yang masuk
Lakukan pemecahan masalah dalam urutan berikut:
Periksa apakah aturan pemantauan peringatan diaktifkan dan apakah catatan eksekusi normal dihasilkan.
Periksa jendela kueri aktual, hasil yang dikembalikan, kondisi pemicu, dan ambang batas pemicu berkelanjutan untuk memastikan apakah event peringatan dihasilkan.
Periksa apakah output notifikasi SLS diaktifkan, serta apakah kebijakan peringatan dan kebijakan tindakan yang terkait dengan aturan pemantauan peringatan sudah benar.
Periksa apakah interval pengulangan, nonaktif, penekanan, percabangan kondisional, atau periode pengiriman berpengaruh.
Periksa status penerima, sakelar saluran, konten templat, dan pengaturan webhook, lalu tinjau catatan error notifikasi.
Konfigurasi yang berhasil dan pengiriman notifikasi aktual harus diverifikasi secara terpisah.
Diagnosis event peringatan tidak dapat menemukan riwayat peringatan
Pertama, pastikan rentang waktu, zona waktu, ID aturan pemantauan peringatan, wilayah tempat riwayat disimpan, dan izin akses.
Riwayat Alert Center biasanya disimpan di internal-alert-center-log di bawah sls-alert-<ID akun>-<wilayah>. Riwayat eksekusi proyek disimpan di internal-alert-history di bawah Proyek tempat aturan pemantauan peringatan berada. Keduanya memiliki bidang dan tujuan yang berbeda. Untuk informasi lebih lanjut, lihat Gunakan pernyataan kueri kustom untuk menganalisis log peringatan.
Saat pertama kali menggunakan Alert Center, lengkapi pemilihan Region di Konsol SLS. Riwayat eksekusi proyek diaktifkan dengan mengakses halaman detail aturan pemantauan peringatan yang sesuai di konsol untuk pertama kalinya. Untuk informasi tentang cara melihat detail aturan pemantauan peringatan dan laporan statistik historis, lihat Kelola aturan pemantauan peringatan.