Mengimpor dasbor Grafana ke Cloud Monitoring

Dokumen ini menjelaskan cara mengimpor file dasbor dalam format JSON Grafana ke Cloud Monitoring. Anda dapat mengimpor dasbor Grafana dengan cara berikut:

Proses impor mengonversi file dasbor dalam format JSON yang digunakan oleh Grafana menjadi format JSON yang digunakan oleh Cloud Monitoring. Dasbor yang dikonversi mungkin berbeda dengan dasbor Grafana asli. Misalnya, jika dasbor Grafana menggunakan fitur yang tidak tersedia di dasbor Cloud Monitoring, aspek dasbor Grafana tersebut tidak akan dikonversi. Perbedaan ini tercantum dalam hasil impor.

Anda hanya dapat mengimpor dasbor yang menggunakan ekspresi PromQL dan sumber data Prometheus. Dasbor yang menggunakan bentuk kueri atau sumber data lainnya mungkin tidak berhasil diimpor.

Untuk mengetahui informasi tentang cara mengimpor pemberitahuan Prometheus ke Cloud Monitoring, lihat Memigrasikan aturan pemberitahuan dan penerima dari Prometheus.

Untuk informasi umum tentang cara mengelola dasbor yang diimpor, lihat Membuat dan mengelola dasbor kustom.

Sebelum memulai

Baik Anda menggunakan konsol Google Cloud atau alat pengimpor untuk mengimpor dasbor, Anda harus memiliki otorisasi yang memadai, dan Anda memerlukan dasbor untuk diimpor. Saat menggunakan alat impor, ada prasyarat tambahan.

Otorisasi

Untuk mendapatkan izin yang diperlukan guna membuat dan mengubah dasbor kustom, minta administrator untuk memberi Anda peran IAM Monitoring Editor (roles/monitoring.editor) di project Anda. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Untuk informasi selengkapnya tentang peran, lihat Mengontrol akses dengan Identity and Access Management.

Mengumpulkan dasbor Grafana yang akan diimpor

Untuk mengimpor dasbor Grafana, Anda harus menyimpannya secara lokal sebagai file dalam format JSON. Anda mungkin ingin membuat direktori khusus untuk file dasbor ini.

Mengimpor dasbor menggunakan konsol Google Cloud

Anda dapat mengimpor dasbor Grafana ke Cloud Monitoring dari tempat berikut di konsol Google Cloud:

  • Tab Daftar dasbor di halaman Dasbor Pemantauan.
  • Bagian dasbor checklist orientasi di halaman Ringkasan Monitoring.

Mengimpor dasbor Grafana

Untuk mengimpor satu atau beberapa dasbor Grafana, lakukan tindakan berikut

  1. Buka halaman Dasbor atau Ringkasan di Monitoring:

    • Di konsol Google Cloud, buka halaman  Dasbor:

      Buka Dasbor

      Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Monitoring.

    • Di konsol Google Cloud, buka halaman Ringkasan Monitoring:

      Buka Ringkasan

      Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Monitoring.

  2. Klik  Import Grafana Dashboards.

  3. Klik Browse untuk membuka direktori tempat Anda menyimpan dasbor Grafana dalam format JSON, lalu pilih dasbor yang ingin Anda impor.

    Setiap file JSON di-staging setelah dipilih; panel File yang Disiapkan menunjukkan apakah ada masalah dalam konversi.

    • Klik  Lihat JSON yang dikonversi untuk melihat hasil konversi.
    • Klik  Hapus file untuk menghapus dasbor dari operasi impor.

  4. Klik  Impor. Panel Hasil impor menunjukkan apakah setiap dasbor berhasil diimpor atau tidak.

  5. Untuk melihat dasbor yang berhasil diimpor, klik  Lihat.

Melihat dasbor yang diimpor

Untuk melihat dasbor yang diimpor, lakukan tindakan berikut:

  1. Di konsol Google Cloud, buka halaman  Dasbor:

    Buka Dasbor

    Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Monitoring.

  2. Temukan dasbor yang ingin Anda lihat dalam daftar. Untuk memfilter daftar dasbor, Anda dapat melakukan hal berikut:

    • Pilih kategori Kustom untuk hanya melihat dasbor yang ditentukan pengguna.
    • Pilih label cloud-monitoring-dashboard-importer untuk hanya melihat dasbor Grafana yang diimpor menggunakan Konsol Google Cloud.
    • Gunakan penelusuran panel filter menurut nama.

Mengimpor dasbor menggunakan alat pengimpor

Anda dapat menggunakan alat pengimpor untuk mengonversi dasbor Grafana dan menguploadnya ke Cloud Monitoring sebagai satu operasi, atau Anda dapat melakukan konversi dan langkah upload secara terpisah. Anda dapat memilih pendekatan ini jika ingin mengedit dasbor yang dikonversi sebelum menguploadnya.

Prasyarat tambahan

Sebelum dapat menginstal dan menjalankan pengimpor dasbor, Anda harus melakukan hal berikut:

  1. Gunakan lingkungan yang mendukung skrip shell Bash.
  2. Memiliki atau menginstal Git.
  3. Memiliki atau menginstal Node.js, versi 20.4.1 atau yang lebih baru.
  4. Memiliki atau menginstal Google Cloud CLI. Jika Anda sudah menginstal gcloud CLI, pastikan Anda memiliki versi terbaru dengan menjalankan perintah gcloud components update.

Mendapatkan pengimpor dasbor

Pengimpor dasbor disimpan di repositori GitHub monitoring-dashboard-samples. Untuk mendapatkan pengimpor, lakukan hal berikut:

  1. Meng-cloning repository

    git clone https://github.com/GoogleCloudPlatform/monitoring-dashboard-samples

  2. Ubah ke direktori untuk pengimpor dasbor:

    cd monitoring-dashboard-samples/scripts/dashboard-importer

Pengimpor dasbor menyertakan skrip berikut:

  • import.sh, yang mengonversi dasbor dan secara opsional mengupload dasbor yang dikonversi ke Cloud Monitoring.

  • upload.sh, yang mengupload dasbor yang dikonversi—atau dasbor Monitoring apa pun—ke Cloud Monitoring. Skrip import.sh memanggil skrip ini untuk melakukan upload.

Saat menggunakan skrip import.sh, Anda harus menentukan lokasi dasbor Grafana yang akan dikonversi. Pengimpor membuat direktori yang berisi dasbor yang dikonversi dan informasi lainnya. Bagian berikut menjelaskan direktori ini.

Dasbor Grafana yang akan dikonversi

Anda dapat menggunakan pengimpor dasbor untuk mengonversi satu atau beberapa dasbor sekaligus dengan menentukan jalur ke file dasbor.

  • Anda dapat menentukan jalur ke direktori yang berisi dasbor. Hanya file dalam direktori yang memiliki ekstensi .json yang diproses.

  • Anda dapat menentukan jalur ke satu file JSON. Nama file harus memiliki ekstensi .json.

Dasbor yang dikonversi dan informasi lainnya

Saat pertama kali dijalankan, pengimpor akan membuat subdirektori reports. Setiap kali menjalankan pengimpor, Anda akan mendapatkan direktori output baru di bawah direktori reports, yang diberi nama berdasarkan tanggal dan waktu. Nama direktori output memiliki struktur berikut:
reports/YYYY-M-D/HH:MM:SS

Untuk setiap pemanggilan pengimpor, direktori output berisi hal berikut:

  • Satu atau beberapa file dengan nama yang sama dengan dasbor Grafana asli, tetapi sekarang dalam format JSON Cloud Monitoring.
  • File report.json, yang mencatat informasi berikut untuk setiap dasbor yang dikonversi:
    • Nama dan lokasi file dasbor Grafana yang dikonversi.
    • Nama dan lokasi file dasbor Monitoring yang dikonversi.
    • Pemberitahuan tentang fitur apa pun di dasbor Grafana yang tidak memiliki fitur yang sesuai di Cloud Monitoring sehingga tidak dapat disertakan dalam dasbor yang dikonversi.
    • Error apa pun yang terjadi dalam konversi.

Jika Anda telah mengupload dasbor, direktori laporan juga akan menyertakan file upload_HH:MM:SS.txt, yang menyertakan URL tempat dasbor diupload.

Mengimpor dasbor Grafana

Untuk mengonversi dasbor Grafana dan menguploadnya ke Cloud Monitoring, gunakan skrip import.sh:

./import.sh PATH_TO_DIRECTORY_OR_FILE PROJECT_ID

Skrip ini melakukan hal berikut:

  1. Mengonversi dasbor di PATH_TO_DIRECTORY_OR_FILE dari format JSON yang digunakan oleh Grafana menjadi format JSON yang digunakan oleh Cloud Monitoring.

  2. Mengupload dasbor yang dikonversi ke project Google Cloud Anda PROJECT_ID menggunakan Google Cloud CLI.

    Jika Anda belum mengautentikasi ke gcloud CLI, jalankan perintah gcloud auth login sebelum menjalankan skrip import.sh.

Anda dapat mengimpor semua dasbor Grafana dalam direktori, atau menentukan satu dasbor dalam direktori untuk diimpor.

  • Untuk mengimpor semua dasbor di direktori GRAFANA_DASHBOARDS_DIR ke project Google Cloud PROJECT_ID, tentukan direktori, relatif terhadap direktori pengimpor, dan project ID tujuan saat memanggil skrip:

    ./import.sh GRAFANA_DASHBOARDS_DIR PROJECT_ID

  • Untuk hanya mengonversi dasbor MY_GRAFANA_DASHBOARD.json di direktori GRAFANA_DASHBOARDS_DIR, sertakan nama file dasbor, secara relatif terhadap direktori pengimpor, saat memanggil skrip:

    ./import.sh GRAFANA_DASHBOARDS_DIR/MY_GRAFANA_DASHBOARD.json PROJECT_ID

Pengimpor dasbor menyertakan contoh dasbor Grafana sebagai examples/k8s_cluster_example.json. Perintah berikut mengimpor dasbor tersebut ke project yang ditentukan:

./import.sh examples/k8s_cluster_example.json PROJECT_ID

Saat dipanggil dengan PROJECT_ID my-project-test-1, outputnya akan menyerupai hal berikut:

Converting: Kubernetes Cluster Overview
✓ Kubernetes Cluster Overview converted successfully

Conversion of examples/k8s_cluster_example.json complete. Conversion Report located at: reports/2023-9-28/22:14:57/report.json


To upload these dashboard(s) manually, you can run:
./upload.sh reports/2023-9-28/22:14:57/ <PROJECT_ID>

Conversion Complete. Proceeding to uploading...

Now running: ./upload.sh reports/2023-9-28/22:14:57/ my-project-test-1

Uploading 1 dashboard(s) from a directory with the following args:
Directory: reports/2023-9-28/22:14:57/
Project: my-project-test-1

The following are your dashboards:
- k8s_cluster_example.json

Setelah skrip import.sh membuat direktori output dan mengonversi dasbor, tetapi sebelum mengupload dasbor yang dikonversi ke project Anda, skrip akan meminta konfirmasi. Masukkan y, dan skrip akan mengupload dasbor dan mencetak URL untuk dasbor baru:

Would you like to continue? (y/n) y

✓ k8s_cluster_example.json successfully uploaded:
https://console.cloud.google.com/monitoring/dashboards/builder/9c341ef8-cfef-4bdd-98d5-821571c520ef?project=my-project-test-1

Upload log created in reports/2023-9-28/22:14:57/upload_22:14:57.txt

Need to troubleshoot? Please visit:
https://github.com/GoogleCloudPlatform/monitoring-dashboard-samples/tree/master/scripts/dashboard-importer/README.md#troubleshooting

Mengonversi dasbor Grafana tanpa mengupload

Jika Anda ingin memeriksa atau mengedit dasbor yang dikonversi sebelum menguploadnya, hapus nilai PROJECT_ID saat memanggil skrip import.sh:

./import.sh PATH_TO_DIRECTORY_OR_FILE

Pengimpor mengonversi dasbor seperti yang dijelaskan dalam Mengimpor dasbor Grafana, tetapi tidak mengupload dasbor yang dikonversi ke Cloud Monitoring.

Anda dapat menjalankan langkah upload nanti, dengan menggunakan skrip upload.sh secara manual.

Mengupload dasbor secara manual

Untuk mengupload dasbor secara manual dalam format JSON Cloud Monitoring, gunakan skrip upload.sh.

    ./upload.sh PATH_TO_DIRECTORY_OR_FILE PROJECT_ID

Skrip upload.sh menggunakan Google Cloud CLI untuk mengupload file JSON. Jika Anda belum melakukan autentikasi ke gcloud CLI, jalankan perintah gcloud auth login sebelum menjalankan skrip upload.sh.

  • Untuk mengupload semua dasbor di direktori reports/YYYY-M-D/HH:MM:SS, tentukan direktori, relatif terhadap direktori pengimpor, dan project ID tujuan saat memanggil skrip:

    ./upload.sh reports/YYYY-M-D/HH:MM:SS PROJECT_ID

    Saat mengupload semua dasbor dari direktori, skrip akan meminta Anda untuk melanjutkan atau keluar sebelum mengupload dasbor.

  • Untuk mengupload dasbor tertentu di direktori reports/YYYY-M-D/HH:MM:SS, tentukan direktori dan nama file, relatif terhadap direktori pengimpor, dan ID project tujuan saat memanggil skrip:

    ./upload.sh reports/YYYY-M-D/HH:MM:SS/MY_MONITORING_DASHBOARD.json PROJECT_ID

    Saat mengupload satu dasbor dari direktori, skrip akan dijalankan tanpa meminta konfirmasi Anda sebelum mengupload dasbor.

Misalnya, perintah berikut mengupload dasbor yang disimpan dalam subdirektori reports ke project Google Cloud my-project-test-1:

./upload.sh reports/2023-9-26/22:48:31/k8s_cluster_example.json my-project-test-1
Uploading json file: k8s_cluster_example.json to project: my-project-test-1...

✓ k8s_cluster_example.json successfully uploaded:
https://console.cloud.google.com/monitoring/dashboards/builder/25956d9a-93e2-410c-ada1-ec6872cb6665?project=my-project-test-1

Melihat dasbor yang diupload

Untuk melihat dasbor yang diupload, lakukan tindakan berikut:

  1. Di konsol Google Cloud, buka halaman  Dasbor:

    Buka Dasbor

    Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Monitoring.

  2. Temukan dasbor yang ingin Anda lihat dalam daftar. Untuk memfilter daftar dasbor, Anda dapat melakukan hal berikut:

    • Pilih kategori Kustom untuk hanya melihat dasbor yang ditentukan pengguna.
    • Pilih label cloud-ops-grafana-importer untuk hanya melihat dasbor Grafana yang diimpor menggunakan alat pengimpor.
    • Gunakan penelusuran panel filter menurut nama.

Pemecahan masalah

Kami terkadang memublikasikan update kecil dan perbaikan bug pada alat ini. Sebelum mencoba pemecahan masalah lebih lanjut, coba perbaiki masalah terlebih dahulu dengan menggunakan git pull untuk mendownload versi terbaru repositori, lalu impor lagi.

Untuk informasi tentang masalah pada dasbor yang dikonversi, seperti diagram yang tidak menampilkan data, lihat file README pengimpor.

Langkah selanjutnya