Halaman ini diterjemahkan oleh Cloud Translation API.

Membuat dasbor visualisasi

Halaman ini menjelaskan proses pembuatan dan pengelolaan dasbor dalam instance Grafana Anda, yang digunakan untuk visualisasi log dan metrik dari project air-gapped Google Distributed Cloud (GDC) Anda.

Dasbor memberikan representasi visual dinamis dari performa sistem Anda. Dasbor ini terdiri dari satu atau beberapa panel yang dapat disesuaikan, yang masing-masing dikonfigurasi untuk mengirim kueri dan menampilkan metrik tertentu dari komponen GDC Anda. Panel ini memungkinkan Anda melakukan hal berikut:

Visualisasikan metrik melalui berbagai jenis grafik.
Tentukan nilai minimum pemberitahuan untuk memicu notifikasi berdasarkan nilai metrik.
Sesuaikan properti tampilan seperti label, unit, dan rentang waktu.
Tetapkan resolusi waktu yang konsisten untuk perbandingan yang akurat.

Dengan menggunakan dasbor Grafana secara efektif, Anda dapat memperoleh insight berharga tentang performa dan kondisi lingkungan GDC Anda.

Sebelum memulai

Untuk mendapatkan izin yang Anda perlukan guna mengakses dan melihat dasbor Grafana, minta Admin IAM Organisasi atau Admin IAM Project untuk memberi Anda salah satu peran Penampil Grafana yang telah ditentukan sebelumnya.

Selain itu, untuk mendapatkan izin yang Anda perlukan guna mengelola objek API yang diperlukan untuk membuat dasbor, minta Admin IAM Organisasi atau Admin IAM Project Anda untuk memberi Anda peran ConfigMap dan Dashboard terkait.

Bergantung pada tingkat akses dan izin yang Anda perlukan, Anda mungkin mendapatkan peran pembuat, editor, atau pelihat untuk resource ini dalam organisasi atau project. Untuk mengetahui informasi selengkapnya, lihat Siapkan izin IAM.

Setelah mendapatkan peran yang sesuai, ikuti langkah-langkah berikut sebelum membuat dasbor:

Kumpulkan metrik dari beban kerja Anda.
Tetapkan jalur file kubeconfig sebagai variabel lingkungan:
```
export KUBECONFIG=KUBECONFIG_PATH
```
Ganti KUBECONFIG_PATH dengan jalur ke file kubeconfig untuk server Management API tempat Anda ingin membuat dasbor.

Mengidentifikasi endpoint Grafana Anda

URL berikut adalah endpoint instance Grafana project Anda:

https://GDC_URL/PROJECT_NAMESPACE/grafana

Ganti kode berikut:

GDC_URL: URL organisasi Anda di GDC.
PROJECT_NAMESPACE: namespace project Anda.

Misalnya, endpoint Grafana untuk project platform-obs di organisasi org-1 adalah https://org-1/platform-obs/grafana.

Membuat dasbor kustom

Ikuti langkah-langkah berikut untuk membuat dasbor Grafana dan menyesuaikan setelan Anda:

Buka endpoint Grafana untuk menampilkan antarmuka pengguna.
Dari menu navigasi, klik Tambahkan.
Dari menu drop-down, klik Dasbor. Grafana membuat dasbor kosong.
Di dasbor kosong, tambahkan semua panel yang Anda inginkan.
Di menu Sumber data pada setiap panel, pilih sumber data yang Anda inginkan untuk panel, termasuk metrik (prometheus), log audit (auditloki), dan log operasional (oploki).

Untuk semesta multi-zona, Grafana memiliki sumber data berlabel zona yang dapat Anda gunakan untuk membuat visualisasi dasbor dengan metrik dan log dari beberapa zona. Sumber data ini diberi nama dengan format DATA_SOURCE-ZONE_ID, dengan:
- DATA_SOURCE dapat menggunakan salah satu nilai berikut:
  - Prometheus (prometheus atau metrics) untuk menampilkan metrik.
  - Log audit (auditloki) untuk menampilkan log audit.
  - Log operasional (oploki) untuk menampilkan log operasional.
- ZONE_ID adalah ID zona tempat Anda ingin menampilkan data di dasbor.
Selain itu, untuk membuat dasbor visualisasi bagi resource lintas zona, nama sumber datanya adalah --Mixed--. Sumber data ini memungkinkan Anda menambahkan beberapa kueri per zona dan memiliki visualisasi data lintas zona dalam satu dasbor. Anda dapat menggunakan fitur ini untuk membuat perbandingan perilaku antara, misalnya, satu metrik atau kueri log di beberapa zona semesta Anda.
Sesuaikan detail Anda dan edit panel untuk memberikan kueri atau melakukan pembaruan lainnya.

Tips: Saat menyesuaikan dasbor, terapkan praktik terbaik untuk kasus penggunaan Anda guna memfasilitasi visualisasi dan interpretasi data observabilitas dari komponen Anda. Misalnya, tetapkan nilai minimum penerimaan, tampilkan sinyal yang berguna, tambahkan label ke grafik, dan pilih resolusi waktu yang konsisten.
Dari menu bar, klik Setelan dasbor untuk membuka halaman Setelan.
Dari menu navigasi, pilih Model JSON.
Salin model JSON dasbor dan tempelkan ke dalam file teks biasa untuk digunakan di masa mendatang.

Membuat objek `ConfigMap`.

Ikuti langkah-langkah berikut untuk membuat objek ConfigMap yang berisi model JSON dasbor:

Buka jendela terminal.
Buat objek ConfigMap. Di bagian data objek ConfigMap, tempelkan model JSON yang sebelumnya Anda salin:
```
apiVersion: v1
kind: ConfigMap
metadata:
  namespace: PROJECT_NAMESPACE
  name: CONFIGMAP_NAME
data:
  JSON_FILE_NAME.json: |
    {
    JSON_MODEL
    }
```
Ganti kode berikut:
- PROJECT_NAMESPACE: namespace project Anda.
- CONFIGMAP_NAME: nama yang ingin Anda berikan pada objek ConfigMap Anda.
- JSON_FILE_NAME: nama yang ingin Anda berikan ke file untuk model JSON dasbor.
- JSON_MODEL: model JSON dari dasbor kustom Anda.
Untuk contoh tampilan objek ini, lihat contoh ConfigMap.

Terapkan objek ConfigMap ke server Management API:

kubectl --kubeconfig ${KUBECONFIG} apply -f CONFIGMAP_NAME.yaml

Contoh `ConfigMap`

File YAML berikut menunjukkan contoh objek ConfigMap dari dasbor di namespace platform-obs:

  apiVersion: v1
  kind: ConfigMap
  metadata:
    namespace: platform-obs
    name: my-project-dashboard-configmap
  data:
    my-project-dashboard.json: |
      {
      "annotations": {
        "list": [
          {
            "builtIn": 1,
            "datasource": "--",
            "enable": true,
            "hide": true,
            "iconColor": "rgba(0, 211, 255, 1)",
            "name": "Annotations & Alerts",
            "type": "dashboard"
          }
        ]
      },
      "editable": true,
      "graphTooltip": 0,
      "id": null,
      "links": [],
      "panels": [],
      "schemaVersion": 27,
      "style": "dark",
      "tags": [],
      "templating": {
        "list": []
      },
      "time": {
        "from": "now-6h",
        "to": "now"
      },
      "timepicker": {},
      "timezone": "",
      "title": "Sample dashboard",
      "uid": null,
      "version": 0
      }

Membuat resource kustom `Dashboard`

Ikuti langkah-langkah berikut untuk membuat resource kustom Dashboard dan mengimpor dasbor kustom ke instance Grafana project Anda:

Buka jendela terminal.
Buat resource kustom Dashboard dan konfigurasikan file dengan nama yang Anda berikan ke objek ConfigMap:
```
apiVersion: observability.gdc.goog/v1
kind: Dashboard
metadata:
  namespace: PROJECT_NAMESPACE
  name: DASHBOARD_NAME
spec:
  configMapRef:
    name: CONFIGMAP_NAME
    namespace: PROJECT_NAMESPACE
    key: JSON_FILE_NAME.json
  foldername: Default
```
Ganti kode berikut:
- PROJECT_NAMESPACE: namespace project Anda.
- DASHBOARD_NAME: nama yang ingin Anda berikan ke resource kustom Dashboard.
- CONFIGMAP_NAME: nama yang Anda berikan ke objek ConfigMap.
- JSON_FILE_NAME: nama yang Anda berikan ke file yang berisi model JSON dasbor dalam objek ConfigMap.
Catatan: Untuk mengatur dasbor dalam folder, tentukan foldername di bagian spec pada resource Dashboard. Jika kolom ini tidak diisi, defaultnya adalah folder Default. Folder akan dibuat secara otomatis jika belum ada.

Terapkan resource kustom Dashboard ke server Management API:

kubectl --kubeconfig ${KUBECONFIG} apply -f DASHBOARD_NAME.yaml

Sistem memantau perubahan pada resource kustom Dashboard dan objek ConfigMap terkait. Untuk memperbarui atau menghapus dasbor, ubah resource ini. Setiap modifikasi akan memicu pembaruan pada Grafana. Anda tidak dapat menyimpan pembaruan yang dilakukan langsung di antarmuka pengguna Grafana.