#10 Zabbix-agent op Microsoft Windows

Agent configureren

Beide generaties Zabbix-agents draaien als een Windows-service. Voor Zabbix agent 2, vervang agentd door agent2 in de onderstaande instructies.

U kunt een enkele instantie van Zabbix-agent of meerdere instanties van de agent op een Microsoft Windows-host. Een enkele instantie kan de standaard configuratiebestand C:\zabbix_agentd.conf of een configuratie bestand opgegeven in de opdrachtregel. In het geval van meerdere gevallen elk agent-instantie moet een eigen configuratiebestand hebben (een van de instances kunnen het standaard configuratie bestand gebruiken).

Een voorbeeld configuratie bestand is beschikbaar in het Zabbix-bronarchief als: conf/zabbix_agentd.win.conf.

Zie het configuratiebestand opties voor details over het configureren van Zabbix Windows-agent.

Hostnaamparameter

Om active . uit te voeren checks op een host Zabbix-agent moet de hostnaam hebben gedefinieerd. Bovendien is de hostnaam waarde die aan de kant van de agent is ingesteld, moet exact overeenkomen met de "Host naam" geconfigureerd voor de host in de voorkant.

De waarde van de hostnaam aan de kant van de agent kan worden gedefinieerd met de Hostnaam of HostnameItem parameter in de agent configuratie file - of de standaardwaarden worden gebruikt als een van deze parameters niet is opgegeven.

De standaardwaarde voor de parameter HostnameItem is de geretourneerde waarde door de agentsleutel "system.hostname". Voor Windows retourneert het resultaat van de functie gethostname(), die naamruimteproviders opvraagt om de lokale hostnaam te bepalen. Als geen naamruimteprovider reageert, wordt de NetBIOS-naam geretourneerd.

De standaardwaarde voor Hostnaam is de waarde die wordt geretourneerd door de HostnameItem parameter. Dus, in feite, als beide parameters zijn: niet gespecificeerd is de werkelijke hostnaam de NetBIOS-naam van de host; Zabbix agent gebruikt NetBIOS-hostnaam om de lijst met actieve controles op te halen van de Zabbix-server en stuur de resultaten ernaar.

De standaardwaarde voor Hostnaam is de waarde die wordt geretourneerd door de HostnameItem parameter. Dus, in feite, als beide parameters zijn: niet gespecificeerd is de werkelijke hostnaam de NetBIOS-naam van de host; Zabbix agent gebruikt NetBIOS-hostnaam om de lijst met actieve controles op te halen van de Zabbix-server en stuur de resultaten ernaar.

De sleutel "system.hostname" ondersteunt twee optionele parameters - type en transformeren.

Type parameter bepaalt het type naam dat het item moet retourneren. Ondersteunde waarden:

  • netbios (standaard) - retourneert de NetBIOS-hostnaam die beperkt is tot 15 symbolen en staat alleen in HOOFDLETTERS;

  • host - hoofdlettergevoelig, geeft de volledige, echte Windows-hostnaam terug (zonder domein);

  • shorthost (ondersteund sinds Zabbix 5.4.7) - retourneert een deel van de hostnaam voor de eerste punt. Het zal een volledige string teruggeven als de naam bevat geen punt.

  • Transform * parameter wordt ondersteund sinds Zabbix 5.4.7 en maakt het mogelijk om: specificeer een extra transformatieregel voor de hostnaam. Ondersteund waarden:

  • geen (standaard) - gebruik de originele letterkast;

  • lower - zet de tekst om in kleine letters.

Dus, om de configuratie van het zabbix_agentd.conf-bestand te vereenvoudigen en maak het verenigde, konden twee verschillende benaderingen worden gebruikt.

  1. laat de parameters Hostnaam of HostnaamItem ongedefinieerd en Zabbix-agent gebruikt NetBIOS-hostnaam als hostnaam;
  2. laat de parameter Hostnaam ongedefinieerd en definieer HostnameItem soortgelijk:
    HostnameItem=system.hostname[host] - voor gebruik door Zabbix-agent de volledige, echte (hoofdlettergevoelige) Windows-hostnaam als hostnaam
    HostnameItem=system.hostname[shorthost,lower] - voor Zabbix agent om slechts een deel van de hostnaam voor de eerste punt te gebruiken, omgezet in kleine letters.

Hostnaam wordt ook gebruikt als onderdeel van de Windows-servicenaam die wordt gebruikt voor: installeren, starten, stoppen en verwijderen van de Windows-service. Voor bijvoorbeeld, als Zabbix agent configuratiebestand specificeert: Hostname=Windows_db_server, dan wordt de agent geïnstalleerd als een Windows-service "Zabbix Agent [Windows_db_server]". Daarom, om te hebben een andere Windows-servicenaam voor elke Zabbix agent instantie, elk instantie moet een andere hostnaam gebruiken.

Agent installeren als Windows-service

Een enkele instantie van Zabbix-agent installeren met de standaardinstelling configuratiebestand c:\zabbix_agentd.conf:

zabbix_agentd.exe --install

Op een 64-bits systeem, een 64-bit Zabbix-agentversie is vereist om alle controles met betrekking tot het uitvoeren van 64-bits processen te laten werken correct.

Als u een ander configuratiebestand wilt gebruiken dan: c:\zabbix_agentd.conf, gebruik het volgende commando voor: service installatie:

zabbix_agentd.exe --config <your_configuration_file> --install

Er moet een volledig pad naar het configuratiebestand worden opgegeven.

Meerdere exemplaren van Zabbix-agent kunnen worden geïnstalleerd als services zoals deze:

  zabbix_agentd.exe --config <configuration_file_for_instance_1> --install --multiple-agents
         zabbix_agentd.exe --config <configuration_file_for_instance_2> --install --multiple-agents
         ...
         zabbix_agentd.exe --config <configuration_file_for_instance_N> --install --multiple-agents

De geïnstalleerde service zou nu zichtbaar moeten zijn in het Configuratiescherm.

Startagent

Om de agent service te starten, kunt u het Configuratiescherm gebruiken of het doen vanuit opdrachtregel.

Een enkele instantie van Zabbix-agent starten met de standaardinstelling configuratiebestand:

 zabbix_agentd.exe --start

Een enkele instantie van Zabbix-agent starten met een andere configuratie het dossier:

 zabbix_agentd.exe --config <uw_configuratiebestand> --start

Om een of meerdere instanties van Zabbix-agent te starten:

 zabbix_agentd.exe --config <configuration_file_for_this_instance> --start --multiple-agents

Stop agent

Om de agent service te stoppen, kunt u het Configuratiescherm gebruiken of het doen vanuit: opdrachtregel.

Om een enkele instantie van Zabbix-agent te stoppen die met de standaard is gestart configuratiebestand:

 zabbix_agentd.exe --stop

Om een enkele instantie van Zabbix-agent te stoppen, begon met een andere configuratiebestand:

 zabbix_agentd.exe --config <your_configuration_file> --stop

Om een of meerdere instanties van Zabbix-agent te stoppen:

 zabbix_agentd.exe --config <configuration_file_for_this_instance> --stop --multiple-agents

Agent Windows-service verwijderen

Een enkele instantie van Zabbix-agent verwijderen met de standaard: configuratiebestand:

   zabbix_agentd.exe --uninstall

Een enkele instantie van Zabbix-agent verwijderen met een niet-standaard: configuratiebestand:

   zabbix_agentd.exe --config <your_configuration_file> --uninstall

Om meerdere exemplaren van Zabbix-agent van Windows-services te verwijderen:

  zabbix_agentd.exe --config <configuration_file_for_instance_1> --uninstall --multiple-agents
         zabbix_agentd.exe --config <configuration_file_for_instance_2> --uninstall --multiple-agents
         ...
         zabbix_agentd.exe --config <configuration_file_for_instance_N> --uninstall --multiple-agents

Beperkingen

Zabbix-agent voor Windows ondersteunt niet niet-standaard Windows-configuraties waar CPU's worden gedistribueerd niet-uniform over NUMA-knooppunten. Als logische CPU's worden gedistribueerd niet-uniform, dan zijn CPU-prestatiestatistieken mogelijk niet beschikbaar voor sommige CPU's. Als er bijvoorbeeld 72 logische CPU's zijn met 2 NUMA-knooppunten, beide nodes moeten elk 36 CPU's hebben.