BT Sistem Yönetimi

Zabbix Grafana Bağlantısı: Eklenti, API Token, Salt Okuma

Zabbix Grafana bağlantısı: eklenti kurulumu, salt okuma Zabbix rolü, API token, Apache'de Authorization başlığı, data source ve ilk Zabbix paneli adım adım.

İlker Pehlivan

Zabbix ve Grafana, Grafana Labs’in Zabbix eklentisiyle bağlanır. Eklenti Grafana’ya bir Zabbix data source’u ekler ve bu data source ölçümü Zabbix API’den okur. Bağlantının güvenliği Grafana’da değil Zabbix’te kurulur. Zabbix’te yalnız okuma yetkisi olan, yalnız gösterilecek host gruplarını gören ve arayüze giremeyen bir Zabbix kullanıcısı açılır, Grafana o kullanıcının API token’ıyla bağlanır.

Grafana nedir yazısında Grafana’yı akşam haberlerindeki hava durumu bültenine benzetmiştik. Kanal ölçümü kendisi yapmaz, Meteoroloji Genel Müdürlüğü’nden (MGM) alır. MGM bunun için kanala bir abone hesabı açar. Hesap yalnız kanalın yayınlayacağı istasyonların verisini gösterir. Kanal veriyi okur ama istasyondaki ölçümü düzeltemez, MGM’nin uyarı defterine de not düşemez.

Zabbix Grafana benzetmesi: meteoroloji bürosunun gişesi, solda zeytin yeşili paltolu kanal kuryesi abone kartını elinde tutuyor, ortada tek parça ahşap tezgah, tezgahın sağında lacivert ceketli memur elini tezgahın üstüne koymuş, arkasında kapakları kapalı cam dolapta barometre, termometre ve rüzgar gülü, en sağda küçük masada kayışla bağlanıp asma kilitle kilitlenmiş defter
Kurye kartı alır, ölçümleri cam dolabın ardından görür ama dolabı açamaz, uyarı defteri de kilitlidir. Grafana'nın Zabbix'teki hesabı da böyle kurulur: yalnız okur, arayüze giremez, eylemlere kapalıdır.

Bu yazı o abone hesabını Zabbix 8.0’da açar ve Grafana 13.3’e bağlar. Sunucu, Grafana kurulumu yazısında Grafana’yı kurduğumuz Ubuntu 26.04 makinesidir. Zabbix 8.0 da aynı makinede çalışıyor. Zabbix kurulumu yazısındaki düzenle 7.0 olarak kuruldu ve Zabbix güncellemesi yazısındaki adımlarla 8.0’a yükseltildi. Temiz bir 8.0 kurulumunun farkı tek yerde çıkıyor, o da rol adımında yazılı.

Grafana’nın Zabbix kurulumundaki yerini Zabbix rehberi sıralar. Her adımı ölçtüm: Zabbix’in hazır User rolünün neden yetmediği, Apache arkasında token’ın neden Zabbix’e ulaşmadığı, Grafana’daki onay düğmesinin neyi durdurduğu ve Grafana’nın gerçekten yalnız izin verilen host’ları görüp görmediği aşağıda.

Zabbix Grafana Bağlantısı Nasıl Olmalı?

Bağlantıda verilecek kararlar az ama her birinin yanlışı sessizdir. Yanlış kurulmuş bir bağlantıda da Grafana veri gösterir, açık yalnız bir denetimde ya da bir kaza sonrasında görünür. Kararlar eklentinin yapılandırma belgesine ve Zabbix’in kullanıcı rolleri belgesine dayanıyor:

KararOlması gerekenNeden
Kimlik doğrulamaAPI tokenTek kullanıcıya bağlı, bitiş tarihi var, ayrıca kapatılabilir. Parola Grafana’ya verilmez.
Zabbix kullanıcısıGrafana’ya özel tek hesapKişinin hesabı kullanılırsa kişi ayrılınca bağlantı kopar, kayıtta kimin yaptığı karışır.
Arayüz erişimiKapalı (Frontend access Disabled)Token çalınsa bile Zabbix arayüzüne girmeye yaramaz.
RolAPI açık, bütün eylemleri kapalı özel rolHazır User rolü problem onaylama, yorum ve önem değiştirme yetkisi taşır.
Host gruplarıYalnız ekranda gösterilecek gruplar, ReadGrafana’da her kullanıcı data source’un gördüğü her şeyi sorgulayabilir.
URLZabbix sunucusunun adıyla, HTTPS (https://zabbix.ad.sistemkusu.com/zabbix/api_jsonrpc.php). Lab’daki gibi aynı sunucudaysa http://127.0.0.1/zabbix/api_jsonrpc.phpGrafana canlıda ayrı sunucuda durur. Token her istekte ağdan geçtiği için bağlantı şifrelenir.
Eklenti sürümüEn az 6.10.36.10.0 Zabbix 8.0’daki trend sorgusu hatasını giderdi. 6.10.3 onay ve script isteklerinde Grafana rolünü denetlemeye başladı.
Disable acknowledges for read-only usersAçıkViewer rolündeki kullanıcının onay isteği Grafana’da durur, Zabbix’e hiç gitmez.
Direct DB ConnectionBaşlangıçta kapalıHız gerekmedikçe Zabbix veritabanına ikinci bir okuyucu açılmaz. Açılırsa belge bağlantıyı yalnız Grafana’nın sunucusuna izin verecek biçimde kısıtlamayı önerir.

Son satırın gerekçesi de belgede: Direct DB Connection geçmiş veriyi API yerine doğrudan Zabbix veritabanından okur. Geniş zaman aralıklarında hızlıdır, ama Grafana’ya Zabbix veritabanında bir hesap açmayı gerektirir. Küçük ve orta kurulumda API yeterlidir.

Örnekteki MGM’de bu tablo abone hesabının sözleşmesidir. Hesap kanala özeldir, MGM’nin iç sistemine giremez, yalnız sözleşmedeki istasyonları gösterir ve uyarı defterine yazamaz.

Zabbix Tarafı: Okuma Grubu, Rol ve Kullanıcı

Zabbix’te üç kayıt açılır: host gruplarını tanımlayan bir kullanıcı grubu, eylemleri kapatan bir rol ve bu ikisini taşıyan kullanıcı. Sıra önemlidir, çünkü kullanıcı formu grubu ve rolü listeden seçer. Hepsi Zabbix arayüzünde Super admin yetkili bir hesapla yapılır.

Kullanıcı Grubu: Arayüz Kapalı, Yalnız Okuma

Users > User groups > Create user group ile yeni grup açılır. Grubun adını işlevini söyleyecek şekilde koyarız, lab’da Grafana okuma. Frontend access alanı Disabled seçilir. Bu gruptaki kullanıcı Zabbix’in web arayüzüne giriş yapamaz, ama API’yi kullanabilir.

Zabbix 8.0 Users, User groups formu: Group name alanında Grafana okuma ve Frontend access alanında Disabled değeri kırmızı çerçeveyle işaretli, Users alanında grafana-okuyucu kullanıcısı.
Grafana'ya ait grubun arayüz erişimi kapalı. Token çalınsa bile Zabbix arayüzüne girmeye yaramaz.

Aynı formun Host permissions sekmesinde, Grafana’da görünecek host grupları seçilir ve onlara Read verilir. Aynı izni alacak grupları tek satırda toplayıp bir kez Read seçmek yeter. Lab’da üç grup verildi:

  • Linux sunucular
  • Windows sunucular
  • Zabbix servers

Windows istemciler grubu bilerek dışarıda bırakıldı, çünkü kullanıcı bilgisayarları yönetim ekranında gösterilmeyecek. Doğrulama bölümünde bu grubun Grafana’da gerçekten görünmediğini ölçeceğiz.

Zabbix 8.0 User groups formunun Host permissions sekmesi: Linux sunucular, Windows sunucular ve Zabbix servers host grupları tek satırda ve o satırın seçili Read düğmesi kırmızı çerçeveyle işaretli.
Üç host grubu tek satırda, yalnız okuma yetkisiyle. Listede olmayan grup Grafana'da da yoktur.

Rol: User Rolünün Eylemleri Kapalı Kopyası

Zabbix 8.0’da dört hazır rol gelir: User, Admin, Super admin ve Guest. İlk akla gelen User rolüdür, çünkü en düşük yetkili tür odur. Ama “en düşük tür” ile “salt okuma” aynı şey değildir. User rolünün eylem yetkisini veritabanından okudum:

mon02PostgreSQL Çıktısı
 roleid |          name          | value_int 
--------+------------------------+-----------
      1 | actions.default_access |         1
      1 | api.access             |         1
      1 | api.mode               |         0
      4 | actions.default_access |         0
      4 | api.access             |         0
(5 rows)

roleid 1 User rolüdür. actions.default_access değerinin 1 olması, rol formundaki Access to actions kutularının hepsinin açık olduğu anlamına gelir: problem onaylama, yorum ekleme, önem değiştirme, problemi kapatma ve script çalıştırma. roleid 4 Guest rolüdür. Onun eylemleri kapalıdır ama API erişimi de kapalıdır (api.access 0), bu yüzden eklenti onunla çalışmaz.

Bu satırlar 7.0’dan yükseltilmiş bir sunucudan ve rol 7.0’daki ayarını korudu. 8.0’ın temiz kurulumunda ise User rolünde API erişimi kapalı gelir (kurulum yazısındaki rol ölçümü).

Kağıt üstündeki bu yetkinin gerçekte ne yaptığını ölçtüm. User rolündeki bir hesabın token’ıyla bir problemi onaylama isteği gönderdim (event.acknowledge, action: 2). Zabbix isteği kabul etti:

mon02Bash Çıktısı
{"jsonrpc":"2.0","result":{"eventids":[7]},"id":1}

Aynı hesap action: 4 ile probleme yorum da yazabildi. İsteğin curl biçimi aşağıdaki Doğrulama bölümünde.

Yani User rolüyle bağlanan bir Grafana hesabı, ekranda hiçbir düğme olmasa bile, token’ı ele geçiren herkese problem onaylatır ve yorum yazdırır. Onaylanan bir problem Zabbix’te “biri ilgileniyor” diye görünür ve alarm zinciri buna göre davranabilir. Onay action: 16 ile geri alınabilir, ama onay, geri alma ve yorum kayıtları olayın geçmişinde kalır.

Çözüm, User rolünü kopyalayıp eylemlerini kapatmaktır. Users > User roles listesinde User role açılır ve Clone ile kopyalanır. Kopyanın adı lab’da Grafana okuma rolu, User type User kalır.

Formun Access to API bölümünde Enabled kutusuna bakılır. 7.0’dan yükseltilen sunucuda kutu işaretli gelir. 8.0’ın temiz kurulumunda ise boş gelir ve işaretlenir.

API methods alanında Deny list seçili ve liste boş kalır. Boş Deny list hiçbir API yöntemini yasaklamaz. 8.0’da boş bir Allow list ise bütün API çağrılarını reddeder (güncelleme yazısındaki tablo). Hemen altında 8.0 ile gelen Devices bölümü durur, onun Enabled kutusu da boş kalır.

Zabbix 8.0 User roles formunda Grafana okuma rolu: Access to API altında Enabled kutusu işaretli ve API methods alanında boş Deny list kırmızı çerçeveyle işaretli, altındaki Devices bölümünün boş Enabled kutusu da ayrıca işaretli.
API açık ve boş Deny list hiçbir yöntemi yasaklamaz. Devices bölümü kapalı.

Access to actions altındaki bütün kutular ve en alttaki Default access to new actions kutusu kapatılır. 8.0’da bu bölümde on yedi kutu var, beşi User tipinde gri durur ve zaten seçilemez. Son kutu, Zabbix yükseltmesiyle gelecek yeni eylemlerin bu role kendiliğinden açılmasını engeller.

Zabbix 8.0 User roles formunun alt kısmı: Access to actions altındaki on yedi kutunun hepsi boş ve Default access to new actions kutusu boş, iki alan kırmızı çerçeveyle işaretli.
Eylemlerin hepsi kapalı. Yükseltmeyle gelecek yeni eylemler de kapalı gelir.

Aynı onay isteği bu rolü taşıyan grafana-okuyucu hesabının token’ıyla gönderilince reddedildi:

mon02Bash Çıktısı
{"jsonrpc":"2.0","error":{"code":-32602,"message":"Invalid params.","data":"Incorrect value for field \"action\": no permissions to acknowledge problems."},"id":1}

Yorum isteği de no permissions to add problem comments hatasıyla döndü. Örnekteki abone hesabı ilk haliyle MGM personelinin hazır hesabıydı: veriyi okuyor, uyarı defterine de yazabiliyordu. Kopyalanan rol aynı okuma hakkını taşır, defteri kapatır.

Kullanıcı ve API Token

Users > Users > Create user ile kullanıcı açılır. Formda üç değer girilir:

  1. Kullanıcı adı: grafana-okuyucu.
  2. Groups alanında Grafana okuma.
  3. Permissions sekmesinde Role olarak Grafana okuma rolu.

Kullanıcıya bir parola da girilir, çünkü form ister. Grup arayüz erişimini kapattığı için bu parolayla kimse arayüze giremez.

Token Users > API tokens > Create API token ile açılır. User alanında grafana-okuyucu seçilir. Description alanına token’ın nerede kullanıldığı yazılır. Set expiration date and time işaretlenir ve bir bitiş tarihi verilir, lab’da bir yıl. Bitiş tarihi olmayan token, kullanıcı silinene kadar geçerli kalır.

Zabbix 8.0 New API token penceresi: Name alanında grafana ve User alanında grafana-okuyucu, Set expiration date and time işaretli ve Expires at alanında 2027-11-14 15:35:00, bu iki alan grubu kırmızı çerçeveyle işaretli.
Token yalnız Grafana'ya ait kullanıcıya bağlı ve bir yıl sonra kendiliğinden geçersiz olur.

Add sonrası Zabbix token’ı bir kez gösterir. Bu pencere kapanınca token bir daha okunamaz, yalnız yenisi üretilir. Token’ı doğrudan Grafana’ya ya da parola kasasına kopyalarız, ekran görüntüsüne ve e-postaya koymayız.

Apache Arkasında Zabbix API Token: Authorization Başlığı

Grafana’ya geçmeden önce token’ın çalıştığını Grafana sunucusunun kendisinden deneriz. Zabbix 8.0 API’si token’ı yalnız Authorization: Bearer başlığında kabul eder. Deneme curl ile yapılır ve token komut satırına yazılmaz, çünkü komut satırı kabuk geçmişine düşer ve sunucudaki başka kullanıcılar çalışan süreçlerin argümanlarını görebilir. Başlık yalnız sizin okuyabileceğiniz bir dosyaya yazılır:

mon02Bash
umask 077; cat > /home/sistemkusu/zg/hdr-okuyucu

Komut girdi bekler. Tek satır yazılır, TOKEN yerine kendi token’ınız gelir, ardından Enter ve Ctrl+D:

Authorization: Bearer TOKEN

umask 077 dosyanın yalnız sahibine açık (600) oluşmasını sağlar. Dosya yolu kendi ev dizininize göre değişir. curl, -H @dosya biçimiyle başlığı dosyadan okur:

mon02Bash
curl -s -X POST http://127.0.0.1/zabbix/api_jsonrpc.php \
  -H 'Content-Type: application/json-rpc' \
  -H @/home/sistemkusu/zg/hdr-okuyucu \
  -d '{"jsonrpc":"2.0","method":"hostgroup.get","params":{"output":["groupid","name"]},"id":1}'

Zabbix’in Apache ve PHP-FPM ile kurulu olduğu sunucuda bu istek doğru token’la reddedildi:

mon02Bash Çıktısı
{"jsonrpc":"2.0","error":{"code":-32602,"message":"Invalid params.","data":"Not authorized."},"id":1}

Token doğruydu, başlık Zabbix’e ulaşmıyordu. Zabbix bunu bilinen sorunlar sayfasında anlatır. Apache bazı kurulumlarda Authorization başlığını PHP’ye iletmez. Ubuntu paketlerinden kurulan Zabbix’te PHP, Apache’nin proxy_fcgi modülüyle PHP-FPM’e gider ve bu yol başlığı düşürür.

Token’ı gövdedeki eski auth alanıyla göndermek 7.0’da bir geçiş yoluydu. 8.0 bu alanı artık kabul etmez ve isteği Invalid parameter "/": unexpected parameter "auth". hatasıyla reddeder. Eklenti de token’ı başlıkta gönderir. Çözüm, Apache’ye başlığı iletmesini söylemektir. Başlığı iletmek için ayrı bir yapılandırma dosyası açarız, Zabbix paketinin kendi dosyasına dokunmayız, böylece paket güncellemesi ayarı ezmez:

mon02Bash
sudo nano /etc/apache2/conf-available/zabbix-authorization.conf
Apache
# Zabbix API Bearer (Authorization) basligini PHP-FPM'e iletir.
<Directory "/usr/share/zabbix">
    CGIPassAuth On
</Directory>

Dosya etkinleştirilir, yapılandırma denetlenir ve Apache yeniden yüklenir:

mon02Bash
$ sudo a2enconf zabbix-authorization
Enabling conf zabbix-authorization.
To activate the new configuration, you need to run:
  systemctl reload apache2
$ sudo apache2ctl configtest
Syntax OK
$ sudo systemctl reload apache2

CGIPassAuth On, Apache’nin Authorization başlığını dizindeki betiklere, burada Zabbix’in PHP dosyalarına iletmesini sağlar. Aynı curl isteği bundan sonra yalnız hesaba verilen üç grubu döndürdü:

mon02Bash Çıktısı
{"jsonrpc":"2.0","result":[{"groupid":"22","name":"Linux sunucular"},{"groupid":"23","name":"Windows sunucular"},{"groupid":"4","name":"Zabbix servers"}],"id":1}

Hesabın grubunda arayüz erişimi Disabled olduğu halde token çalışıyor. Arayüzü kapatmak API’yi kapatmaz.

Örnekteki MGM binasında bu adım kapı görevlisine verilen talimattır. Görevli kanalın abone kartını içeri iletmezse, hesap doğru olsa bile veri masasına kimse gelmez.

Grafana Zabbix Eklentisi Kurulumu

Eklenti, Grafana sunucusunda grafana cli ile kurulur. Komut /usr/share/grafana dizininden ve grafana kullanıcısıyla çalıştırılır, böylece eklenti dosyaları servisin okuyabileceği sahiplikle yazılır:

mon02Bash
cd /usr/share/grafana
sudo -u grafana grafana cli plugins install alexanderzobnin-zabbix-app
mon02Bash Çıktısı
✔ Downloaded and extracted alexanderzobnin-zabbix-app v6.10.3 zip successfully to /var/lib/grafana/plugins/alexanderzobnin-zabbix-app

Please restart Grafana after installing or removing plugins. Refer to Grafana documentation for instructions if necessary.

Komutu ev dizininizden çalıştırırsanız grafana kullanıcısı o dizini okuyamaz ve komut panic: error getting work directory: stat .: permission denied satırıyla çöker. Dizini değiştirmenin nedeni budur. Kurulumun ardından Grafana yeniden başlatılır:

mon02Bash
sudo systemctl restart grafana-server

Zabbix 8.0’a bağlanacak eklenti en az 6.10.0 sürümünde olmalıdır. Eklentinin sürüm notlarına göre daha eski sürümlerin trend sorgusu 8.0’da unexpected parameter "sortfield" hatasıyla düşer. 6.10.3 ise onay ve script isteklerinde Grafana rolünü denetlemeye başladı, bu yüzden en son sürüm kurulur.

Zabbix eklentisi bir “app plugin”dir: data source, panel ve dashboard’ları bir paket olarak getirir. Eklenti belgesine göre kurmak yetmez, eklenti ayrıca etkinleştirilir. Etkinleştirmeden önce data source listesinde Zabbix aratıldığında hiçbir sonuç çıkmadı. Etkinleştirmek için Grafana’da Administration > Plugins and data > Plugins sayfasında Zabbix açılır ve Enable düğmesine basılır. Düğme Disable’a döner. Eklenti sonradan kaldırılıp tekrar kurulursa etkin durumu korunur, Enable düğmesine yeniden basmak gerekmez.

Grafana Administration, Plugins and data, Plugins altında Zabbix eklenti sayfası: sağ üstte Uninstall ve Disable düğmeleri ile sağ panelde Installed Version 6.10.3 kırmızı çerçeveyle işaretli.
Etkinleştirildikten sonra eklenti sayfası. Enable düğmesinin yerini Disable aldıysa data source eklenebilir.

Zabbix Data Source Ekleme ve Save & Test

Connections > Data sources > Add new data source listesinde artık Zabbix görünür. Formda doldurulacak alanlar azdır:

  1. URL: Zabbix API’nin tam adresi, sonunda api_jsonrpc.php ile. Grafana ayrı sunucudaysa Zabbix sunucusunun adı HTTPS ile yazılır (https://zabbix.ad.sistemkusu.com/zabbix/api_jsonrpc.php). Lab’daki gibi aynı sunucudaysa http://127.0.0.1/zabbix/api_jsonrpc.php.
  2. Authentication method: No Authentication kalır. Bu alan Zabbix girişi değil, Zabbix’in önünde ayrıca HTTP kimlik doğrulaması varsa onun içindir.
  3. Zabbix Connection > Auth type: API token, altındaki API Token alanına token yapıştırılır.
Grafana Zabbix data source ayarları: Connection altındaki URL alanında http://127.0.0.1/zabbix/api_jsonrpc.php ile Zabbix Connection altındaki Auth type alanında API token ve API Token alanında configured değeri kırmızı çerçeveyle işaretli.
Adres Zabbix API'nin kendisi, kimlik ise HTTP başlığı değil Zabbix token'ı.

Kayıttan sonra token alanı yalnız configured gösterir ve Reset düğmesi çıkar. Grafana token’ı şifreli saklar ve bir daha göstermez.

Formun altındaki Additional settings bölümünde fabrika ayarında Enable Trends açıktır. Bu ayar 7 günden eski veriyi Zabbix’in saatlik özet tablosundan (trends) okur. Bu değeri Zabbix’teki history saklama süresiyle aynı tutarız.

Aynı bölümün Other başlığı altındaki Disable acknowledges for read-only users seçeneği açılır. Fabrika ayarında kapalıdır. Ne durdurduğu bir sonraki alt bölümde.

Save & test bağlantıyı dener. Başarılı sonuç Zabbix’in sürümünü yazar:

Grafana Zabbix data source sayfasının altı: Other başlığı altında açık Disable acknowledges for read-only users seçeneği ve Zabbix API version 8.0.0 başarı mesajı kırmızı çerçeveyle işaretli.
Save & test sonucu Zabbix'in API sürümünü gösterir. Onay seçeneği açık.

Onay Düğmesi: Grafana Seçeneği ve Zabbix Rolü

Grafana’nın Problems paneli bir problem satırı açıldığında iki düğme gösterir: Acknowledge problem ve Execute script. Bu düğmelerin gönderdiği istek Zabbix’e data source hesabının token’ıyla gider, düğmeye basan Grafana kullanıcısının kimliğiyle değil. Bu yüzden Grafana tarafındaki seçenek ile Zabbix rolü iki ayrı kilittir. Eklenti 6.10.3’te ikisinin ne yaptığını Viewer rolündeki bir Grafana kullanıcısıyla ölçtüm.

Seçenek kapalıyken Viewer iki düğmeyi de gördü. Acknowledge problem onay penceresini açtı ve yazılan yorum gönderildi. İsteği Grafana durdurmadı, Zabbix’e gitti ve orada data source hesabının rolüne takıldı:

Grafana Problems panelinde Viewer kullanıcısının açtığı Acknowledge Problem penceresi: yorum kutusu ve altında Zabbix'ten dönen 'no permissions to add problem comments' hatası kırmızı çerçeveyle işaretli.
Seçenek kapalıyken Viewer'ın yorumu Zabbix'e kadar gitti. Engeli Zabbix rolü koydu.

Seçenek açılınca Viewer’ın satırında yalnız Explore düğmesi kaldı. Onay ve script düğmeleri hiç çizilmedi:

Grafana Problems panelinde aynı problem satırı iki kez: solda seçenek kapalıyken Explore'un yanında Execute script ve Acknowledge problem düğmeleri, sağda seçenek açıkken aynı yerde yalnız soluk simgeler, iki alan kırmızı çerçeveyle işaretli.
Solda seçenek kapalı, sağda açık. Açıkken Viewer onay ve script düğmelerini görmez.

Düğmeyi gizlemek tek başına yetmezdi, çünkü Viewer aynı isteği tarayıcıdan doğrudan Grafana’nın data source ucuna gönderebilir. Bu yüzden doğrudan istekleri de ölçtüm. Seçenek açıkken Viewer’ın event.acknowledge isteğine Grafana 403 ve insufficient permissions: this action requires a higher role cevabını verdi. İstek Zabbix’e hiç gitmedi. Seçenek kapalıyken aynı istek Zabbix’e ulaştı ve rolden dönen hatayı aldı. script.execute iki durumda da Grafana’da 403 ile durdu.

Eklentinin sürüm notu kuralı şöyle koyar: script.execute Grafana’da Admin rolü ister, event.acknowledge ise seçenek açıkken Editor ya da Admin ister. 6.10.3’ten önceki sürümler bu istekleri kullanıcının rolüne bakmadan data source hesabıyla Zabbix’e iletiyordu. Yani seçenek Viewer’ı durdurur, Editor ve Admin’in isteğini ise yine Zabbix’e bırakır. Sınırı herkes için çizen tek yer Zabbix rolüdür.

Doğrulama: Grafana Yalnız İzin Verilen Host’ları Görüyor mu?

Save & test yalnız bağlantının açıldığını söyler. Hesabın sınırını Grafana’nın içinden ölçmek gerekir, çünkü Grafana’da Viewer rolündeki bir kullanıcı bile data source’a dashboard’daki sorgularla sınırlı olmadan sorgu gönderebilir. Grafana’da kimin neyi göremeyeceğini bu yüzden Zabbix hesabı belirler.

Ölçüm için bir panelin sorgu düzenleyicisinde Group listesini açtım. Listede hesaba verilen üç grup çıktı. Zabbix’te var olan Windows istemciler grubu listede yoktu:

Grafana panel düzenleyicisinde Zabbix sorgusunun Group açılır listesi: /.*/, Linux sunucular, Windows sunucular ve Zabbix servers seçenekleri kırmızı çerçeveyle işaretli, Windows istemciler grubu listede yok.
Grafana yalnız hesaba okuma izni verilen üç host grubunu listeliyor. Windows istemciler grubu Zabbix'te var, burada yok.

Host listesi de aynı sınırı gösterdi. Listede lnx02, SRV01 ve Zabbix server vardı. Windows istemciler grubundaki muhasebe bilgisayarı ANKMUH01 listede yoktu. API’nin kendisi de aynı sonucu verdi. user.get isteği yalnız hesabın kendi kaydını döndürdü, yani hesap Zabbix’teki öteki kullanıcıları da göremiyor:

mon02Bash
$ curl -s -X POST http://127.0.0.1/zabbix/api_jsonrpc.php -H 'Content-Type: application/json-rpc' -H @/home/sistemkusu/zg/hdr-okuyucu -d '{"jsonrpc":"2.0","method":"host.get","params":{"output":["hostid","host"]},"id":1}'
{"jsonrpc":"2.0","result":[{"hostid":"10084","host":"Zabbix server"},{"hostid":"10683","host":"lnx02"},{"hostid":"10684","host":"SRV01"}],"id":1}
$ curl -s -X POST http://127.0.0.1/zabbix/api_jsonrpc.php -H 'Content-Type: application/json-rpc' -H @/home/sistemkusu/zg/hdr-okuyucu -d '{"jsonrpc":"2.0","method":"user.get","params":{"output":["username"]},"id":1}'
{"jsonrpc":"2.0","result":[{"username":"grafana-okuyucu"}],"id":1}

Rolün eylemleri kapattığını da aynı başlık dosyasıyla sınarız. eventids yerine Zabbix’te var olan bir olayın numarası yazılır. Beklenen cevap, rol bölümündeki no permissions to acknowledge problems hatasıdır:

mon02Bash
curl -s -X POST http://127.0.0.1/zabbix/api_jsonrpc.php \
  -H 'Content-Type: application/json-rpc' \
  -H @/home/sistemkusu/zg/hdr-okuyucu \
  -d '{"jsonrpc":"2.0","method":"event.acknowledge","params":{"eventids":"7","action":2},"id":1}'

Denemeler bitince başlık dosyası silinir:

mon02Bash
shred -u /home/sistemkusu/zg/hdr-okuyucu

Bir denetimde sorulacak üç soru buradan çıkar ve üçünün cevabı da ölçülebilir:

  1. Grafana’nın gördüğü host grupları, ekranda gösterilmesi kararlaştırılan gruplarla aynı mı?
  2. Data source hesabıyla event.acknowledge reddediliyor mu ve data source’ta Disable acknowledges for read-only users açık mı?
  3. Hesabın Zabbix arayüzüne girişi kapalı mı ve token’ın bitiş tarihi takvimde mi?

Zabbix Verisiyle İlk Panel

Bağlantı kurulduktan sonra ilk iş bir panelde Zabbix verisini görmektir. Grafana’da Dashboards > New > New dashboard açılır ve panel Configure visualization düğmesiyle eklenir. Zabbix varsayılan data source ise panel düzenleyicisi onu seçili getirir.

Sorgu düzenleyicisi Zabbix’in yapısını izler: Query type Metrics iken sırayla Group, Host ve Item seçilir. Her alan bir regex de kabul eder, /.*/ hepsi anlamına gelir.

Grafana panel düzenleyicisinde CPU utilization paneli: üstte son bir saatin CPU grafiği, altta Data source alanında Zabbix ile sorgunun Group alanında Zabbix servers, Host alanında Zabbix server ve Item alanında CPU utilization değerleri kırmızı çerçeveyle işaretli.
Zabbix sorgusu üç seçimdir: grup, host, item.

Lab’daki panel Zabbix server host’unun CPU utilization item’ını gösteriyor. Grafiğin noktaları, Zabbix’in her dakika topladığı değerlerdir. Grafana bunları kendi veritabanında tutmaz, panel her yenilendiğinde Zabbix API’den yeniden ister. Host alanına sabit bir ad yerine bir dashboard değişkeni ($host) yazmak, aynı paneli dashboard’un üstündeki seçiciyle her sunucu için kullanmayı sağlar. Değişkenler, panel türleri ve iyi bir dashboard düzeni Grafana dashboard oluşturma yazısının konusu.

Zabbix Grafana Bağlantısında Sık Hatalar

BelirtiNedenÇözüm
Save & test Not authorized diyor, token doğruApache Authorization başlığını PHP-FPM’e iletmiyorCGIPassAuth On dosyası, a2enconf, reload
Gövdede auth alanıyla gönderilen istek unexpected parameter "auth" diyorZabbix 8.0 token’ı yalnız başlıkta kabul ediyorAuthorization: Bearer başlığı
Data source listesinde Zabbix yokEklenti kuruldu ama etkinleştirilmediPlugins sayfasında Enable
grafana cli permission denied ile çöküyorKomut ev dizininden grafana kullanıcısıyla çalıştıÖnce cd /usr/share/grafana
Eklenti kuruldu ama Grafana görmüyorServis yeniden başlatılmadısystemctl restart grafana-server
7 günden uzun aralıkta unexpected parameter "sortfield"Eklenti 6.10.0’dan eski, Zabbix 8.0Eklentiyi en son sürüme yükselt
Grafana’da bir host grubu görünmüyorGrup data source hesabının kullanıcı grubuna verilmediHost permissions sekmesine grubu Read ile ekle
Grafana’dan problem onaylanabiliyorHesap hazır User rolündeEylemleri kapalı özel rol ata
Bağlantı bir gün kendiliğinden kesildiToken’ın süresi dolduYeni token üret, data source’ta Reset ile değiştir

Sonuç: Zabbix Grafana Bağlantısının Güvenliği Zabbix Hesabındadır

Zabbix’i Grafana’ya bağlamak beş dakikalık bir iştir: eklenti, etkinleştirme, adres ve token. Bağlantıyı doğru yapan, o token’ın arkasındaki hesaptır. Hazır User rolü okuma için yeterli görünür ama problem onaylar. Apache arkasında token Zabbix’e hiç ulaşmayabilir. Grafana’nın onay seçeneği yalnız Viewer’ı durdurur, Editor ve Admin’in isteği Zabbix’e gider. Lab’da bu üçünün üçü de hata vermeden çalışan bir kurulumun içinde duruyordu.

Girişteki benzetmeye dönersek: abone hesabı kanala özeldir ve bu, Grafana’ya özel grafana-okuyucu kullanıcısıdır. Hesabın MGM’nin iç sistemine girememesi Disabled arayüz erişimidir. Yalnız sözleşmedeki istasyonları göstermesi Read yetkili üç host grubudur. Uyarı defterine yazamaması da eylemleri kapalı roldür. Kapı görevlisinin kartı içeri iletmesi ise CGIPassAuth On satırıdır.

Zabbix ve Grafana Bağlantısı Hakkında Sık Sorulan Sorular

Data source'u bağladığınız Zabbix hesabının yetkisi kadar değiştirebilir. Zabbix'in hazır User rolündeki bir hesap lab'da API üzerinden bir problemi onayladı ve probleme yorum yazdı. Bütün eylem kutuları kapalı özel bir rol atanınca aynı istekler no permissions hatasıyla reddedildi. Grafana tarafında eklentinin Disable acknowledges for read-only users seçeneği 6.10.3 sürümünden beri Viewer rolündeki kullanıcının onay isteğini Grafana'da durdurur. Editor ve Admin'in isteği yine Zabbix'e gider, o yüzden asıl sınırı Zabbix rolü çizer.
Hayır. Eklentiyi Grafana Labs yayımlar, Grafana OSS ile birlikte ücretsiz kullanılır. Lab'da Grafana 13.3.1 üzerinde 6.10.3 sürümü çalışıyor. Eklenti sayfasına göre bu sürüm Grafana 11.6 ya da üstünü ister. Zabbix 8.0 ile en az 6.10.0 gerekir, çünkü eski sürümlerin trend sorgusu 8.0'da hata verir. Zabbix tarafında da lisans yoktur, gereken tek şey API erişimi olan bir kullanıcı ve onun token'ıdır.
API token. Token tek bir kullanıcıya bağlıdır, bitiş tarihi taşır, Zabbix'in API tokens listesinden kapatılabilir ve hesabın parolasını Grafana'ya vermeden çalışır. Kullanıcı adı ve parola da çalışır, ama parola değişince bağlantı kopar ve aynı parola Zabbix arayüzüne de girmeye yarar. Lab'da token bir yıl geçerli açıldı, bitiş tarihi takvime yazılır.
Hayır. Görmemesi daha doğrudur. Grafana yalnız data source hesabının Zabbix'te okuma yetkisi olduğu host gruplarını görür. Lab'da Windows istemciler grubu hesaba verilmedi ve Grafana'nın grup listesinde hiç çıkmadı. Ekranda gösterilmeyecek grupları hesaba vermemek, Grafana'ya giren birinin yanlışlıkla ya da bilerek o host'ları sorgulamasını engeller.
İlker Pehlivan
Yazan

BT Danışmanı | Ağ, Sistem ve Güvenlik Yönetimi

İlker Pehlivan, karmaşık BT altyapılarını ölçeklenebilir ve güvenli sistemlere dönüştürür. Buradaki rehberleri kendi laboratuvarında kurup ölçerek yazar.

LinkedIn

Benzer Makaleler

Grafana Rehberi: Kurulumdan Dashboard'a Adım Adım

Grafana rehberi: kurulumdan Zabbix bağlantısına, dashboard'dan yedeğe altı adımlık sıra. Her adım hangi kurumda gerekir, lab'da hangi yazıda ölçüldü.

14 dk okuma

Network İzleme Hizmeti: Sunucu, Hat ve Ağ Cihazları

Network izleme hizmeti: sunucu, internet hattı, switch ve firewall dakika dakika izlenir, alarm geldiğinde aynı ekip müdahale eder. Kapsam, süreç ve fiyat.

9 dk okuma

Grafana Alert: SQL Sorgusuna E-posta Alarmı ve Silence

Grafana alert kurulumu: SMTP, salt okunur MySQL data source, eşik ve pending period, DatasourceError ve silence, lab'da saatle ölçülen bildirimlerle.

18 dk okuma

Grafana Upgrade: Yedek, 12'den 13'e Geçiş ve Geri Dönüş

Grafana güncellemesi adım adım: grafana.ini, eklenti ve PostgreSQL yedeği, geri yükleme provası, önce eklentiler, 12.4'ten 13.3'e geçiş ve doğru geri dönüş.

14 dk okuma

Grafana Dashboard Oluşturma: Panel, Değişken ve USE

Grafana dashboard oluşturma: USE yöntemiyle panel seçimi, Zabbix verisiyle değişkenler, tekrarlayan panel, yenileme yükü ve Viewer sınırı, lab ölçümüyle.

19 dk okuma

Grafana Kurulumu: Ubuntu 26.04'te PostgreSQL ve Apache

Ubuntu 26.04'e Grafana kurulumu: APT deposu, PostgreSQL veritabanı, Apache arkasında /grafana, admin hesabını kapatmak ve sıkılaştırma adım adım.

17 dk okuma