Cara Menginstal Grafana di Ubuntu: Panduan Pengaturan & Konfigurasi Lengkap

Grafana adalah salah satu platform open-source paling powerful untuk visualisasi data dan monitoring infrastruktur. Baik Anda melacak performa server, metrik aplikasi, atau KPI bisnis, dashboard fleksibel Grafana dan dukungan sumber data yang luas menjadikannya alat yang tak tergantikan bagi administrator sistem atau engineer DevOps mana pun.

Panduan komprehensif ini membimbing Anda melalui setiap langkah instalasi Grafana di Ubuntu — dari persiapan sistem awal hingga mengonfigurasi sumber data, membangun dashboard pertama Anda, menyiapkan alert, dan mengamankan deployment Anda.

> Prasyarat: Server Ubuntu yang berjalan (20.04 atau 22.04 LTS direkomendasikan), privilege sudo, dan koneksi internet yang stabil. Jika Anda membutuhkan server yang andal untuk hosting instance Grafana Anda, pertimbangkan VPS Hosting dari AlexHost — dioptimalkan untuk workload monitoring yang kritis terhadap performa.

Daftar Isi

1. Perbarui Paket Sistem
2. Instal Grafana melalui Official APT Repository
3. Mulai dan Aktifkan Layanan Grafana
4. Akses Antarmuka Web Grafana
5. Konfigurasi Sumber Data
6. Buat Dashboard Pertama Anda
7. Siapkan Alert
8. Amankan Grafana dengan HTTPS dan Access Controls
9. Kelola dan Perbarui Grafana

Langkah 1: Perbarui Paket Sistem {#step-1}

Sebelum menginstal software baru apa pun, sangat penting untuk mensinkronkan indeks paket Anda dan menerapkan semua upgrade yang tersedia. Ini memastikan kompatibilitas dan mengurangi risiko konflik dependensi.

sudo apt update && sudo apt upgrade -y

Biarkan proses selesai sebelum melanjutkan. Pada server yang baru disediakan, ini mungkin memakan waktu beberapa menit.

Langkah 2: Instal Grafana melalui Official APT Repository {#step-2}

Grafana memelihara repository APT resmi untuk sistem berbasis Debian, termasuk Ubuntu. Menggunakan repository resmi memastikan Anda selalu memiliki akses ke rilis stabil terbaru dan patch keamanan.

Langkah 2a: Instal Dependensi yang Diperlukan

Pertama, instal paket software-properties-common, yang menyediakan utilitas add-apt-repository:

sudo apt install -y software-properties-common apt-transport-https wget gnupg2

Langkah 2b: Impor Kunci Penandatanganan GPG Grafana

Menambahkan kunci GPG memungkinkan sistem Anda memverifikasi keaslian paket yang diunduh dari repository Grafana:

wget -q -O - https://packages.grafana.com/gpg.key | sudo apt-key add -

Langkah 2c: Tambahkan Official Grafana APT Repository

sudo add-apt-repository "deb https://packages.grafana.com/oss/deb stable main"

Langkah 2d: Perbarui Daftar Paket dan Instal Grafana

sudo apt update
sudo apt install grafana -y

Setelah instalasi selesai, verifikasi versi yang diinstal:

grafana-server -v

Langkah 3: Mulai dan Aktifkan Layanan Grafana {#step-3}

Setelah instalasi, mulai daemon server Grafana dan konfigurasikan untuk diluncurkan secara otomatis pada boot sistem:

sudo systemctl start grafana-server
sudo systemctl enable grafana-server

Verifikasi bahwa layanan berjalan dengan benar:

sudo systemctl status grafana-server

Anda harus melihat output serupa dengan berikut, mengkonfirmasi layanan active (running):

● grafana-server.service - Grafana instance
     Loaded: loaded (/lib/systemd/system/grafana-server.service; enabled)
     Active: active (running) since ...

Jika layanan gagal dimulai, periksa log untuk kesalahan:

sudo journalctl -u grafana-server -f

Langkah 4: Akses Antarmuka Web Grafana {#step-4}

Secara default, Grafana mendengarkan pada port 3000. Buka browser web Anda dan navigasikan ke:

http://your_server_ip:3000

Ganti your_server_ip dengan alamat IP atau hostname sebenarnya dari server Anda.

Kredensial Login Default

Saat login pertama Anda, Grafana akan segera meminta Anda untuk menetapkan kata sandi baru yang aman. Jangan lewati langkah ini — membiarkan kredensial default tetap ada adalah risiko keamanan yang signifikan.

> Catatan Firewall: Jika Anda menjalankan UFW atau firewall lain, buka port 3000 untuk memungkinkan akses browser:

> “`bash

> sudo ufw allow 3000/tcp

> sudo ufw reload

> “`

Langkah 5: Konfigurasi Sumber Data {#step-5}

Grafana adalah lapisan visualisasi — ia tidak menyimpan metrik sendiri. Sebaliknya, ia terhubung ke sumber data eksternal seperti Prometheus, InfluxDB, Elasticsearch, MySQL, PostgreSQL, dan banyak lainnya. Mengonfigurasi sumber data adalah langkah penting pertama sebelum Anda dapat membangun dashboard apa pun.

Langkah 5a: Navigasikan ke Sumber Data

1. Di sidebar kiri, klik ikon gear (⚙) untuk membuka menu Configuration.
2. Pilih Data Sources.

Langkah 5b: Tambahkan Sumber Data Baru

1. Klik Add data source.
2. Telusuri daftar dan pilih jenis sumber data yang Anda inginkan (misalnya, Prometheus, InfluxDB, MySQL).

Langkah 5c: Masukkan Detail Koneksi

Isi parameter koneksi untuk sumber data pilihan Anda. Misalnya, jika Anda terhubung ke instance Prometheus yang berjalan secara lokal:

• URL: http://localhost:9090
• Access: Server (default)
• Scrape interval: 15s (cocokkan dengan konfigurasi scrape Prometheus Anda)

Untuk instance InfluxDB jarak jauh, Anda akan memberikan URL host, nama database, dan kredensial autentikasi.

Langkah 5d: Simpan dan Uji Koneksi

Klik Save & Test. Grafana akan mencoba terhubung ke sumber data dan menampilkan pesan sukses atau kesalahan. Konfirmasi "Data source is working" berwarna hijau berarti Anda siap membangun dashboard.

Langkah 6: Buat Dashboard Grafana Pertama Anda {#step-6}

Dengan sumber data terhubung, Anda sekarang dapat membuat dashboard untuk memvisualisasikan metrik Anda secara real-time.

Langkah 6a: Buat Dashboard Baru

1. Di sidebar kiri, klik ikon + (plus).
2. Pilih Dashboard.
3. Klik Add new panel.

Langkah 6b: Konfigurasi Panel

Editor panel terbuka, memberi Anda kontrol penuh atas data apa yang ditampilkan dan cara divisualisasikannya.

• Data Source: Pilih sumber data yang Anda konfigurasikan di Langkah 5.
• Query: Tulis kueri metrik Anda. Untuk Prometheus, gunakan PromQL. Misalnya, untuk memvisualisasikan penggunaan CPU:

  100 - (avg by(instance) (rate(node_cpu_seconds_total{mode="idle"}[5m])) * 100)

• Visualization Type: Pilih dari Time series, Gauge, Bar chart, Table, Stat, Heatmap, dan lainnya — tergantung pada sifat data Anda.
• Panel Title: Berikan panel Anda nama deskriptif (misalnya, "CPU Usage — Last 1 Hour").

Langkah 6c: Kustomisasi dan Simpan

Gunakan opsi panel di sebelah kanan untuk mengonfigurasi threshold, skema warna, label sumbu, dan legenda. Setelah puas:

1. Klik Apply untuk menambahkan panel ke dashboard Anda.
2. Ulangi proses untuk menambahkan beberapa panel — masing-masing melacak metrik yang berbeda.
3. Klik ikon Save dashboard (floppy disk) di sudut kanan atas, berikan dashboard Anda nama, dan klik Save.

> Pro Tip: Perpustakaan dashboard resmi Grafana menawarkan ratusan dashboard yang telah dibangun sebelumnya yang dikontribusikan oleh komunitas untuk stack populer seperti Node Exporter, Kubernetes, MySQL, dan NGINX. Anda dapat mengimpornya langsung menggunakan ID dashboard.

Langkah 7: Siapkan Alert {#step-7}

Mesin alerting bawaan Grafana memungkinkan Anda mendefinisikan aturan berbasis threshold dan menerima notifikasi ketika metrik melampaui level kritis — membuat Anda tetap terinformasi sebelum masalah kecil menjadi pemadaman besar.

Langkah 7a: Buat Aturan Alert

1. Buka panel yang ingin Anda pantau dan klik Edit.
2. Navigasikan ke tab Alert dalam editor panel.
3. Klik Create Alert.

Langkah 7b: Tentukan Kondisi Alert

Konfigurasikan kondisi yang memicu alert. Misalnya:

• Condition: WHEN avg() OF query(A, 5m, now) IS ABOVE 90
• Ini memicu alert ketika nilai rata-rata metrik Anda melebihi 90 selama 5 menit terakhir.

Atur bidang Evaluate every dan For untuk mengontrol seberapa sering aturan dievaluasi dan berapa lama kondisi harus bertahan sebelum terpicu.

Langkah 7c: Konfigurasi Saluran Notifikasi

1. Buka Alerting → Notification channels di sidebar kiri.
2. Klik Add channel dan pilih metode pilihan Anda:

• Email — memerlukan konfigurasi SMTP di grafana.ini
• Slack — memerlukan URL webhook Slack
• PagerDuty, OpsGenie, Webhook, dan lainnya

Tetapkan saluran notifikasi ke aturan alert Anda sehingga orang yang tepat diberitahu ketika threshold terlampaui.

Langkah 8: Amankan Grafana dengan HTTPS dan Access Controls {#step-8}

Menjalankan Grafana di lingkungan produksi tanpa pengerasan keamanan yang tepat adalah risiko serius. Ikuti praktik terbaik ini untuk melindungi infrastruktur monitoring Anda.

8a: Aktifkan HTTPS dengan Sertifikat SSL

Mengenkripsi traffic ke instance Grafana Anda sangat penting, terutama jika dapat diakses melalui internet publik. Anda akan membutuhkan sertifikat SSL yang valid — AlexHost menawarkan SSL Certificates yang terjangkau dan mudah diterapkan.

Setelah Anda memiliki sertifikat dan kunci pribadi, edit file konfigurasi Grafana:

sudo nano /etc/grafana/grafana.ini

Temukan bagian [server] dan perbarui parameter berikut:

[server]
protocol = https
http_port = 3000
cert_file = /etc/grafana/ssl/grafana.crt
cert_key = /etc/grafana/ssl/grafana.key

Simpan file dan restart Grafana:

sudo systemctl restart grafana-server

Grafana sekarang akan dapat diakses melalui HTTPS pada port 3000.

> Alternatif yang Direkomendasikan: Tempatkan Grafana di belakang reverse proxy (misalnya, Nginx atau Apache) dan akhiri SSL di level proxy. Ini adalah pendekatan yang lebih fleksibel dan diadopsi secara luas di lingkungan produksi.

8b: Batasi Akses Admin dan Kelola Pengguna

1. Navigasikan ke Server Admin → Users di UI Grafana.
2. Tinjau dan sesuaikan peran pengguna:

• Admin — akses penuh
• Editor — dapat membuat dan mengedit dashboard
• Viewer — akses read-only

1. Nonaktifkan atau hapus akun yang tidak digunakan.
2. Pertimbangkan untuk mengaktifkan LDAP atau OAuth (Google, GitHub, GitLab) untuk autentikasi terpusat.

8c: Rekomendasi Pengerasan Tambahan

• Nonaktifkan akses anonim di grafana.ini:

  [auth.anonymous]
  enabled = false

• Ubah port HTTP default jika Grafana terbuka untuk publik.
• Batasi koneksi keluar dari server Grafana menggunakan aturan firewall.
• Aktifkan audit logging untuk melacak aktivitas pengguna.

Langkah 9: Kelola dan Perbarui Grafana {#step-9}

Menjaga Grafana tetap terbaru sangat penting untuk keamanan dan akses ke fitur baru. Karena Anda menginstal Grafana dari repository APT resmi, update sangat mudah.

Perbarui Grafana

sudo apt update
sudo apt upgrade grafana -y

Perintah Manajemen Layanan Umum

Backup Data Grafana

Grafana menyimpan konfigurasi, dashboard, dan data pengguna dalam database SQLite secara default, berlokasi di:

/var/lib/grafana/grafana.db

Backup file ini secara teratur, terutama sebelum melakukan upgrade:

sudo cp /var/lib/grafana/grafana.db /var/lib/grafana/grafana.db.backup-$(date +%F)

Untuk deployment yang lebih besar, pertimbangkan migrasi ke backend MySQL atau PostgreSQL yang didedikasikan untuk keandalan yang lebih baik dan manajemen backup yang lebih mudah.

Pemecahan Masalah Masalah Umum