Grafana Nedir ve Metrik Görselleştirme Rehberi

Bir sunucunun CPU kullanımı gece yarısı üç dakika boyunca yüzde doksanı geçtiğinde bunu ertesi sabah müşteriler şikayet ettiğinde mi öğrenmek istersiniz, yoksa olay olurken ekranınızda kırmızı bir çizgi hâlinde mi görmek istersiniz? Bu iki senaryo arasındaki fark çoğu zaman doğru görselleştirme aracına sahip olup olmamaktan geçer. Grafana tam da bu boşluğu doldurur: farklı sistemlerde dağınık hâlde duran sayısal verileri tek bir ekranda, insanların bir bakışta anlayabileceği grafiklere ve panolara dönüştürür.

Grafana açık kaynaklı bir metrik görselleştirme ve gözlemlenebilirlik aracıdır. Kendisi veri depolamaz; bunun yerine Prometheus, MySQL, PostgreSQL, InfluxDB, Loki, Elasticsearch gibi onlarca farklı veri kaynağına bağlanır ve oradaki verileri sorgulayıp panolar üzerinde gösterir. Yani Grafana'yı bir vitrin gibi düşünebilirsiniz: arka odada duran ham verileri alır, onları düzenli, canlı ve etkileşimli bir biçimde sergiler. Bu rehberde Grafana'nın çalışma mantığını, kurulumunu, veri kaynağı bağlamayı, panel oluşturmayı, kullanıcı yetkilendirmesini ve uyarı kurallarını uygulamalı örneklerle ele alacağız.

Grafana Nedir ve Nasıl Çalışır#

Grafana'nın en temel özelliği verinin kendisiyle ilgilenmemesi, verinin sunumuyla ilgilenmesidir. Modern bir izleme kurulumunda genellikle üç katman bulunur: verinin üretildiği sistemler (sunucular, uygulamalar, veritabanları), bu veriyi toplayıp saklayan depolar (Prometheus, InfluxDB, Loki) ve bu deponun içindekini görselleştiren katman. Grafana bu son katmandır. Bu ayrım önemlidir çünkü aynı Grafana örneğiyle hem sunucu metriklerini, hem uygulama loglarını, hem de iş zekâsı raporlarını tek çatı altında toplayabilirsiniz.

Grafana'nın en çok birlikte anıldığı araç Prometheus'tur. Prometheus zaman serisi verileri toplar ve saklar; Grafana da bu verileri PromQL sorgularıyla çeker ve grafiğe döker. Ama Grafana yalnızca Prometheus'a bağlı değildir. Bir e-ticaret veritabanındaki günlük sipariş sayısını MySQL'den SQL ile çekip aynı panoda gösterebilir, sunucu loglarını Loki'den okuyup hata sayılarını izleyebilirsiniz. Grafana'nın gücü işte bu heterojen kaynakları tek bir görsel dilde birleştirebilmesinden gelir.

Kavramsal olarak Grafana'da üç temel yapı taşı vardır. Veri kaynağı (data source) Grafana'nın veriyi nereden okuyacağını tanımlar. Panel tek bir grafik, tablo veya göstergedir; örneğin "son 24 saatteki CPU kullanımı" bir paneldir. Pano (dashboard) ise birden fazla panelin bir araya geldiği ekrandır. Bu üçlüyü kavradığınızda Grafana'nın geri kalan her özelliği bu temel üzerine oturur.

Grafana Kurulumu#

Grafana'yı bir Linux sunucusuna kurmanın en temiz yolu resmi APT veya YUM deposunu eklemektir. Bu yöntem güncellemeleri paket yöneticisi üzerinden almanızı sağlar. Ubuntu ve Debian tabanlı sistemlerde aşağıdaki adımlar yeterlidir:

# Gerekli bağımlılıkları kur
sudo apt-get install -y apt-transport-https software-properties-common wget

# Grafana GPG anahtarını ekle
sudo mkdir -p /etc/apt/keyrings/
wget -q -O - https://apt.grafana.com/gpg.key | \
  gpg --dearmor | sudo tee /etc/apt/keyrings/grafana.gpg > /dev/null

# Depoyu sisteme tanıt
echo "deb [signed-by=/etc/apt/keyrings/grafana.gpg] https://apt.grafana.com stable main" | \
  sudo tee /etc/apt/sources.list.d/grafana.list

# Kurulumu tamamla
sudo apt-get update
sudo apt-get install -y grafana

Kurulum bittikten sonra servisi başlatıp sistem açılışında otomatik gelmesini sağlamanız gerekir. systemctl bu iş için standart araçtır:

sudo systemctl daemon-reload
sudo systemctl enable grafana-server
sudo systemctl start grafana-server
sudo systemctl status grafana-server

Grafana varsayılan olarak 3000 numaralı portta çalışır. Tarayıcınızda http://sunucu-ip:3000 adresine gittiğinizde giriş ekranıyla karşılaşırsınız. İlk giriş için kullanıcı adı ve parola admin / admin'dir; sistem sizi hemen parolayı değiştirmeye zorlar ve bunu ciddiye almalısınız. Ana yapılandırma dosyası /etc/grafana/grafana.ini altında bulunur ve büyük ölçüde yorum satırlarıyla dolu, iyi belgelenmiş bir dosyadır. Örneğin sunucu adresini ve kök URL'i şöyle özelleştirebilirsiniz:

[server]
protocol = http
http_port = 3000
domain = izleme.ornekfirma.com
root_url = https://izleme.ornekfirma.com/

[security]
admin_user = admin
disable_gravatar = true
cookie_secure = true

Kaynak açısından Grafana oldukça hafiftir; tek başına 512 MB RAM'li bir sunucuda rahatça çalışır. Ancak yanında Prometheus, Loki gibi veri depoları da barındıracaksanız daha güçlü bir makine tercih etmelisiniz. Bu tür kalıcı izleme yükleri için paylaşımlı hosting yerine kaynakları size ait olan bir sanal sunucu veya VDS çok daha uygundur.

Veri Kaynaklarını Bağlamak#

Grafana kurulduktan sonraki ilk gerçek iş veri kaynağı bağlamaktır. Bunu arayüzden Connections > Data sources menüsünden yapabilirsiniz, ancak altyapıyı kod olarak yönetmek istiyorsanız Grafana'nın "provisioning" özelliğiyle YAML dosyaları üzerinden de tanımlayabilirsiniz. Otomatik ve tekrarlanabilir kurulumlar için ikinci yöntem çok daha sağlıklıdır.

Prometheus bağlantısını YAML ile tanımlamak için /etc/grafana/provisioning/datasources/prometheus.yaml dosyasını oluşturun:

apiVersion: 1

datasources:
  - name: Prometheus
    type: prometheus
    access: proxy
    url: http://localhost:9090
    isDefault: true
    editable: false
    jsonData:
      timeInterval: "15s"
      httpMethod: POST

Buradaki access: proxy ayarı önemlidir: tarayıcının değil, Grafana sunucusunun Prometheus'a bağlanmasını sağlar, böylece Prometheus'u dışarıya açmanız gerekmez. İlişkisel bir veritabanını, örneğin uygulama verisi tutan bir MySQL'i bağlamak da benzer şekildedir. Bağlantı kurulduğunda panellerde doğrudan SQL yazabilirsiniz:

SELECT
  UNIX_TIMESTAMP(created_at) AS "time",
  COUNT(*) AS "Günlük Sipariş"
FROM orders
WHERE $__timeFilter(created_at)
GROUP BY DATE(created_at)
ORDER BY created_at;

Buradaki $__timeFilter() Grafana'nın yerleşik makrolarından biridir; panonun üstündeki zaman aralığı seçicisini otomatik olarak SQL'e çevirir. Bu makrolar sayesinde kullanıcı zaman aralığını değiştirdiğinde sorguyu elle güncellemeniz gerekmez.

Loglar için tercih edilen veri kaynağı ise Loki'dir. Loki, "loglar için Prometheus" olarak tanımlanır ve LogQL adında Prometheus'a çok benzeyen bir sorgu diline sahiptir. Aşağıdaki örnek, belirli bir uygulamanın hata seviyesindeki loglarını dakikada kaç kez ürettiğini gösterir:

sum(rate({app="odeme-servisi"} |= "level=error" [5m]))

Bir Grafana panosunda metrikleri (Prometheus) ve logları (Loki) yan yana koyabilmek gerçek bir güçtür: CPU'nun tavan yaptığı anı grafikte gördüğünüzde, hemen altındaki log panelinde o dakikada ne olduğunu okuyabilirsiniz. Bu tür log toplama ve izleme senaryolarını yedekleme stratejinizle birlikte planlarsanız, bir sorun anında hem neyin bozulduğunu hem de geri dönüş noktanızı bir arada görürsünüz.

İlk Panonuzu Oluşturmak#

Veri kaynağı hazır olduğunda ilk panoyu oluşturmak sürükle bırak kolaylığındadır. Sol menüden Dashboards > New > New dashboard yolunu izleyip Add visualization düğmesine bastığınızda karşınıza panel düzenleyici çıkar. Üst kısımda görselleştirme tipini seçersiniz (zaman serisi grafiği, gösterge/gauge, tek istatistik, tablo, ısı haritası vb.), alt kısımda ise veri kaynağını seçip sorgunuzu yazarsınız.

Sunucu izleme için klasik bir başlangıç noktası CPU, RAM ve disk kullanımıdır. Örneğin Node Exporter ile Prometheus'a akan bir sunucunun bellek kullanım yüzdesini şu PromQL sorgusuyla çizebilirsiniz:

100 * (1 - (node_memory_MemAvailable_bytes / node_memory_MemTotal_bytes))

Bu sorguyu bir "Time series" paneline koyup Y ekseninin birimini yüzde olarak ayarladığınızda, zaman içindeki bellek kullanımını gösteren temiz bir grafik elde edersiniz. Panelin sağ tarafındaki ayarlardan eşik değerleri (thresholds) tanımlayarak yüzde 80'in üstünü sarı, yüzde 90'ın üstünü kırmızı gösterebilirsiniz; böylece grafiğe bakan biri sorunun ciddiyetini renk kodundan anlar.

Panoları verimli kullanmanın anahtarı değişkenlerdir (variables). Pano ayarlarından bir değişken tanımlayıp, örneğin tüm sunucularınızın listesini bir açılır menüye dökebilirsiniz. Ardından panellerdeki sorgularda sabit sunucu adı yerine $sunucu değişkenini kullanırsınız. Sonuç: tek bir pano, açılır menüden seçtiğiniz her sunucu için otomatik olarak yeniden çizilir. Yüzlerce sunucu için yüzlerce pano yapmak yerine tek şablon panoyla tüm filoyu izlersiniz. Hazır panolara ihtiyaç duyarsanız Grafana'nın topluluk kütüphanesinde binlerce hazır pano JSON'u bulunur; bunları ID numarasıyla içe aktarıp kendinize uyarlayabilirsiniz.

Kullanıcı Yönetimi ve Yetkilendirme#

Grafana ekiplerle kullanıldığında kim neyi görebilir ve değiştirebilir sorusu kritik hâle gelir. Grafana bunu üç katmanlı bir modelle çözer: kuruluş (organization), takım (team) ve rol (role). Küçük kurulumlarda tek kuruluş yeterlidir, ancak birden çok müşteriye hizmet veriyorsanız her müşteri için ayrı kuruluş açarak verileri tamamen izole edebilirsiniz.

Temel roller nettir. Viewer yalnızca panoları görüntüler, hiçbir şeyi değiştiremez. Editor pano ve panel oluşturup düzenleyebilir ama sistem ayarlarına dokunamaz. Admin ise veri kaynağı ekleme, kullanıcı davet etme gibi yönetimsel işleri de yapabilir. Aşağıdaki tablo bu rollerin kabaca neye yetkili olduğunu özetler:

Kullanıcıları tek tek yönetmek yerine takımlar oluşturup panoları takım bazında yetkilendirmek çok daha ölçeklenebilirdir. Örneğin "Veritabanı Ekibi" takımına yalnızca veritabanı panolarında Editor yetkisi, diğer panolarda Viewer yetkisi verebilirsiniz. Kurumsal ortamlarda genellikle Grafana'yı mevcut kimlik sağlayıcınıza (LDAP, OAuth, Google Workspace) bağlarsınız; böylece kullanıcılar şirket hesaplarıyla giriş yapar ve ayrılan bir çalışanın erişimi merkezî olarak kesilir. Bu tür kimlik entegrasyonlarını devreye alırken varsayılan admin hesabının parolasını mutlaka güçlü bir değerle değiştirin ve anonim erişimi kapatın:

[auth.anonymous]
enabled = false

[users]
allow_sign_up = false
auto_assign_org_role = Viewer

Uyarı (Alert) Kurallarını Kurmak#

Görselleştirme güzeldir ama gerçek değer, kimse ekrana bakmadığında bile sizi uyaran sistemdir. Grafana'nın birleşik uyarı sistemi (Grafana Alerting) tam olarak bunu yapar: bir metrik belirlediğiniz eşiği aştığında e-posta, Slack, Telegram, webhook ve daha birçok kanaldan bildirim gönderir. Uyarı kurmanın mantığı üç parçadan oluşur: uyarı kuralı (koşul), iletişim noktası (nereye gönderilecek) ve bildirim politikası (hangi uyarı nereye).

Bir uyarı kuralı özünde şudur: "Şu sorgunun sonucu, şu süre boyunca, şu eşiği aşarsa alarm ver." Örneğin bir disk bölümünün doluluk oranı beş dakika boyunca yüzde 90'ın üzerinde kalırsa uyarı üretmek istersiniz. Kuralı arayüzden görsel olarak kurabileceğiniz gibi, provisioning ile YAML olarak da tanımlayabilirsiniz:

apiVersion: 1
groups:
  - orgId: 1
    name: sunucu-kurallari
    folder: Altyapi
    interval: 1m
    rules:
      - uid: disk-doluluk-uyari
        title: Disk Doluluğu Kritik
        condition: C
        for: 5m
        annotations:
          summary: "{{ $labels.instance }} sunucusunda disk %90'ı geçti"
        labels:
          severity: critical

Buradaki for: 5m ifadesi önemlidir: eşik anlık aşıldığında değil, beş dakika boyunca sürekli aşıldığında alarm verir. Bu, geçici sıçramalardan (örneğin bir yedekleme sırasında diskin kısa süre dolması) kaynaklanan yanlış alarmları büyük ölçüde engeller. İletişim noktası olarak e-posta kullanacaksanız SMTP ayarlarını grafana.ini içinde tanımlamanız gerekir:

[smtp]
enabled = true
host = smtp.ornekfirma.com:587
user = [email protected]
password = """gizli-parola"""
from_address = [email protected]
from_name = Grafana Uyari

Uyarıları anlamlı kılmanın sırrı, çok fazla değil, doğru uyarıları kurmaktır. Her metrik için alarm koyarsanız kısa sürede "uyarı yorgunluğu" yaşar ve gerçekten önemli olanları kaçırırsınız. İyi bir başlangıç noktası şudur: kullanıcıyı doğrudan etkileyen belirtileri izleyin (servis yanıt vermiyor, disk doldu, hata oranı fırladı), iç metrikleri ise tanı amaçlı panolarda tutun. Basit uçtan uca erişilebilirlik kontrolü için Grafana biraz ağır kalabilir; bu tür "site ayakta mı" izlemesi için daha hafif bir araç olan Uptime Kuma çoğu zaman daha pratiktir ve Grafana'yı asıl güçlü olduğu derin metrik analizi için saklamanızı sağlar.

Nginx ile Güvenli Yayın#

Grafana'yı 3000 portundan açık bir IP üzerinde çalıştırmak üretim için uygun değildir. Doğru yaklaşım, önüne Nginx gibi bir ters vekil (reverse proxy) koyup HTTPS ile yayınlamaktır. Bu hem şifreli trafik sağlar hem de Grafana'yı standart 443 portu arkasına gizler. Örnek bir Nginx yapılandırması şöyle görünür:

server {
    listen 443 ssl http2;
    server_name izleme.ornekfirma.com;

    ssl_certificate     /etc/letsencrypt/live/izleme.ornekfirma.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/izleme.ornekfirma.com/privkey.pem;

    location / {
        proxy_pass http://localhost:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;

        # Canlı panolar için WebSocket desteği
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

Bu yapının çalışması için önce alan adınızın Grafana sunucusuna işaret etmesi gerekir. DNS tarafında basit bir A kaydı yeterlidir:

izleme.ornekfirma.com.   300   IN   A   203.0.113.45

SSL sertifikasını Let's Encrypt ile ücretsiz alabilir, ya da kurumsal bir kurulumda ücretli SSL sertifikası tercih edebilirsiniz. Yayına açık bir izleme paneli aynı zamanda saldırganların da ilgisini çeker; bu yüzden bir WAF katmanı ve temel DDoS koruması düşünmek yerinde olur. Sunucu tarafı bakımını kendiniz üstlenmek istemiyorsanız, kurulum ve güncellemeleri bizim üstlendiğimiz sunucu yönetimi hizmetimiz bu yükü sizden alır.

Grafana'yı Ne Zaman Tercih Etmeli#

Grafana her sorunun cevabı değildir ve gücünü doğru bağlamda gösterir. Aşağıdaki tablo, Grafana'yı yakın alternatiflerle karşılaştırarak hangi işe hangi aracın daha uygun olduğunu özetler:

Kabaca bir kural şudur: sunucularınızın, uygulamalarınızın ve altyapınızın zaman içindeki davranışını canlı panolarda izlemek istiyorsanız Grafana idealdir. Buna karşılık amacınız iş birimlerine satış, ciro, kullanıcı davranışı gibi raporlar sunmaksa, SQL odaklı ve iş kullanıcısına daha dostane bir araç olan Metabase sizi daha az yorar. En sağlam kurulumlar genellikle bu araçları birlikte kullanır: teknik ekip Grafana ile altyapıyı izler, iş ekibi Metabase ile raporları okur, basit servis durumu ise Uptime Kuma'da anlık görülür. Bu araçların hepsini kendi altyapınızda barındırmak isterseniz, çeşitli açık kaynak uygulamaları tek tıkla kurabileceğiniz App Center ve teknik SEO tarafını iyileştirmek için SEO araçlarımız da işinizi kolaylaştırır.

Sıkça Sorulan Sorular#

Grafana ile Prometheus arasındaki fark nedir?#

İkisi farklı işler yapan tamamlayıcı araçlardır ve sık sık karıştırılır. Prometheus bir veri toplama ve saklama sistemidir; sunuculardan ve uygulamalardan metrikleri belirli aralıklarla çeker ve zaman serisi olarak diskte tutar. Grafana ise bu veriyi kendisi saklamaz, yalnızca Prometheus'a bağlanıp oradaki verileri sorgular ve görselleştirir. Yani Prometheus verinin deposu, Grafana ise vitrinidir. Genellikle ikisi birlikte kurulur ama Grafana MySQL, InfluxDB, Loki gibi başka kaynaklara da bağlanabildiği için tek başına Prometheus'a bağımlı değildir.

Grafana ücretsiz mi?#

Grafana'nın açık kaynak sürümü (Grafana OSS) tamamen ücretsizdir ve AGPL lisansıyla dağıtılır; bu rehberde anlattığımız tüm özellikler bu ücretsiz sürümde mevcuttur. Kendi sunucunuza kurup istediğiniz kadar pano ve kullanıcı oluşturabilirsiniz. Grafana Labs ayrıca gelişmiş kurumsal özellikler, raporlama ve destek içeren ücretli bir Enterprise sürümü ile bulut tabanlı Grafana Cloud hizmeti de sunar, ancak küçük ve orta ölçekli çoğu ihtiyaç için ücretsiz sürüm fazlasıyla yeterlidir.

Grafana kendi sunucuma mı yoksa bulutta mı kurulmalı?#

Bu tercih verinizin hassasiyetine ve ekibinizin kaynağına bağlıdır. Kendi sunucunuza kurduğunuzda tüm veri sizde kalır, tam kontrol sahibi olursunuz ve dışarıya aylık ücret ödemezsiniz; karşılığında kurulum, güncelleme ve yedekleme sorumluluğunu üstlenirsiniz. Yönetilen bulut çözümleri bu bakımı sizden alır ama verilerinizi üçüncü tarafa emanet etmenizi ve kullanım arttıkça artan bir fatura ödemenizi gerektirir. Kalıcı ve kaynakları size ait bir izleme yükü için kendi sanal sunucunuza kurmak çoğu zaman hem daha ekonomik hem de daha esnektir.

Grafana'da uyarılar neden gönderilmiyor?#

En sık karşılaşılan neden yapılandırma eksiğidir. Öncelikle iletişim noktanızın (contact point) doğru kurulduğundan ve e-posta gönderiyorsanız grafana.ini içindeki SMTP ayarlarının çalıştığından emin olun; arayüzdeki "Test" düğmesi burada çok işinize yarar. İkinci sık hata, bildirim politikasının uyarı kuralınızın etiketleriyle eşleşmemesidir; uyarı üretiliyor ama hiçbir politikaya takılmadığı için hiçbir yere gönderilmiyordur. Ayrıca kuralın gerçekten tetiklenip tetiklenmediğini Alerting bölümündeki durum ekranından kontrol edin; for süresi henüz dolmadıysa uyarı "pending" durumundadır ve henüz bildirim çıkmaz.

Grafana panolarını nasıl yedeklerim ve taşırım?#

Grafana panoları özünde JSON dosyalarıdır ve bu onları taşımayı kolaylaştırır. Bir panonun sağ üst köşesindeki paylaş menüsünden "Export" ile JSON çıktısını alabilir, başka bir Grafana örneğinde "Import" ile geri yükleyebilirsiniz. Daha sistemli bir yaklaşım için panoları ve veri kaynaklarını provisioning klasörlerinde YAML/JSON olarak sürüm kontrolünde tutmaktır; böylece tüm izleme yapılandırmanız kod hâline gelir ve sunucu değiştirdiğinizde birkaç dosyayla her şeyi yeniden ayağa kaldırırsınız. Grafana'nın kendi ayar ve kullanıcı verisi ise varsayılan SQLite veritabanında ya da bağladığınız harici veritabanında durur; düzenli yedek almanız gereken asıl yer burasıdır.

Kapanış#

Grafana, dağınık sayısal verilerinizi anlamlı ve canlı panolara dönüştürerek altyapınızın nabzını sürekli elinizde tutmanızı sağlar. Doğru kurulduğunda bir sorunu müşteriniz fark etmeden önce siz görür, uyarı kurallarıyla gece yarısı bile haberdar olur ve tek bir ekrandan onlarca sunucuyu izleyebilirsiniz. Bu rehberde ele aldığımız veri kaynağı bağlama, panel oluşturma, yetkilendirme ve uyarı adımları, sağlam bir gözlemlenebilirlik altyapısının temelini oluşturur.

Grafana gibi kalıcı bir izleme aracını çalıştırmak için kaynakları size ait, kararlı bir altyapı şarttır. İster ilk adımınızı atın ister mevcut kurulumunuzu büyütün, size uygun bir sanal sunucu veya yüksek performanslı VDS seçenekleriyle Grafana'nızı kendi kontrolünüzde barındırabilirsiniz. Kurulum ve bakımı bize bırakmak isterseniz sunucu yönetimi hizmetimizle ilgilenebilir, tüm sunucu ailemizi sunucu sayfamızdan inceleyebilirsiniz. Verilerinizi izlemeye başlayın; çünkü ölçemediğiniz şeyi yönetemezsiniz.