Mengimpor peringatan Grafana ke Layanan Log (Grafana 8.0 dan yang lebih baru) -

Grafana menyediakan antarmuka pengguna grafis (GUI) untuk menggunakan fitur peringatan. Anda dapat menambahkan titik kontak di Grafana sehingga Grafana dapat mengirim peringatan ke sistem peringatan Layanan Log. Sistem tersebut kemudian memproses peringatan, seperti melakukan penghilangan derau dan mengirim notifikasi. Jika versi Grafana Anda adalah 8.0 atau lebih baru, ikuti petunjuk dalam topik ini.

Prasyarat

Aplikasi impor peringatan telah dibuat. Untuk informasi lebih lanjut, lihat Konfigurasikan URL Webhook untuk Impor Peringatan.

Konfigurasikan Grafana

Masuk ke konsol Grafana.

Buat titik kontak.

Di panel navigasi sisi kiri, pilih Alerting > Contact points dan klik New contact point.

Pada halaman Create contact point, konfigurasikan parameter berikut.

Parameter	Deskripsi
Name	Nama dari titik kontak.
Contact point type	Jenis dari titik kontak. Dalam contoh ini, pilih webhook.
Url	URL dari titik kontak. Dalam contoh ini, masukkan URL lengkap dari URL webhook yang dihasilkan setelah Anda membuat layanan impor peringatan dan aplikasi impor peringatan dalam sistem impor peringatan Layanan Log. Untuk informasi lebih lanjut, lihat Dapatkan URL webhook.

Klik Save contact point.

Tambahkan titik kontak ke kebijakan notifikasi.
Anda dapat menambahkan titik kontak ke kebijakan notifikasi root atau membuat rute dan menambahkan titik kontak ke rute tersebut. Dalam contoh ini, tambahkan titik kontak ke kebijakan notifikasi root.
1. Klik Notification policies.
2. Di bagian Root policy - default for all alerts, klik Edit.
3. Di daftar drop-down Default contact point, pilih titik kontak yang dibuat di Langkah 2.
4. Klik Save.

Peringatan Grafana

Berikut ini adalah contoh kode yang menunjukkan peringatan Grafana:

{
    "receiver": "http",
    "status": "firing",
    "alerts":
    [
        {
            "status": "firing",
            "labels":
            {
                "alertname": "test"
            },
            "annotations":
            {
                "description": "peringatan uji coba",
            },
            "startsAt": "2022-02-17T21:44:07.106902+08:00",
            "endsAt": "0001-01-01T00:00:00Z",
            "generatorURL": "http://localhost:3000/alerting/abcd/edit",
            "fingerprint": "65d7bbdb01ce6c93",
            "silenceURL": "http://localhost:3000/alerting/silence/new?alertmanager=grafana&matchers=alertname%3Dtest",
            "dashboardURL": "",
            "panelURL": "",
            "valueString": "[ metric='go_threads{instance=\"prometheus\", job=\"prometheus\"}' labels={__name__=go_threads, instance=prometheus, job=prometheus} value=15 ]"
        }
    ],
    "groupLabels":
    {},
    "commonLabels":
    {
        "alertname": "test"
    },
    "commonAnnotations":
    {
        "description": "peringatan uji coba",
    },
    "externalURL": "http://localhost:3000/",
    "version": "1",
    "groupKey": "{}/{alertname=\"test\"}:{}",
    "truncatedAlerts": 0,
    "orgId": 1,
    "title": "[FIRING:1]  (test)",
    "state": "alerting",
    "message": "**Firing**\n\nValue: [ metric='go_threads{instance=\"prometheus\", job=\"prometheus\"}' labels={__name__=go_threads, instance=prometheus, job=prometheus} value=15 ]\nLabels:\n - alertname = test\nAnnotations:\n - description = peringatan uji coba\nSource: http://localhost:3000/alerting/abcd/edit\nSilence: http://localhost:3000/alerting/silence/new?alertmanager=grafana&matchers=alertname%3Dtest\n"
}

Pemetaan bidang

Setelah peringatan Grafana diimpor ke Layanan Log, peringatan tersebut dikonversi menjadi peringatan Layanan Log berdasarkan pemetaan bidang. Berikut ini adalah contoh kode yang menunjukkan peringatan Layanan Log:

{
    "aliuid": "{ID akun Alibaba Cloud tempat aplikasi impor peringatan berada}",
    "alert_instance_id": "{ID instansi peringatan yang dihasilkan secara otomatis}",
    "alert_id": "test",
    "alert_type": "sls_pub",
    "alert_name": "test",
    "region": "{Wilayah proyek tempat Pusat Peringatan berada}",
    "project": "{Proyek tempat Pusat Peringatan berada}",
    "project_id": 0,
    "next_eval_interval": 0,
    "alert_time": 1645607565,
    "fire_time": 1645105447,
    "fire_results": null,
    "fire_results_count": 0,
    "resolve_time": 0,
    "status": "firing",
    "results": null,
    "labels":
    {},
    "annotations":
    {
        "__config_app__": "sls_pub_alert",
        "__pub_alert_app__": "{ID aplikasi impor peringatan}",
        "__pub_alert_protocol__": "grafana8",
        "__pub_alert_region__": "{Wilayah endpoint tempat peringatan dikirim}",
        "__pub_alert_service__": "{ID layanan impor peringatan}",
        "desc": "peringatan uji coba",
        "fingerprint": "65d7bbdb01ce6c93",
        "silenceURL": "http://localhost:3000/alerting/silence/new?alertmanager=grafana&matchers=alertname%3Dtest",
        "valueString": "[ metric='go_threads{instance=\"prometheus\", job=\"prometheus\"}' labels={__name__=go_threads, instance=prometheus, job=prometheus} value=15 ]"
    },
    "severity": 6,
    "policy":
    {
        "alert_policy_id": "{Kebijakan peringatan yang ditentukan untuk aplikasi impor peringatan}",
        "action_policy_id": "{Kebijakan tindakan yang ditentukan untuk aplikasi impor peringatan}",
        "use_default": false,
        "repeat_interval": "{Interval ulang yang ditentukan untuk aplikasi impor peringatan}"
    },
    "template": null,
    "drill_down_query": "http://localhost:3000/alerting/abcd/edit",
}

Tabel berikut menjelaskan pemetaan antara bidang Layanan Log dan bidang Grafana.

Bidang Layanan Log	Bidang Grafana	Deskripsi
aliuid	Tidak ada	ID akun Alibaba Cloud tempat aplikasi impor peringatan berada.
alert_id	alertname	ID aturan pemantauan peringatan. Jika bidang labels dalam peringatan Grafana berisi bidang alertname, nilai bidang alert_id sama dengan nilai bidang alertname. Jika tidak, bidang alert_id kosong.
alert_type	Tidak ada	Jenis peringatan. Nilainya tetap sebagai sls_pub.
alert_name	alertname	Nama aturan pemantauan peringatan. Jika bidang labels dalam peringatan Grafana berisi bidang alertname, nilai bidang alert_name sama dengan nilai bidang alertname. Selain itu, bidang alertname dalam peringatan Grafana dihapus setelah konversi. Jika nilainya berbeda, bidang alert_name kosong.
status	status	Status peringatan.
next_eval_interval	Tidak ada	Interval evaluasi peringatan. Nilainya tetap sebagai 0.
alert_time	Tidak ada	Waktu pertama kali peringatan dipicu. Nilai bidang ini menunjukkan waktu ketika Layanan Log menerima peringatan Grafana.
fire_time	startsAt	Waktu peringatan dipicu.
resolve_time	endsAt	Waktu peringatan dibersihkan. Jika nilai bidang status dalam peringatan Grafana adalah firing, nilai bidang resolve_time adalah 0. Jika tidak, nilai resolve_time adalah timestamp yang ditunjukkan oleh bidang endsAt.
labels	labels	Label peringatan. Jika Anda menambahkan label pada tab Enrichment saat membuat aplikasi impor peringatan, label tersebut akan ditambahkan ke bidang labels.
annotations	annotations	Anotasi peringatan. Bidang berikut ditambahkan ke bidang annotations dalam peringatan Layanan Log: __config_app__: "sls_pub_alert" __pub_alert_service__: {ID layanan impor peringatan} __pub_alert_app__: {ID aplikasi impor peringatan} __pub_alert_protocol__: "alert manager" __pub_alert_region__: {Wilayah endpoint tempat peringatan dikirim} desc: Jika bidang annotations dalam peringatan Grafana berisi bidang desc, bidang description, bidang summary, atau kombinasi dari bidang-bidang tersebut, nilai bidang desc dalam peringatan Layanan Log adalah nilai dari bidang desc, description, summary, atau kombinasi nilai-nilai dari bidang-bidang tersebut dalam peringatan Grafana. Bidang desc, description, dan summary memiliki prioritas dalam urutan menurun. Selain itu, bidang desc, description, dan summary dalam peringatan Grafana dihapus setelah konversi. fingerprint: Bidang fingerprint dalam bidang annotations peringatan Grafana silenceURL: Bidang silenceURL dalam bidang annotations peringatan Grafana dashboardURL: Bidang dashboardURL dalam bidang annotations peringatan Grafana panelURL: Bidang panelURL dalam bidang annotations peringatan Grafana valueString: Bidang valueString dalam bidang annotations peringatan Grafana Jika Anda menambahkan anotasi pada tab Enrichment saat membuat aplikasi impor peringatan, anotasi tersebut akan ditambahkan ke bidang annotations.
severity	severity	Tingkat keparahan peringatan. Catatan Jika bidang annotations atau labels dalam peringatan Grafana berisi bidang severity, Layanan Log memetakan nilai bidang severity dalam peringatan Grafana ke tingkat keparahan dalam peringatan Layanan Log setelah peringatan Grafana diimpor ke Layanan Log. Jika bidang annotations atau labels dalam peringatan Grafana tidak berisi bidang severity, Layanan Log menggunakan tingkat keparahan sedang untuk peringatan secara default. Untuk informasi lebih lanjut, lihat Tingkat keparahan.
policy	Tidak ada	Kebijakan peringatan yang ditentukan untuk aplikasi impor peringatan. Untuk informasi lebih lanjut, lihat Deskripsi variabel kebijakan.
project	Tidak ada	Proyek tempat Pusat Peringatan berada. Untuk informasi lebih lanjut, lihat Proyek.
drill_down_query	generatorURL externalURL dan groupLabels	URL peringatan Grafana. Jika peringatan Grafana berisi bidang generatorURL, nilai bidang drill_down_query sama dengan nilai bidang generatorURL. Jika peringatan Grafana tidak berisi bidang generatorURL, dan bidang groupLabels kosong, nilai bidang drill_down_query sama dengan nilai bidang externalURL. Jika peringatan Grafana tidak berisi bidang generatorURL, dan bidang groupLabels tidak kosong, nilai bidang drill_down_query adalah kombinasi nilai bidang groupLabels dan externalURL. Jika Anda mengklik URL tersebut, Anda akan diarahkan ke halaman manajemen peringatan Grafana. Di halaman ini, Grafana secara otomatis menampilkan peringatan yang sesuai dengan isi bidang groupLabels.