[comment]: # ({9884b1d2-9884b1d2})
# 10 Zabbix aģents uz Microsoft Windows

[comment]: # ({/9884b1d2-9884b1d2})

[comment]: # ({9134e90f-bc82b50c})
#### Aģenta konfigurēšana

Abas Zabbix aģentu paaudzes darbojas kā Windows pakalpojums. Zabbix
agent 2 gadījumā tālāk sniegtajās instrukcijās aizstājiet *agentd* ar *agent2*.

Microsoft Windows hostā var palaist vienu Zabbix aģenta instanci vai vairākas
aģenta instances. Viena instance var izmantot vai nu:

- noklusējuma konfigurācijas failu, kas atrodas tajā pašā
  direktorijā, kur aģenta binārais fails;
- komandrindā norādītu konfigurācijas failu.

Vairāku instanču gadījumā katrai aģenta instancei jābūt savam
konfigurācijas failam (viena no instancēm var izmantot noklusējuma konfigurācijas failu).

Konfigurācijas faila piemērs ir pieejams Zabbix avota arhīvā kā:

- `conf/zabbix_agentd.conf` Zabbix aģentam;
- `conf/zabbix_agent2.conf` Zabbix agent2.

Ja vēlaties instalēt Zabbix aģentu/agent 2 operētājsistēmā Windows kā pakalpojumu no
[arhīva](https://www.zabbix.com/download_agents), skaidri nenorādot
konfigurācijas failu, tad pirms aģenta instalēšanas:

- `conf/zabbix_agentd.conf` manuāli jākopē direktorijā, kurā
  tiks instalēts zabbix_agentd.exe;
- `conf/zabbix_agent2.conf` un `conf/zabbix_agent2.d` direktorijs manuāli jākopē
  direktorijā, kurā tiks instalēts zabbix_agent2.exe.

Skatiet [konfigurācijas faila](/manual/appendix/config/zabbix_agentd_win)
opcijas, lai iegūtu detalizētu informāciju par Zabbix Windows aģenta konfigurēšanu.

[comment]: # ({/9134e90f-bc82b50c})

[comment]: # ({5f456a33-011f29f0})
##### Hostname parametrs

Lai veiktu [aktīvās
pārbaudes](/manual/appendix/items/activepassive#active-checks) uz hosta,
Zabbix aģentam ir jābūt definētam hostname. Turklāt aģenta pusē iestatītajai hostname vērtībai precīzi jāsakrīt ar "[Host
name](/manual/config/hosts/host)", kas konfigurēts hostam lietotāja saskarnē.

Hostname vērtību aģenta pusē var definēt ar parametru **Hostname** vai **HostnameItem** aģenta [konfigurācijas
failā](/manual/appendix/config/zabbix_agentd_win) - vai arī tiek izmantotas noklusējuma vērtības, ja neviens no šiem parametriem nav norādīts.

Parametra **HostnameItem** noklusējuma vērtība ir vērtība, ko atgriež aģenta atslēga "system.hostname". Windows gadījumā tā atgriež gethostname() funkcijas rezultātu, kas vaicā nosaukumvietu nodrošinātājus, lai noteiktu lokālā hosta nosaukumu. Ja neviens nosaukumvietas nodrošinātājs neatbild, tiek atgriezts NetBIOS nosaukums.

Parametra **Hostname** noklusējuma vērtība ir vērtība, ko atgriež parametrs HostnameItem. Tātad, ja abi šie parametri nav norādīti, faktiskais hostname būs hosta NetBIOS nosaukums; Zabbix aģents izmantos NetBIOS hosta nosaukumu, lai no Zabbix serveris izgūtu aktīvo pārbaužu sarakstu un nosūtītu tam rezultātus.

Atslēga "system.hostname" atbalsta divus papildu parametrus - *type* un *transform*.

*Type* nosaka nosaukuma tipu, ko vienums atgriezīs:

-   *netbios* (noklusējums) - atgriež NetBIOS hosta nosaukumu, kas ir ierobežots līdz 15 simboliem un ir tikai UPPERCASE;
-   *host* - reģistrjutīgs, atgriež pilnu, īsto Windows hosta nosaukumu (bez domēna);
-   *shorthost* - atgriež hostname daļu pirms pirmā punkta.
    Tas atgriezīs pilnu virkni, ja nosaukumā nav punkta.
-   *fqdn* - atgriež Fully Qualified Domain Name (bez beigu punkta).

*Transform* ļauj norādīt papildu hostname transformācijas noteikumu:

-   *none* (noklusējums) - izmantot sākotnējo burtu reģistru;
-   *lower* - pārvērst tekstu mazajiem burtiem.

Tātad, lai vienkāršotu zabbix\_agentd.conf faila konfigurāciju un padarītu to vienotu, var izmantot trīs dažādas pieejas:

1.  Atstāt parametrus **Hostname** vai **HostnameItem** nedefinētus, un Zabbix aģents izmantos NetBIOS hosta nosaukumu kā hostname.
2.  Atstāt parametru **Hostname** nedefinētu un definēt **HostnameItem** šādi:<br>
    **HostnameItem=system.hostname\[host\]** - lai Zabbix aģents izmantotu pilnu, īsto (reģistrjutīgo) Windows hosta nosaukumu kā hostname.<br>
    **HostnameItem=system.hostname\[shorthost,lower\]** - lai Zabbix aģents izmantotu tikai hostname daļu pirms pirmā punkta, pārveidotu to mazajos burtos.<br>
    **HostnameItem=system.hostname\[fqdn\]** - lai Zabbix aģents izmantotu Fully Qualified Domain Name kā hostname.

Hosta nosaukums tiek izmantots arī kā daļa no Windows pakalpojuma nosaukuma, kas tiek izmantots Windows pakalpojuma instalēšanai, palaišanai, apturēšanai un atinstalēšanai. Piemēram, ja Zabbix aģenta konfigurācijas failā ir norādīts `Hostname=Windows_db_server`, tad aģents tiks instalēts kā Windows pakalpojums "`Zabbix Agent [Windows_db_server]`". Tāpēc, lai katram Zabbix aģenta instancei būtu atšķirīgs Windows pakalpojuma nosaukums, katrai instancei jāizmanto atšķirīgs hosta nosaukums.

[comment]: # ({/5f456a33-011f29f0})

[comment]: # ({0c3a3ff4-1c178c2a})
#### Aģenta instalēšana kā Windows pakalpojumu

Pirms aģenta instalēšanas manuāli nokopējiet `conf/zabbix_agentd.conf` uz 
direktoriju, kurā tiks instalēts zabbix_agentd.exe.

Lai instalētu vienu Zabbix aģenta instanci ar noklusējuma
konfigurācijas failu:

    zabbix_agentd.exe --install

::: noteimportant
64 bitu sistēmā ir nepieciešama 64 bitu Zabbix aģenta versija,
lai visas pārbaudes, kas saistītas ar palaistiem 64 bitu procesiem, darbotos
pareizi.
:::

Ja vēlaties izmantot konfigurācijas failu, kas nav noklusējuma fails, 
pakalpojuma instalēšanai jāizmanto šāda komanda:

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

Jānorāda pilns ceļš uz konfigurācijas failu.

Vairākas Zabbix aģenta instances var instalēt kā pakalpojumus šādi:

      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

Instalētajam pakalpojumam tagad jābūt redzamam vadības panelī.

[comment]: # ({/0c3a3ff4-1c178c2a})

[comment]: # ({635edc59-635edc59})
#### Aģenta palaišana

Lai palaistu aģenta servisu, varat izmantot vadības paneli vai izdarīt to no
komandrindas.

Lai palaistu vienu Zabbix aģenta instanci ar noklusējuma
konfigurācijas failu:

     zabbix_agentd.exe --start

Lai palaistu vienu Zabbix aģenta instanci ar citu konfigurācijas
failu:

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

Lai palaistu vienu no vairākām Zabbix aģenta instancēm:

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

[comment]: # ({/635edc59-635edc59})

[comment]: # ({f3f0d3db-f3f0d3db})
#### Aģenta apturēšana

Lai apturētu aģenta servisu, varat izmantot Vadības paneli vai izdarīt to no
komandrindas.

Lai apturētu vienu Zabbix aģenta instanci, kas palaista ar noklusējuma
konfigurācijas failu:

     zabbix_agentd.exe --stop

Lai apturētu vienu Zabbix aģenta instanci, kas palaista ar citu
konfigurācijas failu:

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

Lai apturētu vienu no vairākām Zabbix aģenta instancēm:

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

[comment]: # ({/f3f0d3db-f3f0d3db})

[comment]: # ({db2e6708-db2e6708})
#### Zabbix aģenta Windows servisa atinstalēšana

Lai atinstalētu vienu Zabbix aģenta instanci, izmantojot noklusējuma
konfigurācijas failu:

       zabbix_agentd.exe --uninstall

Lai atinstalētu vienu Zabbix aģenta instanci, izmantojot nenoklusējuma
konfigurācijas failu:

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

Lai atinstalētu vairākas Zabbix aģenta instances no Windows servisiem:

      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

[comment]: # ({/db2e6708-db2e6708})

[comment]: # ({dec5f8ea-b7b226d1})
#### Ierobežojumi

Zabbix aģents operētājsistēmai Windows neatbalsta
nestandarta Windows konfigurācijas, kurās CPU ir sadalīti
nevienmērīgi starp NUMA mezgliem. Ja loģiskie CPU ir sadalīti
nevienmērīgi, tad CPU veiktspējas metrikas dažiem CPU var nebūt
pieejamas. Piemēram, ja ir 72 loģiskie CPU un 2 NUMA mezgli,
abos mezglos jābūt pa 36 CPU katrā.

[comment]: # ({/dec5f8ea-b7b226d1})