Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Menghubungkan Grafana
<a name="connecting-telemetry-sources-connecting-grafana"></a>

Integrasi Grafana memungkinkan AWS DevOps Agen untuk menanyakan metrik, dasbor, dan data peringatan dari instans Grafana Anda selama penyelidikan insiden. Integrasi ini mengikuti proses dua langkah: pendaftaran Grafana tingkat akun, diikuti dengan menghubungkannya ke Ruang Agen individu.

Untuk meningkatkan keamanan, integrasi Grafana hanya mengaktifkan alat hanya-baca. Alat tulis dinonaktifkan dan tidak dapat diaktifkan. Ini berarti agen dapat menanyakan dan membaca data dari instance Grafana Anda tetapi tidak dapat membuat, memodifikasi, atau menghapus sumber daya Grafana apa pun seperti dasbor, peringatan, atau anotasi. Untuk informasi selengkapnya, lihat [Keamanan di AWS DevOps Agen](https://docs.aws.amazon.com/devopsagent/latest/userguide/aws-devops-agent-security.html).

## Persyaratan Grafana
<a name="grafana-requirements"></a>

Sebelum menghubungkan Grafana, pastikan Anda memiliki:
+ Grafana versi 9.0 atau yang lebih baru. Beberapa fitur, terutama operasi terkait sumber data, mungkin tidak berfungsi dengan benar dengan versi sebelumnya karena titik akhir API yang hilang.
+ Instans Grafana dapat diakses melalui HTTPS. Endpoint jaringan publik dan pribadi didukung. Dengan konektivitas jaringan pribadi, instans Grafana Anda dapat di-host di dalam VPC tanpa akses internet publik. Lihat perinciannya di [Menghubungkan ke alat yang dihosting secara pribadi](configuring-capabilities-for-aws-devops-agent-connecting-to-privately-hosted-tools.md).
+ Akun layanan Grafana dengan token akses yang memiliki izin baca yang sesuai

## Mendaftarkan Grafana (tingkat akun)
<a name="registering-grafana-account-level"></a>

Grafana terdaftar di tingkat AWS akun dan dibagikan di antara semua Ruang Agen di akun itu.

### Langkah 1: Konfigurasikan Grafana
<a name="step-1-configure-grafana"></a>

1. Masuk ke Konsol AWS Manajemen

1. Arahkan ke konsol AWS DevOps Agen

1. Buka halaman **Penyedia Kemampuan** (dapat diakses dari navigasi samping)

1. **Temukan **Grafana** di bagian Penyedia yang **tersedia** di bawah **Telemetri** dan klik Daftar**

1. Pada halaman **Konfigurasi Grafana**, masukkan informasi berikut:
   + **Nama Layanan** (wajib) — Masukkan nama deskriptif untuk server Grafana Anda menggunakan karakter alfanumerik, tanda hubung, dan garis bawah saja. Misalnya, `my-grafana-server`.
   + **URL Grafana** (wajib) — Masukkan URL HTTPS lengkap instance Grafana Anda. Misalnya, `https://myinstance.grafana.net`.
   + **Token Akses Akun Layanan** (wajib) — Masukkan token akses akun layanan Grafana. Token biasanya dimulai dengan`glsa_`. Untuk membuat token akun layanan, navigasikan ke instans Grafana Anda, buka **Administrasi > Akun layanan**, buat akun layanan dengan peran Viewer, dan buat token.
   + **Deskripsi** (opsional) — Tambahkan deskripsi untuk membantu mengidentifikasi tujuan server. Misalnya, `Production Grafana server for monitoring`.

1. (Opsional) Tambahkan AWS tag ke pendaftaran untuk tujuan organisasi.

1. Klik **Berikutnya**

### Langkah 2: Tinjau dan kirimkan pendaftaran Grafana
<a name="step-2-review-and-submit-grafana-registration"></a>

1. Tinjau semua detail konfigurasi Grafana

1. Klik **Submit** untuk menyelesaikan pendaftaran

1. Setelah pendaftaran berhasil, Grafana muncul di bagian **Saat ini terdaftar** di halaman Penyedia Kemampuan

## Menambahkan Grafana ke Ruang Agen
<a name="adding-grafana-to-an-agent-space"></a>

Setelah mendaftarkan Grafana di tingkat akun, Anda dapat menghubungkannya ke Ruang Agen individual:

1. Di konsol AWS DevOps Agen, pilih Ruang Agen

1. Buka tab **Kemampuan**

1. **Di bagian **Telemetri**, klik Tambah**

1. Pilih **Grafana** dari daftar penyedia yang tersedia

1. Klik **Simpan**

## Mengkonfigurasi webhook peringatan Grafana
<a name="configuring-grafana-alert-webhooks"></a>

Anda dapat mengonfigurasi Grafana untuk secara otomatis memicu investigasi AWS DevOps Agen saat peringatan menyala dengan mengirimkan webhook melalui titik kontak Grafana. Untuk detail tentang metode otentikasi webhook dan manajemen kredensi, lihat. [Memanggil DevOps Agen melalui Webhook](configuring-capabilities-for-aws-devops-agent-invoking-devops-agent-through-webhook.md)

### Langkah 1: Buat template notifikasi khusus
<a name="step-1-create-a-custom-notification-template"></a>

Dalam instance Grafana Anda, navigasikan ke **Alerting > Contact points > Notification templates** dan buat template baru dengan konten berikut:

```
{{ define "devops-agent-payload" }}
{
  "eventType": "incident",
  "incidentId": "{{ (index .Alerts 0).Labels.alertname }}-{{ (index .Alerts 0).Fingerprint }}",
  "action": "{{ if eq .Status "resolved" }}resolved{{ else }}created{{ end }}",
  "priority": "{{ if eq .Status "resolved" }}MEDIUM{{ else }}HIGH{{ end }}",
  "title": "{{ (index .Alerts 0).Labels.alertname }}",
  "description": "{{ (index .Alerts 0).Annotations.summary }}",
  "service": "{{ if (index .Alerts 0).Labels.job }}{{ (index .Alerts 0).Labels.job }}{{ else }}grafana{{ end }}",
  "timestamp": "{{ (index .Alerts 0).StartsAt }}",
  "data": {
    "metadata": {
      {{ range $k, $v := (index .Alerts 0).Labels }}
      "{{ $k }}": "{{ $v }}",
      {{ end }}
      "_source": "grafana"
    }
  }
}
{{ end }}
```

Template ini memformat peringatan Grafana ke dalam struktur payload webhook yang diharapkan oleh Agen. AWS DevOps Ini memetakan label peringatan, anotasi, dan status ke dalam bidang yang sesuai, dan mencakup semua label peringatan sebagai metadata.

**Catatan:** Template ini hanya memproses peringatan pertama dalam grup. Grafana mengelompokkan beberapa peringatan penembakan menjadi satu notifikasi secara default. Untuk memastikan setiap peringatan dikirim satu per satu, konfigurasikan kebijakan notifikasi Anda untuk dikelompokkan menurut`alertname`. Selain itu, template ini tidak luput dari karakter JSON khusus dalam nilai label atau anotasi. Pastikan label peringatan dan `summary` anotasi tidak mengandung karakter seperti tanda kutip ganda atau baris baru, yang akan menghasilkan JSON yang tidak valid.

### Langkah 2: Buat titik kontak webhook
<a name="step-2-create-a-webhook-contact-point"></a>

1. **Di Grafana, navigasikan ke **Peringatan > Titik kontak dan klik Tambahkan titik kontak****

1. Pilih **Webhook** sebagai tipe integrasi

1. Atur **URL** ke titik akhir webhook AWS DevOps Agen

1. Di bawah **pengaturan Webhook Opsional**, konfigurasikan header otentikasi berdasarkan jenis webhook Anda. Lihat [metode otentikasi Webhook](configuring-capabilities-for-aws-devops-agent-invoking-devops-agent-through-webhook.md) untuk detailnya.

1. Setel bidang **Pesan** untuk menggunakan templat kustom Anda: `{{ template "devops-agent-payload" . }}`

1. Klik **Simpan titik kontak**

### Langkah 3: Tetapkan titik kontak ke kebijakan pemberitahuan
<a name="step-3-assign-the-contact-point-to-a-notification-policy"></a>

1. Arahkan ke **Peringatan > Kebijakan pemberitahuan**

1. Mengedit kebijakan yang sudah ada atau membuat yang baru

1. Atur titik kontak ke titik kontak webhook yang Anda buat

1. Klik **Simpan kebijakan**

Saat peringatan yang cocok diaktifkan, Grafana akan mengirimkan muatan yang diformat ke AWS DevOps Agen, yang akan memulai penyelidikan secara otomatis.

## Batasan
<a name="limitations"></a>
+ **ClickHouse alat sumber ClickHouse data — alat** sumber data saat ini tidak didukung.
+ **Pencegahan insiden proaktif** — saat ini [Pencegahan insiden proaktif](working-with-devops-agent-proactive-incident-prevention.md) tidak menggunakan alat Grafana. Support direncanakan untuk rilis di masa depan.

### Pertimbangan Grafana yang Dikelola Amazon
<a name="amazon-managed-grafana-considerations"></a>

Jika Anda menggunakan [Grafana Terkelola Amazon](https://aws.amazon.com/grafana/) (AMG), perhatikan batasan berikut:
+ **Titik kontak Webhook tidak didukung** - AMG saat ini tidak mendukung titik kontak webhook dalam konfigurasi peringatannya. Anda tidak dapat menggunakan AMG untuk mengirim webhook peringatan langsung ke Agen. AWS DevOps Untuk detailnya, lihat [Memperingatkan titik kontak di Grafana Terkelola Amazon](https://docs.aws.amazon.com/grafana/latest/userguide/v9-alerting-explore-contacts.html).
+ **Kedaluwarsa token akun layanan** — Token akun layanan AMG memiliki masa kedaluwarsa maksimum 30 hari. Anda perlu memutar token dan memperbarui pendaftaran Grafana Anda di AWS DevOps Agen sebelum kedaluwarsa. Lihat [Mengelola koneksi Grafana](#managing-grafana-connections) untuk mengetahui cara memperbarui kredensional. Untuk detail tentang batas token AMG, lihat [Akun layanan di Grafana Terkelola Amazon](https://docs.aws.amazon.com/grafana/latest/userguide/service-accounts.html).

## Mengelola koneksi Grafana
<a name="managing-grafana-connections"></a>
+ **Memperbarui kredensi** — Jika token akun layanan Anda kedaluwarsa atau perlu diperbarui, deregister Grafana dari halaman Penyedia Kemampuan dan daftar ulang dengan token baru.
+ **Melihat instans yang terhubung** — Di konsol AWS DevOps Agen, pilih Ruang Agen Anda dan buka tab Kemampuan untuk melihat sumber telemetri yang terhubung.
+ **Menghapus Grafana** **— Untuk memutuskan Grafana dari Ruang Agen, pilih Grafana di bagian Telemetri dan klik Hapus.** Untuk menghapus pendaftaran sepenuhnya, hapus terlebih dahulu dari semua Ruang Agen, lalu deregister dari halaman Penyedia Kemampuan.