Iestatīšana no pirmkoda

Pārskats

Ja instalēts no pirmkoda, tālāk sniegtā informācija palīdzēs jums iestatīt Zabbix Java gateway.

Failu pārskats

Ja ieguvāt Java gateway no pirmkoda, jums vajadzētu būt iegūtai čaulas skriptu, JAR un konfigurācijas failu kopai mapē $PREFIX/sbin/zabbix_java. Šo failu loma ir apkopota zemāk.

bin/zabbix-java-gateway-$VERSION.jar

Pats Java gateway JAR fails.

lib/logback-core-1.5.16.jar
lib/logback-classic-1.5.16.jar
lib/slf4j-api-2.0.16.jar
lib/android-json-4.3_r3.1.jar

Java gateway atkarības: Logback, SLF4J un Android JSON bibliotēka.

lib/logback.xml  
lib/logback-console.xml

Logback konfigurācijas faili.

shutdown.sh  
startup.sh

Palīgskripti Java gateway palaišanai un apturēšanai.

settings.sh

Konfigurācijas fails, ko izmanto iepriekš minētie startup un shutdown skripti.

Java gateway konfigurēšana un palaišana

Pēc noklusējuma Java gateway klausās 10052. portā. Ja plānojat palaist Java gateway citā portā, to varat norādīt skriptā settings.sh. Skatiet Java gateway konfigurācijas faila aprakstu, lai uzzinātu, kā norādīt šo un citas opcijas.

Kad iestatījumi jūs apmierina, varat palaist Java gateway, izpildot palaišanas skriptu:

./startup.sh

Tāpat, kad Java gateway jums vairs nav nepieciešams, izpildiet apturēšanas skriptu, lai to apturētu:

./shutdown.sh

Ņemiet vērā, ka atšķirībā no serveris vai starpniekserveris, Java gateway ir viegls un tam nav nepieciešama datubāze.

Servera konfigurēšana darbam ar Java gateway

Kad Java gateway ir palaists un darbojas, jums jānorāda Zabbix serverim, kur atrast Zabbix Java gateway. To izdara, norādot parametrus JavaGateway un JavaGatewayPort servera konfigurācijas failā. Ja hosts, kurā darbojas JMX lietotne, tiek uzraudzīts ar Zabbix starpniekserveri, tad savienojuma parametri jānorāda starpniekservera konfigurācijas failā.

JavaGateway=192.168.3.14
JavaGatewayPort=10052

Pēc noklusējuma serveris nepalaiž nevienu procesu, kas saistīts ar JMX uzraudzību. Tomēr, ja vēlaties to izmantot, jums jānorāda iepriekš izveidoto Java aptaujātāju instanču skaits. To izdara tāpat, kā norādāt parastos aptaujātājus un uztvērējus.

StartJavaPollers=5

Neaizmirstiet restartēt serveri vai starpniekserveri, kad esat pabeidzis to konfigurēšanu.

Java gateway atkļūdošana

Ja rodas kādas problēmas ar Java gateway vai kļūdas ziņojums, ko redzat par vienumu lietotāja saskarnē, nav pietiekami aprakstošs, iespējams, vēlēsieties apskatīt Java gateway žurnālfailu.

Pēc noklusējuma Java gateway reģistrē savas darbības failā /tmp/zabbix_java.log ar žurnalēšanas līmeni "info". Dažreiz ar šo informāciju nepietiek un ir nepieciešama informācija ar žurnalēšanas līmeni "debug". Lai palielinātu žurnalēšanas līmeni, modificējiet failu lib/logback.xml un nomainiet atribūtu level tagam <root> uz "debug":

<root level="debug">
  <appender-ref ref="FILE" />
</root>

Ņemiet vērā, ka atšķirībā no Zabbix serveris vai Zabbix starpniekserveris nav nepieciešams pārstartēt Zabbix Java gateway pēc faila logback.xml maiņas — izmaiņas failā logback.xml tiks uztvertas automātiski. Kad atkļūdošana ir pabeigta, varat atjaunot žurnalēšanas līmeni uz "info".

Ja vēlaties reģistrēt citā failā vai pilnīgi citā vidē, piemēram, datubāzē, pielāgojiet failu logback.xml atbilstoši savām vajadzībām. Plašāku informāciju skatiet Logback rokasgrāmatā.

Dažreiz atkļūdošanas nolūkos ir lietderīgi palaist Java gateway kā konsoles lietotni, nevis dēmonu. Lai to izdarītu, izkomentējiet mainīgo PID_FILE failā settings.sh. Ja PID_FILE ir izlaists, skripts startup.sh palaiž Java gateway kā konsoles lietotni un liek Logback tā vietā izmantot failu lib/logback-console.xml, kas ne tikai reģistrē izvadi konsolē, bet arī izmanto žurnalēšanas līmeni "debug".

Visbeidzot, ņemiet vērā, ka, tā kā Java gateway žurnalēšanai izmanto SLF4J, varat aizstāt Logback ar sev vēlamo ietvaru, ievietojot atbilstošu JAR failu direktorijā lib. Plašāku informāciju skatiet SLF4J rokasgrāmatā.

JMX uzraudzība

Skatiet JMX uzraudzība lapu, lai iegūtu sīkāku informāciju.