Ubuntu’da Grafana Nasıl Kurulur: Tam Kurulum ve Yapılandırma Kılavuzu

Grafana, veri görselleştirme ve altyapı izleme için en güçlü açık kaynak platformlarından biridir. Sunucu performansını, uygulama metriklerini veya işletme KPI’larını takip ediyor olsanız da, Grafana’nın esnek panoları ve geniş veri kaynağı desteği, herhangi bir sistem yöneticisi veya DevOps mühendisi için vazgeçilmez bir araç haline getirir.

Bu kapsamlı rehber, Grafana’yı Ubuntu’ya yüklemenin her adımında size yol gösterir — ilk sistem hazırlığından veri kaynaklarını yapılandırmaya, ilk panonuzu oluşturmaya, uyarıları ayarlamaya ve dağıtımınızı güvenli hale getirmeye kadar.

> Ön Koşullar: Çalışan bir Ubuntu sunucusu (20.04 veya 22.04 LTS önerilir), sudo ayrıcalıkları ve kararlı bir internet bağlantısı. Grafana örneğinizi barındıracak güvenilir bir sunucuya ihtiyacınız varsa, AlexHost’tan VPS Hosting düşünün — performans açısından kritik izleme iş yükleri için optimize edilmiştir.

Adım 1: Sistem Paketlerini Güncelle

Herhangi bir yeni yazılım yüklemeden önce, paket dizininizi senkronize etmek ve tüm kullanılabilir yükseltmeleri uygulamak kritik önem taşır. Bu, uyumluluğu sağlar ve bağımlılık çatışmalarının riskini azaltır.

sudo apt update && sudo apt upgrade -y

İşlemin tamamlanmasını bekleyin ve ardından devam edin. Yeni sağlanan bir sunucuda bu, birkaç dakika sürebilir.

Adım 2: Resmi APT Deposu Aracılığıyla Grafana’yı Yükleyin

Grafana, Debian tabanlı sistemler de dahil olmak üzere Ubuntu için resmi bir APT deposu tutar. Resmi depoyu kullanmak, her zaman en son kararlı sürümlere ve güvenlik yamalarına erişim sağlamanızı garantiler.

Adım 2a: Gerekli Bağımlılıkları Yükleyin

Önce software-properties-common paketini yükleyin; bu paket add-apt-repository yardımcı programını sağlar:

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

Adım 2b: Grafana GPG İmzalama Anahtarını İçe Aktarın

GPG anahtarını eklemek, sisteminizin Grafana deposundan indirilen paketlerin orijinalliğini doğrulamasını sağlar:

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

Adım 2c: Resmi Grafana APT Deposunu Ekleyin

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

Adım 2d: Paket Listesini Güncelleyin ve Grafana’yı Yükleyin

sudo apt update
sudo apt install grafana -y

Yükleme tamamlandıktan sonra, yüklü sürümü doğrulayın:

grafana-server -v

Adım 3: Grafana Hizmetini Başlatın ve Etkinleştirin

Kurulumdan sonra, Grafana sunucu daemon’unu başlatın ve sistem önyüklemesinde otomatik olarak başlaması için yapılandırın:

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

Hizmetin doğru şekilde çalışıp çalışmadığını doğrulayın:

sudo systemctl status grafana-server

Hizmetin active (running) olduğunu doğrulayan aşağıdakine benzer bir çıktı görmelisiniz:

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

Hizmet başlatılamazsa, hatalar için günlükleri kontrol edin:

sudo journalctl -u grafana-server -f

Adım 4: Grafana Web Arayüzüne Erişin

Varsayılan olarak, Grafana port 3000 üzerinde dinler. Web tarayıcınızı açın ve şu adrese gidin:

http://your_server_ip:3000

your_server_ip yerine sunucunuzun gerçek IP adresi veya hostname’ini yazın.

Varsayılan Giriş Kimlik Bilgileri

İlk giriş yaptığınızda, Grafana sizi hemen yeni, güvenli bir şifre belirlemeye davet edecektir. Bu adımı atlamayın — varsayılan kimlik bilgilerini yerinde bırakmak önemli bir güvenlik riski oluşturur.

> Firewall Notu: UFW veya başka bir firewall çalıştırıyorsanız, tarayıcı erişimine izin vermek için port 3000’i açın:

> “`bash

> sudo ufw allow 3000/tcp

> sudo ufw reload

> “`

Adım 5: Veri Kaynaklarını Yapılandırın

Grafana bir görselleştirme katmanıdır — metrikleri kendisi depolamaz. Bunun yerine, Prometheus, InfluxDB, Elasticsearch, MySQL, PostgreSQL ve diğer birçok harici veri kaynağına bağlanır. Bir veri kaynağını yapılandırmak, herhangi bir pano oluşturabilmeniz için gerekli ilk adımdır.

Adım 5a: Veri Kaynaklarına Gidin

1. Sol kenar çubuğunda, Yapılandırma menüsünü açmak için dişli simgesine (⚙) tıklayın.
2. Veri Kaynakları‘nı seçin.

Adım 5b: Yeni Veri Kaynağı Ekleyin

1. Veri kaynağı ekle‘ye tıklayın.
2. Listeyi inceleyin ve istediğiniz veri kaynağı türünü seçin (örneğin, Prometheus, InfluxDB, MySQL).

Adım 5c: Bağlantı Ayrıntılarını Girin

Seçilen veri kaynağınız için bağlantı parametrelerini doldurun. Örneğin, yerel olarak çalışan bir Prometheus örneğine bağlanıyorsanız:

• URL: http://localhost:9090
• Erişim: Server (default)
• Scrape aralığı: 15s (Prometheus scrape yapılandırmanızla eşleştirin)

Uzak bir InfluxDB örneği için, ana bilgisayar URL’sini, veritabanı adını ve kimlik doğrulama kimlik bilgilerini sağlarsınız.

Adım 5d: Bağlantıyı Kaydedin ve Test Edin

Kaydet ve Test Et‘e tıklayın. Grafana, veri kaynağına bağlanmaya çalışacak ve başarı veya hata mesajı görüntüleyecektir. Yeşil “Veri kaynağı çalışıyor” onayı, pano oluşturmaya hazır olduğunuz anlamına gelir.

Adım 6: İlk Grafana Panonuzu Oluşturun

Bir veri kaynağı bağlandığında, metriklerinizi gerçek zamanlı olarak görselleştirmek için panolar oluşturabilirsiniz.

Adım 6a: Yeni Pano Oluşturun

1. Sol kenar çubuğunda + (artı) simgesini tıklayın.
2. Dashboard seçeneğini seçin.
3. Add new panel seçeneğini tıklayın.

Adım 6b: Paneli Yapılandırın

Panel editörü açılır ve hangi verilerin görüntüleneceği ve nasıl görselleştirileceği üzerinde tam kontrol sağlar.

• Data Source: Adım 5’te yapılandırdığınız veri kaynağını seçin.
• Query: Metrik sorgunuzu yazın. Prometheus için PromQL kullanın. Örneğin, CPU kullanımını görselleştirmek için:

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

• Visualization Type: Verilerinizin niteliğine bağlı olarak Time series, Gauge, Bar chart, Table, Stat, Heatmap ve daha fazlasından seçim yapın.
• Panel Title: Panelinize açıklayıcı bir ad verin (örneğin, “CPU Usage — Last 1 Hour”).

Adım 6c: Özelleştirin ve Kaydedin

Eşikleri, renk şemalarını, eksen etiketlerini ve göstergeleri yapılandırmak için sağ taraftaki panel seçeneklerini kullanın. Memnun olduğunuzda:

1. Paneli panonuza eklemek için Apply seçeneğini tıklayın.
2. Her biri farklı bir metriği izleyen birden fazla panel eklemek için işlemi tekrarlayın.
3. Sağ üst köşedeki Save dashboard simgesini (disket) tıklayın, panonuza bir ad verin ve Save seçeneğini tıklayın.

> Pro Tip: Grafana’nın resmi pano kütüphanesi, Node Exporter, Kubernetes, MySQL ve NGINX gibi popüler yığınlar için yüzlerce önceden oluşturulmuş, topluluk tarafından katkıda bulunulan pano sunar. Bunları doğrudan bir pano kimliği kullanarak içe aktarabilirsiniz.

Adım 7: Uyarıları Ayarlayın

Grafana’nın yerleşik uyarı motoru, eşik tabanlı kurallar tanımlamanıza ve metrikler kritik seviyeleri aştığında bildirim almanıza olanak tanır — küçük sorunlar büyük kesintilere dönüşmeden sizi bilgilendirmiş olur.

Adım 7a: Uyarı Kuralı Oluşturun

1. İzlemek istediğiniz paneli açın ve Düzenle‘ye tıklayın.
2. Panel editörü içinde Uyarı sekmesine gidin.
3. Uyarı Oluştur‘a tıklayın.

Adım 7b: Uyarı Koşullarını Tanımlayın

Uyarıyı tetikleyen koşulları yapılandırın. Örneğin:

• Koşul: WHEN avg() OF query(A, 5m, now) IS ABOVE 90
• Bu, metriğinizin ortalama değeri son 5 dakika içinde 90’ı aştığında bir uyarı tetikler.

Kuralın ne sıklıkta değerlendirildiğini ve koşulun tetiklenmeden önce ne kadar süre devam etmesi gerektiğini kontrol etmek için Her şunu değerlendir ve Şu süre için alanlarını ayarlayın.

Adım 7c: Bildirim Kanallarını Yapılandırın

1. Sol kenar çubuğunda Uyarı Verme → Bildirim kanalları‘na gidin.
2. Kanal ekle‘ye tıklayın ve tercih ettiğiniz yöntemi seçin:

• E-posta — grafana.ini içinde SMTP yapılandırması gerektirir
• Slack — Slack webhook URL’si gerektirir
• PagerDuty, OpsGenie, Webhook ve daha fazlası

Eşikler aşıldığında doğru kişilerin bilgilendirilmesi için bildirim kanalını uyarı kuralınıza atayın.

Adım 8: Grafana’yı HTTPS ve Erişim Kontrolleriyle Güvenli Hale Getirin

Grafana’yı uygun güvenlik sertleştirmesi olmadan bir üretim ortamında çalıştırmak ciddi bir risktir. İzleme altyapınızı korumak için bu en iyi uygulamaları izleyin.

8a: HTTPS’yi SSL Sertifikasıyla Etkinleştirin

Grafana örneğinize giden trafiği şifrelemek, özellikle genel internet üzerinden erişilebilir ise gereklidir. Geçerli bir SSL sertifikasına ihtiyacınız olacak — AlexHost, dağıtması kolay uygun fiyatlı SSL Sertifikaları sunmaktadır.

Sertifikanız ve özel anahtarınız olduğunda, Grafana yapılandırma dosyasını düzenleyin:

sudo nano /etc/grafana/grafana.ini

[server] bölümünü bulun ve aşağıdaki parametreleri güncelleyin:

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

Dosyayı kaydedin ve Grafana’yı yeniden başlatın:

sudo systemctl restart grafana-server

Grafana artık 3000 numaralı bağlantı noktasında HTTPS üzerinden erişilebilir olacaktır.

> Önerilen Alternatif: Grafana’yı bir ters proxy’nin (örn. Nginx veya Apache) arkasına yerleştirin ve SSL sonlandırmasını proxy düzeyinde gerçekleştirin. Bu, üretim ortamlarında daha esnek ve yaygın olarak benimsenen bir yaklaşımdır.

8b: Yönetici Erişimini Kısıtlayın ve Kullanıcıları Yönetin

1. Grafana UI’de Server Admin → Users (Sunucu Yöneticisi → Kullanıcılar) bölümüne gidin.
2. Kullanıcı rollerini gözden geçirin ve ayarlayın:

• Admin — tam erişim
• Editor — pano oluşturabilir ve düzenleyebilir
• Viewer — salt okunur erişim

1. Kullanılmayan hesapları devre dışı bırakın veya silin.
2. Merkezi kimlik doğrulama için LDAP veya OAuth (Google, GitHub, GitLab) etkinleştirmeyi düşünün.

8c: Ek Sertleştirme Önerileri

• grafana.ini içinde anonim erişimi devre dışı bırakın:

  [auth.anonymous]
  enabled = false

• Grafana genel olarak açıksa varsayılan HTTP bağlantı noktasını değiştirin.
• Grafana sunucusundan giden bağlantıları kısıtlayın güvenlik duvarı kurallarını kullanarak.
• Denetim günlüğünü etkinleştirin kullanıcı etkinliğini izlemek için.

Adım 9: Grafana’yı Yönetin ve Güncelleyin

Grafana’yı güncel tutmak güvenlik ve yeni özelliklere erişim için kritiktir. Grafana’yı resmi APT deposundan yüklediğiniz için güncellemeler basittir.

Grafana’yı Güncelleyin

sudo apt update
sudo apt upgrade grafana -y

Yaygın Hizmet Yönetimi Komutları

Grafana Verilerini Yedekleyin

Grafana, yapılandırma, panolar ve kullanıcı verilerini varsayılan olarak SQLite veritabanında depolar; konumu:

/var/lib/grafana/grafana.db

Bu dosyayı düzenli olarak yedekleyin, özellikle yükseltme gerçekleştirmeden önce:

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

Daha büyük dağıtımlar için, geliştirilmiş güvenilirlik ve daha kolay yedekleme yönetimi için MySQL veya PostgreSQL arka ucuna geçişi düşünün.

Yaygın Sorunları Giderme

Grafana Stack’iniz için Doğru Hosting Seçimi

Grafana dağıtımınızın performansı, temel altyapıya büyük ölçüde bağlıdır. Doğru hosting katmanını seçmek için hızlı bir kılavuz:

• Küçük takımlar / kişisel projeler: Shared Web Hosting hafif kurulumlar için çalışabilir, ancak Grafana için genellikle bir VPS önerilir.
• Üretim izleme yığınları: Bir VPS Hosting planı size adanmış kaynaklar, root erişimi ve Grafana’yı Prometheus, InfluxDB veya diğer bileşenlerle birlikte çalıştırma esnekliği sağlar.
• Yüksek hacimli veri alımı / ML odaklı gözlemlenebilirlik: Büyük ölçekli veri işleme veya AI destekli anomali tespiti içeren iş yükleri için GPU Hosting düşünün.
• Kurumsal düzey dağıtımlar: Dedicated Servers görev açısından kritik izleme altyapısı için maksimum performans, izolasyon ve güvenlik sağlar.

Sonuç

Ubuntu üzerinde Grafana’yı yüklemek ve yapılandırmak, sistemleriniz ve uygulamalarınıza güçlü, gerçek zamanlı görünürlük sağlayan basit bir işlemdir. Bu kılavuzu takip ederek şunları öğrendiniz:

• Ubuntu’da resmi depodan Grafana’yı yüklemek
• Grafana hizmetini başlatmak, etkinleştirmek ve doğrulamak
• Prometheus, InfluxDB ve MySQL gibi veri kaynaklarını bağlamak
• Özel paneller ve görselleştirmelerle etkileşimli panolar oluşturmak
• Çok kanallı bildirimlerle eşik tabanlı uyarılar yapılandırmak
• Grafana örneğinizi HTTPS ve rol tabanlı erişim kontrolü ile güvenli hale getirmek
• Standart APT komutlarını kullanarak Grafana’yı bakımını yapmak ve güncellemek

Tek bir VPS’i izliyor olsanız da karmaşık bir çok düğümlü altyapıyı izliyor olsanız da, Grafana performans sorunlarından önce haberdar olmak ve veri odaklı kararlar almak için ihtiyaç duyduğunuz gözlemlenebilirlik temelini sağlar. Bunu AlexHost’tan güvenilir bir barındırma ortamı ile birleştirin ve dünya standartlarında bir izleme yığını oluşturmak için ihtiyaç duyduğunuz her şeye sahip olursunuz.