BT Danışmanlık

GLPI Zabbix Entegrasyonu: Alarmdan Destek Kaydı Açmak

GLPI Zabbix entegrasyonu: Zabbix'in hazır GLPI webhook'u, OAuth istemcisi, dar yetkili kullanıcı, severity eşlemesi ve e-posta yoluyla farkı, lab ölçümüyle.

İlker Pehlivan

GLPI Zabbix entegrasyonu, Zabbix’te açılan bir problemin GLPI’da kendiliğinden destek kaydına dönüşmesidir. Zabbix 7.0, GLPI için hazır bir webhook ile gelir. Webhook, bir olay olduğunda başka bir uygulamanın adresine istek gönderen bağlantıdır. Zabbix’in GLPI webhook’u problem açılınca kayıt açar, problem güncellenince kayda takip ekler, problem kapanınca kaydı Çözülmüş durumuna alır. İkinci yol e-postadır. Zabbix alarmı e-postayla gönderir, GLPI’nın e-posta alıcısı iletiden kayıt açar.

Yazı, GLPI rehberimizin 12. adımıdır. Ölçümler iki lab sunucusunda alındı: Zabbix kurulumu yazısındaki gibi kurulan Zabbix 7.0.32 (mon02) ve GLPI kurulumu yazısındaki GLPI 12.0.1 (itsm01). Kuruluma doğrudan geçmek için ön koşullardan başlayabilirsiniz.

GLPI nedir yazımızda GLPI’yı bir tapu ve kadastro dairesine, GLPI mail to ticket yazısında e-posta alıcısını o dairenin gelen evrak masasına benzettik. Zabbix bu daireye yazı gönderen başka bir kurumdur ve yazısını iki yolla ulaştırır. Birincisi postadır: her yazı ayrı bir zarfla masaya düşer. Zarfın üstünde dosya numarası olmadığı için masa her zarfa yeni bir dosya açar, “sorun giderildi” yazısına da.

İkincisi kurumun kendi görevlisidir. Görevli daireye yetki kartıyla girer, dosyayı kendisi açar ve dairenin verdiği dosya numarasını kendi defterine yazar. Sonraki her yazıyı o dosyaya ekler.

GLPI Zabbix entegrasyonu benzetmesi: tapu ve kadastro dairesinin tonozlu ön salonu, solda sokak kapısının yanında her birinin kapağına bir zarf iliştirilmiş yeni dosyaların durduğu yan masa ve mektup yarığının altında zarflarla dolu hasır sepet, ortada boş taş zemin, sağda göğsünde kordonlu yetki kartı taşıyan mavi paltolu görevli bankoda kendi cep defterine not alıyor, bankonun arkasında onu izleyen daire memuru
Soldaki yol e-postadır: yarıktan düşen her zarf, "sorun giderildi" yazısı da, yeni bir dosya açar. Sağdaki yol webhook'tur: Zabbix'in görevlisi yetki kartıyla, yani GLPI API istemcisiyle girer, dosya numarasını kendi defterine yazar ve sonraki her yazıyı aynı kayda ekler.

GLPI Zabbix Entegrasyonu Nasıl Olmalı?

Doğru kurulmuş bir entegrasyonun beş özelliği vardır:

  1. Yalnız müdahale isteyen alarm kayıt açar. Kayda dönüşecek alarm, bir insanın bir şey yapması gereken alarmdır. Zabbix’te bunlar severity değeri High ve Disaster olan problemlerdir. Average ve altı panoda kalır. Zabbix rehberimizde ölçtüğümüz bir günde açılan 70 problemin 66’sı High’ın altındaydı.
  2. Bir problem bir kayıttır. Problemin güncellemesi ve kapanışı aynı kayda yazılır, yeni kayıt açmaz. Teknisyen problemin bütün geçmişini tek kayıtta görür.
  3. Zabbix GLPI’ya kendi kullanıcısıyla ve dar bir yetkiyle bağlanır. Kullanıcı yalnız kayıt açabilir, güncelleyebilir ve takip ekleyebilir. Bir yöneticinin hesabı ya da Super-Admin profili kullanılmaz.
  4. Bağlantı HTTPS’tir ve sertifika doğrulanır. Webhook GLPI’ya kullanıcının parolasını ve erişim anahtarını gönderir. Sertifikası doğrulanmayan bağlantıda bu bilgiler araya giren birine açık kalır.
  5. Düşen alarm görülür. Webhook başarısız bir isteği yeniden denemez. Kayda dönüşemeyen alarm Zabbix’te izlenir, kaydı elle açılır.

Bu düzene dayanak olan üç kaynak:

  1. Zabbix’in GLPI webhook belgesi (github.com/zabbix): Zabbix’teki severity, GLPI’daki önem derecesine (urgency) çevrilir. Güncelleme kayda takip olarak eklenir, kapanan problemin kaydı Çözülmüş olur. Yeniden deneme sayısı fabrika ayarında 1’dir ve belge bunun değiştirilmemesini öneriyor: tekrar denemede mükerrer kayıt ve takip açılabilir. GLPI tarafında Zabbix’in kullanıcısına yalnız kayıt ve takip hakları verilir.
  2. Aynı belgenin parametre tablosu: tls_verify parametresi sertifika doğrulamasını yönetir. Değeri none olursa doğrulama tamamen kapanır.
  3. GLPI 12.0.1’in kendi uyarısı: eski REST API açılırken GLPI bir onay penceresi gösterir ve olabildiğinde yalnız yeni API’nin kullanılmasını önerir. Zabbix’in belgesi de eski API’yi yeni entegrasyonlar için önermiyor.

Webhook mu, E-posta mı?

İki yol lab’da aynı türden bir High problemiyle yan yana denendi:

WebhookE-posta
Problem açılıncaBir kayıtBir kayıt
Problem güncelleninceAynı kayda takipLab’da denenmedi
Problem kapanıncaAynı kayıt Çözülmüş olurAyrı, yeni bir kayıt açılır
GLPI’da önem derecesiZabbix’teki severity’denHer zaman Orta
İstek kaynağıHelpdeskE-Mail
İstekte bulunanBoşGLPI’daki zabbix kullanıcısı
Kaydın açılmasıBirkaç saniyemailgate’in sonraki turu, en çok on dakika
Zabbix’teki problemde GLPI bağlantısıVarYok

Önerilen yol webhook’tur. E-posta yolunda problem ve kapanışı iki ayrı kayıttır ve ikisi de Yeni durumunda kalır: teknisyen her problem için iki kaydı elle eşleştirip kapatır. E-posta yolu, Zabbix sunucusu GLPI’ya HTTPS ile ulaşamıyorsa ya da kurum GLPI’nın API’sini açmak istemiyorsa düşünülür. Yazının ana akışı webhook’tur, e-posta yolu sonda kendi bölümünde.

Ön Koşul: Ad, Sertifika ve İki Kullanıcı

Bu yazı iki sunucunun da kurulu olduğunu ve GLPI’nın kendi adıyla HTTPS üzerinden açıldığını varsayar. GLPI tarafının kurulumu GLPI HTTPS yazısındadır. Webhook GLPI’ya bu adresten bağlanır.

Ad. Zabbix sunucusu GLPI’nın adını çözebilmelidir. Kurumda bu ad DNS’ten çözülür. Lab’daki Zabbix sunucusu etki alanının DNS sunucusunu kullanmadığı için ad /etc/hosts dosyasına yazıldı.

Sertifika. GLPI’nın sertifikası iç sertifika otoritesinden alındıysa Zabbix sunucusu o otoritenin kök sertifikasını tanımalıdır. Lab’da kök sertifika eklenmeden önce açılan ilk alarm GLPI’ya ulaşmadı. Zabbix’in yazdığı hata:

mon02Çıktı
Sending failed: Error: cannot get URL: SSL certificate OpenSSL verify result: unable to get local issuer certificate (20).

Kök sertifika Ubuntu’nun sertifika deposuna eklenir. Kopyalanan dosya, GLPI HTTPS yazısında GLPI sunucusunun deposuna eklenen kök sertifikanın kendisidir:

mon02Bashroot
sudo cp sistemkusu-lab-root-ca.crt /usr/local/share/ca-certificates/
sudo update-ca-certificates
mon02Bash Çıktısı
Updating certificates in /etc/ssl/certs...
rehash: warning: skipping ca-certificates.crt, it does not contain exactly one certificate or CRL
1 added, 0 removed; done.
Running hooks in /etc/ca-certificates/update.d...
done.

1 added satırı kök sertifikanın depoya girdiğini gösterir. rehash uyarısı işlemi durdurmadı: hemen ardından Zabbix sunucusundan GLPI’ya yapılan istek sertifikayı doğruladı. Zabbix sunucusunu yeniden başlatmak gerekmedi. Kök sertifika eklendikten sonra hem media type’ın Test düğmesi hem gerçek bir alarm GLPI’ya ulaştı, zabbix-server servisi bu arada hiç yeniden başlamadı. Yani kök sertifika çalışan Zabbix’e bakım saati beklemeden eklenir.

İki kullanıcı. GLPI’da Zabbix’in bağlanacağı bir kullanıcı, Zabbix’te bildirimi alacak bir kullanıcı açılır. İkisi de bir kişiye ait değildir. İkisi de yalnız bu iş için kullanılır, böylece birinin hesabı kapandığı gün alarmlar durmaz.

GLPI Tarafı: API, OAuth İstemcisi ve Kullanıcı

GLPI tarafında dört iş vardır: API’yi açmak, Zabbix için bir OAuth istemcisi tanımlamak, Zabbix’e özel bir profil açmak ve o profili taşıyan bir kullanıcı açmak.

API. Menü yolu: Yapılandırma → Genel → API sekmesi. Fabrika ayarında sekmedeki iki anahtar da kapalıdır. Yalnız API kullanılsın açılır:

GLPI 12.0.1 Yapılandırma > Genel > API sekmesi: açık 'API kullanılsın' anahtarı, API adresi alanı ve kapalı 'Eski REST API kullanılsın' anahtarı işaretli.
Yeni API açık, eski REST API kapalı. Sayfa API adresini v3.0 olarak gösteriyor.

Sayfanın gösterdiği adres /api.php/v3.0 ile biter. Zabbix’in webhook’u ise /api.php/v2.2 adresini çağırır. Lab’daki GLPI 12.0.1 bu adrese de yanıt verdi ve webhook çalıştı. GLPI’nın ileriki bir sürümünde eski numaranın kalkıp kalkmayacağı bugünden bilinmez. Bu yüzden GLPI her yükseltildiğinde webhook bir deneme alarmıyla yeniden sınanır.

Eski REST API kapalı kalır. Webhook onu da kullanabilir ve lab’da GLPI 12.0.1’de onunla da kayıt açtı. Ama GLPI eski API’yi açarken bir onay penceresi gösterir ve olabildiğinde yalnız yeni API’nin kullanılmasını önerir.

OAuth istemcisi. OAuth istemcisi, GLPI’nın API’sine bağlanacak uygulamanın GLPI’daki kaydıdır. GLPI istemciye bir kimlik ve bir parola üretir. Zabbix bu ikisiyle birlikte kullanıcının adını ve parolasını vererek GLPI’dan süreli bir erişim anahtarı (token) alır, kaydı o anahtarla açar. Lab’daki GLPI’nın web sunucusu log’una göre webhook her bildirimde önce yeni bir anahtar istiyor. Menü yolu: Yapılandırma → OAuth istemcileri → Ekle:

GLPI OAuth istemcisi formu: Ad zabbix, İzinler Parola ve Kapsamlar api alanları işaretli.
Zabbix için OAuth istemcisi: izin türü Parola, kapsam yalnız api.
AlanDeğerNeden
Adzabbixİstemcinin hangi uygulamaya ait olduğu
İzinlerParolaFabrika değeri Doğrulama kodu kaldırılır. Webhook anahtarı kullanıcı adı ve parolayla alır
Kapsamlarapiİstemci yalnız API’ye erişir, öteki kapsamlar seçilmez

Kayıttan sonra form İstemci kimliği ve İstemci parolası alanlarını gösterir. İkisi de 64 karakterdir ve Zabbix’teki media type’a girilir. Formdaki IP adresi kısıtlamaları alanı istemciyi belirli adreslere bağlamak içindir. Lab’da bu alan boş kaldı ve etkisi ölçülmedi.

Profil. Zabbix’in kullanıcısı Super-Admin olmaz, kendi profilini taşır. Menü yolu: Yönetim → Profiller → Ekle. Lab’da profilin adı zabbix-webhook oldu. Profilin arayüzü alanında Standart arayüz seçildi: fabrika değeri Basit arayüzdür, Zabbix’in belgesi standart arayüzü istiyor. Profilin Destek sekmesinde yalnız dört hak işaretlenir:

GLPI zabbix-webhook profilinin Destek sekmesi: destek kayıtlarında Güncelle, Ekle ve Tüm destek kayıtlarını görüntüle, izlemelerde 'Ekle (istekte bulunan)' işaretli, öteki kutular boş.
Zabbix'in profili: kayıt açma, güncelleme, bütün kayıtları görme ve takip ekleme. Başka hak yok.
SatırHak
Destek kayıtlarıEkle
Destek kayıtlarıGüncelle
Destek kayıtlarıTüm destek kayıtlarını görüntüle
İzlemelerEkle (istekte bulunan)

Liste Zabbix’in belgesinden gelir. Lab’da bu dört hakla kayıt açma, güncelleme ve takip ekleme çalıştı. Haklar tek tek çıkarılarak denenmedi, yani hangisinin zorunlu olduğu ölçülmedi.

Kullanıcı. Menü yolu: Yönetim → Kullanıcılar → Ekle. Lab’daki kullanıcının giriş adı zabbix, profili zabbix-webhook, birimi kök birimdir. Parolası 26 karakterlik rastgele bir dizgidir. Bu parola bir insanın hatırlayacağı bir parola değildir, yalnız Zabbix’teki media type’ta durur. Kullanıcı Active Directory’den gelmez, GLPI’nın yerel kullanıcısıdır.

Örnekteki dairede bu dört iş görevlinin yetki kartıdır. Kart görevliye dosya açma, dosyaya yazma ve not ekleme hakkı verir, başka bir şey vermez.

Zabbix Tarafı: GLPI Media Type

Media type, Zabbix’in bildirimi gönderdiği kanaldır: e-posta, SMS ya da bir uygulamanın API’si. Zabbix 7.0.32’de GLPI media type’ı hazır gelir. Alerts → Media types listesinde GLPI adıyla durur ve kapalıdır. Belgenin anlattığı içe aktarma adımı gerekmedi.

Önce bir global makro tanımlanır. Webhook, kayda Zabbix’teki probleme giden bir bağlantı yazar ve bağlantının kökünü {$ZABBIX.URL} makrosundan alır. Menü yolu: Administration → Macros. Lab’daki değer http://192.168.1.29/zabbix oldu. Değer protokolle başlar: belge protokolsüz zabbix.com değerini yanlış örnek olarak veriyor.

Sonra media type açılır ve parametreleri doldurulur:

Zabbix GLPI media type'ının doldurulmuş parametre listesi, sır değerleri noktalı, severity eşlemesi fabrika ayarında.
GLPI media type'ı: GLPI'nın adresi, OAuth istemcisinin kimliği ve parolası, kullanıcının adı ve parolası. Severity eşlemesi fabrika ayarında.
ParametreDeğer
glpi_urlhttps://glpi.ad.sistemkusu.com, sonunda yol olmadan
glpi_client_id, glpi_client_secretOAuth istemcisinin kimliği ve parolası
glpi_username, glpi_passwordGLPI’daki zabbix kullanıcısı
glpi_legacy_apifalse, fabrika değeri, yeni API

Severity eşlemesi fabrika ayarında kalır. GLPI’nın Türkçe arayüzünde karşılığı Önem derecesi alanıdır:

Zabbix’te severityGLPI’da önem derecesi
Not classified, InformationÇok düşük
WarningDüşük
AverageOrta
HighYüksek
DisasterÇok yüksek

Options sekmesindeki Attempts değeri fabrika ayarında 1’dir ve 1 kalır. Belgeye göre fazla deneme, yarıda kalan bir istekten sonra aynı kaydın ya da takibin iki kez açılmasına yol açabilir. Bu tercihin bedeli aşağıda, GLPI’ya ulaşamayan alarm bölümünde.

Hangi Alarm Kayıt Açar? Kullanıcı ve Eylem

Zabbix bildirimi bir kullanıcıya gönderir. Webhook’un bildirimi de bir kullanıcıya gider, Zabbix’in belgesi bunun için ayrı bir kullanıcı istiyor. Lab’daki düzen:

AyarDeğerNeden
Kullanıcı grubuGLPI bildirim, Frontend access DisabledKullanıcı arayüze girmez
Grubun host izniBildirimi gidecek host grupları, ReadZabbix, kullanıcının göremediği host’un problemini ona bildirmez
Kullanıcıglpi-webhookBildirimin alıcısı
Kullanıcının medyasıType GLPI, Send to -Webhook bu alanı kullanmaz ama alan boş bırakılamaz

Sonra bildirimi gönderen eylem (action) açılır: Alerts → Actions → Trigger actions. Eylemin koşulu, hangi alarmın kayıt olacağını belirler. Lab’daki eylemin tek koşulu Trigger severity is greater than or equals High oldu. İşlemleri üç bölümde de aynıdır:

Zabbix eyleminin Operations sekmesi: açılış, kapanış ve güncelleme işlemlerinin üçü de glpi-webhook kullanıcısına GLPI media type'ıyla gidiyor.
Açılış, kapanış ve güncelleme işlemlerinin üçü de aynı kullanıcıya GLPI media type'ıyla gider.

Üç işlemin üçü de gereklidir. Operations problem açılınca kaydı açar. Recovery operations problem kapanınca kaydı çözer. Update operations, biri problemi güncelleyince kayda takip ekler. Recovery işlemi yoksa problemin kapandığı GLPI’ya hiç gönderilmez.

Koşulun sonucu lab’da ölçüldü. Severity değeri Average olan bir deneme problemi açılıp kapandı ve GLPI’ya hiçbir istek gitmedi: Zabbix’in Action log ekranında o problem için satır bile yoktu. High ve Disaster problemlerin her biri kayıt açtı. Hangi alarmın GLPI’ya gideceğine Zabbix karar verir, GLPI’ya ulaşan her bildirim kayıt olur.

Örnekteki dairede bu, kurumun görevlisine verdiği talimattır. Görevli daireye yalnız acil yazıları götürür.

Alarmdan Kayda: GLPI’da Ne Açılır?

Lab’da severity değeri High olan bir deneme problemi açıldı. Problem bir dosyanın varlığına bakan bir trigger’dan geliyordu ve dosya oluşturulunca açıldı. GLPI’da birkaç saniye içinde 24 numaralı kayıt açıldı:

Zabbix webhook'unun GLPI'da açtığı 24 numaralı destek kaydı: gövdede problemin özeti, sağ panelde Helpdesk istek kaynağı, Yüksek önem derecesi ve boş istekte bulunan alanı işaretli.
Webhook'un açtığı kayıt: başlık Zabbix'teki problemin adı, gövde problemin özeti ve Zabbix'e dönüş bağlantısı. Önem derecesi severity'den geliyor, kategori ve istekte bulunan boş.

Kayıttan okunan beş şey:

  1. Başlık ve gövde Zabbix’ten gelir. Başlık problemin adıdır, başına Problem: eklenir. Gövde problemin başlama saatini, host’u, severity değerini ve Zabbix’teki problem numarasını taşır. Son satır Zabbix’teki probleme giden bağlantıdır.
  2. Önem derecesi severity’den gelir, etki sabittir. Problem High olduğu için önem derecesi Yüksek geldi. Etki her kayıtta Ortadır. GLPI önceliği bu ikisinden hesapladığı için öncelik Yüksek oldu.
  3. Kaynak Helpdesk, tür Olaydır. Elle açılan kayıtla aynı kaynaktır. Alarmdan gelen kaydı ayıran, kaydı açan kullanıcıdır: kaydın üstünde Oluşturan satırında Zabbix Webhook yazar.
  4. İstekte bulunan boştur. Webhook kayda istekte bulunan eklemez. Kaydın Aktörler bölümü boş açılır.
  5. Kategori boştur. Kaydı ilk açan teknisyen kategoriyi doldurur. Lab’da kayda kategori atayan bir kural kurulmadı.

Sabit etkinin bir sonucu var. Disaster problemin kaydında önem derecesi Çok yüksek geldi, öncelik yine Yüksek kaldı. GLPI’nın fabrika matrisinde Orta etki ile Çok yüksek önem derecesinin önceliği Yüksektir. Yani GLPI’nın listesinde High ve Disaster aynı öncelikle sıralanır. Matris GLPI helpdesk ve SLA yazısında.

Zabbix tarafında da bir iz kalır. Webhook kaydı açınca kaydın numarasını ve adresini probleme etiket olarak yazar. Monitoring → Problems ekranında problemin adına tıklanınca açılan menüde GLPI kaydına giden bir bağlantı çıkar:

Zabbix Problems ekranı: üstteki problemin GLPI etiketleri ve menüdeki 'GLPI: Problem 24' bağlantısı işaretli, alttaki problemde etiket yok.
Kayıt açılınca problem iki etiket alıyor ve menüde GLPI kaydına bağlantı çıkıyor. Alttaki problem GLPI'ya ulaşamamıştı, etiketi yok.

Bu etiket webhook’un hafızasıdır. Problem güncellenince ya da kapanınca webhook hangi kaydı değiştireceğini bu etiketten okur. Etiketi olmayan problemin başına geleni aşağıda ölçtük.

Örnekteki dairede bu, görevlinin kendi defterine yazdığı dosya numarasıdır.

Güncelleme ve Kapanış Aynı Kayda Yazılır

Lab’da problem açıkken Zabbix’te problemin Update penceresinden bir mesaj yazıldı: Teknisyen yolda, sicaklik kontrol ediliyor. Yeni kayıt açılmadı. 24 numaralı kaydın başlığı Updated problem in 1m 33s: ile başlayacak biçimde değişti ve mesaj kayda takip olarak eklendi.

Aynı pencereden problemin severity değeri de değiştirildi. Değer önce Not classified’a düştü, sonra Disaster’a çıktı. GLPI’daki önem derecesi her seferinde Zabbix’teki yeni değere göre yeniden yazıldı: önce Çok düşük, sonra Çok yüksek. Belge güncellemenin önem derecesini değiştirdiğini yazıyor, lab bunun iki yönde de olduğunu gösterdi. Zabbix’te severity değerini değiştiren kişi GLPI’daki önceliği de değiştirir.

Sonra deneme dosyası silindi ve problem kapandı. Webhook aynı kaydı Çözülmüş durumuna aldı ve kapanışı bir takip olarak yazdı. Aşağıdaki 29 numaralı kayıtta aynı akış severity değiştirilmeden yürüdü: problem tek bir mesajla güncellendi, sonra kapandı:

GLPI'da Çözülmüş durumdaki 29 numaralı kayıt: 'Resolved in' ile başlayan başlık ile Zabbix Webhook'un güncelleme ve kapanış takipleri işaretli.
Kapanan kayıt: güncelleme ve kapanış iki takip olarak eklendi, durum Çözülmüş. Severity değişmediği için önem derecesi açılıştaki gibi Yüksek kaldı.

Kapanışta iki ayrıntı var:

  • Kayıt Kapalı değil, Çözülmüş’tür. Kaydın kapanış tarihi boş kaldı. GLPI’da bir çözüm kaydı da oluşmadı: webhook durumu doğrudan Çözülmüş yapıyor, çözümü yalnız takip olarak yazıyor. Kaydı kapatmak teknisyenin işidir.
  • Takipte güncelleyenin adı her zaman yazmaz. Takip metni Inaccessible user commented problem diye başladı. Güncellemeyi kimin yaptığı Zabbix’te problemin geçmişinde her durumda görünür.

Takibin ilk sözcükleri, media type’ın güncelleme mesajı şablonundaki {USER.FULLNAME} makrosundan gelir. Problemi güncelleyen kullanıcı ilkerpehlivan, bildirimin alıcısı glpi-webhook idi ve ikisi ortak bir kullanıcı grubunda değildi. İkisi izin tanımlanmamış ortak bir gruba alınınca takip Ilker Pehlivan (ilkerpehlivan) commented problem diye başladı. Güncelleyenin Super admin olması tek başına adı göstermemişti.

Zabbix 7.0’ın makro listesi bu makroyu yalnız güncellemeyi yapan kullanıcının adı, soyadı ve kullanıcı adı diye tanımlıyor, alıcıya bağlı bir kuralı yazmıyor (zabbix.com). Kural Zabbix’in kaynak kodunda yazılı.

Makroyu dolduran kod (expression.c), adı yazmadan önce zbx_check_user_permissions() işlevini çağırır (db.c). İşlev, problemi güncelleyen kullanıcının değil bildirimi alan kullanıcının rolüne bakar. Alıcı Super admin ise ad her zaman yazılır. Değilse ad yalnız iki kullanıcı ortak bir kullanıcı grubundaysa yazılır, yoksa yerine Inaccessible user gelir. Bu kurulumda alıcı glpi-webhook olduğu için sonucu onun rolü ve grubu belirler. Lab’daki deneme bu kuralla örtüşüyor.

GLPI’ya Ulaşamayan Alarm Kaybolur

Webhook bir istek dener. İstek düşerse ne olduğunu görmek için lab’da GLPI’nın web sunucusu durduruldu ve High bir problem açıldı. Zabbix’in hatası:

mon02Çıktı
Sending failed: Error: cannot get URL: Failed to connect to glpi.ad.sistemkusu.com port 443 after 0 ms: Could not connect to server.

Web sunucusu yaklaşık bir dakika sonra yeniden başlatıldı. Kayıt sonradan açılmadı: Zabbix aynı bildirimi yeniden göndermedi ve problem etiketsiz kaldı. Ardından aynı probleme bir güncelleme yazıldı ve problem kapatıldı. İkisi de GLPI’ya ulaşmadı. GLPI’nın web sunucusu log’u nedeni gösteriyor:

itsm01Çıktı
glpi.ad.sistemkusu.com:443 192.168.1.29 [08/Nov/2026:15:12:15 +0300] "PATCH /api.php/v2.2/Assistance/Ticket/*UNKNOWN* HTTP/1.1" 404 410 "-" "-"
glpi.ad.sistemkusu.com:443 192.168.1.29 [08/Nov/2026:15:12:41 +0300] "PATCH /api.php/v2.2/Assistance/Ticket/*UNKNOWN* HTTP/1.1" 404 410 "-" "-"

Webhook kaydın numarasını problemin etiketinden okur. Etiket olmayınca numaranın yerine Zabbix’in çözemediği makro için yazdığı *UNKNOWN* gider ve GLPI 404, yani “bulunamadı” yanıtı verir. Zabbix’te bu iki bildirimin hatası Unknown INFO. Check debug log for more information. diye görünür ve nedeni söylemez.

Aynı sonuç lab’da sertifika hatasıyla da görüldü. Kök sertifika eklenmeden önce açılan problem kayıtsız kaldı. Sertifika eklendikten sonra gelen kapanışı da 404 aldı. Yani GLPI’ya bir kez ulaşamayan problem, ömrü boyunca GLPI’da yoktur.

Düşen bildirim Zabbix’te görülür. Reports → Action log ekranında her bildirim satırının Status sütununda Sent ya da Failed yazar:

Zabbix Action log ekranı: GLPI'ya ulaşamayan problemin üç bildirimi Failed, alttaki önceki bildirim Sent.
GLPI'ya ulaşamayan problemin açılışı, güncellemesi ve kapanışı Failed. Satırın sonundaki simge hatanın metnini gösterir.

Üç önlem:

  1. Action log düzenli okunur. Failed satırı olan her problem için GLPI’da kayıt elle açılır.
  2. Eyleme ikinci bir işlem eklenir. Aynı eylemin Operations bölümüne ekibin e-posta adresine giden bir işlem daha eklenirse GLPI’ya ulaşamayan alarm ekibe yine ulaşır.
  3. Attempts 1 kalır. Deneme sayısını artırmak kaybı azaltır ama belgeye göre mükerrer kayıt açabilir.

Örnekteki dairenin diliyle görevli kapıyı kapalı bulursa bir daha gelmez. Dosya numarası almadığı için o işin sonraki yazılarını da hiçbir dosyaya ekleyemez.

E-posta Yolu: Zabbix Alarmı mailgate ile Kayıt Olur

İkinci yol GLPI’nın e-posta alıcısıdır. Zabbix alarmı destek kutusuna e-posta olarak gönderir, GLPI’nın mailgate görevi iletiyi okuyup kayıt açar. Alıcının kurulumu GLPI mail to ticket yazısındadır, Zabbix’in e-posta ayarı Zabbix trigger ve alarm yazısında. Lab’da aynı türden bir High problemi bu yolla da denendi. Zabbix’in Email media type’ı bir SMTP sunucusuna bağlandı, glpi-webhook kullanıcısına ikinci medya olarak destek kutusunun adresi eklendi ve ayrı bir eylem açıldı.

İleti birkaç saniyede kutuya düştü ve mailgate’in sonraki turunda kayıt oldu. Problem kapanınca gelen ikinci ileti ise ayrı bir kayıt açtı:

GLPI destek kayıtları listesinde iki satır kırmızı çerçeveyle işaretli: 27 numaralı 'Resolved in 1m 30s: GLPI deneme High: /var/tmp/glpi-test-high dosyasi var' ve 26 numaralı 'Problem: GLPI deneme High: /var/tmp/glpi-test-high dosyasi var' kayıtları. İkisinin durumu Yeni, önceliği Orta.
E-posta yolunda problem ve kapanışı iki ayrı kayıt. İkisi de Yeni, ikisinin de önceliği Orta.

Webhook yoluyla dört fark:

  1. Kapanış ayrı kayıttır. GLPI bir iletiyi var olan kayda ancak konuda [GLPI #0000026] gibi yedi haneli bir numara ya da GLPI’nın kendi ileti kimliği varsa bağlar. Zabbix’in iletisi ikisini de taşımaz.
  2. Önem derecesi her zaman Ortadır. İletinin gövdesinde Severity: High yazar ama GLPI gövdeden önem derecesi okumaz.
  3. İstekte bulunan, göndereni tanıyan kullanıcıdır. Fabrika ayarında GLPI tanımadığı göndericiden kayıt açmaz. Bu yüzden Zabbix’in gönderen adresi GLPI’da bir kullanıcıya kayıtlı olmalıdır. Lab’da adres zabbix kullanıcısına yazıldı.
  4. Otomatik ileti kuralına takılmaz. Zabbix’in iletisinde Auto-Submitted ve Precedence başlıkları yoktu. GLPI’nın otomatik yanıtı reddeden fabrika kuralı bu yüzden devreye girmedi.

Bu yol seçilirse eylemden Recovery operations kaldırılabilir. Kapanış ayrı kayıt açmaz, kaydı problemin kapandığını gören teknisyen çözer.

Örnekteki dairede bu, posta yoludur. Her zarf masada yeni bir dosya açar, çünkü zarfın üstünde dosya numarası yoktur.

Doğru Kurulduğunu Nasıl Anlarsınız?

Yedi kontrol:

  1. Bağlantı: Zabbix sunucusundan GLPI’nın adresine yapılan istek sertifika hatası vermiyor.
  2. Kayıt: High bir deneme problemi GLPI’da tek bir kayıt açıyor. Önem derecesi Yüksek, Oluşturan satırında Zabbix’in kullanıcısı var.
  3. Etiket: Zabbix’te problem __zbx_glpi_problem_id etiketini alıyor ve menüde GLPI bağlantısı çıkıyor.
  4. Güncelleme: problem Update ile güncellenince aynı kayda takip ekleniyor.
  5. Kapanış: problem kapanınca aynı kayıt Çözülmüş oluyor.
  6. Süzgeç: Average bir problem GLPI’ya hiçbir şey göndermiyor.
  7. Yetki: Zabbix’in GLPI kullanıcısının profili Super-Admin değil.

Kurulumdan sonra en sık görülen belirtiler:

BelirtiOlası sebepBakılacak yer
Action log’da unable to get local issuer certificateZabbix sunucusu GLPI’nın kök sertifikasını tanımıyorKök sertifika, update-ca-certificates
Action log’da Failed to connect ... port 443GLPI’nın web sunucusu kapalı ya da ad çözülmüyorGLPI sunucusu, DNS kaydı
Action log’da Unknown INFO. Check debug logProblemin GLPI etiketi yok, ilk bildirim düşmüşProblemin Tags sütunu, GLPI web sunucusu log’unda *UNKNOWN*
Test must contain a schema hatası veriyorTest penceresi makroyu çözmüyorTest alanına gerçek değer yazmak
Average problem kayıt açıyorEylemin severity koşulu eksikEylemin Conditions bölümü
Kapanan problemin kaydı Yeni kalıyorRecovery operations yokEylemin Operations sekmesi
Takipte ad yerine Inaccessible user yazıyorglpi-webhook Super admin değil ve güncelleyen kullanıcıyla ortak bir kullanıcı grubunda değilİki kullanıcının Groups alanı
Problemin kapanışı ayrı kayıt açıyorE-posta yolu kullanılıyorWebhook’a geçmek

Sonuç: Webhook Bir Kez Dener

Zabbix ile GLPI’yı bağlamak, iki tarafta da hazır parçaları açmaktır: Zabbix’in GLPI media type’ı ve GLPI’nın API’si. Lab’da ilk kayıt, alarmdan birkaç saniye sonra açıldı. Beklenenden farklı çıkan beş şey:

  1. Zabbix’in belgesi GLPI 12’yi sınadığı sürümler arasında saymıyor. Webhook GLPI 12.0.1’de iki API ile de çalıştı.
  2. GLPI 12 API adresini v3.0 olarak gösteriyor, webhook v2.2 adresini çağırıyor ve bu adres de yanıt veriyor.
  3. Önem derecesi her güncellemede Zabbix’teki o anki severity değerinden yeniden yazılıyor, iki yönde de.
  4. Kapanan problemin kaydı Kapalı değil Çözülmüş oluyor ve GLPI’da çözüm kaydı oluşmuyor.
  5. GLPI’ya bir kez ulaşamayan problem ömrü boyunca GLPI’da yok: güncellemesi ve kapanışı da düşüyor.

Girişteki benzetmeye dönersek: kurumun görevlisi yetki kartıyla daireye girer, dosyayı kendisi açar ve dosya numarasını defterine yazar. Sonraki her yazıyı aynı dosyaya ekler, dosyayı “çözüldü” diye işaretler ama kapatmaz. Kapıyı kapalı bulduğu gün ise geri gelmez. Posta yolunda her zarf ayrı bir dosya açar. Rehberin son adımı GLPI upgrade yazısındaki yedek ve sürüm yükseltmedir. Bütün sıra GLPI rehberinde.

GLPI Zabbix Entegrasyonu Hakkında Sık Sorulan Sorular

Gerekmez. Zabbix 7.0, GLPI için hazır bir webhook ile gelir. Lab'daki Zabbix 7.0.32'de bu media type GLPI adıyla listede hazırdı, yalnız kapalıydı. GLPI tarafında da eklenti kurulmaz: GLPI'nın kendi API'si açılır, Zabbix için bir OAuth istemcisi, bir profil ve bir kullanıcı tanımlanır.
Lab'da çalıştı. Zabbix'in belgesi webhook'un sınandığı sürümler olarak GLPI 10.0 ve 11.0'ı sayıyor, 12'yi saymıyor. Lab'daki GLPI 12.0.1'de webhook yeni API ile kayıt açtı, güncelledi ve çözdü. Eski REST API ile de kayıt açtı. Belgede sayılmayan bir sürümde webhook canlıya alınmadan önce bir deneme alarmıyla sınanır.
Kapanmaz, Çözülmüş durumuna geçer. Webhook problemin kapandığını kayda bir takip olarak yazar ve kaydın durumunu Çözülmüş yapar. Lab'da kaydın kapanış tarihi boş kaldı ve GLPI'da bir çözüm kaydı oluşmadı. Kaydı kapatmak teknisyenin işidir.
Kaybolur. Webhook bir kez dener. Lab'da GLPI'nın web sunucusu durdurulmuşken açılan problem Zabbix'te Failed oldu ve web sunucusu yeniden açıldıktan sonra da kayıt açılmadı. O problemin sonraki güncellemesi ve kapanışı da GLPI'ya ulaşmadı. Düşen bildirim Zabbix'in Action log ekranında Failed olarak görünür, kaydı teknisyen elle açar.
İ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

GLPI Rehberi: Kurulumdan Helpdesk'e Adım Adım

GLPI rehberi: kurulumdan Active Directory'ye, envanterden SLA'ya on üç adımlık sıra. Her adım hangi kurumda gerekir, fabrika ayarı ne, lab'da ne ölçtük.

22 dk okuma

BT Envanter Yönetimi: Sistem Seçimi ve Kurulum Hizmeti

Kurumunuza hangi envanter sistemi uyar? Açık kaynak, bulut ve kurumsal ITSM seçeneklerini ölçeğinize göre karşılaştırıyor, seçtiğiniz sistemi kuruyoruz.

8 dk okuma

GLPI Active Directory ve LDAP: LDAPS ile Bağlantı

GLPI Active Directory bağlantısı adım adım: LDAPS ve 636, salt okuma servis hesabı, DNS, içe aktarmadan önce daraltılan kapsam ve saatlik kullanıcı eşitlemesi.

14 dk okuma

GLPI Agent GPO ile Dağıtım: Başlangıç Betiği ve Parola

GLPI Agent GPO ile dağıtım: resmi VBS betiği açılışta MSI'ı kurar ve ayarı her açılışta yeniden yazar. Betik SYSVOL'de değil, kapalı paylaşımda durur.

18 dk okuma

GLPI Envanter Kuralları: Etiket, Konum ve Kopya Kayıt

GLPI envanter kuralları: agent etiketinden konum atayan kural, kuralın her envanterde çalışması, elle düzeltmenin kilidi ve kopya kaydı önleyen eşleştirme.

17 dk okuma

GLPI HTTPS: İç CA Sertifikası, Apache ve GLPI Adresi

GLPI HTTPS yapılandırması adım adım: iç CA'dan SAN'lı sertifika, Apache'de 443 ve yönlendirme, HSTS, GLPI uygulama adresi ve session.cookie_secure ayarı.

16 dk okuma