Documentation
Table of Contents
4 Java a? ge?idi
Genel bak??
JMX uygulamalar?n?n izlenmesi i?in yerel destek, Áú»¢¶Ä²© 2.0'dan itibaren kullan?labilen "Áú»¢¶Ä²© Java a? ge?idi" adl? bir Áú»¢¶Ä²© artalan s¨¹reci ?eklinde bulunur. Áú»¢¶Ä²© Java a? ge?idi, Java ile yaz?lm?? bir artalan s¨¹recidir. Áú»¢¶Ä²© sunucusu, bir ana bilgisayarda belirli bir JMX sayac?n?n de?erini bulmak i?in ilgilenilen uygulamay? uzaktan sorgulamak i?in kullanan Áú»¢¶Ä²© Java a? ge?idini sorgular. Uygulaman?n herhangi bir ek yaz?l?ma ihtiyac? yoktur, sadece komut sat?r?nda -Dcom.sun.management.jmxremote se?ene?iyle ba?lat?lmas? gerekir.
Java a? ge?idi, Áú»¢¶Ä²© sunucusundan veya proxysinden gelen ba?lant?lar? kabul eder ve yaln?zca bir "pasif proxy" olarak kullan?labilir. Áú»¢¶Ä²© proxynin aksine, Áú»¢¶Ä²© proxyden de kullan?labilir (Áú»¢¶Ä²© proxyler zincirlenemez). Her bir Java a? ge?idine eri?im do?rudan Áú»¢¶Ä²© sunucu veya proxy yap?land?rma dosyas?nda yap?land?r?l?r, bu nedenle her Áú»¢¶Ä²© sunucu veya Áú»¢¶Ä²© proxysi i?in yaln?zca bir Java a? ge?idi yap?land?r?labilir. Bir ana makine JMX arac?s? ve di?er t¨¹rlerden ??eler i?eriyorsa, Java a? ge?idine bilgi ?ekmek i?in yaln?zca JMX arac? ??eleri ge?ebilir.
Java a? ge?idi ¨¹zerinden bir ??e g¨¹ncellenece?inde, Áú»¢¶Ä²© sunucusu veya proxysi, Java a? ge?idine ba?lan?p de?er isteyecek ve Java a? ge?idi de s?rayla bilgiyi ?ekip sunucuya veya proxyye geri g?nderecektir. Bu nedenle, Java a? ge?idi herhangi bir de?eri ?nbelle?e almaz.
Áú»¢¶Ä²© sunucusu ve proxysi, Java a? ge?idine ba?lanan ve StartJavaPollers se?ene?iyle kontrol edilen belirli bir s¨¹re? t¨¹r¨¹ne sahiptir. Dahili olarak, Java a? ge?idi, START_POLLERS se?ene?iyle kontrol edilen birden ?ok i? par?ac??? ba?lat?r. Sunucu taraf?nda, bir ba?lant? Timeout (Zaman A??m?) s¨¹resinden uzun s¨¹rerse sonland?r?lacakt?r, ancak Java a? ge?idi hala JMX sayac?ndan de?er almakla me?gul olabilir. Bunu ??zmek i?in, Áú»¢¶Ä²© 2.0.15, Áú»¢¶Ä²© 2.2.10 ve Áú»¢¶Ä²© 2.4.5'ten beri Java a? ge?idinde JMX a? i?lemleri i?in zaman a??m?n? ayarlamay? sa?layan TIMEOUT se?ene?i bulunmaktad?r.
Áú»¢¶Ä²© sunucusu veya proxysi, istekleri m¨¹mk¨¹n oldu?unca tek bir JMX hedefinde sorgulamaya ?al??acak (??e aral?klar?ndan etkilenir) ve daha iyi performans i?in onlar? tek bir ba?lant?da Java A? Ge?idine g?nderilecektir.
StartJavaPollers de?erinin START_POLLERS de?erinden k¨¹?¨¹k veya ona e?it olmas? ?nerilir, aksi halde Java a? ge?idinde gelen isteklere hizmet etmek i?in hi?bir i? par?ac??? bulunmad??? durumlar olabilir.
A?a??daki b?l¨¹mlerde Áú»¢¶Ä²© Java a? ge?idininin nas?l al?n?p ?al??t?r?laca??, JMX izleme i?in Áú»¢¶Ä²© Java a? ge?idini kullanmada Áú»¢¶Ä²© sunucusunun (veya Áú»¢¶Ä²© proxysinin) nas?l yap?land?r?laca?? ve Áú»¢¶Ä²© grafik kullan?c? aray¨¹z¨¹nde belirli JMX saya?lar?na kar??l?k gelen Áú»¢¶Ä²© ??elerinin nas?l yap?land?r?laca?? anlat?lmaktad?r.
4.1 Java a? ge?idini alma
Java a? ge?idini alman?n iki yolu vard?r. Birincisi, Java a? ge?idi paketini Áú»¢¶Ä²© web sitesinden indirmek ve di?eri de Java a? ge?idini kaynaktan derlemektir.
4.1.1 Áú»¢¶Ä²© web sitesinden indirme
Áú»¢¶Ä²© Java a? ge?idi paketleri (RHEL, Debian, Ubuntu i?in) adresinden indirilebilir.
4.1.2 Kaynaktan derleme
Java a? ge?idini derlemek i?in ?nce ./configure beti?ini --enable-java se?ene?iyle ?al??t?r?n. Java a? ge?idinin kurulumu yaln?zca tek bir y¨¹r¨¹t¨¹lebilir dosya de?il b¨¹t¨¹n bir dizin a?ac? olu?turaca?? i?in ?ntan?ml? /usr/local d???nda bir y¨¹kleme yolu ayarlamak i?in --prefix se?ene?ini kullanman?z ?nerilir.
Java a? ge?idini bir JAR dosyas?na derlemek ve paketlemek i?in make komutunu ?al??t?r?n. Bu ad?m i?in yolunuzda javac ve jar y¨¹r¨¹t¨¹lebilir dosyalar?n?n olmas? gerekti?ini unutmay?n.
?imdi src/zabbix_java/bin dizini i?inde zabbix-java-gateway-$VERSION.jar dosyan?z var. E?er Java a? ge?idini, da??t?m dizinindeki src/zabbix_java dosyas?ndan ?al??t?rmak konusunda rahatsan?z, Java a? ge?idini yap?land?rma ve ?al??t?rma y?nergelerine ge?ebilirsiniz. Aksi takdirde, yeterli ayr?cal?klara sahip oldu?unuzdan emin olun ve make install komutunu ?al??t?r?n.
4.2 Java a? ge?idi da??t?m?ndaki dosyalara genel bak??
Java a? ge?idini nas?l elde etti?inize bak?lmaks?z?n, $PREFIX/sbin/zabbix_java alt?nda kabuk betikleri, JAR ve yap?land?rma dosyalar?n?n bir derlemesine sahip olarak bitirmi? olmal?s?n?z. Bu dosyalar?n rol¨¹ a?a??da ?zetlenmi?tir.
Java a? ge?idi JAR dosyas?n?n kendisi.
lib/logback-core-0.9.27.jar
lib/logback-classic-0.9.27.jar
lib/slf4j-api-1.6.1.jar
lib/android-json-4.3_r3.1.jarJava a? ge?idi ba??ml?l?klar?: , ve kitapl???.
Logback yap?land?rma dosyalar?.
Java a? ge?idinin ba?lat?lmas? ve durdurulmas? i?in uygun komut dosyalar?.
Yukar?daki ba?latma ve kapatma komut dosyalar?n?n kaynak ald??? yap?land?rma dosyas?.
4.3 Java a? ge?idinin yap?land?r?lmas? ve ?al??t?r?lmas?
?ntan?ml? olarak, Java a? ge?idi, 10052 numaral? ba?lant? noktas?n? dinler. Java a? ge?idini farkl? bir ba?lant? noktas?nda ?al??t?rmay? planl?yorsan?z bunu settings.sh beti?inde belirtebilirsiniz. Bunun ve di?er se?eneklerin nas?l belirtilece?ini ??renmek i?in Java gateway yap?land?rma dosyas?n?n a??klamas?na bak?n.
10052 numaral? ba?lant? noktas? .
Ayarlarla ilgili i?iniz rahat etti?inde, ba?latma beti?ini ?al??t?rarak Java a? ge?idini ba?latabilirsiniz:
Ayn? ?ekilde, Java a? ge?idine art?k ihtiyac?n?z olmad???nda, durdurmak i?in kapatma beti?ini ?al??t?r?n:
Sunucu veya proxynin aksine Java a? ge?idi hafiftir ve bir veritaban?na ihtiya? duymad???n? unutmay?n.
4.4 Sunucuyu Java a? ge?idiyle kullanmak ¨¹zere yap?land?rma
?imdi Java a? ge?idi ?al???yor, Áú»¢¶Ä²© sunucuya Áú»¢¶Ä²© Java a? ge?idini nerede bulaca??n? s?ylemeniz gerekiyor. Bu, JavaGateway ve JavaGatewayPort parametrelerini sunucu yap?land?rma dosyas?nda belirterek yap?l?r. JMX uygulamas?n?n ?al??t??? ana makine Áú»¢¶Ä²© proxy taraf?ndan izlenirse, ba?lant? parametrelerini proxy yap?land?rma dosyas?nda belirtin.
?ntan?ml? olarak sunucu, JMX izlemeyle ilgili herhangi bir s¨¹re? ba?latmaz. Bununla birlikte, bunu kullanmak isterseniz, ?nceden ?atallanm?? (pre-forked) Java sorgulay?c? ?rneklerini belirtmeniz gerekir. Bunu, normal sorgulay?c?lar? ve izleyicileri belirtti?iniz gibi yapabilirsiniz.
Ayarlad?ktan sonra sunucuyu veya proxyyi yeniden ba?latmay? unutmay?n.
4.5 Java a? ge?idinin hata ay?klanmas?
Java a? ge?idinde herhangi bir sorun oldu?unda veya ?ny¨¹zdeki bir ??e hakk?nda g?rd¨¹?¨¹n¨¹z hata iletisinin yeterince a??klay?c? olmad??? durumlarda, Java a? ge?idi kay?t dosyas?na bakmak isteyebilirsiniz.
?ntan?ml? olarak Java a? ge?idi, etkinliklerini "info" kay?t seviyesiyle /tmp/zabbix_java.log dosyas?na kaydeder. Bazen bu bilgi yeterli de?ildir ve ¡°debug¡± kay?t seviyesinde bilgiye ihtiya? vard?r. Kay?t seviyesini art?rmak i?in lib/logback.xml dosyas?n? de?i?tirin ve <root> etiketinin level ?zniteli?ini "debug" olarak de?i?tirin:
Áú»¢¶Ä²© sunucusunun veya Áú»¢¶Ä²© proxysinin aksine, logback.xml dosyas?n? de?i?tirdikten sonra Áú»¢¶Ä²© Java a? ge?idini yeniden ba?latmaya gerek olmad???n? unutmay?n, logback.xml'deki de?i?iklikler otomatik olarak al?n?r. Hata ay?klama i?lemini tamamlad???n?zda kaydetme seviyesini "bilgi" seviyesine d?nd¨¹rebilirsiniz.
Farkl? bir dosyaya veya veritaban? gibi tamamen farkl? bir ortama oturum a?mak isterseniz, ihtiya?lar?n?z? kar??lamak i?in logback.xml dosyas?n? ayarlay?n. Daha ?ok bilgi i?in bak?n?z.
Bazen hata ay?klama amac?yla, Java a? ge?idini bir artalan s¨¹reci yerine bir konsol uygulamas? olarak ?al??t?rmak kullan??l?d?r. Bunu yapmak i?in, settings.sh dosyas?ndaki PID_FILE de?i?kenini yorum haline ?evirin. PID_FILE atlan?rsa, startup.sh beti?i Java a? ge?idini bir konsol uygulamas? olarak ba?lat?r ve Logback'e lib/logback-console.xml dosyas?n? kulland?rtarak yaln?zca konsolda kay?tlar? g?stermesini de?il, ayn? zamanda "hata ay?klama" seviyesiyle g¨¹nl¨¹k dosyas?na da kaydetmesini sa?lar.
Finally, note that since Java gateway uses SLF4J for logging, you can replace Logback with the framework of your choice by placing an appropriate JAR file in lib directory. See for more details. Son olarak, Java a? ge?idi g¨¹nl¨¹?e kaydetme i?in SLF4J kulland???ndan, lib dizininde uygun bir JAR dosyas? yerle?tirerek Logback'i se?ti?iniz ba?ka bir ?at?yla de?i?tirebilirsiniz. Daha ?ok ayr?nt? i?in bak?n.