### ### # 4 Update operations k # 5 Installation from containers # 5 Uzstādīšana no konteineriem ## AUTHOR Zabbix LLC ------------------------------------------------------------------------ [ ]{#index} ## AUTORS SIA Zabbix -------------------------------------------------- ---------------------- [ ]{#rādītājs} ## DESCRIPTION **zabbix\_agent2** is an application for monitoring parameters of various services.\ \ [ ]{#lbAE} ## APRAKSTS **zabbix\_aģents2** ir lietojumprogramma dažādu pakalpojumu parametru monitorēšanai.\ \ [ ]{#lbAE} ## DESCRIPTION **zabbix\_agentd** is a daemon for monitoring various server parameters. [ ]{#lbAE} ## APRAKSTS **zabbix\_agentd** ir dēmons dažādu servera parametru uzraudzībai. [ ]{#lbAE} #### Docker base images Zabbix components are provided on Ubuntu, Alpine Linux and CentOS base images: |Image|Version| |---|---| |[alpine](https://hub.docker.com/_/alpine/)|3.12| |[ubuntu](https://hub.docker.com/_/ubuntu/)|20.04 (focal)| |[centos](https://hub.docker.com/_/centos/)|8| All images are configured to rebuild latest images if base images are updated. #### Docker bāzes attēli Zabbix komponenti tiek nodrošināti uz Ubuntu, Alpine Linux un CentOS bāzes attēliem: |Attēls|Versija| |---|---| |[alpine](https://hub.docker.com/_/alpine/)|3.12| |[ubuntu](https://hub.docker.com/_/ubuntu/)|20.04 (fokālais)| |[centos](https://hub.docker.com/_/centos/)|8| Visi attēli ir konfigurēti tā, lai pārbūvētu jaunākos attēlus, ja bāzes attēli ir atjaunināti. #### Docker file sources Everyone can follow Docker file changes using the Zabbix [official repository](https://github.com/zabbix/zabbix-docker) on [github.com](https://github.com/). You can fork the project or make your own images based on official Docker files. #### Docker failu avoti Ikviens var sekot līdzi Docker failu izmaiņām, izmantojot Zabbix [oficiālo repozitoriju](https://github.com/zabbix/zabbix-docker), kurš atrodas [github.com](https://github.com/). Jūs varat atdalīties un izveidot jaunu projektu, vai arī izveidot savus attēlus, kas izveidoti uz oficiālo Docker failu bāzes. ### Docker Zabbix provides [Docker](https://www.docker.com) images for each Zabbix component as portable and self-sufficient containers to speed up deployment and update procedure. Zabbix components come with MySQL and PostgreSQL database support, Apache2 and Nginx web server support. These images are separated into different images. ### Konteineru tehnoloģija (Docker) Zabbix nodrošina [Docker](https://www.docker.com) attēlus katram Zabbix komponentam kā pārnesamus un pašpietiekamus konteinerus, lai paātrinātu izvietošanas un atjaunināšanas procedūru. Zabbix komponentiem ir MySQL un PostgreSQL datu bāžu atbalsts, kā arī Apache2 un Nginx tīmekļa servera atbalsts. Šie attēli ir sadalīti atšķirīgos attēlos. ## FILES */usr/local/etc/zabbix\_agent2.conf* Default location of Zabbix agent 2 configuration file (if not modified during compile time). [ ]{#lbAH} ## FAILI */usr/local/etc/zabbix\_agent2.conf* Zabbix aģenta 2 konfigurācijas faila noklusējuma atrašanās vieta (ja nav izmainīta kompilēšanas laikā). [ ]{#lbAH} ## NAME zabbix\_agent2 - Zabbix agent 2\ \ [ ]{#lbAC} ## NOSAUKUMS zabbix\_agent2 — Zabbix aģents 2\ \ [ ]{#lbAC} ## NAME zabbix\_agentd - Zabbix agent daemon [ ]{#lbAC} ## NOSAUKUMS zabbix\_agent2 — Zabbix aģents 2\ \ [ ]{#lbAC} ## OPTIONS **-c**, **--config** *config-file* Use the alternate *config-file* instead of the default one. **-f**, **--foreground** Run Zabbix agent in foreground. **-R**, **--runtime-control** *runtime-option* Perform administrative functions according to *runtime-option*. [ ]{#lbAF} ## IESPĒJAS **-c**, **--config** *config-file* Izmantojiet alternatīvo *config-file*, nevis noklusējuma failu. **-f**, **--priekšplāns** Palaidiet Zabbix aģentu priekšplānā. **-R**, **--runtime-control** *izpildlaika opcija* Veikt administratīvās funkcijas saskaņā ar *runtime-option*. [ ]{#lbAF} ## OPTIONS **-c**, **--config** *config-file* Use the alternate *config-file* instead of the default one. **-R**, **--runtime-control** *runtime-option* Perform administrative functions according to *runtime-option*. ## IESPĒJAS **-c**, **--konfig** *konfig-fails* Izmantojiet alternatīvo *konfig-failu*, nevis noklusējuma failu. **-R**, **--izpildlaika-kontrole** *izpildlaika-iespēja* Veic administratīvās funkcijas saskaņā ar *izpildlaika-iespēju*. #### Overview Update operations are available in actions with the following event sources: - *Triggers* - when problems are [updated](/manual/acknowledges#updating_problems) by other users, i.e. commented upon, acknowledged, severity has been changed, closed (manually); - *Services* - when the severity of a service has changed but the service is still not recovered. Both messages and remote commands are supported in update operations. While several operations can be added, escalation is not supported - all operations are assigned to a single step and therefore will be performed simultaneously. helo ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(8), **[zabbix\_js](zabbix_js)**(8), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(8), **[zabbix\_server](zabbix_server)**(8) [ ]{#lbAI} ## SKATĪT ARĪ Dokumentāciju <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(8), **[zabbix\_js](zabbix_js)**(8), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(8), **[zabbix\_server](zabbix_server)**(8) [ ]{#lbAI} # This topic does not exist yet. We are sorry, the page you are looking for cannot be found. Return to the homepage, try searching, or get [help](https://www.zabbix.com/support). # Šī tēma vēl nepastāv.bb Atvainojiet, lapa, kuru jūs meklējat, nav atrodama. Atgriezieties mājaslapā, mēģiniet meklēt vai saņemiet [palīdzību] (https://www.zabbix.com/support). # Zabbix manpages These are Zabbix manpages for Zabbix processes. # Zabbix rokasgrāmata Šī ir Zabbix procesu rokasgrāmata. ### ### # 4. Installation Please use the sidebar to access content in the Installation section. # 4. Uzstādīšana Lūdzu, izmantojiet sānjoslu, lai piekļūtu saturam sadaļā Instalēšana. # 5 Installation from containers # 5 Uzstādīšana no konteineriem ##### 7 Start up the daemons Run zabbix\_server on the server side. shell> zabbix_server ::: noteclassic Make sure that your system allows allocation of 36MB (or a bit more) of shared memory, otherwise the server may not start and you will see "Cannot allocate shared memory for <type of cache>." in the server log file. This may happen on FreeBSD, Solaris 8.\. ::: Run zabbix\_agentd on all the monitored machines. shell> zabbix_agentd ::: noteclassic Make sure that your system allows allocation of 2MB of shared memory, otherwise the agent may not start and you will see "Cannot allocate shared memory for collector." in the agent log file. This may happen on Solaris 8. ::: If you have installed Zabbix proxy, run zabbix\_proxy. shell> zabbix_proxy ##### 7 Start up the daemons Run zabbix\_server on the server side. shell> zabbix_server ::: noteclassic Make sure that your system allows allocation of 36MB (or a bit more) of shared memory, otherwise the server may not start and you will see "Cannot allocate shared memory for <type of cache>." in the server log file. This may happen on FreeBSD, Solaris 8.\ ::: Run zabbix\_agentd on all the monitored machines. shell> zabbix_agentd ::: noteclassic Make sure that your system allows allocation of 2MB of shared memory, otherwise the agent may not start and you will see "Cannot allocate shared memory for collector." in the agent log file. This may happen on Solaris 8. ::: If you have installed Zabbix proxy, run zabbix\_proxy. shell> zabbix_proxy ## AUTHOR Zabbix LLC ------------------------------------------------------------------------ [ ]{#index} ## AUTORS SIA Zabbix -------------------------------------------------- ---------------------- [ ]{#rādītājs} ##### Collapsed menu When the menu is collapsed to icons only, a full menu reappears as soon as the mouse cursor is placed upon it. Note that it reappears over page content; to move page content to the right you have to click on the expand button. If the mouse cursor again is placed outside the full menu, the menu will collapse again after two seconds. You can also make a collapsed menu reappear fully by hitting the Tab key. Hitting the Tab key repeatedly will allow to focus on the next menu element. ##### Collapsed menu When the menu is collapsed to icons only, a full menu reappears as soon as the mouse cursor is placed upon it. Note that it reappears over page content; to move page content to the right you have to click on the expand button. If the mouse cursor again is placed outside the full menu, the menu will collapse again after two seconds. You can also make a collapsed menu reappear fully by hitting the Tab key. Hitting the Tab key repeatedly will allow to focus on the next menu element. ## DESCRIPTION **zabbix\_agent2** is an application for monitoring parameters of various services.\ \ [ ]{#lbAE} ## APRAKSTS **zabbix\_aģents2** ir lietojumprogramma dažādu pakalpojumu parametru monitorēšanai.\ \ [ ]{#lbAE} ## DESCRIPTION **zabbix\_agentd** is a daemon for monitoring various server parameters. [ ]{#lbAE} ## APRAKSTS **zabbix\_agentd** ir dēmons dažādu servera parametru uzraudzībai. [ ]{#lbAE} #### Discovery actions The following conditions can be used in discovery-based events: |Condition type|Supported operators|Description| |--|--|------| |*Host IP*|equals<br>does not equal|Specify an IP address range or a range to exclude for a discovered host.<br>**equals** - host IP is in the range.<br>**does not equal** - host IP is not in the range.<br>It may have the following formats:<br>Single IP: 192.168.1.33<br>Range of IP addresses: 192.168.1-10.1-254<br>IP mask: 192.168.4.0/24<br>List: 192.168.1.1-254, 192.168.2.1-100, 192.168.2.200, 192.168.4.0/24<br>Support for spaces in the list format is provided since Zabbix 3.0.0.| |*Service type*|equals<br>does not equal|Specify a service type of a discovered service or a service type to exclude.<br>**equals** - matches the discovered service.<br>**does not equal** - does not match the discovered service.<br>Available service types: SSH, LDAP, SMTP, FTP, HTTP, HTTPS *(available since Zabbix 2.2 version)*, POP, NNTP, IMAP, TCP, Zabbix agent, SNMPv1 agent, SNMPv2 agent, SNMPv3 agent, ICMP ping, telnet *(available since Zabbix 2.2 version)*.| |*Service port*|equals<br>does not equal|Specify a TCP port range of a discovered service or a range to exclude.<br>**equals** - service port is in the range.<br>**does not equal** - service port is not in the range.| |*Discovery rule*|equals<br>does not equal|Specify a discovery rule or a discovery rule to exclude.<br>**equals** - using this discovery rule.<br>**does not equal** - using any other discovery rule, except this one.| |*Discovery check*|equals<br>does not equal|Specify a discovery check or a discovery check to exclude.<br>**equals** - using this discovery check.<br>**does not equal** - using any other discovery check, except this one.| |*Discovery object*|equals|Specify the discovered object.<br>**equals** - equal to discovered object (a device or a service).| |*Discovery status*|equals|**Up** - matches 'Host Up' and 'Service Up' events.<br>**Down** - matches 'Host Down' and 'Service Down' events.<br>**Discovered** - matches 'Host Discovered' and 'Service Discovered' events.<br>**Lost** - matches 'Host Lost' and 'Service Lost' events.| |*Uptime/Downtime*|is greater than or equals<br>is less than or equals|Uptime for 'Host Up' and 'Service Up' events. Downtime for 'Host Down' and 'Service Down' events.<br>**is greater than or equals** - is more or equal to. Parameter is given in seconds.<br>**is less than or equals** - is less or equal to. Parameter is given in seconds.| |*Received value*|equals<br>does not equal<br>is greater than or equals<br>is less than or equals<br>contains<br>does not contain|Specify the value received from an agent (Zabbix, SNMP) check in a discovery rule. String comparison. If several Zabbix agent or SNMP checks are configured for a rule, received values for each of them are checked (each check generates a new event which is matched against all conditions).<br>**equals** - equal to the value.<br>**does not equal** - not equal to the value.<br>**is greater than or equals** - more or equal to the value.<br>**is less than or equals** - less or equal to the value.<br>**contains** - contains the substring. Parameter is given as a string.<br>**does not contain** - does not contain the substring. Parameter is given as a string.| |*Proxy*|equals<br>does not equal|Specify a proxy or a proxy to exclude.<br>**equals** - using this proxy.<br>**does not equal** - using any other proxy except this one.| ::: noteclassic Service checks in a discovery rule, which result in discovery events, do not take place simultaneously. Therefore, if **multiple** values are configured for `Service type`, `Service port` or `Received value` conditions in the action, they will be compared to one discovery event at a time, but **not** to several events simultaneously. As a result, actions with multiple values for the same check types may not be executed correctly. ::: #### Discovery actions The following conditions can be used in discovery-based events: |Condition type|Supported operators|Description| |--|--|------| |*Host IP*|equals<br>does not equal|Specify an IP address range or a range to exclude for a discovered host.<br>**equals** - host IP is in the range.<br>**does not equal** - host IP is not in the range.<br>It may have the following formats:<br>Single IP: 192.168.1.33<br>Range of IP addresses: 192.168.1-10.1-254<br>IP mask: 192.168.4.0/24<br>List: 192.168.1.1-254, 192.168.2.1-100, 192.168.2.200, 192.168.4.0/24<br>Support for spaces in the list format is provided since Zabbix 3.0.0.| |*Service type*|equals<br>does not equal|Specify a service type of a discovered service or a service type to exclude.<br>**equals** - matches the discovered service.<br>**does not equal** - does not match the discovered service.<br>Available service types: SSH, LDAP, SMTP, FTP, HTTP, HTTPS *(available since Zabbix 2.2 version)*, POP, NNTP, IMAP, TCP, Zabbix agent, SNMPv1 agent, SNMPv2 agent, SNMPv3 agent, ICMP ping, telnet *(available since Zabbix 2.2 version)*.| |*Service port*|equals<br>does not equal|Specify a TCP port range of a discovered service or a range to exclude.<br>**equals** - service port is in the range.<br>**does not equal** - service port is not in the range.| |*Discovery rule*|equals<br>does not equal|Specify a discovery rule or a discovery rule to exclude.<br>**equals** - using this discovery rule.<br>**does not equal** - using any other discovery rule, except this one.| |*Discovery check*|equals<br>does not equal|Specify a discovery check or a discovery check to exclude.<br>**equals** - using this discovery check.<br>**does not equal** - using any other discovery check, except this one.| |*Discovery object*|equals|Specify the discovered object.<br>**equals** - equal to discovered object (a device or a service).| |*Discovery status*|equals|**Up** - matches 'Host Up' and 'Service Up' events<br>**Down** - matches 'Host Down' and 'Service Down' events<br>**Discovered** - matches 'Host Discovered' and 'Service Discovered' events<br>**Lost** - matches 'Host Lost' and 'Service Lost' events| |*Uptime/Downtime*|is greater than or equals<br>is less than or equals|Uptime for 'Host Up' and 'Service Up' events. Downtime for 'Host Down' and 'Service Down' events.<br>**is greater than or equals** - is more or equal to. Parameter is given in seconds.<br>**is less than or equals** - is less or equal to. Parameter is given in seconds.| |*Received value*|equals<br>does not equal<br>is greater than or equals<br>is less than or equals<br>contains<br>does not contain|Specify the value received from an agent (Zabbix, SNMP) check in a discovery rule. String comparison. If several Zabbix agent or SNMP checks are configured for a rule, received values for each of them are checked (each check generates a new event which is matched against all conditions).<br>**equals** - equal to the value.<br>**does not equal** - not equal to the value.<br>**is greater than or equals** - more or equal to the value.<br>**is less than or equals** - less or equal to the value.<br>**contains** - contains the substring. Parameter is given as a string.<br>**does not contain** - does not contain the substring. Parameter is given as a string.| |*Proxy*|equals<br>does not equal|Specify a proxy or a proxy to exclude.<br>**equals** - using this proxy.<br>**does not equal** - using any other proxy except this one.| ::: noteclassic Service checks in a discovery rule, which result in discovery events, do not take place simultaneously. Therefore, if **multiple** values are configured for `Service type`, `Service port` or `Received value` conditions in the action, they will be compared to one discovery event at a time, but **not** to several events simultaneously. As a result, actions with multiple values for the same check types may not be executed correctly. ::: ##### Discovery of disabled systemd units Since Zabbix 6.0.1 it is also possible to discover **disabled** systemd units. In this case three macros are returned in the resulting JSON: - {#UNIT.PATH} - {#UNIT.ACTIVESTATE} - {#UNIT.UNITFILESTATE}. ::: noteimportant To have items and triggers created from prototypes for disabled systemd units, make sure to adjust (or remove) prohibiting LLD filters for {#UNIT.ACTIVESTATE} and {#UNIT.UNITFILESTATE}. ::: ##### Discovery of disabled systemd units Since Zabbix 6.0.1 it is also possible to discover **disabled** systemd units. In this case three macros are returned in the resulting JSON: - {#UNIT.PATH} - {#UNIT.ACTIVESTATE} - {#UNIT.UNITFILESTATE}. ::: noteimportant To have items and triggers created from prototypes for disabled systemd units, make sure to adjust (or remove) prohibiting LLD filters for {#UNIT.ACTIVESTATE} and {#UNIT.UNITFILESTATE}. ::: ## FILES */usr/local/etc/zabbix\_agent2.conf* Default location of Zabbix agent 2 configuration file (if not modified during compile time). [ ]{#lbAH} ## FAILI */usr/local/etc/zabbix\_agent2.conf* Zabbix aģenta 2 konfigurācijas faila noklusējuma atrašanās vieta (ja nav izmainīta kompilēšanas laikā). [ ]{#lbAH} ##### Hidden menu Even when the menu is hidden completely, a full menu is just one mouse click away, by clicking on the burger icon. Note that it reappears over page content; to move page content to the right you have to unhide the menu by clicking on the show sidebar button. ##### Hidden menu Even when the menu is hidden completely, a full menu is just one mouse click away, by clicking on the burger icon. Note that it reappears over page content; to move page content to the right you have to unhide the menu by clicking on the show sidebar button. #### Installing locales To list all installed languages, run: locale -a If some languages that are needed are not listed, open the */etc/locale.gen* file and uncomment the required locales. Since Zabbix uses UTF-8 encoding, you need to select locales with UTF-8 charset. Now run: locale-gen Restart the web server. The locales should now be installed. It may be required to reload Zabbix frontend page in browser using Ctrl + F5 for new languages to appear. #### Installing locales To list all installed languages, run: locale -a If some languages that are needed are not listed, open the */etc/locale.gen* file and uncomment the required locales. Since Zabbix uses UTF-8 encoding, you need to select locales with UTF-8 charset. Now, run: locale-gen Restart the web server. The locales should now be installed. It may be required to reload Zabbix frontend page in browser using Ctrl + F5 for new languages to appear. #### Internal event actions The following conditions can be set for actions based on internal events: |Condition type|Supported operators|Description| |--|--|------| |*Event type*|equals|**Item in "not supported" state** - matches events where an item goes from a 'normal' to 'not supported' state.<br>**Low-level discovery rule in "not supported" state** - matches events where a low-level discovery rule goes from a 'normal' to 'not supported' state.<br>**Trigger in "unknown" state** - matches events where a trigger goes from a 'normal' to 'unknown' state.| |*Host group*|equals<br>does not equal|Specify host groups or host groups to exclude.<br>**equals** - event belongs to this host group.<br>**does not equal** - event does not belong to this host group.| |*Tag name*|equals<br>does not equal<br>contains<br>does not contain|Specify event tag or event tag to exclude.<br>**equals** - event has this tag.<br>**does not equal** - event does not have this tag.<br>**contains** - event has a tag containing this string.<br>**does not contain** - event does not have a tag containing this string.| |*Tag value*|equals<br>does not equal<br>contains<br>does not contain|Specify event tag and value combination or tag and value combination to exclude.<br>**equals** - event has this tag and value.<br>**does not equal** - event does not have this tag and value.<br>**contains** - event has a tag and value containing these strings.<br>**does not contain** - event does not have a tag and value containing these strings.| |*Template*|equals<br>does not equal|Specify templates or templates to exclude.<br>**equals** - event belongs to an item/trigger/low-level discovery rule inherited from this template.<br>**does not equal** - event does not belong to an item/trigger/low-level discovery rule inherited from this template.| |*Host*|equals<br>does not equal|Specify hosts or hosts to exclude.<br>**equals** - event belongs to this host.<br>**does not equal** - event does not belong to this host.| #### Internal event actions The following conditions can be set for actions based on internal events: |Condition type|Supported operators|Description| |--|--|------| |*Event type*|equals|**Item in "not supported" state** - matches events where an item goes from a 'normal' to 'not supported' state<br>**Low-level discovery rule in "not supported" state** - matches events where a low-level discovery rule goes from a 'normal' to 'not supported' state<br>**Trigger in "unknown" state** - matches events where a trigger goes from a 'normal' to 'unknown' state| |*Host group*|equals<br>does not equal|Specify host groups or host groups to exclude.<br>**equals** - event belongs to this host group.<br>**does not equal** - event does not belong to this host group.| |*Tag name*|equals<br>does not equal<br>contains<br>does not contain|Specify event tag or event tag to exclude.<br>**equals** - event has this tag<br>**does not equal** - event does not have this tag<br>**contains** - event has a tag containing this string<br>**does not contain** - event does not have a tag containing this string| |*Tag value*|equals<br>does not equal<br>contains<br>does not contain|Specify event tag and value combination or tag and value combination to exclude.<br>**equals** - event has this tag and value<br>**does not equal** - event does not have this tag and value<br>**contains** - event has a tag and value containing these strings<br>**does not contain** - event does not have a tag and value containing these strings| |*Template*|equals<br>does not equal|Specify templates or templates to exclude.<br>**equals** - event belongs to an item/trigger/low-level discovery rule inherited from this template.<br>**does not equal** - event does not belong to an item/trigger/low-level discovery rule inherited from this template.| |*Host*|equals<br>does not equal|Specify hosts or hosts to exclude.<br>**equals** - event belongs to this host.<br>**does not equal** - event does not belong to this host.| ##### Mass editing options Buttons below the list offer some mass-editing options: - *Enable* - change trigger status to *Enabled*. - *Disable* - change trigger status to *Disabled*. - *Copy* - copy the triggers to other hosts or templates. - *Mass update* - update several properties for a number of triggers at once. - *Delete* - delete the triggers. To use these options, mark the checkboxes before the respective triggers, then click on the required button. ##### Mass editing options Buttons below the list offer some mass-editing options: - *Enable* - change trigger status to *Enabled* - *Disable* - change trigger status to *Disabled* - *Copy* - copy the triggers to other hosts or templates - *Mass update* - update several properties for a number of triggers at once - *Delete* - delete the triggers To use these options, mark the checkboxes before the respective triggers, then click on the required button. ## NAME zabbix\_agent2 - Zabbix agent 2\ \ [ ]{#lbAC} ## NOSAUKUMS zabbix\_agent2 — Zabbix aģents 2\ \ [ ]{#lbAC} ## NAME zabbix\_agentd - Zabbix agent daemon [ ]{#lbAC} ## NOSAUKUMS zabbix\_agent2 — Zabbix aģents 2\ \ [ ]{#lbAC} ## OPTIONS **-c**, **--config** *config-file* Use the alternate *config-file* instead of the default one. **-f**, **--foreground** Run Zabbix agent in foreground. **-R**, **--runtime-control** *runtime-option* Perform administrative functions according to *runtime-option*. [ ]{#lbAF} ## IESPĒJAS **-c**, **--config** *config-file* Izmantojiet alternatīvo *config-file*, nevis noklusējuma failu. **-f**, **--priekšplāns** Palaidiet Zabbix aģentu priekšplānā. **-R**, **--runtime-control** *izpildlaika opcija* Veikt administratīvās funkcijas saskaņā ar *runtime-option*. [ ]{#lbAF} ## OPTIONS **-c**, **--config** *config-file* Use the alternate *config-file* instead of the default one. **-R**, **--runtime-control** *runtime-option* Perform administrative functions according to *runtime-option*. ## IESPĒJAS **-c**, **--konfig** *konfig-fails* Izmantojiet alternatīvo *konfig-failu*, nevis noklusējuma failu. **-R**, **--izpildlaika-kontrole** *izpildlaika-iespēja* Veic administratīvās funkcijas saskaņā ar *izpildlaika-iespēju*. #### Options |Parameter|Description| |---------|-----------| |-V --version|Print the plugin version and license information.| |-h --help|Print help information (shorthand).| #### Options |Parameter|Description| |---------|-----------| |-V --version|Print the plugin version and license information.| |-h --help|Print help information (shorthand).| #### Overview With escalations you can create custom scenarios for sending notifications or executing remote commands. In practical terms it means that: - Users can be informed about new problems immediately. - Notifications can be repeated until the problem is resolved. - Sending a notification can be delayed. - Notifications can be escalated to another "higher" user group. - Remote commands can be executed immediately or when a problem is not resolved for a lengthy period. Actions are escalated based on the **escalation step**. Each step has a duration in time. You can define both the default duration and a custom duration of an individual step. The minimum duration of one escalation step is 60 seconds. You can start actions, such as sending notifications or executing commands, from any step. Step one is for immediate actions. If you want to delay an action, you can assign it to a later step. For each step, several actions can be defined. The number of escalation steps is not limited. Escalations are defined when [configuring an operation](operation#configuring_an_operation). Escalations are supported for problem operations only, not recovery. #### Overview With escalations you can create custom scenarios for sending notifications or executing remote commands. In practical terms it means that: - Users can be informed about new problems immediately - Notifications can be repeated until the problem is resolved - Sending a notification can be delayed - Notifications can be escalated to another "higher" user group - Remote commands can be executed immediately or when a problem is not resolved for a lengthy period Actions are escalated based on the **escalation step**. Each step has a duration in time. You can define both the default duration and a custom duration of an individual step. The minimum duration of one escalation step is 60 seconds. You can start actions, such as sending notifications or executing commands, from any step. Step one is for immediate actions. If you want to delay an action, you can assign it to a later step. For each step, several actions can be defined. The number of escalation steps is not limited. Escalations are defined when [configuring an operation](operation#configuring_an_operation). Escalations are supported for problem operations only, not recovery. ### Parameters `(object/array)` Items to create. Additionally to the [standard item properties](object#host), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |preprocessing|array|Item [preprocessing](/manual/api/reference/item/object#item_preprocessing) options.| |tags|array|Item [tags](/manual/api/reference/item/object#item_tag).| ### Parameters `(object/array)` Items to create. Additionally to the [standard item properties](object#host), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |preprocessing|array|Item [preprocessing](/manual/api/reference/item/object#item_preprocessing) options.| |tags|array|Item [tags.](/manual/api/reference/item/object#item_tag)| ### Parameters `(object/array)` Web scenario properties to be updated. The `httptestid` property must be defined for each web scenario, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. Additionally to the [standard web scenario properties](object#web_scenario), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |steps|array|Scenario [steps](/manual/api/reference/httptest/object#scenario_step) to replace existing steps.| |tags|array|Web scenario [tags](/manual/api/reference/httptest/object#web_scenario_tag).| ### Parameters `(object/array)` Web scenario properties to be updated. The `httptestid` property must be defined for each web scenario, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. Additionally to the [standard web scenario properties](object#web_scenario), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |steps|array|Scenario [steps](/manual/api/reference/httptest/object#scenario_step) to replace existing steps.| |tags|array|Web scenario [tags.](/manual/api/reference/httptest/object#web_scenario_tag)| # Plugins # Plugins #### Possible deadlocks with MySQL/MariaDB When running under high load, and with more than one LLD worker involved, it is possible to run into a deadlock caused by an InnoDB error related to the row-locking strategy (see [upstream bug](https://github.com/mysql/mysql-server/commit/7037a0bdc83196755a3bf3e935cfb3c0127715d5)). The error has been fixed in MySQL since 8.0.29, but not in MariaDB. For more details, see [ZBX-21506](https://support.zabbix.com/browse/ZBX-21506). #### Possible deadlocks with MySQL/MariaDB When running under high load, and with more than one LLD worker involved, it is possible to run into a deadlock caused by an InnoDB error related to the row-locking strategy (see [upstream bug](https://github.com/mysql/mysql-server/commit/7037a0bdc83196755a3bf3e935cfb3c0127715d5)). The error has been fixed in MySQL since 8.0.29, but not in MariaDB. For more details, see [ZBX-21506](https://support.zabbix.com/browse/ZBX-21506). ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(8), **[zabbix\_js](zabbix_js)**(8), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(8), **[zabbix\_server](zabbix_server)**(8) [ ]{#lbAI} ## SKATĪT ARĪ Dokumentāciju <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(8), **[zabbix\_js](zabbix_js)**(8), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(8), **[zabbix\_server](zabbix_server)**(8) [ ]{#lbAI} #### SSH checks - Some Linux distributions like Debian, Ubuntu do not support encrypted private keys (with passphrase) if the libssh2 library is installed from packages. Please see [ZBX-4850](https://support.zabbix.com/browse/ZBX-4850) for more details. - When using libssh 0.9.x on some Linux distributions with OpenSSH 8, SSH checks may occasionally report "Cannot read data from SSH server". This is caused by a libssh [issue](https://gitlab.com/libssh/libssh-mirror/-/merge_requests/101) ([more detailed report](https://bugs.libssh.org/T231)). The error is expected to have been fixed by a stable libssh 0.9.5 release. See also [ZBX-17756](https://support.zabbix.com/browse/ZBX-17756) for details. - Using the pipe "|" in the SSH script may lead to a "Cannot read data from SSH server" error. In this case it is recommended to upgrade the libssh library version. See also [ZBX-21337](https://support.zabbix.com/browse/ZBX-21337) for details. #### SSH checks - Some Linux distributions like Debian, Ubuntu do not support encrypted private keys (with passphrase) if the libssh2 library is installed from packages. Please see [ZBX-4850](https://support.zabbix.com/browse/ZBX-4850) for more details. - When using libssh 0.9.x on some Linux distributions with OpenSSH 8 SSH checks may occasionally report "Cannot read data from SSH server". This is caused by a libssh [issue](https://gitlab.com/libssh/libssh-mirror/-/merge_requests/101) ([more detailed report](https://bugs.libssh.org/T231)). The error is expected to have been fixed by a stable libssh 0.9.5 release. See also [ZBX-17756](https://support.zabbix.com/browse/ZBX-17756) for details. - Using the pipe "|" in the SSH script may lead to a "Cannot read data from SSH server" error. In this case it is recommended to upgrade the libssh library version. See also [ZBX-21337](https://support.zabbix.com/browse/ZBX-21337) for details. ##### Starting Zabbix server as cluster node Two parameters are required in the server [configuration](/manual/appendix/config/zabbix_server) to start a Zabbix server as cluster node: - **HANodeName** parameter must be specified for each Zabbix server that will be an HA cluster node. This is a unique node identifier (e.g. `zabbix-node-01`) that the server will be referred to in agent and proxy configurations. If you do not specify HANodeName, then the server will be started in standalone mode. - **NodeAddress** parameter must be specified for each node. The NodeAddress parameter (address:port) will be used by Zabbix frontend to connect to the active server node. NodeAddress must match the IP or FQDN name of the respective Zabbix server. Restart all Zabbix servers after making changes to the configuration files. They will now be started as cluster nodes. The new status of the servers can be seen in *Reports* → *[System information](/manual/web_interface/frontend_sections/reports/status_of_zabbix#status_of_ha_cluster_nodes)* and also by running: ``` zabbix_server -R ha_status ``` This runtime command will log the current HA cluster status into the Zabbix server log (and to stdout): {width="600"} ##### Starting Zabbix server as cluster node Two parameters are required in the server [configuration](/manual/appendix/config/zabbix_server) to start a Zabbix server as cluster node: - **HANodeName** parameter must be specified for each Zabbix server that will be an HA cluster node. This is a unique node identifier (e.g. `zabbix-node-01`) that the server will be referred to in agent and proxy configurations. If you do not specify HANodeName, then the server will be started in standalone mode. - **NodeAddress** parameter must be specified for each node. The NodeAddress parameter (address:port) will be used by Zabbix frontend to connect to the active server node. NodeAddress must match the IP or FQDN name of the respective Zabbix server. Restart all Zabbix servers after making changes to the configuration files. They will now be started as cluster nodes. The new status of the servers can be seen in *Reports* → *[System information](/manual/web_interface/frontend_sections/reports/status_of_zabbix#status_of_ha_cluster_nodes)* and also by running: ``` zabbix_server -R ha_status ``` This runtime command will log the current HA cluster status into the Zabbix server log (and to stdout): {width="600"} ## SYNOPSIS **zabbix\_agent2** \[**-c** *config-file*\]\ **zabbix\_agent2** \[**-c** *config-file*\] **-p**\ **zabbix\_agent2** \[**-c** *config-file*\] **-t** *item-key*\ **zabbix\_agent2** \[**-c** *config-file*\] **-R** *runtime-option*\ **zabbix\_agent2 -h**\ **zabbix\_agent2 -V**\ \ [ ]{#lbAD} ## KONTEKSTS **zabbix\_aģents2** \[**-c** *konfig-fails*\]\ **zabbix\_aģents2** \[**-c** *konfig-fails*\] **-p**\ **zabbix\_aģents2** \[**-c** *konfig-fails*\] **-t** *vienuma-atslēga*\ **zabbix\_aģents2** \[**-c** *konfig-fails*\] **-R** *izpildlaika-iespēja*\ **zabbix\_aģents2 -h**\ **zabbix\_aģents2 -V**\ \ [ ]{#lbAD} # This topic does not exist yet. We are sorry, the page you are looking for cannot be found. Return to the homepage, try searching, or get [help](https://www.zabbix.com/support). # Šī tēma vēl nepastāv. Atvainojiet, lapa, kuru jūs meklējat, nav atrodama. Atgriezieties mājaslapā, mēģiniet meklēt vai saņemiet [palīdzību] (https://www.zabbix.com/support). ##### Time shift An optional time shift is supported with time or value count as the function parameter. This parameter allows to reference data from a period of time in the past. Time shift starts with `now` - specifying the current time, and is followed by `+N<time unit>` or `-N<time unit>` - to add or subtract N time units. For example, `avg(/host/key,1h:now-1d)` will return the average value for an hour one day ago. ::: noteimportant Time shift specified in months (M) and years (y) is only supported for [trend functions](/manual/appendix/functions/trends). Other functions support seconds (s), minutes (m), hours (h), days (d), and weeks (w). ::: **Time shift with absolute time periods** Absolute time periods are supported in the time shift parameter, for example, midnight to midnight for a day, Monday-Sunday for a week, first day-last day of the month for a month. Time shift for absolute time periods starts with `now` - specifying the current time, and is followed by any number of time operations: `/<time unit>` - defines the beginning and end of the time unit, for example, midnight to midnight for a day, `+N<time unit>` or `-N<time unit>` - to add or subtract N time units. Please note that the value of time shift can be greater or equal to 0, while the time period minimum value is 1. |Parameter|Description| |--|--------| |1d:now/d|Yesterday| |1d:now/d+1d|Today| |2d:now/d+1d|Last 2 days| |1w:now/w|Last week| |1w:now/w+1w|This week| ##### Time shift An optional time shift is supported with time or value count as the function parameter. This parameter allows to reference data from a period of time in the past. Time shift starts with `now` - specifying the current time, and is followed by `+N<time unit>` or `-N<time unit>` - to add or subtract N time units. For example, `avg(/host/key,1h:now-1d)` will return the average value for an hour one day ago. ::: noteimportant Time shift specified in months (M) and years (y) is only supported for [trend functions](/manual/appendix/functions/trends). Other functions support seconds (s), minutes (m), hours (h), days (d), and weeks (w). ::: **Time shift with absolute time periods** Absolute time periods are supported in the time shift parameter, for example, midnight to midnight for a day, Monday-Sunday for a week, first day-last day of the month for a month. Time shift for absolute time periods starts with `now` - specifying the current time, and is followed by any number of time operations: `/<time unit>` - defines the beginning and end of the time unit, for example, midnight to midnight for a day, `+N<time unit>` or `-N<time unit>` - to add or subtract N time units. Please note that the value of time shift can be greater or equal to 0, while the time period minimum value is 1. |Parameter|Description| |--|--------| |1d:now/d|Yesterday| |1d:now/d+1d|Today| |2d:now/d+1d|Last 2 days| |1w:now/w|Last week| |1w:now/w+1w|This week| # Zabbix manpages These are Zabbix manpages for Zabbix processes. # Zabbix rokasgrāmata Šī ir Zabbix procesu rokasgrāmata. ### ### # 10 Cookies used by Zabbix # 10 Zabbix izmantotās sīkdatnes # 10 Discovery of Windows performance counter instances # 10 Windows veiktspējas skaitītāju instanču atklāšana # 10 Graph (classic) # 10 Grafiks (klasiskais) # 10 Graph (classic) # 10 Grafiks (klasiskais) # 10 Inclusion # 10 Iekļaušana # 10 IPMI agent # 10 IPMI aģents # 10 Notifications upon events # 10 Paziņojumi par notikumiem # 10 Oracle plugin # 10 Oracle spraudnis # 10 proc.get parameters # 10 proc.get parametri # 10 Template changes This page lists all changes to the stock templates that are shipped with Zabbix. Upgrading to the latest Zabbix version will not automatically upgrade the templates used. It is suggested to modify the templates in existing installations by downloading the latest templates from the [Zabbix Git repository](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates) and [importing](/manual/xml_export_import/templates#importing) them manually into Zabbix. If templates with the same names already exist, the *Delete missing* options should be checked when importing to achieve a clean import. This way, the old items that are no longer in the updated template will be removed (note that it will mean losing history of these old items). ::: noteclassic Please be informed that since Zabbix 6.0, all templates follow an updated format, which may impact the import of pre-6.0 templates. For more information, see [Template changes in 6.0](https://www.zabbix.com/documentation/6.0/en/manual/installation/template_changes#updated-template-format). ::: # 10 Veidņu izmaiņas Šajā lapā ir uzskaitītas visas izmaiņas standarta veidnēs, kas tiek piegādātas kopā ar Zabbix. Jaunināšana uz jaunāko Zabbix versiju automātiski neatjauninās izmantotās veidnes. Ieteicams modificēt veidnes esošajās instalācijās, lejupielādējot jaunākās veidnes no [Zabbix Git repozitorija](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates) un manuāli tās [importējot](/manual/xml_export_import/templates#importing) Zabbix. Ja jau pastāv veidnes ar tādiem pašiem nosaukumiem, importēšanas laikā jāatzīmē opcija *Delete missing*, lai nodrošinātu tīru importu. Tādējādi vecie vienumi, kas vairs nav atjauninātajā veidnē, tiks noņemti (ņemiet vērā, ka tas nozīmēs šo veco vienumu vēstures zudumu). ::: noteclassic Lūdzu, ņemiet vērā, ka kopš Zabbix 6.0 visas veidnes izmanto atjauninātu formātu, kas var ietekmēt pirms 6.0 veidņu importēšanu. Plašāku informāciju skatiet sadaļā [Veidņu izmaiņas 6.0 versijā](https://www.zabbix.com/documentation/6.0/en/manual/installation/template_changes#updated-template-format). ::: # 10 Value cache # 10 Vērtību kešatmiņa # 10 Version compatibility # 10 Versiju saderība # 10 Virtual machine monitoring # 10 Virtuālās mašīnas uzraudzība # 10 What's new in Zabbix 7.0.5 See [breaking changes](/manual/installation/upgrade_notes_705#breaking-changes) for this version. # 10 Kas jauns Zabbix 7.0.5 Skatiet [nesaderīgās izmaiņas](/manual/installation/upgrade_notes_705#breaking-changes) šajā versijā. # 10 Zabbix agent on Microsoft Windows # 10 Zabbix aģents uz Microsoft Windows # 11 Discovery using WMI queries # 11 Atklāšana, izmantojot WMI vaicājumus # 11 Execute now # 11 Izpildīt tagad # 11 Graph prototype # 11 Grafika prototips # 11 Graph prototype # 11 Grafika prototips # 11 Macros # 11 Makrosi # 11 Maintenance # 11 Apkope # 11 PostgreSQL plugin # 11 PostgreSQL spraudnis # 11 SAML setup with Microsoft Entra ID # 11 SAML iestatīšana ar Microsoft Entra ID # 11 SSH agent # 11 SSH aģents # 11 Time zones # 11 Laika joslas # 11 Unreachable/unavailable host interface settings # 11 Nesasniedzama/nepieejama hosta saskarnes iestatījumi # 11 Upgrade notes for 7.0.0 These notes are for upgrading from Zabbix 6.4.x to Zabbix 7.0.0. All notes are grouped into: - **Breaking changes** - changes that may break existing installations and other critical information related to the upgrade process - **Other** - all remaining information describing the changes in Zabbix functionality See also: - [Upgrade procedure](/manual/installation/upgrade) for all relevant information about upgrading from versions before Zabbix 6.4.0; - [Upgrading HA cluster](/manual/concepts/server/ha#upgrading-ha-cluster) for instructions on upgrading servers in a **high-availability** (HA) cluster. # 11 Atjaunināšanas piezīmes 7.0.0 versijai Šīs piezīmes attiecas uz atjaunināšanu no Zabbix 6.4.x uz Zabbix 7.0.0. Visas piezīmes ir sagrupētas šādi: - **Pārtraucošas izmaiņas** - izmaiņas, kas var pārtraukt esošo instalāciju darbību, un cita būtiska informācija, kas saistīta ar atjaunināšanas procesu - **Cits** - visa pārējā informācija, kas apraksta izmaiņas Zabbix funkcionalitātē Skatiet arī: - [Atjaunināšanas procedūra](/manual/installation/upgrade) visai būtiskajai informācijai par atjaunināšanu no versijām, kas ir vecākas par Zabbix 6.4.0; - [HA klastera atjaunināšana](/manual/concepts/server/ha#upgrading-ha-cluster) instrukcijām par serveru atjaunināšanu **augstas pieejamības** (HA) klasterī. # 11 What's new in Zabbix 7.0.6 # 11 Kas jauns Zabbix 7.0.6 versijā # 11 Zabbix sender dynamic link library for Windows #### Overview In a Windows environment applications can send data to Zabbix server/proxy by using the Zabbix sender dynamic link library (zabbix\_sender.dll) instead of having to launch an external process (zabbix\_sender.exe). zabbix_sender.h and zabbix_sender.lib are required for compiling user applications with zabbix_sender.dll. #### Getting it There are two ways of getting zabbix_sender.dll. **1.** [Download](https://www.zabbix.com/download_agents) zabbix_sender.h, zabbix_sender.lib and zabbix_sender.dll files as a ZIP archive. When choosing download options make sure to select "No encryption" under *Encryption* and "Archive" under *Packaging*. Then download Zabbix agent (not Zabbix agent 2). The zabbix_sender.h, zabbix_sender.lib and zabbix_sender.dll files will be inside the downloaded ZIP archive in the `bin\dev` directory. Unzip the files where you need it. **2.** Build zabbix_sender.dll from source (see [instructions](/manual/installation/install/win_agent#overview)). The dynamic link library with the development files will be located in the `bin\winXX\dev` directory. To use it, include the zabbix_sender.h header file and link with the zabbix_sender.lib library. #### See also - [example](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/build/win32/examples/zabbix_sender/sender.c) of a simple Zabbix sender utility implemented with Zabbix sender dynamic link library to illustrate the library usage; - [zabbix_sender.h](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/zabbix_sender/win32/zabbix_sender.h) file for the interface functions of the Zabbix sender dynamic link library. This file contains documentation explaining the purpose of each interface function, its arguments, and return value. # 11 Zabbix sender dinamisko saišu bibliotēka operētājsistēmai Windows #### Pārskats Windows vidē lietojumprogrammas var sūtīt datus uz Zabbix serveri/starpniekserveri, izmantojot Zabbix sender dinamisko saišu bibliotēku (zabbix\_sender.dll), nevis palaižot ārēju procesu (zabbix\_sender.exe). Lai kompilētu lietotāju lietojumprogrammas ar zabbix_sender.dll, ir nepieciešami zabbix_sender.h un zabbix_sender.lib. #### Iegūšana Ir divi veidi, kā iegūt zabbix_sender.dll. **1.** [Lejupielādējiet](https://www.zabbix.com/download_agents) failus zabbix_sender.h, zabbix_sender.lib un zabbix_sender.dll ZIP arhīva veidā. Izvēloties lejupielādes opcijas, pārliecinieties, ka sadaļā *Encryption* ir atlasīts "No encryption" un sadaļā *Packaging* ir atlasīts "Archive". Pēc tam lejupielādējiet Zabbix aģentu (nevis Zabbix aģentu 2). Faili zabbix_sender.h, zabbix_sender.lib un zabbix_sender.dll atradīsies lejupielādētajā ZIP arhīvā direktorijā `bin\dev`. Izpakojiet failus vajadzīgajā vietā. **2.** Veidojiet zabbix_sender.dll no pirmkoda (skatiet [norādījumus](/manual/installation/install/win_agent#overview)). Dinamisko saišu bibliotēka kopā ar izstrādes failiem atradīsies direktorijā `bin\winXX\dev`. Lai to izmantotu, iekļaujiet galvenes failu zabbix_sender.h un sasaistiet ar bibliotēku zabbix_sender.lib. #### Skatiet arī - vienkāršas Zabbix sender utilītas [piemērs](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/build/win32/examples/zabbix_sender/sender.c), kas ieviesta, izmantojot Zabbix sender dinamisko saišu bibliotēku, lai ilustrētu bibliotēkas lietošanu; - fails [zabbix_sender.h](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/zabbix_sender/win32/zabbix_sender.h) Zabbix sender dinamisko saišu bibliotēkas saskarnes funkcijām. Šajā failā ir dokumentācija, kas izskaidro katras saskarnes funkcijas mērķi, tās argumentus un atgriezto vērtību. # 12 Discovery using ODBC SQL queries # 12 Atklāšana, izmantojot ODBC SQL vaicājumus # 12 Honeycomb # 12 Honeycomb # 12 Honeycomb # 12 Honeycomb # 12 Redis plugin # 12 Redis spraudnis # 12 Regular expressions # 12 Regulārās izteiksmes # 12 Remote monitoring of Zabbix stats # 12 Attālināta Zabbix statistikas uzraudzība # 12 Resetting password # 12 Paroles atiestatīšana # 12 Restricting agent checks # 12 Aģenta pārbaužu ierobežošana # 12 SAML setup with Okta This section provides guidelines for configuring [Okta](https://okta.com) to enable SAML 2.0 authentication and user provisioning for Zabbix. # 12 SAML iestatīšana ar Okta Šī sadaļa sniedz norādījumus par [Okta](https://okta.com) konfigurēšanu, lai iespējotu SAML 2.0 autentifikāciju un lietotāju nodrošināšanu Zabbix. # 12 Service monitoring upgrade # 12 Pakalpojumu uzraudzības jaunināšana # 12 Telnet agent # 12 Telnet aģents # 12 Upgrade notes for 7.0.1 # 12 Atjaunināšanas piezīmes par 7.0.1 # 12 Users and user groups # 12 Lietotāji un lietotāju grupas # 12 What's new in Zabbix 7.0.7 # 12 Kas jauns Zabbix 7.0.7 versijā # 13 Configuring Kerberos with Zabbix # 13 Kerberos konfigurēšana ar Zabbix # 13 Discovery using Prometheus data # 13 Atklāšana, izmantojot Prometheus datus # 13 Host availability # 13 Hosts pieejamība # 13 Host availability # 13 Hosts pieejamība # 13 JMX agent # 13 JMX aģents # 13 Other issues # 13 Citas problēmas # 13 Problem acknowledgment # 13 Problēmas apstiprināšana # 13 SAML setup with OneLogin # 13 SAML iestatīšana ar OneLogin # 13 SMART plugin # 13 SMART spraudnis # 13 Storage of secrets # 13 Slepeno datu glabāšana # 13 Time period selector # 13 Laika perioda atlasītājs # 13 Upgrade notes for 7.0.2 # 13 Atjaunināšanas piezīmes par 7.0.2 # 13 What's new in Zabbix 7.0.8 # 13 Kas jauns Zabbix 7.0.8 versijā # 14 Agent vs agent 2 comparison This section describes the differences between the Zabbix agent and the Zabbix agent 2. |Parameter|Zabbix agent|Zabbix agent 2| |--|------|------| |Programming language|C|Go with some parts in C| |Daemonization|yes|by systemd only (yes on Windows)| |Supported extensions|Custom [loadable modules](/manual/extensions/loadablemodules) in C.|Custom [plugins](/manual/extensions/plugins) in Go.| |*Requirements*|<|<| |Supported platforms|Linux, IBM AIX, FreeBSD, NetBSD, OpenBSD, HP-UX, Mac OS X, Solaris: 9, 10, 11, Windows: all desktop and server versions since XP|Linux, Windows: all desktop and server versions, on which a [supported Go version](/manual/installation/requirements#agent-2) can be installed.| |Supported crypto libraries|GnuTLS 3.1.18 and newer<br>OpenSSL 1.0.1, 1.0.2, 1.1.0, 1.1.1, 3.0.x<br>LibreSSL - tested with versions 2.7.4, 2.8.2 (certain limitations apply, see the [Encryption](/manual/encryption#compiling-zabbix-with-encryption-support) page for details).|Linux: OpenSSL 1.0.1 and later.<br>MS Windows: OpenSSL 1.1.1 or later.<br>The OpenSSL library must have PSK support enabled. LibreSSL is not supported.| |*Monitoring processes*|<|<| |Processes|A separate active check process for each server/proxy record.|Single process with automatically created threads.<br>The maximum number of threads is determined by the GOMAXPROCS environment variable.| |Metrics|**UNIX**: see a list of supported [items](/manual/config/items/itemtypes/zabbix_agent).<br><br>**Windows**: see a list of additional Windows-specific [items](/manual/config/items/itemtypes/zabbix_agent/win_keys).|**UNIX**: All metrics supported by Zabbix agent.<br>Additionally, the agent 2 provides Zabbix-native monitoring solution for: Docker, Memcached, MySQL, PostgreSQL, Redis, systemd, and other monitoring targets - see a full list of agent 2 specific [items](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2).<br><br>**Windows**: All metrics supported by Zabbix agent, and also net.tcp.service\* checks of HTTPS, LDAP.<br>Additionally, the agent 2 provides Zabbix-native monitoring solution for: PostgreSQL, Redis.| |Concurrency|Active checks for single server are executed sequentially.|Checks from different plugins or multiple checks within one plugin can be executed concurrently.| |Third-party traps|no|yes| |*Additional features*|<|<| |Persistent storage|no|yes| |Persistent files for log\*\[\] metrics|yes (only on Unix)|no| |Log data upload|Can be performed during log gathering to free the buffer.|Log gathering is stopped when the buffer is full, therefore the [BufferSize](/manual/appendix/config/zabbix_agent2) parameter must be at least MaxLinesPerSecond x 2.| |Changes user at runtime|yes (Unix-like systems only)|no (controlled by systemd)| |User-configurable ciphersuites|yes|no| **See also:** - *Zabbix processes description*: [Zabbix agent](/manual/concepts/agent), [Zabbix agent 2](/manual/concepts/agent2) - *Configuration parameters*: Zabbix agent [UNIX](/manual/appendix/config/zabbix_agentd) / [Windows](/manual/appendix/config/zabbix_agentd_win), Zabbix agent 2 [UNIX](/manual/appendix/config/zabbix_agent2) / [Windows](/manual/appendix/config/zabbix_agent2_win) # 14 Agent vs agent 2 salīdzinājums Šī sadaļa apraksta atšķirības starp Zabbix aģentu un Zabbix aģentu 2. |Parameter|Zabbix agent|Zabbix agent 2| |--|------|------| |Programmēšanas valoda|C|Go ar dažām daļām C| |Demonizācija|jā|tikai ar systemd (jā operētājsistēmā Windows)| |Atbalstītie paplašinājumi|Pielāgoti [ielādējami moduļi](/manual/extensions/loadablemodules) C valodā.|Pielāgoti [spraudņi](/manual/extensions/plugins) Go valodā.| |*Prasības*|<|<| |Atbalstītās platformas|Linux, IBM AIX, FreeBSD, NetBSD, OpenBSD, HP-UX, Mac OS X, Solaris: 9, 10, 11, Windows: visas darbvirsmas un serveru versijas kopš XP|Linux, Windows: visas darbvirsmas un serveru versijas, kurās var instalēt [atbalstītu Go versiju](/manual/installation/requirements#agent-2).| |Atbalstītās kriptogrāfijas bibliotēkas|GnuTLS 3.1.18 un jaunākas<br>OpenSSL 1.0.1, 1.0.2, 1.1.0, 1.1.1, 3.0.x<br>LibreSSL - testēts ar versijām 2.7.4, 2.8.2 (piemēroti noteikti ierobežojumi, skatiet lapu [Encryption](/manual/encryption#compiling-zabbix-with-encryption-support) sīkākai informācijai).|Linux: OpenSSL 1.0.1 un jaunāka.<br>MS Windows: OpenSSL 1.1.1 vai jaunāka.<br>OpenSSL bibliotēkā jābūt iespējotam PSK atbalstam. LibreSSL netiek atbalstīts.| |*Uzraudzības procesi*|<|<| |Procesi|Atsevišķs aktīvās pārbaudes process katram servera/starpniekservera ierakstam.|Viens process ar automātiski izveidotiem pavedieniem.<br>Maksimālo pavedienu skaitu nosaka GOMAXPROCS vides mainīgais.| |Metrikas|**UNIX**: skatiet atbalstīto [vienumu](/manual/config/items/itemtypes/zabbix_agent) sarakstu.<br><br>**Windows**: skatiet papildu Windows specifisko [vienumu](/manual/config/items/itemtypes/zabbix_agent/win_keys) sarakstu.|**UNIX**: visas metrikas, ko atbalsta Zabbix aģents.<br>Turklāt aģents 2 nodrošina Zabbix iebūvētu uzraudzības risinājumu: Docker, Memcached, MySQL, PostgreSQL, Redis, systemd un citiem uzraudzības mērķiem - skatiet pilnu aģentam 2 specifisko [vienumu](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2) sarakstu.<br><br>**Windows**: visas metrikas, ko atbalsta Zabbix aģents, kā arī net.tcp.service\* HTTPS, LDAP pārbaudes.<br>Turklāt aģents 2 nodrošina Zabbix iebūvētu uzraudzības risinājumu: PostgreSQL, Redis.| |Vienlaicīgums|Aktīvās pārbaudes vienam serverim tiek izpildītas secīgi.|Pārbaudes no dažādiem spraudņiem vai vairākas pārbaudes viena spraudņa ietvaros var tikt izpildītas vienlaicīgi.| |Trešo pušu trapi|nē|jā| |*Papildu funkcijas*|<|<| |Pastāvīgā krātuve|nē|jā| |Pastāvīgi faili log\*\[\] metrikām|jā (tikai Unix)|nē| |Žurnāla datu augšupielāde|Var tikt veikta žurnāla vākšanas laikā, lai atbrīvotu buferi.|Žurnāla vākšana tiek apturēta, kad buferis ir pilns, tāpēc parametram [BufferSize](/manual/appendix/config/zabbix_agent2) jābūt vismaz MaxLinesPerSecond x 2.| |Maina lietotāju izpildes laikā|jā (tikai Unix tipa sistēmās)|nē (kontrolē systemd)| |Lietotāja konfigurējami šifru komplekti|jā|nē| **Skatiet arī:** - *Zabbix procesu apraksts*: [Zabbix aģents](/manual/concepts/agent), [Zabbix aģents 2](/manual/concepts/agent2) - *Konfigurācijas parametri*: Zabbix aģents [UNIX](/manual/appendix/config/zabbix_agentd) / [Windows](/manual/appendix/config/zabbix_agentd_win), Zabbix aģents 2 [UNIX](/manual/appendix/config/zabbix_agent2) / [Windows](/manual/appendix/config/zabbix_agent2_win) # 14 Calculated item # 14 Aprēķinātais vienums # 14 Configuration export/import # 14 Konfigurācijas eksportēšana/importēšana # 14 Discovery of block devices In a similar way as [file systems](/manual/discovery/low_level_discovery#configuring-lowlevel-discovery) are discovered, it is possible to also discover block devices and their type. # 14 Bloku ierīču atklāšana Līdzīgi kā tiek atklātas [failu sistēmas](/manual/discovery/low_level_discovery#configuring-lowlevel-discovery), ir iespējams atklāt arī bloku ierīces un to tipu. # 14 Host navigator # 14 Hostu navigators # 14 Host navigator # 14 Hostu navigators # 14 modbus.get parameters # 14 modbus.get parametri # 14 Oracle database setup # 14 Oracle datubāzes iestatīšana # 14 Scheduled reports # 14 Plānotie pārskati # 14 Upgrade notes for 7.0.3 # 14 Atjaunināšanas piezīmes par 7.0.3 # 14 What's new in Zabbix 7.0.9 See [breaking changes](/manual/installation/upgrade_notes_709#breaking-changes) for this version. # 14 Kas jauns Zabbix 7.0.9 Skatiet [nesaderīgās izmaiņas](/manual/installation/upgrade_notes_709#breaking-changes) šajā versijā. # 15 Creating custom performance counter names for VMware # 15 Pielāgotu VMware veiktspējas skaitītāju nosaukumu izveide # 15 Data export # 15 Datu eksportēšana # 15 Dependent item # 15 Atkarīgais vienums # 15 Discovery # 15 Atklāšana # 15 Discovery of host interfaces in Zabbix # 15 Hostu saskarņu atklāšana Zabbix # 15 Escaping examples # 15 Atkāpšanās piemēri # 15 Item history # 15 Vienuma vēsture # 15 Item history # 15 Vienumu vēsture # 15 Upgrade notes for 7.0.4 # 15 Atjaunināšanas piezīmes par 7.0.4 # 15 Upgrading to numeric values of extended range # 15 Jaunināšana uz paplašinātā diapazona skaitliskajām vērtībām # 15 What's new in Zabbix 7.0.10 See [breaking changes](/manual/installation/upgrade_notes_7010#breaking-changes) for this version. # 15 Kas jauns Zabbix 7.0.10 Skatiet [nesaderīgās izmaiņas](/manual/installation/upgrade_notes_7010#breaking-changes) šajā versijā. # 16 Distributed monitoring # 16 Izkliedētā uzraudzība # 16 Item navigator # 16 Vienumu navigators # 16 Item navigator # 16 Vienumu navigators # 16 Return values for system.sw.packages.get # 16 Atgrieztās vērtības priekš system.sw.packages.get # 16 Script item # 16 Skripta vienums # 16 Setting up scheduled reports # 16 Plānoto pārskatu iestatīšana # 16 Upgrade notes for 7.0.5 # 16 Atjaunināšanas piezīmes par 7.0.5 # 16 What's new in Zabbix 7.0.11 # 16 Kas jauns Zabbix 7.0.11 versijā # 17 Additional frontend languages # 17 Papildu lietotāja saskarnes valodas # 17 Browser item # 17 Pārlūka vienums # 17 Encryption # 17 Šifrēšana # 17 Item value # 17 Vienuma vērtība # 17 Item value # 17 Vienuma vērtība # 17 Return values for net.dns.get # 17 Atgrieztās vērtības priekš net.dns.get # 17 Upgrade notes for 7.0.6 # 17 Atjaunināšanas piezīmes par 7.0.6 # 17 What's new in Zabbix 7.0.12 # 17 Kas jauns Zabbix 7.0.12 versijā # 18 Google Chrome TLS certificate trust # 18 Google Chrome TLS sertifikāta uzticamība # 18 Map # 18 Karte # 18 Map # 18 Karte # 18 Notes on system.cpu.util items on Windows # 18 Piezīmes par system.cpu.util vienumiem operētājsistēmā Windows # 18 Upgrade notes for 7.0.7 **Warning!** In this version, Zabbix server crashes upon processing low-level discovery rule [overrides](/manual/discovery/low_level_discovery#override). As a workaround, disable LLD rules containing overrides. The issue has been fixed in Zabbix 7.0.8rc2. We recommend upgrading to Zabbix 7.0.8 as soon as possible. # 18 Jaunināšanas piezīmes par 7.0.7 **Brīdinājums!** Šajā versijā Zabbix serveris avarē, apstrādājot zema līmeņa atklāšanas noteikuma [pārrakstīšanas](/manual/discovery/low_level_discovery#override). Kā pagaidu risinājumu atspējojiet LLD noteikumus, kas satur pārrakstīšanas. Šī problēma ir novērsta Zabbix 7.0.8rc2. Mēs iesakām pēc iespējas ātrāk jaunināt uz Zabbix 7.0.8. # 18 Web interface # 18 Lietotāja saskarne # 18 What's new in Zabbix 7.0.13 # 18 Kas jauns Zabbix 7.0.13 versijā # 19 Best practices # 19 Labākā prakse # 19 Map navigation tree # 19 Kartes navigācijas koks # 19 Map navigation tree # 19 Kartes navigācijas koks # 19 Upgrade notes for 7.0.8 This minor version doesn't have any upgrade notes. # 19 Atjaunināšanas piezīmes 7.0.8 versijai Šai mazajai versijai nav atjaunināšanas piezīmju. # 19 What's new in Zabbix 7.0.14 # 19 Kas jauns Zabbix 7.0.14 versijā # 1 Access control # 1 Piekļuves kontrole # 1 Action log # 1 Darbību žurnāls # 1 Action log # 1 Darbību žurnāls # 1 Actions # 1 Darbības # 1 Additional JavaScript objects # 1 Papildu JavaScript objekti # 1 Aggregate calculations # 1 Apkopojošie aprēķini # 1 Aggregate functions Except where stated otherwise, all functions listed here are supported in: - [Trigger expressions](/manual/config/triggers/expression) - [Calculated items](/manual/config/items/itemtypes/calculated) - [Expression macros](/manual/config/macros/expression_macros) Aggregate functions can work with either: - history of items, for example, `min(/host/key,1h)` - [foreach functions](/manual/appendix/functions/aggregate/foreach) as the only parameter, for example, `min(last_foreach(/*/key))` (only in calculated items; cannot be used in triggers directly) The functions are listed without additional information. Click on the function to see the full details. |Function|Description| |--|--------| |[avg](#avg)|The average value of an item within the defined evaluation period.| |[bucket_percentile](#bucket-percentile)|Calculates the percentile from the buckets of a histogram.| |[count](#count)|The count of values in an array returned by a foreach function.| |[histogram_quantile](#histogram-quantile)|Calculates the φ-quantile from the buckets of a histogram.| |[item_count](#item-count)|The count of existing items in configuration that match the filter criteria.| |[kurtosis](#kurtosis)|The "tailedness" of the probability distribution in collected values within the defined evaluation period.| |[mad](#mad)|The median absolute deviation in collected values within the defined evaluation period.| |[max](#max)|The highest value of an item within the defined evaluation period.| |[min](#min)|The lowest value of an item within the defined evaluation period.| |[skewness](#skewness)|The asymmetry of the probability distribution in collected values within the defined evaluation period.| |[stddevpop](#stddevpop)|The population standard deviation in collected values within the defined evaluation period.| |[stddevsamp](#stddevsamp)|The sample standard deviation in collected values within the defined evaluation period.| |[sum](#sum)|The sum of collected values within the defined evaluation period.| |[sumofsquares](#sumofsquares)|The sum of squares in collected values within the defined evaluation period.| |[varpop](#varpop)|The population variance of collected values within the defined evaluation period.| |[varsamp](#varsamp)|The sample variance of collected values within the defined evaluation period.| # 1 Apkopojošās funkcijas Ja nav norādīts citādi, visas šeit uzskaitītās funkcijas tiek atbalstītas: - [trigeru izteiksmēs](/manual/config/triggers/expression) - [aprēķinātajos vienumos](/manual/config/items/itemtypes/calculated) - [izteiksmju makrosos](/manual/config/macros/expression_macros) Apkopojošās funkcijas var darboties ar: - vienumu vēsturi, piemēram, `min(/host/key,1h)` - [foreach funkcijām](/manual/appendix/functions/aggregate/foreach) kā vienīgo parametru, piemēram, `min(last_foreach(/*/key))` (tikai aprēķinātajos vienumos; nevar izmantot tieši trigeros) Funkcijas ir uzskaitītas bez papildu informācijas. Noklikšķiniet uz funkcijas, lai skatītu pilnu informāciju. |Function|Description| |--|--------| |[avg](#avg)|Vienuma vidējā vērtība noteiktajā novērtēšanas periodā.| |[bucket_percentile](#bucket-percentile)|Aprēķina procentili no histogrammas spaiņiem.| |[count](#count)|Vērtību skaits masīvā, ko atgriež foreach funkcija.| |[histogram_quantile](#histogram-quantile)|Aprēķina φ-kvantiļu no histogrammas spaiņiem.| |[item_count](#item-count)|Esošo vienumu skaits konfigurācijā, kas atbilst filtra kritērijiem.| |[kurtosis](#kurtosis)|Savākto vērtību varbūtības sadalījuma "astes smagums" noteiktajā novērtēšanas periodā.| |[mad](#mad)|Savākto vērtību mediānā absolūtā novirze noteiktajā novērtēšanas periodā.| |[max](#max)|Augstākā vienuma vērtība noteiktajā novērtēšanas periodā.| |[min](#min)|Zemākā vienuma vērtība noteiktajā novērtēšanas periodā.| |[skewness](#skewness)|Savākto vērtību varbūtības sadalījuma asimetrija noteiktajā novērtēšanas periodā.| |[stddevpop](#stddevpop)|Savākto vērtību populācijas standartnovirze noteiktajā novērtēšanas periodā.| |[stddevsamp](#stddevsamp)|Savākto vērtību izlases standartnovirze noteiktajā novērtēšanas periodā.| |[sum](#sum)|Savākto vērtību summa noteiktajā novērtēšanas periodā.| |[sumofsquares](#sumofsquares)|Savākto vērtību kvadrātu summa noteiktajā novērtēšanas periodā.| |[varpop](#varpop)|Savākto vērtību populācijas dispersija noteiktajā novērtēšanas periodā.| |[varsamp](#varsamp)|Savākto vērtību izlases dispersija noteiktajā novērtēšanas periodā.| # 1 Building Zabbix agent on Windows # 1 Zabbix aģenta izveide operētājsistēmā Windows # 1 Cause and symptom problems # 1 Cēloņu un simptomu problēmas # 1 Ceph plugin # 1 Ceph spraudnis # 1 Compilation issues These are the known issues regarding Zabbix compilation from sources. For all other cases, see the [Known issues](/manual/installation/known_issues) page. # 1 Kompilēšanas problēmas Šīs ir zināmās problēmas, kas saistītas ar Zabbix kompilēšanu no avota koda. Visos citos gadījumos skatiet lapu [Zināmās problēmas](/manual/installation/known_issues). # 1 Conditions # 1 Nosacījumi # 1 Configuring a host # 1 Hosts konfigurēšana # 1 Configuring a network discovery rule # 1 Tīkla atklāšanas kārtulas konfigurēšana # 1 Configuring a network map # 1 Tīkla kartes konfigurēšana # 1 Configuring a template # 1 Veidnes konfigurēšana # 1 Configuring a trigger # 1 Trigera konfigurēšana # 1 Configuring a user # 1 Lietotāja konfigurēšana # 1 Connection type or permission problems # 1 Savienojuma veida vai atļauju problēmas # 1 Creating an item # 1 Vienuma izveide # 1 CyberArk configuration This section explains how to configure Zabbix to retrieve secrets from CyberArk Vault CV12. The vault should be installed and configured as described in the official [CyberArk documentation](https://docs.cyberark.com/Product-Doc/OnlineHelp/PAS/12.1/en/Content/HomeTilesLPs/LP-Tile6.htm?tocpath=Installation%7C_____0). To learn about configuring TLS in Zabbix, see [*Storage of secrets*](/manual/config/secrets#tls-configuration). # 1 CyberArk konfigurācija Šajā sadaļā ir skaidrots, kā konfigurēt Zabbix, lai izgūtu noslēpumus no CyberArk Vault CV12. Glabātuvei jābūt instalētai un konfigurētai, kā aprakstīts oficiālajā [CyberArk dokumentācijā](https://docs.cyberark.com/Product-Doc/OnlineHelp/PAS/12.1/en/Content/HomeTilesLPs/LP-Tile6.htm?tocpath=Installation%7C_____0). Lai uzzinātu par TLS konfigurēšanu Zabbix, skatiet [*Noslēpumu glabāšana*](/manual/config/secrets#tls-configuration). # 1 Dashboards # 1 Paneļi # 1 Dashboard widgets # 1 Informācijas paneļa logrīki # 1 Database creation # 1 Datubāzes izveide # 1 Discovery of mounted filesystems # 1 Pievienoto failu sistēmu atklāšana ##### 1 Download the source archive Go to the [Zabbix download page](http://www.zabbix.com/download_sources#70LTS) and download the source archive. Once downloaded, extract the sources, by running: tar -zxvf zabbix-7.0.0.tar.gz ::: notetip Enter the correct Zabbix version in the command. It must match the name of the downloaded archive. ::: ##### 1 Lejupielādējiet avota arhīvu Dodieties uz [Zabbix lejupielādes lapu](http://www.zabbix.com/download_sources#70LTS) un lejupielādējiet avota arhīvu. Pēc lejupielādes izvelciet avota failus, izpildot: tar -zxvf zabbix-7.0.0.tar.gz ::: notetip Komandā ievadiet pareizo Zabbix versiju. Tai ir jāatbilst lejupielādētā arhīva nosaukumam. ::: # 1 Dynamic indexes # 1 Dinamiskie indeksi # 1 Email # 1 E-pasts # 1 Escaping special characters from LLD macro values in JSONPath When low-level discovery macros are used in JSONPath preprocessing and their values are resolved, the following rules of escaping special characters are applied: - only backslash (\\) and double quote (") characters are considered for escaping; - if the resolved macro value contains these characters, each of them is escaped with a backslash; - if they are already escaped with a backslash, it is not considered as escaping and both the backslash and the following special characters are escaped once again. For example: |JSONPath|LLD macro value|After substitution| |--------|---------------|------------------| |$.\[?(@.value == "{\#MACRO}")\]|special "value"|$.\[?(@.value == "special \\"value\\"")\]| |^|c:\\temp|$.\[?(@.value == "c:\\\\temp")\]| |^|a\\\\b|$.\[?(@.value == "a\\\\\\\\b")\]| When used in the expression, the macro that may have special characters should be enclosed in double quotes: |JSONPath|LLD macro value|After substitution|Result| |--------|--------|--------|--------| |$.\[?(@.value == "{\#MACRO}")\]|special "value"|$.\[?(@.value == "special \\"value\\"")\]|OK| |$.\[?(@.value == {\#MACRO})\]|^|$.\[?(@.value == special \\"value\\")\]|**Bad JSONPath expression**| When used in the path, the macro that may have special characters should be enclosed in square brackets **and** double quotes: |JSONPath|LLD macro value|After substitution|Result| |--------|--------|--------|--------| |$.\["{\#MACRO}"\].value|c:\\temp|$.\["c:\\\\temp"\].value|OK| |$.{\#MACRO}.value|^|$.c:\\\\temp.value|**Bad JSONPath expression**| # 1 Speciālo rakstzīmju atsoļošana no LLD makro vērtībām JSONPath Kad JSONPath priekšapstrādē tiek izmantoti zema līmeņa atklāšanas makro un to vērtības tiek aizstātas, tiek piemēroti šādi speciālo rakstzīmju atsoļošanas noteikumi: - atsoļošanai tiek ņemtas vērā tikai atpakaļējā slīpsvītra (\\) un dubultpēdiņa (") rakstzīmes; - ja aizstātā makro vērtība satur šīs rakstzīmes, katra no tām tiek atsoļota ar atpakaļējo slīpsvītru; - ja tās jau ir atsoļotas ar atpakaļējo slīpsvītru, tas netiek uzskatīts par atsoļošanu, un gan atpakaļējā slīpsvītra, gan tai sekojošā speciālā rakstzīme tiek atsoļota vēlreiz. Piemēram: |JSONPath|LLD makro vērtība|Pēc aizstāšanas| |--------|---------------|------------------| |$.\[?(@.value == "{\#MACRO}")\]|special "value"|$.\[?(@.value == "special \\"value\\"")\]| |^|c:\\temp|$.\[?(@.value == "c:\\\\temp")\]| |^|a\\\\b|$.\[?(@.value == "a\\\\\\\\b")\]| Ja makro tiek izmantots izteiksmē, makro, kurā var būt speciālās rakstzīmes, jāieliek dubultpēdiņās: |JSONPath|LLD makro vērtība|Pēc aizstāšanas|Rezultāts| |--------|--------|--------|--------| |$.\[?(@.value == "{\#MACRO}")\]|special "value"|$.\[?(@.value == "special \\"value\\"")\]|OK| |$.\[?(@.value == {\#MACRO})\]|^|$.\[?(@.value == special \\"value\\")\]|**Nederīga JSONPath izteiksme**| Ja makro tiek izmantots ceļā, makro, kurā var būt speciālās rakstzīmes, jāieliek kvadrātiekavās **un** dubultpēdiņās: |JSONPath|LLD makro vērtība|Pēc aizstāšanas|Rezultāts| |--------|--------|--------|--------| |$.\["{\#MACRO}"\].value|c:\\temp|$.\["c:\\\\temp"\].value|OK| |$.{\#MACRO}.value|^|$.c:\\\\temp.value|**Nederīga JSONPath izteiksme**| # 1 Event menu # 1 Notikumu izvēlne # 1 Export to files # 1 Eksportēšana uz failiem # 1 Extending Zabbix agents This tutorial provides step-by-step instructions on how to extend the functionality of Zabbix agent with the use of a [user parameter](/manual/config/items/userparameters). # 1 Zabbix aģentu paplašināšana Šajā pamācībā ir sniegtas soli pa solim instrukcijas par to, kā paplašināt Zabbix aģenta funkcionalitāti, izmantojot [lietotāja parametru](/manual/config/items/userparameters). # 1 Foreach functions # 1 Foreach funkcijas # 1 General # 1 Vispārīgi # 1 Getting Zabbix # 1 Zabbix iegūšana # 1 Global notifications # 1 Globālie paziņojumi # 1 Graphs # 1 Grafiki # 1 Graphs # 1 Grafiki # 1 High availability # 1 Augsta pieejamība # 1 Hosts and host groups # 1 Hosti un hostu grupas # 1 HTTP # 1 HTTP # 1 Installation and setup This section covers database creation, security configuration, platform-specific setup procedures, and feature configuration. Please use the sidebar to find the procedure relevant to your environment. # 1 Instalēšana un iestatīšana Šajā sadaļā ir aprakstīta datubāzes izveide, drošības konfigurēšana, platformai specifiskas iestatīšanas procedūras un funkciju konfigurēšana. Lūdzu, izmantojiet sānjoslu, lai atrastu jūsu videi atbilstošo procedūru. # 1 Introduction Zabbix is an enterprise-grade open-source monitoring platform. It monitors parameters across networks and IT infrastructure (from servers and applications to databases, virtual machines, and services) and then sends alerts when problems occur, while storing the historical data for analysis and trend visualization. You can create dashboards, automate responses to problems, and visualize trends. Zabbix can be scaled from small networks to infrastructures with thousands of hosts. This manual covers installation, configuration, and advanced topics. To explore a specific topic, please use the sidebar navigation. # 1 Ievads Zabbix ir uzņēmuma līmeņa atvērtā pirmkoda uzraudzības platforma. Tā uzrauga parametrus visā tīklā un IT infrastruktūrā (no serveriem un lietotnēm līdz datubāzēm, virtuālajām mašīnām un pakalpojumiem) un pēc tam nosūta brīdinājumus, kad rodas problēmas, vienlaikus saglabājot vēsturiskos datus analīzei un tendenču vizualizācijai. Jūs varat izveidot informācijas paneļus, automatizēt reakcijas uz problēmām un vizualizēt tendences. Zabbix var mērogot no maziem tīkliem līdz infrastruktūrām ar tūkstošiem hosts. Šī rokasgrāmata aptver instalēšanu, konfigurēšanu un padziļinātas tēmas. Lai izpētītu konkrētu tēmu, lūdzu, izmantojiet sānjoslas navigāciju. # 1 Item key format Item key format, including key parameters, must follow syntax rules. The following illustrations depict the supported syntax. Allowed elements and characters at each point can be determined by following the arrows - if some block can be reached through the line, it is allowed, if not - it is not allowed. {width="600"} To construct a valid item key, one starts with specifying the key name, then there's a choice to either have parameters or not - as depicted by the two lines that could be followed. # 1 Vienuma atslēgas formāts Vienuma atslēgas formātam, tostarp atslēgas parametriem, jāatbilst sintakses noteikumiem. Tālāk redzamajās ilustrācijās ir attēlota atbalstītā sintakse. Atļautos elementus un rakstzīmes katrā punktā var noteikt, sekojot bultiņām — ja kādu bloku var sasniegt pa līniju, tas ir atļauts, ja ne — tas nav atļauts. {width="600"} Lai izveidotu derīgu vienuma atslēgu, vispirms jānorāda atslēgas nosaukums, pēc tam var izvēlēties, vai izmantot parametrus vai neizmantot tos — kā parādīts ar divām līnijām, kurām var sekot. # 1 Item prototypes # 1 Vienumu prototipi # 1 Item prototypes # 1 Vienumu prototipi # 1 Item prototypes Once a [rule is created](/manual/discovery/low_level_discovery#configuring-lowlevel-discovery), go to the items for that rule and press "Create item prototype" to create an item prototype. Note how the {\#FSNAME} macro is used where a file system name is required. The use of a low-level discovery macro is mandatory in the item key to make sure that the discovery is processed correctly. When the discovery rule is processed, this macro will be substituted with the discovered file system. {width="600"} ::: noteclassic When [item key](/manual/config/items/item/key) parameters are not used, place the LLD macro inside the item key brackets `[...]` (for example `v_[{#MACRO}]`). ::: Low-level discovery [macros](/manual/config/macros/lld_macros) and user [macros](/manual/appendix/macros/supported_by_location_user) are supported in item prototype configuration and item value preprocessing [parameters](/manual/config/items/item#item-value-preprocessing).Note that when used in update intervals, a single macro has to fill the whole field. Multiple macros in one field or macros mixed with text are not supported. ::: noteclassic Context-specific escaping of low-level discovery macros is performed for safe use in regular expression and XPath preprocessing parameters. ::: Attributes that are specific for item prototypes: |Parameter|Description| |--|--------| |*Create enabled*|If checked the item will be added in an enabled state.<br>If unchecked, the item will be added to a discovered entity, but in a disabled state.| |*Discover*|If checked (default) the item will be added to a discovered entity.<br>If unchecked, the item will not be added to a discovered entity, unless this setting is [overridden](/manual/discovery/low_level_discovery#override) in the discovery rule.| We can create several item prototypes for each file system metric we are interested in:  Click on the three-dot icon to open the menu for the specific item prototype with these options: - *Create trigger prototype* - create a trigger prototype based on this item prototype - *Trigger prototypes* - click to see a list with links to already-configured trigger prototypes of this item prototype - *Create dependent item* - create a dependent item for this item prototype *[Mass update](/manual/config/items/itemupdate#using-mass-update)* option is available if you want to update properties of several item prototypes at once. # 1 Vienumu prototipi Kad [noteikums ir izveidots](/manual/discovery/low_level_discovery#configuring-lowlevel-discovery), dodieties uz šī noteikuma vienumiem un nospiediet "Create item prototype", lai izveidotu vienuma prototipu. Pievērsiet uzmanību, ka {\#FSNAME} makro tiek izmantots tur, kur ir nepieciešams failu sistēmas nosaukums. Zema līmeņa atklāšanas makro izmantošana ir obligāta vienuma atslēgā, lai nodrošinātu, ka atklāšana tiek apstrādāta pareizi. Kad atklāšanas noteikums tiek apstrādāts, šis makro tiks aizstāts ar atklāto failu sistēmu. {width="600"} ::: noteclassic Ja [vienuma atslēgas](/manual/config/items/item/key) parametri netiek izmantoti, ievietojiet LLD makro vienuma atslēgas iekavās `[...]` (piemēram, `v_[{#MACRO}]`). ::: Zema līmeņa atklāšanas [makro](/manual/config/macros/lld_macros) un lietotāja [makro](/manual/appendix/macros/supported_by_location_user) tiek atbalstīti vienuma prototipa konfigurācijā un vienuma vērtības pirmapstrādes [parametros](/manual/config/items/item#item-value-preprocessing). Ņemiet vērā, ka, ja tie tiek izmantoti atjaunināšanas intervālos, vienam makro ir jāaizpilda viss lauks. Vairāki makro vienā laukā vai makro, kas sajaukti ar tekstu, netiek atbalstīti. ::: noteclassic Zema līmeņa atklāšanas makro konteksta specifiska aizbēgšana tiek veikta drošai lietošanai regulāro izteiksmju un XPath pirmapstrādes parametros. ::: Vienuma prototipiem specifiskie atribūti: |Parameter|Description| |--|--------| |*Create enabled*|Ja atzīmēts, vienums tiks pievienots iespējotā stāvoklī.<br>Ja nav atzīmēts, vienums tiks pievienots atklātajai entītijai, bet atspējotā stāvoklī.| |*Discover*|Ja atzīmēts (noklusējums), vienums tiks pievienots atklātajai entītijai.<br>Ja nav atzīmēts, vienums netiks pievienots atklātajai entītijai, ja vien šis iestatījums nav [pārrakstīts](/manual/discovery/low_level_discovery#override) atklāšanas noteikumā.| Mēs varam izveidot vairākus vienumu prototipus katram failu sistēmas rādītājam, kas mūs interesē:  Noklikšķiniet uz trīs punktu ikonas, lai atvērtu konkrētā vienuma prototipa izvēlni ar šādām opcijām: - *Create trigger prototype* - izveidot trigeris prototipu, pamatojoties uz šo vienuma prototipu - *Trigger prototypes* - noklikšķiniet, lai skatītu sarakstu ar saitēm uz jau konfigurētajiem šī vienuma prototipa trigeris prototipiem - *Create dependent item* - izveidot atkarīgo vienumu šim vienuma prototipam *[Mass update](/manual/config/items/itemupdate#using-mass-update)* opcija ir pieejama, ja vēlaties vienlaikus atjaunināt vairāku vienumu prototipu īpašības. # 1 Items # 1 Vienumi # 1 Items # 1 Vienumi # 1 Loadable modules # 1 Ielādējamie moduļi # 1 Login and configuring user # 1 Pieteikšanās un lietotāja konfigurēšana # 1 Macro functions #### Overview Macro functions offer the ability to customize [macro](/manual/config/macros) values (for example, shorten or extract specific substrings), making them easier to work with. The syntax of a macro function is: ```default {macro.func(params)} ``` where - **macro** - the macro to customize; - **func** - the function to apply (see [supported functions](#supported-functions)); - **params** - a comma-delimited list of function parameters, which must be **double-quoted** if: - start with a space or double quotes; - contain closing parentheses or a comma. For example: ```default {{TIME}.fmttime(format,time_shift)} {{ITEM.VALUE}.regsub(pattern, output)} {{$USERMACRO}.regsub(pattern, output)} {{#LLDMACRO}.regsub(pattern, output)} ``` Macro functions are supported for: - [Built-in macros](/manual/appendix/macros/supported_by_location) - [User macros](/manual/appendix/macros/supported_by_location#other-macro-types) - [Low-level discovery macros](/manual/appendix/macros/supported_by_location#other-macro-types) - [Expression macros](/manual/appendix/macros/supported_by_location#other-macro-types) Macro functions can be used in all locations supporting the listed macros. This applies unless explicitly stated that only a macro is expected (for example, when configuring [host macros](/manual/config/hosts/host#configuration) or low-level discovery rule [filters](/manual/discovery/low_level_discovery#filter)). See also: [known issues](/manual/installation/known_issues#macro-functions). A single function per macro is supported; multiple macro functions in chain are not supported. :::noteclassic Please see [escaping examples](/manual/appendix/escaping) for cases when macro functions are used inside other contexts (function, item key, another macro, etc). ::: # 1 Makro funkcijas #### Pārskats Makro funkcijas nodrošina iespēju pielāgot [makro](/manual/config/macros) vērtības (piemēram, saīsināt vai izvilkt noteiktas apakšvirknes), padarot tās ērtāk lietojamas. Makro funkcijas sintakse ir: ```default {macro.func(params)} ``` kur - **macro** - pielāgojamais makro; - **func** - lietojamā funkcija (skatiet [atbalstītās funkcijas](#supported-functions)); - **params** - ar komatiem atdalīts funkcijas parametru saraksts, kam jābūt **iekļautam dubultpēdiņās**, ja: - sākas ar atstarpi vai dubultpēdiņām; - satur aizverošās iekavas vai komatu. Piemēram: ```default {{TIME}.fmttime(format,time_shift)} {{ITEM.VALUE}.regsub(pattern, output)} {{$USERMACRO}.regsub(pattern, output)} {{#LLDMACRO}.regsub(pattern, output)} ``` Makro funkcijas tiek atbalstītas šādiem elementiem: - [Iebūvētie makro](/manual/appendix/macros/supported_by_location) - [Lietotāja makro](/manual/appendix/macros/supported_by_location#other-macro-types) - [Zema līmeņa atklāšanas makro](/manual/appendix/macros/supported_by_location#other-macro-types) - [Izteiksmes makro](/manual/appendix/macros/supported_by_location#other-macro-types) Makro funkcijas var izmantot visās vietās, kur tiek atbalstīti uzskaitītie makro. Tas attiecas uz gadījumiem, ja nav skaidri norādīts, ka tiek gaidīts tikai makro (piemēram, konfigurējot [hosts makro](/manual/config/hosts/host#configuration) vai zema līmeņa atklāšanas noteikuma [filtrus](/manual/discovery/low_level_discovery#filter)). Skatiet arī: [zināmās problēmas](/manual/installation/known_issues#macro-functions). Vienam makro tiek atbalstīta tikai viena funkcija; vairāku makro funkciju ķēdēšana netiek atbalstīta. :::noteclassic Lūdzu, skatiet [atdalīšanas piemērus](/manual/appendix/escaping) gadījumiem, kad makro funkcijas tiek izmantotas citos kontekstos (funkcijā, vienuma atslēgā, citā makro utt.). ::: # 1 Manual structure # 1 Rokasgrāmatas struktūra # 1 Media types # 1 Mediju tipi # 1 Menu # 1 Izvēlne # 1 Monitor Linux with Zabbix agent # 1. Monitor Linux with Zabbix agent # 1 MySQL encryption configuration # 1 MySQL šifrēšanas konfigurācija # 1 Network discovery # 1 Tīkla atklāšana # 1 Overview # 1 Pārskats # 1 Preprocessing testing # 1 Priekšapstrādes testēšana # 1 Problems # 1 Problēmas # 1 Problem suppression # 1 Problēmu apspiešana # 1 Proxies # 1 Starpniekserveri # 1 Red Hat Enterprise Linux # 1 Red Hat Enterprise Linux # 1 Security best practices # 1 Drošības labākā prakse # 1 Sending message # 1 Ziņojuma sūtīšana # 1 Server # 1 Serveris # 1 Server-proxy data exchange protocol # 1 Servera un starpniekservera datu apmaiņas protokols # 1 Services # 1 Pakalpojumi # 1 Service tree The service tree is configured in the *Services -> Services* menu section. In the upper right corner, switch from [View](/manual/web_interface/frontend_sections/services/service#viewing-services) to the Edit mode. {width=600} To [configure](#service-configuration) a new service, click on the *Create service* button in the top right-hand corner. To quickly add a child service, you can alternatively press a plus icon next to the parent service. This will open the same service configuration form, but the *Parent services* parameter will be pre-filled. # 1 Pakalpojumu koks Pakalpojumu koks tiek konfigurēts izvēlnes sadaļā *Services -> Services*. Augšējā labajā stūrī pārslēdzieties no [View](/manual/web_interface/frontend_sections/services/service#viewing-services) uz rediģēšanas režīmu. {width=600} Lai [konfigurētu](#service-configuration) jaunu pakalpojumu, augšējā labajā stūrī noklikšķiniet uz pogas *Create service*. Lai ātri pievienotu pakārtoto pakalpojumu, varat arī nospiest plusa ikonu blakus vecākpakalpojumam. Tiks atvērta tā pati pakalpojuma konfigurācijas forma, taču parametrs *Parent services* būs aizpildīts iepriekš. # 1 Setup from RHEL packages # 1 Iestatīšana no RHEL pakotnēm # 1 Simple graphs # 1 Vienkārši grafiki ##### 1 Stop agent Stop Zabbix agent. ##### 1 Apturiet aģentu Apturiet Zabbix aģentu. ##### 1 Stop proxy Stop Zabbix proxy. ##### 1 Apturiet starpniekserveri Apturiet Zabbix starpniekserveri. ##### 1 Stop server Stop Zabbix server to make sure that no new data is inserted into database. ##### 1 Apturiet serveri Apturiet Zabbix serveri, lai pārliecinātos, ka datubāzē netiek ievietoti jauni dati. ##### 1 Stop Zabbix processes Stop Zabbix server to make sure that no new data is inserted into database: ```bash systemctl stop zabbix-server ``` If upgrading Zabbix proxy, agent, or agent 2, stop these components too: ```bash systemctl stop zabbix-proxy systemctl stop zabbix-agent systemctl stop zabbix-agent2 ``` ##### 1 Apturiet Zabbix procesus Apturiet Zabbix serveri, lai pārliecinātos, ka datubāzē netiek ievietoti jauni dati: ```bash systemctl stop zabbix-server ``` Ja jaunināt Zabbix starpniekserveri, aģentu vai aģentu 2, apturiet arī šīs komponentes: ```bash systemctl stop zabbix-proxy systemctl stop zabbix-agent systemctl stop zabbix-agent2 ``` ##### 1 Stop Zabbix processes Stop Zabbix server to make sure that no new data is inserted into database: ```bash systemctl stop zabbix-server ``` If upgrading Zabbix proxy, agent, or agent 2, stop these components too: ```bash systemctl stop zabbix-proxy systemctl stop zabbix-agent systemctl stop zabbix-agent2 ``` ##### 1 Apturiet Zabbix procesus Apturiet Zabbix serveri, lai pārliecinātos, ka datubāzē netiek ievietoti jauni dati: ```bash systemctl stop zabbix-server ``` Ja jaunināt Zabbix starpniekserveri, aģentu vai aģentu 2, apturiet arī šos komponentus: ```bash systemctl stop zabbix-proxy systemctl stop zabbix-agent systemctl stop zabbix-agent2 ``` # 1 Supported macros # 1 Atbalstītie makrosi # 1 Synchronization of monitoring configuration # 1 Monitoringa konfigurācijas sinhronizācija # 1 System information # 1 Sistēmas informācija # 1 Template groups # 1 Veidņu grupas # 1 Template groups #### Overview In the frontend, template groups can be [exported](/manual/xml_export_import) only with template export. When a template is exported, all groups it belongs to are exported with it automatically. API allows exporting template groups independently of templates. # 1 Veidņu grupas #### Pārskats Lietotāja saskarnē veidņu grupas var [eksportēt](/manual/xml_export_import) tikai kopā ar veidņu eksportu. Kad veidne tiek eksportēta, visas grupas, kurām tā pieder, tiek automātiski eksportētas kopā ar to. API ļauj eksportēt veidņu grupas neatkarīgi no veidnēm. # 1 Trigger-based event correlation # 1 Uz trigeriem balstīta notikumu korelācija # 1 Trigger event generation # 1 Trigera notikumu ģenerēšana # 1 Upgrade from sources # 1 Jaunināšana no avotiem # 1 User groups # 1 Lietotāju grupas # 1 Using certificates # 1 Sertifikātu izmantošana # 1 vm.memory.size parameters # 1 vm.memory.size parametri # 1 VMware monitoring item keys # 1 VMware uzraudzības vienumu atslēgas # 1 VMware monitoring item keys # 1 VMware uzraudzības vienumu atslēgas # 1 Webhook script examples # 1 Webhook skriptu piemēri # 1 Web monitoring items # 1 Tīmekļa uzraudzības vienumi # 1 Windows agent installation from MSI # 1 Windows aģenta instalēšana no MSI # 1 Zabbix agent # 1 Zabbix aģents # 1 Zabbix agent 2 # 1 Zabbix aģents 2 # 1 Zabbix agent template operation Steps to ensure correct operation of templates that collect metrics with [Zabbix agent](/manual/concepts/agent): 1. Make sure that Zabbix agent is installed on the host. For active checks, also make sure that the Zabbix server/proxy address is added to the 'ServerActive' parameter of the agent [configuration file](/manual/appendix/config/zabbix_agentd#serveractive). 2. [Link](/manual/config/templates/linking#linking-a-template) the template to a target host (if the template is not available in your Zabbix installation, you may need to [import](/manual/config/templates_out_of_the_box#template-upgrade) the template first). 3. If necessary, adjust the values of template macros. 4. Configure the instance being monitored to allow data sharing with Zabbix. A detailed description of a template, including the full list of macros, items, and triggers, is available in the template's README file (accessible by clicking on a template name). The following templates are available: - [Apache by Zabbix agent](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/apache_agent/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Apache by Zabbix agent active](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/apache_agent_active/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [HAProxy by Zabbix agent](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/haproxy_agent/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [IIS by Zabbix agent](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/iis_agent/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [IIS by Zabbix agent active](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/iis_agent_active/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Microsoft Exchange Server 2016 by Zabbix agent](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/exchange/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Microsoft Exchange Server 2016 by Zabbix agent active](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/exchange_active/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [MySQL by Zabbix agent](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mysql_agent/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [MySQL by Zabbix agent active](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mysql_agent_active/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Nginx by Zabbix agent](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nginx_agent/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Nginx by Zabbix agent active](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nginx_agent_active/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [PHP-FPM by Zabbix agent](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/php-fpm_agent/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [PHP-FPM by Zabbix agent active](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/php-fpm_agent_active/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [PostgreSQL by Zabbix agent](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/postgresql_agent/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [PostgreSQL by Zabbix agent active](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/postgresql_agent_active/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [RabbitMQ cluster by Zabbix agent](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/rabbitmq_agent/README.md?at=refs%2Fheads%2Frelease%2F7.0) # 1 Zabbix aģenta veidnes darbība Darbības, kas jāveic, lai nodrošinātu pareizu to veidņu darbību, kuras apkopo metriku ar [Zabbix aģents](/manual/concepts/agent): 1. Pārliecinieties, ka Zabbix aģents ir instalēts uz hosta. Aktīvajām pārbaudēm pārliecinieties arī, ka Zabbix servera/starpniekservera adrese ir pievienota aģenta [konfigurācijas faila](/manual/appendix/config/zabbix_agentd#serveractive) parametram 'ServerActive'. 2. [Saistiet](/manual/config/templates/linking#linking-a-template) veidni ar mērķa hostu (ja veidne nav pieejama jūsu Zabbix instalācijā, vispirms var būt nepieciešams veikt veidnes [importēšanu](/manual/config/templates_out_of_the_box#template-upgrade)). 3. Ja nepieciešams, pielāgojiet veidnes makro vērtības. 4. Konfigurējiet uzraudzīto instanci tā, lai tā atļautu datu koplietošanu ar Zabbix. Detalizēts veidnes apraksts, tostarp pilns makro, vienumu un trigeru saraksts, ir pieejams veidnes README failā (tam var piekļūt, noklikšķinot uz veidnes nosaukuma). Pieejamas šādas veidnes: - [Apache by Zabbix agent](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/apache_agent/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Apache by Zabbix agent active](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/apache_agent_active/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [HAProxy by Zabbix agent](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/haproxy_agent/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [IIS by Zabbix agent](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/iis_agent/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [IIS by Zabbix agent active](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/iis_agent_active/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Microsoft Exchange Server 2016 by Zabbix agent](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/exchange/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Microsoft Exchange Server 2016 by Zabbix agent active](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/exchange_active/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [MySQL by Zabbix agent](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mysql_agent/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [MySQL by Zabbix agent active](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mysql_agent_active/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Nginx by Zabbix agent](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nginx_agent/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Nginx by Zabbix agent active](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nginx_agent_active/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [PHP-FPM by Zabbix agent](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/php-fpm_agent/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [PHP-FPM by Zabbix agent active](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/php-fpm_agent_active/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [PostgreSQL by Zabbix agent](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/postgresql_agent/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [PostgreSQL by Zabbix agent active](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/postgresql_agent_active/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [RabbitMQ cluster by Zabbix agent](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/rabbitmq_agent/README.md?at=refs%2Fheads%2Frelease%2F7.0) # 1 Zabbix server # 1 Zabbix serveris # 20 API # 20 API # 20 Pie chart # 20 sektoru diagramma # 20 Pie chart # 20 sektoru diagramma # 20 Upgrade notes for 7.0.9 # 20 Atjaunināšanas piezīmes par 7.0.9 # 20 What's new in Zabbix 7.0.15 This minor version has no functional changes. # 20 Kas jauns Zabbix 7.0.15 Šajā mazajā versijā nav funkcionālu izmaiņu. # 21 Extensions # 21 Paplašinājumi # 21 Problem hosts # 21 Problemātiskie hosts # 21 Problem hosts # 21 Problemātiskie hosts # 21 Upgrade notes for 7.0.10 # 21 Atjaunināšanas piezīmes par 7.0.10 # 21 What's new in Zabbix 7.0.16 This minor version has no functional changes. # 21 Kas jauns Zabbix 7.0.16 Šajā mazajā versijā nav funkcionālu izmaiņu. # 22 Appendixes # 22 Pielikumi # 22 Problems # 22 Problēmas # 22 Problems # 22 Problēmas # 22 Upgrade notes for 7.0.11 # 22 Atjaunināšanas piezīmes par 7.0.11 # 22 What's new in Zabbix 7.0.17 # 22 Kas jauns Zabbix 7.0.17 versijā # 23 Problems by severity # 23 Problēmas pēc smaguma pakāpes # 23 Problems by severity # 23 Problēmas pēc smaguma pakāpes # 23 Upgrade notes for 7.0.12 This minor version doesn't have any upgrade notes. # 23 Jaunināšanas piezīmes versijai 7.0.12 Šai mazajai versijai nav jaunināšanas piezīmju. # 23 What's new in Zabbix 7.0.18 # 23 Kas jauns Zabbix 7.0.18 # 24 SLA report # 24 SLA pārskats # 24 SLA report # 24 SLA pārskats # 24 Upgrade notes for 7.0.13 # 24 Atjaunināšanas piezīmes par 7.0.13 # 24 What's new in Zabbix 7.0.19 # 24 Kas jauns Zabbix 7.0.19 # 25 System information # 25 Sistēmas informācija # 25 System information # 25 Sistēmas informācija # 25 Upgrade notes for 7.0.14 # 25 Atjaunināšanas piezīmes par 7.0.14 # 25 What's new in Zabbix 7.0.20 **Warning!** Upgrading to this version is not recommended due to [errors](/manual/installation/known_issues#known-issues-in-7.0.20) related to graphs and the Zabbix agent 2 MySQL plugin. # 25 Kas jauns Zabbix 7.0.20 **Brīdinājums!** Jaunināšana uz šo versiju nav ieteicama, jo ir [kļūdas](/manual/installation/known_issues#known-issues-in-7.0.20), kas saistītas ar grafikiem un Zabbix aģents 2 MySQL spraudni. # 26 Top hosts # 26 Populārākie hosts # 26 Top hosts # 26 Top hosts # 26 Upgrade notes for 7.0.15 This minor version has no upgrade notes. # 26 Atjaunināšanas piezīmes 7.0.15 versijai Šai mazajai versijai nav atjaunināšanas piezīmju. # 26 What's new in Zabbix 7.0.21 This minor version has no functional changes. # 26 Kas jauns Zabbix 7.0.21 Šajā mazajā versijā nav funkcionālu izmaiņu. # 27 Top triggers # 27 Populārākie trigeri # 27 Top triggers # 27 Populārākie trigeri # 27 Upgrade notes for 7.0.16 This minor version has no upgrade notes. # 27 Atjaunināšanas piezīmes 7.0.16 versijai Šai mazajai versijai nav atjaunināšanas piezīmju. # 27 What's new in Zabbix 7.0.22 See [breaking changes](/manual/installation/upgrade_notes_7022#breaking-changes) for this version. # 27 Kas jauns Zabbix 7.0.22 Skatiet [pārtraucošās izmaiņas](/manual/installation/upgrade_notes_7022#breaking-changes) šajā versijā. # 28 Trigger overview # 28 Trigeru pārskats # 28 Trigger overview # 28 Trigeru pārskats # 28 Upgrade notes for 7.0.17 # 28 Atjaunināšanas piezīmes par 7.0.17 # 28 What's new in Zabbix 7.0.23 # 28 Kas jauns Zabbix 7.0.23 versijā # 29 Upgrade notes for 7.0.18 This minor version has no upgrade notes. # 29 Atjaunināšanas piezīmes 7.0.18 versijai Šai mazajai versijai nav atjaunināšanas piezīmju. # 29 URL # 29 URL # 29 URL # 29 URL # 29 What's new in Zabbix 7.0.24 # 29 Kas jauns Zabbix 7.0.24 versijā # 2 Actions # 2 Darbības # 2 Active agent autoregistration # 2 Aktīvā aģenta automātiskā reģistrācija # 2 Agent # 2 Aģents # 2 Audit log # 2 Audita žurnāls ##### 2 Back up configuration files and Zabbix agent binaries Make a backup copy of the Zabbix agent binary and configuration file. ##### 2 Dublējiet konfigurācijas failus un Zabbix aģenta bināros failus Izveidojiet Zabbix aģenta binārā faila un konfigurācijas faila rezerves kopiju. ##### 2 Back up configuration files and Zabbix proxy binaries Make a backup copy of the Zabbix proxy binary and configuration file. ##### 2 Dublējiet konfigurācijas failus un Zabbix starpniekservera bināros failus Izveidojiet Zabbix starpniekservera binārā faila un konfigurācijas faila rezerves kopiju. ##### 2 Back up the existing Zabbix database This is a very important step. Make sure that you have a backup of your database. It will help if the upgrade procedure fails (lack of disk space, power off, any unexpected problem). ##### 2 Izveidojiet esošās Zabbix datubāzes dublējumu Šis ir ļoti svarīgs solis. Pārliecinieties, ka jums ir jūsu datubāzes dublējums. Tas palīdzēs, ja jaunināšanas procedūra neizdosies (diska vietas trūkums, elektroapgādes pārtraukums, jebkāda neparedzēta problēma). ##### 2 Back up Zabbix database Back up your existing Zabbix database to safeguard against upgrade failures (for example, disk space issues, power loss, or unexpected problems). ##### 2 Izveidojiet Zabbix datubāzes dublējumu Izveidojiet esošās Zabbix datubāzes dublējumu, lai pasargātos no jaunināšanas kļūmēm (piemēram, diska vietas problēmām, elektroapgādes pārtraukuma vai neparedzētām problēmām). ##### 2 Back up Zabbix database Back up your existing Zabbix database to safeguard against upgrade failures (for example, disk space issues, power loss, or unexpected problems). ##### 2 Izveidojiet Zabbix datubāzes dublējumu Izveidojiet esošās Zabbix datubāzes dublējumu, lai pasargātu sevi no jaunināšanas kļūmēm (piemēram, diska vietas problēmām, elektroapgādes pārtraukuma vai neparedzētām problēmām). # 2 Bitwise functions All functions listed here are supported in: - [Trigger expressions](/manual/config/triggers/expression) - [Calculated items](/manual/config/items/itemtypes/calculated) - [Expression macros](/manual/config/macros/expression_macros) The functions are listed without additional information. Click on the function to see the full details. |Function|Description| |--|--------| |[bitand](#bitand)|The value of "bitwise AND" of an item value and mask.| |[bitlshift](#bitlshift)|The bitwise shift left of an item value.| |[bitnot](#bitnot)|The value of "bitwise NOT" of an item value.| |[bitor](#bitor)|The value of "bitwise OR" of an item value and mask.| |[bitrshift](#bitrshift)|The bitwise shift right of an item value.| |[bitxor](#bitxor)|The value of "bitwise exclusive OR" of an item value and mask.| # 2 Bitu operācijas funkcijas Visas šeit uzskaitītās funkcijas tiek atbalstītas: - [Trigeru izteiksmēs](/manual/config/triggers/expression) - [Aprēķinātajos vienumos](/manual/config/items/itemtypes/calculated) - [Izteiksmju makrosos](/manual/config/macros/expression_macros) Funkcijas ir uzskaitītas bez papildu informācijas. Noklikšķiniet uz funkcijas, lai skatītu pilnu informāciju. |Function|Description| |--|--------| |[bitand](#bitand)|"bitwise AND" vērtība no vienuma vērtības un maskas.| |[bitlshift](#bitlshift)|Vienuma vērtības bitu nobīde pa kreisi.| |[bitnot](#bitnot)|Vienuma vērtības "bitwise NOT" vērtība.| |[bitor](#bitor)|"bitwise OR" vērtība no vienuma vērtības un maskas.| |[bitrshift](#bitrshift)|Vienuma vērtības bitu nobīde pa labi.| |[bitxor](#bitxor)|"bitwise exclusive OR" vērtība no vienuma vērtības un maskas.| # 2 Browser item JavaScript objects # 2 Pārlūka vienuma JavaScript objekti # 2 Building Zabbix agent 2 on Windows # 2 Zabbix aģenta 2 būvēšana operētājsistēmā Windows # 2 Certificate problems # 2 Sertifikātu problēmas # 2 Clock # 2 Pulkstenis # 2 Clock # 2 Pulkstenis # 2 Configuration best practices # 2 Konfigurācijas labākā prakse # 2 Configuring a host group # 2 Hosts grupas konfigurēšana # 2 Configuring a template group # 2 Veidņu grupas konfigurēšana ##### 2 Create user account All Zabbix daemon processes run under unprivileged system users. If a Zabbix daemon is started from an unprivileged user account, it will continue running as that user. In the default configuration, if a daemon is started as `root`, it will switch to the `zabbix` user account, which must be present. To create a `zabbix` system user and group, run the commands listed below. RedHat-based system: groupadd --system zabbix useradd --system -g zabbix -d /usr/lib/zabbix -s /sbin/nologin -c "Zabbix Monitoring System" zabbix Debian-based system: addgroup --system --quiet zabbix adduser --quiet --system --disabled-login --ingroup zabbix --home /var/lib/zabbix --no-create-home zabbix There is no need to create a separate user account for Zabbix frontend. ###### Security recommendation If the Zabbix [server](/manual/concepts/server) and [agent](/manual/concepts/agent) run on the same machine, it is recommended to run them under **separate user accounts**. Running both as the same user allows the agent to access the server's configuration file, which could expose sensitive information—such as the database password—to any Admin-level user in Zabbix. ::: noteimportant Running Zabbix as `root`, `bin`, or any other account with special rights is a security risk. ::: ###### Home directory (optional) Zabbix processes do not require a home directory, so creating one is generally not recommended. However, if you need functionality that requires a home directory (for example, storing MySQL credentials in $HOME/.my.cnf), you can create it using the commands listed below. On RedHat-based systems, run: mkdir -m u=rwx,g=rwx,o= -p /usr/lib/zabbix chown zabbix:zabbix /usr/lib/zabbix On Debian-based systems, run: mkdir -m u=rwx,g=rwx,o= -p /var/lib/zabbix chown zabbix:zabbix /var/lib/zabbix ##### 2 Izveidot lietotāja kontu Visi Zabbix dēmona procesi darbojas ar sistēmas lietotājiem bez paaugstinātām tiesībām. Ja Zabbix dēmona process tiek palaists no lietotāja konta bez paaugstinātām tiesībām, tas turpinās darboties kā šis lietotājs. Noklusējuma konfigurācijā, ja dēmona process tiek palaists kā `root`, tas pārslēgsies uz `zabbix` lietotāja kontu, kuram ir jābūt izveidotam. Lai izveidotu `zabbix` sistēmas lietotāju un grupu, izpildiet tālāk norādītās komandas. Uz RedHat balstītai sistēmai: groupadd --system zabbix useradd --system -g zabbix -d /usr/lib/zabbix -s /sbin/nologin -c "Zabbix Monitoring System" zabbix Uz Debian balstītai sistēmai: addgroup --system --quiet zabbix adduser --quiet --system --disabled-login --ingroup zabbix --home /var/lib/zabbix --no-create-home zabbix Zabbix lietotāja saskarnei nav nepieciešams izveidot atsevišķu lietotāja kontu. ###### Drošības ieteikums Ja Zabbix [serveris](/manual/concepts/server) un [aģents](/manual/concepts/agent) darbojas vienā un tajā pašā datorā, ieteicams tos palaist ar **atsevišķiem lietotāja kontiem**. Ja abi darbojas ar vienu un to pašu lietotāju, aģents var piekļūt servera konfigurācijas failam, kas var atklāt sensitīvu informāciju, piemēram, datubāzes paroli, jebkuram Zabbix administratora līmeņa lietotājam. ::: noteimportant Zabbix palaišana kā `root`, `bin` vai jebkurš cits konts ar īpašām tiesībām ir drošības risks. ::: ###### Mājas direktorijs (pēc izvēles) Zabbix procesiem nav nepieciešams mājas direktorijs, tāpēc tā izveide parasti nav ieteicama. Tomēr, ja jums ir nepieciešama funkcionalitāte, kurai vajadzīgs mājas direktorijs (piemēram, MySQL akreditācijas datu glabāšana $HOME/.my.cnf), to varat izveidot, izmantojot tālāk norādītās komandas. Uz RedHat balstītās sistēmās izpildiet: mkdir -m u=rwx,g=rwx,o= -p /usr/lib/zabbix chown zabbix:zabbix /usr/lib/zabbix Uz Debian balstītās sistēmās izpildiet: mkdir -m u=rwx,g=rwx,o= -p /var/lib/zabbix chown zabbix:zabbix /var/lib/zabbix # 2 Custom graphs # 2 Pielāgoti grafiki # 2 Custom intervals # 2 Pielāgoti intervāli # 2 Debian/Ubuntu # 2 Debian/Ubuntu # 2 Definitions # 2. Definitions # 2 Discovery of network interfaces In a similar way as [file systems](/manual/discovery/low_level_discovery#configuring-lowlevel-discovery) are discovered, it is possible to also discover network interfaces. # 2 Tīkla saskarņu atklāšana Līdzīgi kā tiek atklātas [failu sistēmas](/manual/discovery/low_level_discovery#configuring-lowlevel-discovery), ir iespējams atklāt arī tīkla saskarnes. # 2 Docker plugin # 2 Docker spraudnis 2. Do not use "ps -ef" to browse processes - it shows only non-kernel processes. Use "ps -Af" to see all processes which will be seen by Zabbix agent. 3. Let's go through example of 'topasrec' how Zabbix agent proc.mem[] selects processes. ``` $ ps -Af | grep topasrec root 10747984 1 0 Mar 16 - 0:00 /usr/bin/topasrec -L -s 300 -R 1 -r 6 -o /var/perf daily/ -ypersistent=1 -O type=bin -ystart_time=04:08:54,Mar16,2023 ``` proc.mem[] has arguments: ``` proc.mem[<name>,<user>,<mode>,<cmdline>,<memtype>] ``` 2. Neizmantojiet "ps -ef" procesu pārlūkošanai — tas parāda tikai ne-kodola procesus. Izmantojiet "ps -Af", lai redzētu visus procesus, kurus redzēs Zabbix aģents. 3. Apskatīsim 'topasrec' piemēru, kā Zabbix aģents proc.mem[] atlasa procesus. ``` $ ps -Af | grep topasrec root 10747984 1 0 Mar 16 - 0:00 /usr/bin/topasrec -L -s 300 -R 1 -r 6 -o /var/perf daily/ -ypersistent=1 -O type=bin -ystart_time=04:08:54,Mar16,2023 ``` proc.mem[] ir argumenti: ``` proc.mem[<name>,<user>,<mode>,<cmdline>,<memtype>] ``` # 2 Escaping-related upgrade issues # 2 Ar jaunināšanu saistītas problēmas ar atsoļošanu # 2 Frontend sections # 2 Lietotāja saskarnes sadaļas # 2 Global event correlation # 2 Globālā notikumu korelācija # 2 HashiCorp configuration # 2 HashiCorp konfigurācija # 2 Host dashboards # 2 Hostu paneļi # 2 Host group elements # 2 Hostu grupu elementi # 2 Host groups # 2 Hostu grupas # 2 Host groups #### Overview In the frontend, host groups can be [exported](/manual/xml_export_import) only with host export. When a host is exported, all groups it belongs to are exported with it automatically. API allows exporting host groups independently of hosts. # 2 Hostu grupas #### Pārskats Lietotāja saskarnē hostu grupas var [eksportēt](/manual/xml_export_import) tikai kopā ar hostu eksportu. Kad hosts tiek eksportēts, visas grupas, kurām tas pieder, tiek automātiski eksportētas kopā ar to. API ļauj eksportēt hostu grupas neatkarīgi no hostiem. # 2 Host menu # 2 Hostu izvēlne # 2 Hosts # 2 Hosti # 2 Hosts # 2 Hosti # 2 Items # 2 Vienumi # 2 Item value preprocessing # 2 Vienuma vērtības priekšapstrāde # 2 LDAP # 2 LDAP # 2 macOS agent installation from PKG # 2 macOS aģenta instalēšana no PKG # 2 Media types # 2 Mediju tipi # 2 Monitoring # 2 Uzraudzība # 2 Network maps # 2 Tīkla kartes # 2 New host # 2 Jauns hosts # 2 Operations # 2 Darbības # 2 Other event sources # 2 Citi notikumu avoti # 2 Passive and active agent checks # 2 Pasīvās un aktīvās aģenta pārbaudes # 2 Permissions # 2 Atļaujas # 2 Plugins # 2 Spraudņi # 2 PostgreSQL encryption configuration # 2 PostgreSQL šifrēšanas konfigurācija # 2 Preprocessing details # 2 Priekšapstrādes detaļas # 2 Process configuration This section documents configuration file parameters for Zabbix server, proxy, agent, agent 2, and other processes. Please use the sidebar to navigate to the relevant subsection. # 2 Procesu konfigurācija Šajā sadaļā ir dokumentēti konfigurācijas failu parametri Zabbix serverim, starpniekserverim, aģentam, aģentam 2 un citiem procesiem. Lūdzu, izmantojiet sānjoslu, lai pārietu uz attiecīgo apakšsadaļu. # 2 Proxy load balancing and high availability # 2 Starpniekservera slodzes balansēšana un augsta pieejamība # 2 Real-life scenario # 2 Reālas dzīves scenārijs # 2 Remote commands # 2 Attālinātās komandas # 2 Repairing Zabbix database character set and collation # 2 Zabbix datubāzes rakstzīmju kopas un kolācijas labošana # 2 Requirements # 2 Prasības # 2 Scheduled reports # 2 Plānotie pārskati # 2 Setup from Debian/Ubuntu packages # 2 Iestatīšana no Debian/Ubuntu pakotnēm # 2 Simple check # 2 Vienkārša pārbaude # 2 SLA # 2 SLA # 2 SLA # 2 SLA # 2 SMS # 2 SMS # 2 Sound in browsers # 2 Skaņa pārlūkprogrammās # 2 Special OIDs Some of the most used SNMP OIDs are translated automatically to a numeric representation by Zabbix. For example, **ifIndex** is translated to **1.3.6.1.2.1.2.2.1.1**, **ifIndex.0** is translated to **1.3.6.1.2.1.2.2.1.1.0**. The table contains list of the special OIDs. |Special OID|Identifier|Description| |--|--|------| |ifIndex|1.3.6.1.2.1.2.2.1.1|A unique value for each interface.| |ifDescr|1.3.6.1.2.1.2.2.1.2|A textual string containing information about the interface.This string should include the name of the manufacturer, the product name and the version of the hardware interface.| |ifType|1.3.6.1.2.1.2.2.1.3|The type of interface, distinguished according to the physical/link protocol(s) immediately 'below' the network layer in the protocol stack.| |ifMtu|1.3.6.1.2.1.2.2.1.4|The size of the largest datagram which can be sent / received on the interface, specified in octets.| |ifSpeed|1.3.6.1.2.1.2.2.1.5|An estimate of the interface's current bandwidth in bits per second.| |ifPhysAddress|1.3.6.1.2.1.2.2.1.6|The interface's address at the protocol layer immediately \`below' the network layer in the protocol stack.| |ifAdminStatus|1.3.6.1.2.1.2.2.1.7|The current administrative state of the interface.| |ifOperStatus|1.3.6.1.2.1.2.2.1.8|The current operational state of the interface.| |ifInOctets|1.3.6.1.2.1.2.2.1.10|The total number of octets received on the interface, including framing characters.| |ifInUcastPkts|1.3.6.1.2.1.2.2.1.11|The number of subnetwork-unicast packets delivered to a higher-layer protocol.| |ifInNUcastPkts|1.3.6.1.2.1.2.2.1.12|The number of non-unicast (i.e., subnetwork- broadcast or subnetwork-multicast) packets delivered to a higher-layer protocol.| |ifInDiscards|1.3.6.1.2.1.2.2.1.13|The number of inbound packets which were chosen to be discarded even though no errors had been detected to prevent their being deliverable to a higher-layer protocol. One possible reason for discarding such a packet could be to free up buffer space.| |ifInErrors|1.3.6.1.2.1.2.2.1.14|The number of inbound packets that contained errors preventing them from being deliverable to a higher-layer protocol.| |ifInUnknownProtos|1.3.6.1.2.1.2.2.1.15|The number of packets received via the interface which were discarded because of an unknown or unsupported protocol.| |ifOutOctets|1.3.6.1.2.1.2.2.1.16|The total number of octets transmitted out of the interface, including framing characters.| |ifOutUcastPkts|1.3.6.1.2.1.2.2.1.17|The total number of packets that higher-level protocols requested be transmitted, and which were not addressed to a multicast or broadcast address at this sub-layer, including those that were discarded or not sent.| |ifOutNUcastPkts|1.3.6.1.2.1.2.2.1.18|The total number of packets that higher-level protocols requested be transmitted, and which were addressed to a multicast or broadcast address at this sub-layer, including those that were discarded or not sent.| |ifOutDiscards|1.3.6.1.2.1.2.2.1.19|The number of outbound packets which were chosen to be discarded even though no errors had been detected to prevent their being transmitted. One possible reason for discarding such a packet could be to free up buffer space.| |ifOutErrors|1.3.6.1.2.1.2.2.1.20|The number of outbound packets that could not be transmitted because of errors.| |ifOutQLen|1.3.6.1.2.1.2.2.1.21|The length of the output packet queue (in packets).| # 2 Īpašie OID Daži no visbiežāk izmantotajiem SNMP OID tiek automātiski pārveidoti uz skaitlisku attēlojumu Zabbix sistēmā. Piemēram, **ifIndex** tiek pārveidots uz **1.3.6.1.2.1.2.2.1.1**, bet **ifIndex.0** tiek pārveidots uz **1.3.6.1.2.1.2.2.1.1.0**. Tabulā ir ietverts īpašo OID saraksts. |Īpašais OID|Identifikators|Apraksts| |--|--|------| |ifIndex|1.3.6.1.2.1.2.2.1.1|Unikāla vērtība katrai saskarnei.| |ifDescr|1.3.6.1.2.1.2.2.1.2|Teksta virkne, kas satur informāciju par saskarni. Šajā virknē jāiekļauj ražotāja nosaukums, produkta nosaukums un aparatūras saskarnes versija.| |ifType|1.3.6.1.2.1.2.2.1.3|Saskarnes tips, kas noteikts atbilstoši fiziskajam/saites protokolam(-iem), kas protokolu stekā atrodas tieši "zem" tīkla slāņa.| |ifMtu|1.3.6.1.2.1.2.2.1.4|Lielākās datagrammas izmērs, ko var nosūtīt/saņemt caur saskarni, norādīts oktetos.| |ifSpeed|1.3.6.1.2.1.2.2.1.5|Saskarnes pašreizējā joslas platuma novērtējums bitos sekundē.| |ifPhysAddress|1.3.6.1.2.1.2.2.1.6|Saskarnes adrese protokolu slānī, kas protokolu stekā atrodas tieši \`zem' tīkla slāņa.| |ifAdminStatus|1.3.6.1.2.1.2.2.1.7|Saskarnes pašreizējais administratīvais stāvoklis.| |ifOperStatus|1.3.6.1.2.1.2.2.1.8|Saskarnes pašreizējais darbības stāvoklis.| |ifInOctets|1.3.6.1.2.1.2.2.1.10|Kopējais saskarnē saņemto oktetu skaits, ieskaitot kadrēšanas rakstzīmes.| |ifInUcastPkts|1.3.6.1.2.1.2.2.1.11|Apakštīkla unicast pakešu skaits, kas piegādātas augstāka līmeņa protokolam.| |ifInNUcastPkts|1.3.6.1.2.1.2.2.1.12|Ne-unicast (t.i., apakštīkla apraides vai apakštīkla multiraides) pakešu skaits, kas piegādātas augstāka līmeņa protokolam.| |ifInDiscards|1.3.6.1.2.1.2.2.1.13|Ienākošo pakešu skaits, kuras tika izvēlētas atmešanai, lai gan kļūdas netika konstatētas, tādējādi nepieļaujot to piegādi augstāka līmeņa protokolam. Viens no iespējamiem šādas paketes atmešanas iemesliem varētu būt bufera vietas atbrīvošana.| |ifInErrors|1.3.6.1.2.1.2.2.1.14|Ienākošo pakešu skaits, kurās bija kļūdas, kas neļāva tās piegādāt augstāka līmeņa protokolam.| |ifInUnknownProtos|1.3.6.1.2.1.2.2.1.15|Caur saskarni saņemto pakešu skaits, kas tika atmestas nezināma vai neatbalstīta protokola dēļ.| |ifOutOctets|1.3.6.1.2.1.2.2.1.16|Kopējais no saskarnes nosūtīto oktetu skaits, ieskaitot kadrēšanas rakstzīmes.| |ifOutUcastPkts|1.3.6.1.2.1.2.2.1.17|Kopējais pakešu skaits, kuru nosūtīšanu pieprasīja augstāka līmeņa protokoli un kuras šajā apakšslānī nebija adresētas multiraides vai apraides adresei, ieskaitot tās, kas tika atmestas vai netika nosūtītas.| |ifOutNUcastPkts|1.3.6.1.2.1.2.2.1.18|Kopējais pakešu skaits, kuru nosūtīšanu pieprasīja augstāka līmeņa protokoli un kuras šajā apakšslānī bija adresētas multiraides vai apraides adresei, ieskaitot tās, kas tika atmestas vai netika nosūtītas.| |ifOutDiscards|1.3.6.1.2.1.2.2.1.19|Izejošo pakešu skaits, kuras tika izvēlētas atmešanai, lai gan kļūdas netika konstatētas, tādējādi nepieļaujot to nosūtīšanu. Viens no iespējamiem šādas paketes atmešanas iemesliem varētu būt bufera vietas atbrīvošana.| |ifOutErrors|1.3.6.1.2.1.2.2.1.20|Izejošo pakešu skaits, kuras nevarēja nosūtīt kļūdu dēļ.| |ifOutQLen|1.3.6.1.2.1.2.2.1.21|Izvades pakešu rindas garums (paketēs).| # 2 Streaming to external systems # 2 Straumēšana uz ārējām sistēmām # 2 Trigger expression # 2 Trigeris izteiksme # 2 Trigger prototypes # 2 Trigeru prototipi # 2 Trigger prototypes # 2 Trigeru prototipi # 2 Trigger prototypes We create trigger prototypes in a similar way as item prototypes: {width="600"} Attributes that are specific for trigger prototypes: |Parameter|Description| |--|--------| |*Create enabled*|If checked the trigger will be added in an enabled state.<br>If unchecked, the trigger will be added to a discovered entity, but in a disabled state.| |*Discover*|If checked (default) the trigger will be added to a discovered entity.<br>If unchecked, the trigger will not be added to a discovered entity, unless this setting is [overridden](/manual/discovery/low_level_discovery#override) in the discovery rule.| When real triggers are created from the prototypes, there may be a need to be flexible as to what constant ('20' in our example) is used for comparison in the expression. See how [user macros with context](/manual/config/macros/user_macros_context#use-cases) can be useful to accomplish such flexibility. You can define [dependencies](/manual/config/triggers/dependencies) between trigger prototypes. To do that, go to the *Dependencies* tab. A trigger prototype may depend on another trigger prototype from the same low-level discovery (LLD) rule or on a regular trigger. A trigger prototype may not depend on a trigger prototype from a different LLD rule or on a trigger created from trigger prototype. Host trigger prototype cannot depend on a trigger from a template.  # 2 Trigeru prototipi Mēs veidojam trigeru prototipus līdzīgi kā vienumu prototipus: {width="600"} Atribūti, kas ir specifiski trigeru prototipiem: |Parametrs|Apraksts| |--|--------| |*Create enabled*|Ja atzīmēts, trigeris tiks pievienots iespējotā stāvoklī.<br>Ja nav atzīmēts, trigeris tiks pievienots atklātajai entītijai, bet atspējotā stāvoklī.| |*Discover*|Ja atzīmēts (noklusējums), trigeris tiks pievienots atklātajai entītijai.<br>Ja nav atzīmēts, trigeris netiks pievienots atklātajai entītijai, ja vien šis iestatījums nav [pārrakstīts](/manual/discovery/low_level_discovery#override) atklāšanas kārtulā.| Kad no prototipiem tiek izveidoti reāli trigeri, var rasties nepieciešamība elastīgi noteikt, kāda konstante (mūsu piemērā '20') tiek izmantota salīdzināšanai izteiksmē. Skatiet, kā [lietotāja makrosi ar kontekstu](/manual/config/macros/user_macros_context#use-cases) var būt noderīgi, lai nodrošinātu šādu elastību. Jūs varat definēt [atkarības](/manual/config/triggers/dependencies) starp trigeru prototipiem. Lai to izdarītu, atveriet cilni *Dependencies*. Trigeru prototips var būt atkarīgs no cita trigeru prototipa no tās pašas zema līmeņa atklāšanas (LLD) kārtulas vai no parasta trigera. Trigeru prototips nevar būt atkarīgs no trigeru prototipa no citas LLD kārtulas vai no trigera, kas izveidots no trigera prototipa. Hosta trigera prototips nevar būt atkarīgs no trigera no veidnes.  # 2 Triggers # 2 Trigeri # 2 Triggers # 2 Trigeri # 2 Upgrade from packages # 2 Jaunināšana no pakotnēm # 2 User macros # 2 Lietotāja makrosi # 2 User macros supported by location # 2 Lietotāja makrosi, ko atbalsta atrašanās vieta # 2 User roles # 2 Lietotāju lomas # 2 Using pre-shared keys # 2 Iepriekš koplietotu atslēgu izmantošana # 2 Virtual machine discovery key fields The following table lists fields returned by virtual machine related discovery keys. |**Item key**|<|<| |--|--|------| |**Description**|**Field**|**Retrieved content**| |**vmware.cluster.discovery**|<|<| |Performs cluster discovery.|{\#CLUSTER.ID}|Cluster identifier.| |^|{\#CLUSTER.NAME}|Cluster name.| |^|"resource_pool"|An array containing resource pool data, including resource group ID, tags array, resource pool path, number of virtual machines.<br><br>Array structure:<br>`[{`<br>`"rpid":"resource group id",`<br>`"tags":[{}],`<br>`"rpath":"resource group path",`<br>`"vm_count":0`<br>`}]`<br><br>For `"tags"` array structure, see the "tags" field.| |^|"tags"|An array containing tags with tag name, description and category.<br><br>Array structure:<br>`[{`<br>`"tag":"tag name",`<br>`"tag_description":"tag description",`<br>`"category":"tag category"`<br>`}]`| |**vmware.datastore.discovery**|<|<| |Performs datastore discovery.|{\#DATASTORE}|Datastore name.| |^|{\#DATASTORE.EXTENT}|An array containing datastore extent partition ID and instance name.<br><br>Array structure:<br>`[{`<br>`"partitionid":1,`<br>`"instance":"name"`<br>`}]`| |^|{\#DATASTORE.TYPE}|Datastore type.<br><br>Value examples: `VMFS`, `NFS`, `vsan`, etc.| |^|{\#DATASTORE.UUID}|Datastore identifier.| |^|"tags"|An array containing tags with tag name, description and category.<br><br>Array structure:<br>`[{`<br>`"tag":"tag name",`<br>`"tag_description":"tag description",`<br>`"category":"tag category"`<br>`}]`| |**vmware.dc.discovery**|<|<| |Performs datacenter discovery.|{\#DATACENTER}|Datacenter name.| |^|{\#DATACENTERID}|Datacenter identifier.| |^|"tags"|An array containing tags with tag name, description and category.<br><br>Array structure:<br>`[{`<br>`"tag":"tag name",`<br>`"tag_description":"tag description",`<br>`"category":"tag category"`<br>`}]`| |**vmware.dvswitch.discovery**|<|<| |Performs vSphere distributed switches discovery.|{\#DVS.NAME}|Switch name.| |^|{\#DVS.UUID}|Switch identifier.| |**vmware.hv.discovery**|<|<| |Performs hypervisor discovery.|{\#HV.UUID}|Unique hypervisor identifier.| |^|{\#HV.ID}|Hypervisor identifier (HostSystem managed object name).| |^|{\#HV.NAME}|Hypervisor name.| |^|{\#HV.NETNAME}|Hypervisor network host name.| |^|{\#HV.IP}|Hypervisor IP address, might be empty.<br><br>In case of an HA configuration with multiple net interfaces, the following selection priority for interface is observed:<br>- prefer the IP which shares the IP-subnet with the vCenter IP;<br>- prefer the IP from IP-subnet with default gateway;<br>- prefer the IP from interface with the lowest ID.| |^|{\#CLUSTER.NAME}|Cluster name, might be empty.| |^|{\#DATACENTER.NAME}|Datacenter name.| |^|{\#PARENT.NAME}|Name of container that stores the hypervisor.| |^|{\#PARENT.TYPE}|Type of container in which the hypervisor is stored. The values could be `Datacenter`, `Folder`, `ClusterComputeResource`, `VMware`, where "VMware" stands for unknown container type.| |^|"resource_pool"|An array containing resource pool data, including resource group ID, tags array, resource pool path, number of virtual machines.<br><br>Array structure:<br>`[{`<br>`"rpid":"resource group id",`<br>`"tags":[{}],`<br>`"rpath":"resource group path",`<br>`"vm_count":0`<br>`}]`<br><br>For `"tags"` array structure, see the "tags" field.| |^|"tags"|An array containing tags with tag name, description and category.<br><br>Array structure:<br>`[{`<br>`"tag":"tag name",`<br>`"tag_description":"tag description",`<br>`"category":"tag category"`<br>`}]`| |**vmware.hv.datastore.discovery**|<|<| |Performs hypervisor datastore discovery. Note that multiple hypervisors can use the same datastore.|{\#DATASTORE}|Datastore name.| |^|{\#DATASTORE.TYPE}|Datastore type.<br><br>Value examples: `VMFS`, `NFS`, `vsan`, etc.| |^|{\#DATASTORE.UUID}|Datastore identifier.| |^|{\#MULTIPATH.COUNT}|Registered number of datastore paths.| |^|{\#MULTIPATH.PARTITION.COUNT}|Number of available disk partitions.| |^|"datastore_extent"|An array containing datastore extent instance name and partition ID.<br><br>Array structure:<br>`[{`<br>`"partitionid":1,`<br>`"instance":"name"`<br>`}]`| |^|"tags"|An array containing tags with tag name, description and category.<br><br>Array structure:<br>`[{`<br>`"tag":"tag name",`<br>`"tag_description":"tag description",`<br>`"category":"tag category"`<br>`}]`| |**vmware.hv.net.if.discovery**|<|<| |Performs hypervisor network interfaces discovery.|{\#IFNAME}|Interface name.| |^|{\#IFDRIVER}|Interface driver.| |^|{\#IFDUPLEX}|Interface duplex settings.| |^|{\#IFSPEED}|Interface speed.| |^|{\#IFMAC}|Interface mac address.| |**vmware.vm.discovery**|<|<| |Performs virtual machine discovery.|{\#VM.UUID}|Unique virtual machine identifier.| |^|{\#VM.ID}|Virtual machine identifier (VirtualMachine managed object name).| |^|{\#VM.NAME}|Virtual machine name.| |^|{\#HV.NAME}|Hypervisor name.| |^|{\#HV.UUID}|Unique hypervisor identifier.| |^|{\#HV.ID}|Hypervisor identifier (HostSystem managed object name).| |^|{\#CLUSTER.NAME}|Cluster name, might be empty.| |^|{\#DATACENTER.NAME}|Datacenter name.| |^|{\#DATASTORE.NAME}|Datastore name.| |^|{\#DATASTORE.UUID}|Datastore identifier.| |^|{\#VM.IP}|Virtual machine IP address, might be empty.| |^|{\#VM.DNS}|Virtual machine DNS name, might be empty.| |^|{\#VM.GUESTFAMILY}|Guest virtual machine OS family, might be empty.| |^|{\#VM.GUESTFULLNAME}|Full guest virtual machine OS name, might be empty.| |^|{\#VM.FOLDER}|The chain of virtual machine parent folders, can be used as value for nested groups; folder names are combined with "/". Might be empty.| |^|{\#VM.TOOLS.STATUS}|VMware virtual machine tools state.| |^|{\#VM.POWERSTATE}|VMware virtual machine power state (`poweredOff`, `poweredOn`, or `suspended`).| |^|{\#VM.RPOOL.ID}|Resource pool identifier.| |^|{\#VM.RPOOL.PATH}|Full resource pool path excluding the "root" name "Resources". Folder names are combined with "/".| |^|{\#VM.SNAPSHOT.COUNT}|Number of VM snapshots.| |^|"tags"|An array containing tags with tag name, description and category.<br><br>Array structure:<br>`[{`<br>`"tag":"tag name",`<br>`"tag_description":"tag description",`<br>`"category":"tag category"`<br>`}]`| |^|"vm_customattribute"|An array of virtual machine custom attributes (if defined).<br><br>Array structure:<br>`[{`<br>`"name":"custom field name",`<br>`"value":"custom field value"`<br>`}]`| |^|"net_if"|An array of virtual machine network interfaces.<br><br>Array structure:<br>`[{`<br>`"ifname": "interface name",`<br>`"ifdesc": "interface description",`<br>`"ifmac": "00:00:00:00:00:00",`<br>`"ifconnected": true,`<br>`"iftype": "interface type",`<br>`"ifbackingdevice": "interface backing device",`<br>`"ifdvswitch_uuid": "interface switch uuid",`<br>`"ifdvswitch_portgroup": "interface switch port group",`<br>`"ifdvswitch_port": "interface switch port",`<br>`"ifip": ["interface ip addresses"]`<br>`}]`<br><br>For the description of returned data, see the "vmware.vm.net.if.discovery" item key.| |**vmware.vm.net.if.discovery**|<|<| |Performs virtual machine network interface discovery.|{\#IFNAME}|Network interface name.| |^|{\#IFDESC}|Interface description.| |^|{\#IFMAC}|Interface mac address.| |^|{\#IFCONNECTED}|Interface connection status (`false` - disconnected; `true` - connected).| |^|{\#IFTYPE}|Interface type.| |^|{\#IFBACKINGDEVICE}|Name of the backing device.| |^|{\#IFDVSWITCH.UUID}|Unique vSphere Distributed Switch identifier.| |^|{\#IFDVSWITCH.PORTGROUP}|Distributed port group.| |^|{\#IFDVSWITCH.PORT}|vSphere Distributed Switch port.| |^|"ifip"|An array of interface addresses.| |**vmware.vm.vfs.dev.discovery**|<|<| |Performs virtual machine disk device discovery.|{\#DISKNAME}|Disk device name.| |**vmware.vm.vfs.fs.discovery**|<|<| |Performs virtual machine file system discovery.|{\#FSNAME}|File system name.| # 2 Virtuālās mašīnas atklāšanas atslēgu lauki Šajā tabulā ir uzskaitīti lauki, ko atgriež ar virtuālajām mašīnām saistītās atklāšanas atslēgas. |**Vienuma atslēga**|<|<| |--|--|------| |**Apraksts**|**Lauks**|**Iegūtais saturs**| |**vmware.cluster.discovery**|<|<| |Veic klasteru atklāšanu.|{\#CLUSTER.ID}|Klastera identifikators.| |^|{\#CLUSTER.NAME}|Klastera nosaukums.| |^|"resource_pool"|Masīvs, kas satur resursu pūla datus, tostarp resursu grupas ID, tagu masīvu, resursu pūla ceļu un virtuālo mašīnu skaitu.<br><br>Masīva struktūra:<br>`[{`<br>`"rpid":"resursu grupas id",`<br>`"tags":[{}],`<br>`"rpath":"resursu grupas ceļš",`<br>`"vm_count":0`<br>`}]`<br><br>`"tags"` masīva struktūru skatiet laukā "tags".| |^|"tags"|Masīvs, kas satur tagus ar taga nosaukumu, aprakstu un kategoriju.<br><br>Masīva struktūra:<br>`[{`<br>`"tag":"taga nosaukums",`<br>`"tag_description":"taga apraksts",`<br>`"category":"taga kategorija"`<br>`}]`| |**vmware.datastore.discovery**|<|<| |Veic datu krātuvju atklāšanu.|{\#DATASTORE}|Datu krātuves nosaukums.| |^|{\#DATASTORE.EXTENT}|Masīvs, kas satur datu krātuves extent nodalījuma ID un instances nosaukumu.<br><br>Masīva struktūra:<br>`[{`<br>`"partitionid":1,`<br>`"instance":"nosaukums"`<br>`}]`| |^|{\#DATASTORE.TYPE}|Datu krātuves tips.<br><br>Vērtību piemēri: `VMFS`, `NFS`, `vsan` u.c.| |^|{\#DATASTORE.UUID}|Datu krātuves identifikators.| |^|"tags"|Masīvs, kas satur tagus ar taga nosaukumu, aprakstu un kategoriju.<br><br>Masīva struktūra:<br>`[{`<br>`"tag":"taga nosaukums",`<br>`"tag_description":"taga apraksts",`<br>`"category":"taga kategorija"`<br>`}]`| |**vmware.dc.discovery**|<|<| |Veic datu centru atklāšanu.|{\#DATACENTER}|Datu centra nosaukums.| |^|{\#DATACENTERID}|Datu centra identifikators.| |^|"tags"|Masīvs, kas satur tagus ar taga nosaukumu, aprakstu un kategoriju.<br><br>Masīva struktūra:<br>`[{`<br>`"tag":"taga nosaukums",`<br>`"tag_description":"taga apraksts",`<br>`"category":"taga kategorija"`<br>`}]`| |**vmware.dvswitch.discovery**|<|<| |Veic vSphere izkliedēto komutatoru atklāšanu.|{\#DVS.NAME}|Komutatora nosaukums.| |^|{\#DVS.UUID}|Komutatora identifikators.| |**vmware.hv.discovery**|<|<| |Veic hipervizoru atklāšanu.|{\#HV.UUID}|Unikāls hipervizora identifikators.| |^|{\#HV.ID}|Hipervizora identifikators (HostSystem pārvaldītā objekta nosaukums).| |^|{\#HV.NAME}|Hipervizora nosaukums.| |^|{\#HV.NETNAME}|Hipervizora tīkla hosta nosaukums.| |^|{\#HV.IP}|Hipervizora IP adrese; var būt tukša.<br><br>HA konfigurācijas gadījumā ar vairākām tīkla saskarnēm tiek ievērota šāda saskarnes atlases prioritāte:<br>- priekšroka tiek dota IP adresei, kas atrodas tajā pašā IP apakštīklā kā vCenter IP;<br>- priekšroka tiek dota IP adresei no IP apakštīkla ar noklusējuma vārteju;<br>- priekšroka tiek dota IP adresei no saskarnes ar mazāko ID.| |^|{\#CLUSTER.NAME}|Klastera nosaukums; var būt tukšs.| |^|{\#DATACENTER.NAME}|Datu centra nosaukums.| |^|{\#PARENT.NAME}|Konteinera nosaukums, kurā tiek glabāts hipervizors.| |^|{\#PARENT.TYPE}|Konteinera tips, kurā tiek glabāts hipervizors. Vērtības var būt `Datacenter`, `Folder`, `ClusterComputeResource`, `VMware`, kur "VMware" apzīmē nezināmu konteinera tipu.| |^|"resource_pool"|Masīvs, kas satur resursu pūla datus, tostarp resursu grupas ID, tagu masīvu, resursu pūla ceļu un virtuālo mašīnu skaitu.<br><br>Masīva struktūra:<br>`[{`<br>`"rpid":"resursu grupas id",`<br>`"tags":[{}],`<br>`"rpath":"resursu grupas ceļš",`<br>`"vm_count":0`<br>`}]`<br><br>`"tags"` masīva struktūru skatiet laukā "tags".| |^|"tags"|Masīvs, kas satur tagus ar taga nosaukumu, aprakstu un kategoriju.<br><br>Masīva struktūra:<br>`[{`<br>`"tag":"taga nosaukums",`<br>`"tag_description":"taga apraksts",`<br>`"category":"taga kategorija"`<br>`}]`| |**vmware.hv.datastore.discovery**|<|<| |Veic hipervizora datu krātuvju atklāšanu. Ņemiet vērā, ka vienu un to pašu datu krātuvi var izmantot vairāki hipervizori.|{\#DATASTORE}|Datu krātuves nosaukums.| |^|{\#DATASTORE.TYPE}|Datu krātuves tips.<br><br>Vērtību piemēri: `VMFS`, `NFS`, `vsan` u.c.| |^|{\#DATASTORE.UUID}|Datu krātuves identifikators.| |^|{\#MULTIPATH.COUNT}|Reģistrētais datu krātuves ceļu skaits.| |^|{\#MULTIPATH.PARTITION.COUNT}|Pieejamo diska nodalījumu skaits.| |^|"datastore_extent"|Masīvs, kas satur datu krātuves extent instances nosaukumu un nodalījuma ID.<br><br>Masīva struktūra:<br>`[{`<br>`"partitionid":1,`<br>`"instance":"nosaukums"`<br>`}]`| |^|"tags"|Masīvs, kas satur tagus ar taga nosaukumu, aprakstu un kategoriju.<br><br>Masīva struktūra:<br>`[{`<br>`"tag":"taga nosaukums",`<br>`"tag_description":"taga apraksts",`<br>`"category":"taga kategorija"`<br>`}]`| |**vmware.hv.net.if.discovery**|<|<| |Veic hipervizora tīkla saskarņu atklāšanu.|{\#IFNAME}|Saskarnes nosaukums.| |^|{\#IFDRIVER}|Saskarnes draiveris.| |^|{\#IFDUPLEX}|Saskarnes dupleksa iestatījumi.| |^|{\#IFSPEED}|Saskarnes ātrums.| |^|{\#IFMAC}|Saskarnes MAC adrese.| |**vmware.vm.discovery**|<|<| |Veic virtuālo mašīnu atklāšanu.|{\#VM.UUID}|Unikāls virtuālās mašīnas identifikators.| |^|{\#VM.ID}|Virtuālās mašīnas identifikators (VirtualMachine pārvaldītā objekta nosaukums).| |^|{\#VM.NAME}|Virtuālās mašīnas nosaukums.| |^|{\#HV.NAME}|Hipervizora nosaukums.| |^|{\#HV.UUID}|Unikāls hipervizora identifikators.| |^|{\#HV.ID}|Hipervizora identifikators (HostSystem pārvaldītā objekta nosaukums).| |^|{\#CLUSTER.NAME}|Klastera nosaukums; var būt tukšs.| |^|{\#DATACENTER.NAME}|Datu centra nosaukums.| |^|{\#DATASTORE.NAME}|Datu krātuves nosaukums.| |^|{\#DATASTORE.UUID}|Datu krātuves identifikators.| |^|{\#VM.IP}|Virtuālās mašīnas IP adrese; var būt tukša.| |^|{\#VM.DNS}|Virtuālās mašīnas DNS nosaukums; var būt tukšs.| |^|{\#VM.GUESTFAMILY}|Viesa virtuālās mašīnas OS saime; var būt tukša.| |^|{\#VM.GUESTFULLNAME}|Pilns viesa virtuālās mašīnas OS nosaukums; var būt tukšs.| |^|{\#VM.FOLDER}|Virtuālās mašīnas vecākmapju ķēde; to var izmantot kā vērtību ligzdotām grupām; mapju nosaukumi tiek apvienoti ar "/". Var būt tukšs.| |^|{\#VM.TOOLS.STATUS}|VMware virtuālās mašīnas rīku stāvoklis.| |^|{\#VM.POWERSTATE}|VMware virtuālās mašīnas barošanas stāvoklis (`poweredOff`, `poweredOn` vai `suspended`).| |^|{\#VM.RPOOL.ID}|Resursu pūla identifikators.| |^|{\#VM.RPOOL.PATH}|Pilns resursu pūla ceļš, neiekļaujot "root" nosaukumu "Resources". Mapju nosaukumi tiek apvienoti ar "/".| |^|{\#VM.SNAPSHOT.COUNT}|VM momentuzņēmumu skaits.| |^|"tags"|Masīvs, kas satur tagus ar taga nosaukumu, aprakstu un kategoriju.<br><br>Masīva struktūra:<br>`[{`<br>`"tag":"taga nosaukums",`<br>`"tag_description":"taga apraksts",`<br>`"category":"taga kategorija"`<br>`}]`| |^|"vm_customattribute"|Virtuālās mašīnas pielāgoto atribūtu masīvs (ja definēti).<br><br>Masīva struktūra:<br>`[{`<br>`"name":"pielāgotā lauka nosaukums",`<br>`"value":"pielāgotā lauka vērtība"`<br>`}]`| |^|"net_if"|Virtuālās mašīnas tīkla saskarņu masīvs.<br><br>Masīva struktūra:<br>`[{`<br>`"ifname": "saskarnes nosaukums",`<br>`"ifdesc": "saskarnes apraksts",`<br>`"ifmac": "00:00:00:00:00:00",`<br>`"ifconnected": true,`<br>`"iftype": "saskarnes tips",`<br>`"ifbackingdevice": "saskarnes piesaistītā ierīce",`<br>`"ifdvswitch_uuid": "saskarnes komutatora uuid",`<br>`"ifdvswitch_portgroup": "saskarnes komutatora portu grupa",`<br>`"ifdvswitch_port": "saskarnes komutatora ports",`<br>`"ifip": ["saskarnes ip adreses"]`<br>`}]`<br><br>Atgriezto datu aprakstu skatiet vienuma atslēgā "vmware.vm.net.if.discovery".| |**vmware.vm.net.if.discovery**|<|<| |Veic virtuālās mašīnas tīkla saskarnes atklāšanu.|{\#IFNAME}|Tīkla saskarnes nosaukums.| |^|{\#IFDESC}|Saskarnes apraksts.| |^|{\#IFMAC}|Saskarnes MAC adrese.| |^|{\#IFCONNECTED}|Saskarnes savienojuma statuss (`false` - atvienota; `true` - savienota).| |^|{\#IFTYPE}|Saskarnes tips.| |^|{\#IFBACKINGDEVICE}|Piesaistītās ierīces nosaukums.| |^|{\#IFDVSWITCH.UUID}|Unikāls vSphere Distributed Switch identifikators.| |^|{\#IFDVSWITCH.PORTGROUP}|Izkliedētā portu grupa.| |^|{\#IFDVSWITCH.PORT}|vSphere Distributed Switch ports.| |^|"ifip"|Saskarnes adrešu masīvs.| |**vmware.vm.vfs.dev.discovery**|<|<| |Veic virtuālās mašīnas diska ierīču atklāšanu.|{\#DISKNAME}|Diska ierīces nosaukums.| |**vmware.vm.vfs.fs.discovery**|<|<| |Veic virtuālās mašīnas failu sistēmas atklāšanu.|{\#FSNAME}|Failu sistēmas nosaukums.| # 2 What is Zabbix # 2 Kas ir Zabbix # 2 Windows Zabbix agent # 2 Windows Zabbix aģents # 2 Zabbix agent 2 template operation Steps to ensure correct operation of templates that collect metrics with [Zabbix agent 2](/manual/concepts/agent2): 1. Make sure that the agent 2 is installed on the host, and that the installed version contains the required plugin. In some cases, you may need to [upgrade](/manual/installation/upgrade) the agent 2 first. 2. [Link](/manual/config/templates/linking#linking-a-template) the template to a target host (if the template is not available in your Zabbix installation, you may need to [import](/manual/config/templates_out_of_the_box#template-upgrade) the template first). 3. If necessary, adjust the values of template macros. Note that user macros can be used to override configuration parameters. 4. Configure the instance being monitored to allow data sharing with Zabbix. ::: noteimportant Zabbix agent 2 templates work in conjunction with the plugins. While the basic configuration can be done by simply adjusting user macros, the deeper customization can be achieved by [configuring the plugin](/manual/extensions/plugins#named-sessions) itself. For example, if a plugin supports named sessions, it is possible to monitor several entities of the same kind (e.g. MySQL1 and MySQL2) by specifying named session with own URI, username and password for each entity in the configuration file. ::: A detailed description of a template, including the full list of macros, items, and triggers, is available in the template's README file (accessible by clicking on a template name). The following templates are available: - [Ceph by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/ceph_agent2/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Docker](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/docker/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Memcached](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/memcached/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [MongoDB cluster by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mongodb_cluster/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [MongoDB node by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mongodb/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [MySQL by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mysql_agent2/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [MySQL by Zabbix agent 2 active](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mysql_agent2_active/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Oracle by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/oracle_agent2/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [PostgreSQL by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/postgresql_agent2/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [PostgreSQL by Zabbix agent 2 active](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/postgresql_agent2_active/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Redis](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/redis/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [SMART by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/smart_agent2/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [SMART by Zabbix agent 2 active](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/smart_agent2_active/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Systemd by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/systemd/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Website certificate by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/certificate_agent2/README.md?at=refs%2Fheads%2Frelease%2F7.0) # 2 Zabbix aģents 2 veidnes darbība Darbības, lai nodrošinātu pareizu veidņu darbību, kas apkopo metriku ar [Zabbix aģents 2](/manual/concepts/agent2): 1. Pārliecinieties, ka aģents 2 ir instalēts uz hosta un ka instalētajā versijā ir nepieciešamais spraudnis. Dažos gadījumos vispirms var būt nepieciešams [jaunināt](/manual/installation/upgrade) aģents 2. 2. [Piesaistiet](/manual/config/templates/linking#linking-a-template) veidni mērķa hostam (ja veidne nav pieejama jūsu Zabbix instalācijā, vispirms var būt nepieciešams veikt veidnes [importēšanu](/manual/config/templates_out_of_the_box#template-upgrade)). 3. Ja nepieciešams, pielāgojiet veidnes makro vērtības. Ņemiet vērā, ka lietotāja makro var izmantot konfigurācijas parametru pārrakstīšanai. 4. Konfigurējiet uzraugāmo instanci, lai tā atļautu datu koplietošanu ar Zabbix. ::: noteimportant Zabbix aģents 2 veidnes darbojas kopā ar spraudņiem. Lai gan pamata konfigurāciju var veikt, vienkārši pielāgojot lietotāja makro, dziļāku pielāgošanu var panākt, pašam [konfigurējot spraudni](/manual/extensions/plugins#named-sessions). Piemēram, ja spraudnis atbalsta nosauktas sesijas, ir iespējams uzraudzīt vairākas viena veida entītijas (piem., MySQL1 un MySQL2), konfigurācijas failā katrai entītijai norādot nosauktu sesiju ar savu URI, lietotājvārdu un paroli. ::: Detalizēts veidnes apraksts, tostarp pilns makro, vienumu un trigeru saraksts, ir pieejams veidnes README failā (tam var piekļūt, noklikšķinot uz veidnes nosaukuma). Pieejamas šādas veidnes: - [Ceph by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/ceph_agent2/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Docker](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/docker/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Memcached](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/memcached/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [MongoDB cluster by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mongodb_cluster/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [MongoDB node by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mongodb/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [MySQL by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mysql_agent2/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [MySQL by Zabbix agent 2 active](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mysql_agent2_active/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Oracle by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/oracle_agent2/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [PostgreSQL by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/postgresql_agent2/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [PostgreSQL by Zabbix agent 2 active](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/postgresql_agent2_active/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Redis](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/redis/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [SMART by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/smart_agent2/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [SMART by Zabbix agent 2 active](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/smart_agent2_active/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Systemd by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/systemd/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Website certificate by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/certificate_agent2/README.md?at=refs%2Fheads%2Frelease%2F7.0) # 2 Zabbix agent/agent2 protocol Please refer to [Passive and active agent checks](/manual/appendix/items/activepassive) page for more information on Zabbix agent and Zabbix agent 2 protocols. # 2 Zabbix aģenta/agent2 protokols Lūdzu, skatiet lapu [Passive and active agent checks](/manual/appendix/items/activepassive), lai iegūtu vairāk informācijas par Zabbix aģenta un Zabbix agent 2 protokoliem. # 2 Zabbix proxy # 2 Zabbix starpniekserveris # 30 Upgrade notes for 7.0.19 This minor version has no upgrade notes. # 30 Atjaunināšanas piezīmes 7.0.19 versijai Šai mazajai versijai nav atjaunināšanas piezīmju. # 30 Web monitoring # 30 Tīmekļa uzraudzība # 30 Web monitoring # 30 Tīmekļa uzraudzība # 30 What's new in Zabbix 7.0.25 # 30 Kas jauns Zabbix 7.0.25 versijā # 31 Upgrade notes for 7.0.20 **Warning!** Upgrading to this version is not recommended due to [errors](/manual/installation/known_issues#known-issues-in-7.0.20) related to graphs and the Zabbix agent 2 MySQL plugin. # 31 Atjaunināšanas piezīmes 7.0.20 versijai **Brīdinājums!** Atjaunināšana uz šo versiju nav ieteicama, jo ir [kļūdas](/manual/installation/known_issues#known-issues-in-7.0.20), kas saistītas ar grafikiem un Zabbix aģents 2 MySQL spraudni. # 31 What's new in Zabbix 7.0.26 # 31 Kas jauns Zabbix 7.0.26 versijā # 32 Upgrade notes for 7.0.21 This minor version has no upgrade notes. # 32 Atjaunināšanas piezīmes versijai 7.0.21 Šai mazajai versijai nav atjaunināšanas piezīmju. # 32 What's new in Zabbix 7.0.27 This minor version has no functional changes. # 32 Kas jauns Zabbix 7.0.27 Šajā mazajā versijā nav funkcionālu izmaiņu. # 33 Upgrade notes for 7.0.22 # 33 Atjaunināšanas piezīmes 7.0.22 versijai # 33 What's new in Zabbix 7.0.28 # 33 Kas jauns Zabbix 7.0.28 versijā # 34 Upgrade notes for 7.0.23 # 34 Atjaunināšanas piezīmes par 7.0.23 # 34 What's new in Zabbix 7.0.29 # 34 Kas jauns Zabbix 7.0.29 versijā # 35 Upgrade notes for 7.0.24 # 35 Atjaunināšanas piezīmes par 7.0.24 # 36 Upgrade notes for 7.0.25 This minor version has no upgrade notes. # 36 Atjaunināšanas piezīmes 7.0.25 versijai Šai mazajai versijai nav atjaunināšanas piezīmju. # 37 Upgrade notes for 7.0.26 # 37 Atjaunināšanas piezīmes par 7.0.26 # 38 Upgrade notes for 7.0.27 # 38 Atjaunināšanas piezīmes par 7.0.27 # 39 Upgrade notes for 7.0.28 # 39 Atjaunināšanas piezīmes par 7.0.28 # 39 Upgrade notes for 7.0.28 This minor version has no upgrade notes. # 39 Jaunināšanas piezīmes 7.0.28 versijai Šai mazajai versijai nav jaunināšanas piezīmju. # 3 Additional operations # 3 Papildu darbības # 3 Ad-hoc graphs # 3 Ad-hoc grafiki # 3 Agent 2 # 3 Aģents 2 # 3 Availability report # 3 Pieejamības atskaite ##### 3 Back up configuration files, PHP files and Zabbix binaries Make a backup copy of Zabbix binaries, configuration files and the PHP file directory. ##### 3 Dublējiet konfigurācijas failus, PHP failus un Zabbix bināros failus Izveidojiet Zabbix bināro failu, konfigurācijas failu un PHP failu direktorija rezerves kopiju. ##### 3 Back up Zabbix configuration files, PHP files, and Zabbix binaries Back up existing Zabbix configuration files, PHP files, and Zabbix binaries. For configuration files, run: ```bash mkdir /opt/zabbix-backup/ cp /etc/zabbix/zabbix_server.conf /opt/zabbix-backup/ cp /etc/apache2/conf-enabled/zabbix.conf /opt/zabbix-backup/ ``` For PHP files and Zabbix binaries, run: ```bash cp -R /usr/share/zabbix/ /opt/zabbix-backup/ cp -R /usr/share/zabbix-* /opt/zabbix-backup/ ``` ##### 3 Izveidojiet Zabbix konfigurācijas failu, PHP failu un Zabbix bināro failu dublējumkopiju Izveidojiet esošo Zabbix konfigurācijas failu, PHP failu un Zabbix bināro failu dublējumkopiju. Konfigurācijas failiem izpildiet: ```bash mkdir /opt/zabbix-backup/ cp /etc/zabbix/zabbix_server.conf /opt/zabbix-backup/ cp /etc/apache2/conf-enabled/zabbix.conf /opt/zabbix-backup/ ``` PHP failiem un Zabbix binārajiem failiem izpildiet: ```bash cp -R /usr/share/zabbix/ /opt/zabbix-backup/ cp -R /usr/share/zabbix-* /opt/zabbix-backup/ ``` ##### 3 Back up Zabbix configuration files, PHP files, and Zabbix binaries Back up existing Zabbix configuration files, PHP files, and Zabbix binaries. For configuration files, run: ```bash mkdir /opt/zabbix-backup/ cp /etc/zabbix/zabbix_server.conf /opt/zabbix-backup/ cp /etc/httpd/conf.d/zabbix.conf /opt/zabbix-backup/ ``` For PHP files and Zabbix binaries, run: ```bash cp -R /usr/share/zabbix/ /opt/zabbix-backup/ cp -R /usr/share/zabbix-* /opt/zabbix-backup/ ``` ##### 3 Izveidojiet Zabbix konfigurācijas failu, PHP failu un Zabbix bināro failu dublējumkopiju Izveidojiet esošo Zabbix konfigurācijas failu, PHP failu un Zabbix bināro failu dublējumkopiju. Konfigurācijas failiem izpildiet: ```bash mkdir /opt/zabbix-backup/ cp /etc/zabbix/zabbix_server.conf /opt/zabbix-backup/ cp /etc/httpd/conf.d/zabbix.conf /opt/zabbix-backup/ ``` PHP failiem un Zabbix binārajiem failiem izpildiet: ```bash cp -R /usr/share/zabbix/ /opt/zabbix-backup/ cp -R /usr/share/zabbix-* /opt/zabbix-backup/ ``` # 3 Building Zabbix agent on macOS # 3 Zabbix aģenta būvēšana operētājsistēmā macOS ##### 3 Create Zabbix database For Zabbix [server](/manual/concepts/server) and [proxy](/manual/concepts/proxy) daemons, as well as Zabbix frontend, a database is required. It is not needed to run Zabbix [agent](/manual/concepts/agent). SQL [scripts are provided](/manual/appendix/install/db_scripts) for creating database schema and inserting the dataset. Zabbix proxy database needs only the schema while Zabbix server database requires also the dataset on top of the schema. Having created a Zabbix database, proceed to the following steps of compiling Zabbix. ##### 3 Izveidojiet Zabbix datubāzi Zabbix [serveris](/manual/concepts/server) un [starpniekserveris](/manual/concepts/proxy) dēmoniem, kā arī Zabbix lietotāja saskarnei ir nepieciešama datubāze. Tā nav nepieciešama, lai darbinātu Zabbix [aģents](/manual/concepts/agent). SQL [skripti ir pieejami](/manual/appendix/install/db_scripts), lai izveidotu datubāzes shēmu un ievietotu datu kopu. Zabbix starpniekservera datubāzei ir nepieciešama tikai shēma, savukārt Zabbix servera datubāzei papildus shēmai ir nepieciešama arī datu kopa. Kad Zabbix datubāze ir izveidota, turpiniet ar nākamajiem Zabbix kompilēšanas soļiem. # 3 Custom alert scripts # 3 Pielāgoti brīdinājumu skripti # 3 Dashboards Dashboards - both [global dashboards](/manual/web_interface/frontend_sections/dashboards) and [host dashboards](/manual/web_interface/frontend_sections/monitoring/hosts/dashboards) - provide a strong visualization platform with such [widgets](/manual/web_interface/frontend_sections/dashboards/widgets) and tools as modern graphs, maps, slideshows, and more. {width="600"} # 3 Paneļi Paneļi — gan [globālie paneļi](/manual/web_interface/frontend_sections/dashboards), gan [hostu paneļi](/manual/web_interface/frontend_sections/monitoring/hosts/dashboards) — nodrošina jaudīgu vizualizācijas platformu ar tādiem [logrīkiem](/manual/web_interface/frontend_sections/dashboards/widgets) un rīkiem kā moderni grafiki, kartes, slaidrādes un citi. {width="600"} # 3 Database upgrade to primary keys # 3 Database upgrade to primary keys # 3 Data overview # 3 Datu pārskats # 3 Data overview # 3 Datu pārskats # 3 Date and time functions All functions listed here are supported in: - [Trigger expressions](/manual/config/triggers/expression) - [Calculated items](/manual/config/items/itemtypes/calculated) - [Expression macros](/manual/config/macros/expression_macros) ::: noteimportant Date and time functions cannot be used in the expression by themselves; at least one function from [another group](/manual/appendix/functions), referencing the host item, must be included in the expression (except the [nodata()](/manual/appendix/functions/history#nodata) function). For detailed information on how date and time functions work within expressions, see [Calculation time](/manual/config/triggers#calculation-time). ::: The functions are listed without additional information. Click on the function to see the full details. |Function|Description| |--|--------| |[date](#date)|The current date in YYYYMMDD format.| |[dayofmonth](#dayofmonth)|The day of month in range of 1 to 31.| |[dayofweek](#dayofweek)|The day of week in range of 1 to 7.| |[now](#now)|The number of seconds since the Epoch (00:00:00 UTC, January 1, 1970).| |[time](#time)|The current time in HHMMSS format.| # 3 Datuma un laika funkcijas Visas šeit uzskaitītās funkcijas tiek atbalstītas: - [Trigeru izteiksmēs](/manual/config/triggers/expression) - [Aprēķinātajos vienumos](/manual/config/items/itemtypes/calculated) - [Izteiksmju makrosos](/manual/config/macros/expression_macros) ::: noteimportant Datuma un laika funkcijas nevar izmantot izteiksmē pašas par sevi; izteiksmē jāiekļauj vismaz viena funkcija no [citas grupas](/manual/appendix/functions), kas atsaucas uz host vienumu (izņemot funkciju [nodata()](/manual/appendix/functions/history#nodata)). Plašāku informāciju par to, kā datuma un laika funkcijas darbojas izteiksmēs, skatiet sadaļā [Aprēķina laiks](/manual/config/triggers#calculation-time). ::: Funkcijas ir uzskaitītas bez papildu informācijas. Noklikšķiniet uz funkcijas, lai skatītu pilnu informāciju. |Function|Description| |--|--------| |[date](#date)|Pašreizējais datums formātā YYYYMMDD.| |[dayofmonth](#dayofmonth)|Mēneša diena diapazonā no 1 līdz 31.| |[dayofweek](#dayofweek)|Nedēļas diena diapazonā no 1 līdz 7.| |[now](#now)|Sekunžu skaits kopš Unix laikmeta sākuma (1970. gada 1. janvāris, 00:00:00 UTC).| |[time](#time)|Pašreizējais laiks formātā HHMMSS.| # 3 Discovery of CPUs and CPU cores In a similar way as [file systems](/manual/discovery/low_level_discovery#configuring-lowlevel-discovery) are discovered, it is possible to also discover CPUs and CPU cores. # 3 CPU un CPU kodolu atklāšana Līdzīgi kā tiek atklātas [failu sistēmas](/manual/discovery/low_level_discovery#configuring-lowlevel-discovery), ir iespējams atklāt arī CPU un CPU kodolus. # 3 Ember+ plugin # 3 Ember+ spraudnis # 3 Frontend modules # 3 Lietotāja saskarne moduļi # 3 Graph prototypes # 3 Grafiku prototipi # 3 Graph prototypes # 3 Grafiku prototipi # 3 Graph prototypes We can create graph prototypes, too:  Attributes that are specific for graph prototypes: |Parameter|Description| |--|--------| |*Discover*|If checked (default) the graph will be added to a discovered entity.<br>If unchecked, the graph will not be added to a discovered entity, unless this setting is [overridden](/manual/discovery/low_level_discovery#override) in the discovery rule.|  Finally, we have created a discovery rule that looks as shown below. It has five item prototypes, two trigger prototypes, and one graph prototype.  # 3 Grafu prototipi Mēs varam izveidot arī grafu prototipus:  Grafu prototipiem raksturīgie atribūti: |Parameter|Description| |--|--------| |*Discover*|Ja atzīmēts (noklusējums), grafiks tiks pievienots atklātajai entitātei.<br>Ja nav atzīmēts, grafiks netiks pievienots atklātajai entitātei, ja vien šis iestatījums nav [pārrakstīts](/manual/discovery/low_level_discovery#override) atklāšanas noteikumā.|  Visbeidzot, esam izveidojuši atklāšanas noteikumu, kas izskatās, kā parādīts tālāk. Tam ir pieci vienumu prototipi, divi trigeru prototipi un viens grafu prototips.  # 3 Graphs # 3 Grafiki # 3 Graphs # 3 Grafiki # 3 Housekeeping # 3 Uzturēšana # 3 HTTP template operation Steps to ensure correct operation of templates that collect metrics with the [HTTP agent](/manual/config/items/itemtypes/http): 1. Create a host in Zabbix that corresponds to the monitoring target. Specify the IP address/DNS name of the monitoring target as the main host interface. This is needed for the {HOST.CONN} macro to resolve properly in the template items. 2. [Link](/manual/config/templates/linking#linking-a-template) the template to the host created in step 1 (if the template is not available in your Zabbix installation, you may need to [import](/manual/config/templates_out_of_the_box#template-upgrade) the template first). 3. If necessary, adjust the values of template macros. 4. Configure the instance being monitored to allow data sharing with Zabbix. A detailed description of a template, including the full list of macros, items and triggers, is available in the template's README file (accessible by clicking on a template name). The following templates are available: - [Acronis Cyber Protect Cloud by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/acronis/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Apache by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/apache_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Asterisk by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/tel/asterisk_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [AWS by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [AWS Cost Explorer by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [AWS EC2 by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [AWS ECS Cluster by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [AWS ECS Serverless Cluster by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [AWS ELB Application Load Balancer by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [AWS ELB Network Load Balancer by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [AWS Lambda by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [AWS RDS instance by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [AWS S3 bucket by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Azure by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/azure_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Cisco Meraki organization by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/meraki_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Cisco SD-WAN by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/cisco/cisco_sdwan_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Cisco Secure Firewall Threat Defense by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/cisco/cisco_secure_ftd_http/README.md?at=release%2F7.0) - [ClickHouse by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/clickhouse_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Cloudflare by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/cloudflare_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [CockroachDB by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/cockroachdb_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Control-M enterprise manager by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/controlm_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Control-M server by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/controlm_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [DELL PowerEdge R720 by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/dell/dell_r720_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [DELL PowerEdge R740 by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/dell/dell_r740_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [DELL PowerEdge R820 by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/dell/dell_r820_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [DELL PowerEdge R840 by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/dell/dell_r840_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Elasticsearch Cluster by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/elasticsearch_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Envoy Proxy by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/envoy_proxy_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Etcd by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/etcd_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [FortiGate by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/fortinet/fortigate_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [GitHub repository by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/github_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [GitLab by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/gitlab_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Google Cloud Platform (GCP) by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/gcp/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Hadoop by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/hadoop_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [HAProxy by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/haproxy_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [HashiCorp Consul Cluster by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/consul_http/consul_cluster/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [HashiCorp Consul Node by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/consul_http/consul/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [HashiCorp Nomad by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nomad/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [HashiCorp Vault by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/vault_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Hikvision camera by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cctv/hikvision/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [HPE iLO by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/hpe_ilo_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [HPE MSA 2040 Storage by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/san/hpe_msa2040_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [HPE MSA 2060 Storage by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/san/hpe_msa2060_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [HPE Primera by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/san/hpe_primera_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [HPE Synergy by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/hpe_synergy_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [InfluxDB by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/influxdb_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Jenkins by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/jenkins/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Kubernetes API server by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/kubernetes_http/kubernetes_api_server_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Kubernetes cluster state by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/kubernetes_http/kubernetes_state_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Kubernetes Controller manager by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/kubernetes_http/kubernetes_controller_manager_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Kubernetes kubelet by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/kubernetes_http/kubernetes_kubelet_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Kubernetes nodes by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/kubernetes_http/kubernetes_nodes_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Kubernetes Scheduler by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/kubernetes_http/kubernetes_scheduler_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [MantisBT by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/mantisbt_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Microsoft 365 reports by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/ms365_http/README.md?at=release%2F7.0) - [Microsoft SharePoint by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/sharepoint_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [NetApp AFF A700 by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/san/netapp_aff_a700_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Nextcloud by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nextcloud/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [NGINX by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nginx_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [NGINX Plus by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nginx_plus_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Nutanix Prism Element by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nutanix_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [OpenStack by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/openstack/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [OpenWeatherMap by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/openweathermap_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Oracle Cloud by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/oracle_cloud/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Palo Alto PA-440 by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/paloalto/paloalto_pa440?at=refs%2Fheads%2Frelease%2F7.0) - [PHP-FPM by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/php-fpm_agent/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Proxmox VE by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/proxmox/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Pure Storage FlashArray v1 and v2 by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/san/pure_storage_flasharray/README.md?at=release%2F7.0) - [RabbitMQ cluster by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/rabbitmq_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Ribbon SBC Edge by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/ribbon/ribbon_sbc_edge/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Ribbon SBC SWe CE by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/ribbon/ribbon_sbc_swe_core/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Ribbon SBC SWe Core by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/ribbon/ribbon_sbc_swe_core/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [TiDB by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/tidb_http/tidb_tidb_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [TiDB PD by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/tidb_http/tidb_pd_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [TiDB TiKV by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/tidb_http/tidb_tikv_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Travis CI by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/travis_ci_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Veeam Backup Enterprise Manager by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/veeam/enterprise_manager_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Veeam Backup and Replication by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/veeam/backup_replication_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [VeloCloud SD-WAN by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/velocloud_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [VeloCloud SD-WAN Edge by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/velocloud_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [YugabyteDB by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/yugabytedb_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [ZooKeeper by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/zookeeper_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) # 3 HTTP veidnes darbība Darbības soļi, lai nodrošinātu pareizu to veidņu darbību, kas apkopo metriku ar [HTTP aģents](/manual/config/items/itemtypes/http): 1. Izveidojiet Zabbix hostu, kas atbilst uzraugāmajam mērķim. Norādiet uzraugāmā mērķa IP adresi/DNS nosaukumu kā galveno hosta saskarni. Tas ir nepieciešams, lai {HOST.CONN} makross veidnes vienumos tiktu pareizi atrisināts. 2. [Piesaistiet](/manual/config/templates/linking#linking-a-template) veidni 1. solī izveidotajam hostam (ja veidne jūsu Zabbix instalācijā nav pieejama, vispirms, iespējams, būs jāveic veidnes [importēšana](/manual/config/templates_out_of_the_box#template-upgrade)). 3. Ja nepieciešams, pielāgojiet veidnes makrosu vērtības. 4. Konfigurējiet uzraugāmo instanci, lai tā atļautu datu koplietošanu ar Zabbix. Detalizēts veidnes apraksts, tostarp pilns makrosu, vienumu un trigeru saraksts, ir pieejams veidnes README failā (tam var piekļūt, noklikšķinot uz veidnes nosaukuma). Pieejamas šādas veidnes: - [Acronis Cyber Protect Cloud by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/acronis/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Apache by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/apache_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Asterisk by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/tel/asterisk_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [AWS by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [AWS Cost Explorer by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [AWS EC2 by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [AWS ECS Cluster by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [AWS ECS Serverless Cluster by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [AWS ELB Application Load Balancer by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [AWS ELB Network Load Balancer by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [AWS Lambda by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [AWS RDS instance by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [AWS S3 bucket by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Azure by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/azure_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Cisco Meraki organization by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/meraki_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Cisco SD-WAN by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/cisco/cisco_sdwan_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Cisco Secure Firewall Threat Defense by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/cisco/cisco_secure_ftd_http/README.md?at=release%2F7.0) - [ClickHouse by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/clickhouse_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Cloudflare by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/cloudflare_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [CockroachDB by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/cockroachdb_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Control-M enterprise manager by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/controlm_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Control-M server by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/controlm_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [DELL PowerEdge R720 by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/dell/dell_r720_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [DELL PowerEdge R740 by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/dell/dell_r740_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [DELL PowerEdge R820 by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/dell/dell_r820_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [DELL PowerEdge R840 by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/dell/dell_r840_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Elasticsearch Cluster by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/elasticsearch_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Envoy Proxy by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/envoy_proxy_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Etcd by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/etcd_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [FortiGate by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/fortinet/fortigate_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [GitHub repository by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/github_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [GitLab by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/gitlab_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Google Cloud Platform (GCP) by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/gcp/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Hadoop by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/hadoop_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [HAProxy by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/haproxy_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [HashiCorp Consul Cluster by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/consul_http/consul_cluster/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [HashiCorp Consul Node by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/consul_http/consul/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [HashiCorp Nomad by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nomad/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [HashiCorp Vault by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/vault_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Hikvision camera by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cctv/hikvision/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [HPE iLO by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/hpe_ilo_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [HPE MSA 2040 Storage by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/san/hpe_msa2040_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [HPE MSA 2060 Storage by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/san/hpe_msa2060_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [HPE Primera by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/san/hpe_primera_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [HPE Synergy by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/hpe_synergy_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [InfluxDB by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/influxdb_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Jenkins by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/jenkins/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Kubernetes API server by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/kubernetes_http/kubernetes_api_server_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Kubernetes cluster state by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/kubernetes_http/kubernetes_state_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Kubernetes Controller manager by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/kubernetes_http/kubernetes_controller_manager_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Kubernetes kubelet by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/kubernetes_http/kubernetes_kubelet_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Kubernetes nodes by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/kubernetes_http/kubernetes_nodes_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Kubernetes Scheduler by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/kubernetes_http/kubernetes_scheduler_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [MantisBT by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/mantisbt_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Microsoft 365 reports by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/ms365_http/README.md?at=release%2F7.0) - [Microsoft SharePoint by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/sharepoint_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [NetApp AFF A700 by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/san/netapp_aff_a700_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Nextcloud by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nextcloud/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [NGINX by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nginx_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [NGINX Plus by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nginx_plus_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Nutanix Prism Element by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nutanix_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [OpenStack by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/openstack/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [OpenWeatherMap by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/openweathermap_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Oracle Cloud by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/oracle_cloud/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Palo Alto PA-440 by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/paloalto/paloalto_pa440?at=refs%2Fheads%2Frelease%2F7.0) - [PHP-FPM by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/php-fpm_agent/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Proxmox VE by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/proxmox/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Pure Storage FlashArray v1 and v2 by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/san/pure_storage_flasharray/README.md?at=release%2F7.0) - [RabbitMQ cluster by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/rabbitmq_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Ribbon SBC Edge by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/ribbon/ribbon_sbc_edge/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Ribbon SBC SWe CE by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/ribbon/ribbon_sbc_swe_core/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Ribbon SBC SWe Core by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/ribbon/ribbon_sbc_swe_core/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [TiDB by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/tidb_http/tidb_tidb_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [TiDB PD by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/tidb_http/tidb_pd_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [TiDB TiKV by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/tidb_http/tidb_tikv_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Travis CI by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/travis_ci_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Veeam Backup Enterprise Manager by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/veeam/enterprise_manager_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Veeam Backup and Replication by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/veeam/backup_replication_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [VeloCloud SD-WAN by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/velocloud_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [VeloCloud SD-WAN Edge by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/velocloud_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [YugabyteDB by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/yugabytedb_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [ZooKeeper by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/zookeeper_http/README.md?at=refs%2Fheads%2Frelease%2F7.0) # 3 Installation from sources You can get the very latest version of Zabbix by compiling it from the sources. A step-by-step tutorial for installing Zabbix from the sources is provided here. # 3 Installation from sources You can get the very latest version of Zabbix by compiling it from the sources. A step-by-step tutorial for installing Zabbix from the sources is provided here. ##### 3 Install new agent binaries Use these [instructions](/manual/installation/install#installing-zabbix-daemons) to compile Zabbix agent from sources. Alternatively, you may download pre-compiled Zabbix agents from the [Zabbix download page](http://www.zabbix.com/download.php). ##### 3 Instalēt jaunus aģenta bināros failus Izmantojiet šos [instrukcijas](/manual/installation/install#installing-zabbix-daemons) , lai kompilētu Zabbix aģents no pirmkoda. Alternatīvi varat lejupielādēt iepriekš kompilētus Zabbix aģentus no [Zabbix lejupielādes lapas](http://www.zabbix.com/download.php). ##### 3 Install new proxy binaries Use these [instructions](/manual/installation/install#installing-zabbix-daemons) to compile Zabbix proxy from sources. ##### 3 Instalēt jaunus starpniekservera bināros failus Izmantojiet šos [instrukcijas](/manual/installation/install#installing-zabbix-daemons) lai kompilētu Zabbix starpniekserveri no avota koda. # 3 Inventory # 3 Inventārs # 3 Item menu # 3 Vienuma izvēlne # 3 Item types # 3 Vienumu tipi # 3 JSON examples for VMware items # 3 JSON piemēri VMware vienumiem # 3 Latest data # 3 Jaunākie dati # 3 Link indicators # 3 Saites indikatori # 3 Linking/unlinking # 3 Saišu izveide/noņemšana # 3 Log file monitoring # 3 Žurnālfailu uzraudzība # 3 Low-level discovery # 3 Zema līmeņa atklāšana # 3 Manual closing of problems # 3 Manuāla problēmu aizvēršana # 3 MIB files # 3 MIB faili # 3 Minimum permission level for Windows agent items # 3 Minimālais atļauju līmenis Windows aģenta vienumiem # 3 Monitor Apache via HTTP # 3. Monitor Apache via HTTP # 3 New item # 3 Jauns vienums # 3 Preprocessing examples # 3 Priekšapstrādes piemēri # 3 Protocols This section documents the communication protocols used by Zabbix components, including server-proxy data exchange, agent communication, and data export formats. Please use the sidebar to find the protocol specification you need. # 3 Protokoli Šajā sadaļā ir dokumentēti saziņas protokoli, ko izmanto Zabbix komponenti, tostarp servera un starpniekservera datu apmaiņa, aģenta saziņa un datu eksportēšanas formāti. Lūdzu, izmantojiet sānjoslu, lai atrastu nepieciešamo protokola specifikāciju. # 3 PSK problems # 3 PSK problēmas # 3 Receiving notification on unsupported items # 3 Paziņojuma saņemšana par neatbalstītiem vienumiem # 3 Recovery operations # 3 Atkopšanas darbības # 3 SAML # 3 SAML # 3 Scripts # 3 Skripti # 3 Services # 3 Pakalpojumi # 3 Setup example # 3 Iestatīšanas piemērs # 3 Setup from sources # 3 Iestatīšana no avotiem # 3 SLA report # 3 SLA atskaite # 3 SNMP agent # 3 SNMP aģents # 3 SNMP gateway # 3 SNMP gateway # 3 Templates # 3 Veidnes # 3 Templates # 3 Veidnes # 3 Trigger dependencies # 3 Trigeru atkarības # 3 Triggers # 3 Trigeri # 3 Troubleshooting # 3 Problēmu novēršana # 3 Unstable releases # 3 Nestabilie laidieni # 3 Upgrade from containers # 3 Jaunināšana no konteineriem # 3 User groups # 3 Lietotāju grupas # 3 User macros with context # 3 Lietotāja makrosi ar kontekstu # 3 Users # 3 Lietotāji # 3 User settings # 3 Lietotāja iestatījumi # 3 Web scenarios # 3 Tīmekļa scenāriji # 3 Web server # 3 Tīmekļa serveris # 3 Zabbix agent (UNIX) # 3 Zabbix aģents (UNIX) # 3 Zabbix features # 3 Zabbix funkcijas # 3 Zabbix processes # 3 Zabbix procesi # 40 Upgrade notes for 7.0.29 # 40 Atjaunināšanas piezīmes par 7.0.29 # 4 API tokens # 4 API pilnvaru marķieri ##### 4 Configure the sources C99 with GNU extensions is required for building Zabbix server, Zabbix proxy or Zabbix agent. This version can be explicitly specified by setting CFLAGS="-std=gnu99": export CFLAGS="-std=gnu99" ::: noteclassic If installing from [Zabbix Git repository](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse), it is required to run first: `./bootstrap.sh` ::: When configuring the sources for a Zabbix server or proxy, you must specify the database type to be used. Only one database type can be compiled with a server or proxy process at a time. To see all of the supported configuration options, inside the extracted Zabbix source directory run: ./configure --help To configure the sources for a Zabbix server and agent, you may run something like: ./configure --enable-server --enable-agent --with-mysql --enable-ipv6 --with-net-snmp --with-libcurl --with-libxml2 --with-openipmi --with-ares To configure the sources for a Zabbix server (with PostgreSQL etc.), you may run: ./configure --enable-server --with-postgresql --with-net-snmp To configure the sources for a Zabbix proxy (with SQLite etc.), you may run: ./configure --prefix=/usr --enable-proxy --with-net-snmp --with-sqlite3 --with-ssh2 To configure the sources for a Zabbix agent, you may run: ./configure --enable-agent or, for Zabbix agent 2: ./configure --enable-agent2 ::: noteclassic A [supported Go version](/manual/installation/requirements#agent-2) must be installed to build Zabbix agent 2. ::: Notes on compilation options: - `--enable-agent` - compiles Zabbix agent, as well as [Zabbix get](/manual/concepts/get) and [Zabbix sender](/manual/concepts/sender) command-line utilities. - `--with-libcurl` - required for virtual machine monitoring, SMTP authentication, and `web.page.*` [Zabbix agent items](/manual/config/items/itemtypes/zabbix_agent). See also: [Requirements](/manual/installation/requirements#serverproxy) (libcurl). - `--with-libxml2` - required for virtual machine monitoring. - `--with-libpcre[=DIR]` - Zabbix always compiles with the PCRE library; this option only allows to specify a custom PCRE installation path. - `--with-mysql=/path/to/mysql_config` - specifies the path to a particular MySQL client library configuration. Useful when multiple versions of MySQL or MariaDB are installed. - `--with-oracle` - specifies the location of the Oracle Call Interface (OCI) API. - `--enable-static` - statically links libraries (not supported on [Solaris](https://docs.oracle.com/cd/E18659_01/html/821-1383/bkajp.html)). Use this if you plan to distribute compiled binaries to systems without the required libraries. Not recommended when building Zabbix server. To build the server statically, a static version of every external library is required. The configure script does not check for this automatically. - `--with-stacksize=<value>` - sets the per-thread stack size in kilobytes (e.g., `--with-stacksize=512`). You can increase this value if Zabbix crashes or freezes due to stack overflows (e.g., during [preprocessing](/manual/config/items/preprocessing) on systems with low default thread stack limits). ::: noteimportant If `./configure` fails due to missing libraries or other issues, please check the `config.log` file for detailed error information. For example, if `libssl` is missing, the immediate error message may be misleading: checking for main in -lmysqlclient... no configure: error: Not found mysqlclient library In this case, `config.log` reveals the actual cause: /usr/bin/ld: cannot find -lssl /usr/bin/ld: cannot find -lcrypto ::: See also: - [Compiling Zabbix with encryption support](/manual/encryption#compiling-zabbix-with-encryption-support) - Known [compilation issues](/manual/installation/known_issues/compilation_issues) ##### 4 Konfigurēt avotus Zabbix servera, Zabbix starpniekservera vai Zabbix aģenta būvēšanai ir nepieciešams C99 ar GNU paplašinājumiem. Šo versiju var skaidri norādīt, iestatot CFLAGS="-std=gnu99": export CFLAGS="-std=gnu99" ::: noteclassic Ja instalējat no [Zabbix Git repozitorija](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse), vispirms ir jāpalaiž: `./bootstrap.sh` ::: Konfigurējot avotus Zabbix serverim vai starpniekserverim, jums ir jānorāda izmantojamais datubāzes tips. Vienlaikus ar servera vai starpniekservera procesu var tikt kompilēts tikai viens datubāzes tips. Lai skatītu visas atbalstītās konfigurācijas opcijas, izvilktajā Zabbix avotu direktorijā palaidiet: ./configure --help Lai konfigurētu avotus Zabbix serverim un aģentam, varat palaist, piemēram: ./configure --enable-server --enable-agent --with-mysql --enable-ipv6 --with-net-snmp --with-libcurl --with-libxml2 --with-openipmi --with-ares Lai konfigurētu avotus Zabbix serverim (ar PostgreSQL u.c.), varat palaist: ./configure --enable-server --with-postgresql --with-net-snmp Lai konfigurētu avotus Zabbix starpniekserverim (ar SQLite u.c.), varat palaist: ./configure --prefix=/usr --enable-proxy --with-net-snmp --with-sqlite3 --with-ssh2 Lai konfigurētu avotus Zabbix aģentam, varat palaist: ./configure --enable-agent vai, Zabbix aģentam 2: ./configure --enable-agent2 ::: noteclassic Lai būvētu Zabbix aģentu 2, ir jābūt instalētai [atbalstītai Go versijai](/manual/installation/requirements#agent-2). ::: Piezīmes par kompilēšanas opcijām: - `--enable-agent` - kompilē Zabbix aģentu, kā arī [Zabbix get](/manual/concepts/get) un [Zabbix sender](/manual/concepts/sender) komandrindas utilītprogrammas. - `--with-libcurl` - nepieciešams virtuālo mašīnu uzraudzībai, SMTP autentifikācijai un `web.page.*` [Zabbix aģenta vienumiem](/manual/config/items/itemtypes/zabbix_agent). Skatiet arī: [Prasības](/manual/installation/requirements#serverproxy) (libcurl). - `--with-libxml2` - nepieciešams virtuālo mašīnu uzraudzībai. - `--with-libpcre[=DIR]` - Zabbix vienmēr tiek kompilēts ar PCRE bibliotēku; šī opcija tikai ļauj norādīt pielāgotu PCRE instalācijas ceļu. - `--with-mysql=/path/to/mysql_config` - norāda konkrētas MySQL klienta bibliotēkas konfigurācijas ceļu. Noderīgi, ja ir instalētas vairākas MySQL vai MariaDB versijas. - `--with-oracle` - norāda Oracle Call Interface (OCI) API atrašanās vietu. - `--enable-static` - statiski sasaista bibliotēkas (nav atbalstīts [Solaris](https://docs.oracle.com/cd/E18659_01/html/821-1383/bkajp.html)). Izmantojiet šo opciju, ja plānojat izplatīt kompilētos bināros failus sistēmām bez nepieciešamajām bibliotēkām. Nav ieteicams, būvējot Zabbix serveri. Lai serveri būvētu statiski, ir nepieciešama katras ārējās bibliotēkas statiskā versija. Configure skripts to automātiski nepārbauda. - `--with-stacksize=<value>` - iestata pavediena steka izmēru kilobaitos (piem., `--with-stacksize=512`). Šo vērtību var palielināt, ja Zabbix avarē vai sasalst steka pārpildes dēļ (piem., [priekšapstrādes](/manual/config/items/preprocessing) laikā sistēmās ar zemiem noklusējuma pavediena steka limitiem). ::: noteimportant Ja `./configure` neizdodas trūkstošu bibliotēku vai citu problēmu dēļ, lūdzu, pārbaudiet failu `config.log`, lai iegūtu detalizētu kļūdas informāciju. Piemēram, ja trūkst `libssl`, tūlītējais kļūdas ziņojums var būt maldinošs: checking for main in -lmysqlclient... no configure: error: Not found mysqlclient library Šajā gadījumā `config.log` atklāj patieso iemeslu: /usr/bin/ld: cannot find -lssl /usr/bin/ld: cannot find -lcrypto ::: Skatiet arī: - [Zabbix kompilēšana ar šifrēšanas atbalstu](/manual/encryption#compiling-zabbix-with-encryption-support) - Zināmās [kompilēšanas problēmas](/manual/installation/known_issues/compilation_issues) # 4 Discovery of SNMP OIDs # 4 SNMP OID atklāšana # 4 Discovery rules # 4 Atklāšanas kārtulas # 4 Discovery rules # 4 Atklāšanas kārtulas # 4 Discovery status # 4 Atklāšanas statuss # 4 Discovery status # 4 Atklāšanas statuss # 4 Encoding of returned values Zabbix server expects every returned text value in the UTF8 encoding. This is related to any type of checks: Zabbix agent, SSH, Telnet, etc. Different monitored systems/devices and checks can return non-ASCII characters in the value. For such cases, almost all possible **zabbix** keys contain an additional item key parameter - **<encoding>**. This key parameter is optional but it should be specified if the returned value is not in the UTF8 encoding and it contains non-ASCII characters. Otherwise the result can be unexpected and unpredictable. A description of behavior with different database backends in such cases follows. # 4 Atgriezto vērtību kodējums Zabbix serveris sagaida, ka katra atgrieztā teksta vērtība būs UTF8 kodējumā. Tas attiecas uz jebkura veida pārbaudēm: Zabbix aģents, SSH, Telnet utt. Dažādas uzraudzītās sistēmas/ierīces un pārbaudes vērtībā var atgriezt rakstzīmes, kas nav ASCII. Šādos gadījumos gandrīz visas iespējamās **zabbix** atslēgas satur papildu vienuma atslēgas parametru — **<encoding>**. Šis atslēgas parametrs nav obligāts, taču tas jānorāda, ja atgrieztā vērtība nav UTF8 kodējumā un tajā ir rakstzīmes, kas nav ASCII. Pretējā gadījumā rezultāts var būt negaidīts un neprognozējams. Tālāk ir sniegts apraksts par darbību šādos gadījumos ar dažādām datu bāzu aizmugursistēmām. # 4 Events # 4 Notikumi # 4 Global search It is possible to search Zabbix frontend for hosts, host groups, templates and template groups. The search input box is located below the Zabbix logo in the menu. The search can be started by pressing *Enter* or clicking on the  search icon.  If there is a host that contains the entered string in any part of the name, a dropdown will appear, listing all such hosts (with the matching part highlighted in orange). The dropdown will also list a host if that host's visible name is a match to the technical name entered as a search string; the matching host will be listed, but without any highlighting. # 4 Globālā meklēšana Zabbix lietotāja saskarnē ir iespējams meklēt hosts, hostu grupas, veidnes un veidņu grupas. Meklēšanas ievades lauks atrodas zem Zabbix logotipa izvēlnē. Meklēšanu var sākt, nospiežot *Enter* vai noklikšķinot uz  meklēšanas ikonas.  Ja ir hosts, kura nosaukuma jebkurā daļā ir ievadītā virkne, tiks parādīta nolaižamā izvēlne ar visu šādu hostu sarakstu (atbilstošā daļa tiks izcelta oranžā krāsā). Nolaižamajā izvēlnē tiks parādīts arī hosts, ja tā redzamais nosaukums atbilst kā meklēšanas virknei ievadītajam tehniskajam nosaukumam; atbilstošais hosts tiks uzskaitīts, bet bez izcelšanas. # 4 History and trends # 4 Vēsture un tendences # 4 History functions All functions listed here are supported in: - [Trigger expressions](/manual/config/triggers/expression) - [Calculated items](/manual/config/items/itemtypes/calculated) - [Expression macros](/manual/config/macros/expression_macros) The functions are listed without additional information. Click on the function to see the full details. |Function|Description| |--|--------| |[change](#change)|The amount of difference between the previous and latest value.| |[changecount](#changecount)|The number of changes between adjacent values within the defined evaluation period.| |[count](#count)|The number of values within the defined evaluation period.| |[countunique](#countunique)|The number of unique values within the defined evaluation period.| |[find](#find)|Find a value match within the defined evaluation period.| |[first](#first)|The first (the oldest) value within the defined evaluation period.| |[fuzzytime](#fuzzytime)|Check how much the passive agent time differs from the Zabbix server/proxy time.| |[last](#last)|The most recent value.| |[logeventid](#logeventid)|Check if the event ID of the last log entry matches a regular expression.| |[logseverity](#logseverity)|The log severity of the last log entry.| |[logsource](#logsource)|Check if log source of the last log entry matches a regular expression.| |[monodec](#monodec)|Check if there has been a monotonous decrease in values.| |[monoinc](#monoinc)|Check if there has been a monotonous increase in values.| |[nodata](#nodata)|Check for no data received.| |[percentile](#percentile)|The P-th percentile of a period, where P (percentage) is specified by the third parameter.| |[rate](#rate)|The per-second average rate of the increase in a monotonically increasing counter within the defined time period.| # 4 Vēstures funkcijas Šeit uzskaitītās funkcijas tiek atbalstītas: - [Trigeru izteiksmēs](/manual/config/triggers/expression) - [Aprēķinātajos vienumos](/manual/config/items/itemtypes/calculated) - [Izteiksmju makrosos](/manual/config/macros/expression_macros) Funkcijas ir uzskaitītas bez papildu informācijas. Noklikšķiniet uz funkcijas, lai skatītu pilnu informāciju. |Function|Description| |--|--------| |[change](#change)|Atšķirības apjoms starp iepriekšējo un jaunāko vērtību.| |[changecount](#changecount)|Izmaiņu skaits starp blakus esošajām vērtībām noteiktajā novērtēšanas periodā.| |[count](#count)|Vērtību skaits noteiktajā novērtēšanas periodā.| |[countunique](#countunique)|Unikālo vērtību skaits noteiktajā novērtēšanas periodā.| |[find](#find)|Atrod vērtības atbilstību noteiktajā novērtēšanas periodā.| |[first](#first)|Pirmā (vecākā) vērtība noteiktajā novērtēšanas periodā.| |[fuzzytime](#fuzzytime)|Pārbauda, cik ļoti pasīvā aģenta laiks atšķiras no Zabbix servera/starpniekservera laika.| |[last](#last)|Jaunākā vērtība.| |[logeventid](#logeventid)|Pārbauda, vai pēdējā žurnāla ieraksta notikuma ID atbilst regulārai izteiksmei.| |[logseverity](#logseverity)|Pēdējā žurnāla ieraksta žurnāla nopietnības līmenis.| |[logsource](#logsource)|Pārbauda, vai pēdējā žurnāla ieraksta žurnāla avots atbilst regulārai izteiksmei.| |[monodec](#monodec)|Pārbauda, vai vērtībās ir bijis monotonisks samazinājums.| |[monoinc](#monoinc)|Pārbauda, vai vērtībās ir bijis monotonisks pieaugums.| |[nodata](#nodata)|Pārbauda, vai nav saņemti dati.| |[percentile](#percentile)|Perioda P-tā percentīle, kur P (procentos) ir norādīts trešajā parametrā.| |[rate](#rate)|Monotoniski pieaugoša skaitītāja pieauguma vidējais ātrums sekundē noteiktajā laika periodā.| # 4 Host prototypes # 4 Hostu prototipi # 4 Host prototypes # 4 Hostu prototipi # 4 Host prototypes # 4 Hostu prototipi # 4 Hosts # 4 Hosti # 4 Hosts # 4 Hosti # 4 Installation and first steps # 4 Instalēšana un pirmie soļi # 4 Installation from packages # 4 Installation from packages ##### 4 Install new server binaries Use these [instructions](/manual/installation/install#installing-zabbix-daemons) to compile Zabbix server from sources. ##### 4 Instalēt jaunus servera bināros failus Izmantojiet šos [instrukcijas](/manual/installation/install#installing-zabbix-daemons) lai kompilētu Zabbix serveri no pirmkoda. # 4 Inventory # 4 Inventārs # 4 IPMI template operation IPMI templates do not require any specific setup. To start monitoring, [link](/manual/config/templates/linking#linking-a-template) the template to a target host (if the template is not available in your Zabbix installation, you may need to [import](/manual/config/templates_out_of_the_box#template-upgrade) the template first). A detailed description of a template, including the full list of macros, items, and triggers, is available in the template's README file (accessible by clicking on a template name). Available template: - [Chassis by IPMI](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/chassis_ipmi/README.md?at=refs%2Fheads%2Frelease%2F7.0) # 4 IPMI veidnes darbība IPMI veidnēm nav nepieciešama nekāda īpaša konfigurēšana. Lai sāktu uzraudzību, [saistiet](/manual/config/templates/linking#linking-a-template) veidni ar mērķa hostu (ja veidne nav pieejama jūsu Zabbix instalācijā, vispirms, iespējams, būs jāveic veidnes [importēšana](/manual/config/templates_out_of_the_box#template-upgrade)). Detalizēts veidnes apraksts, tostarp pilns makro, vienumu un trigeru saraksts, ir pieejams veidnes README failā (tam var piekļūt, noklikšķinot uz veidnes nosaukuma). Pieejamā veidne: - [Chassis by IPMI](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/chassis_ipmi/README.md?at=refs%2Fheads%2Frelease%2F7.0) # 4 Items This section contains reference information and technical notes about items, including parameter details for specific item keys, platform-specific details, and notes on special item configurations. Please use the sidebar to find information relevant to your use case. # 4 Vienumi Šajā sadaļā ir ietverta uzziņas informācija un tehniskas piezīmes par vienumiem, tostarp parametru informācija par konkrētām vienumu atslēgām, platformai specifiska informācija un piezīmes par īpašām vienumu konfigurācijām. Lūdzu, izmantojiet sānjoslu, lai atrastu informāciju, kas atbilst jūsu lietošanas gadījumam. # 4 JSONPath functionality # 4 JSONPath funkcionalitāte # 4 Maps # 4 Kartes # 4 Mass update # 4 Masveida atjaunināšana # 4 Memcached plugin # 4 Memcached spraudnis # 4 MFA # 4 MFA # 4 Monitor MySQL with Zabbix agent 2 # 4. Monitor MySQL with Zabbix agent 2 # 4 Nesting # 4 Ligzdošana # 4 Preparing auditlog table for partitioning # 4 Auditlog tabulas sagatavošana sadalīšanai nodalījumos # 4 Proxies # 4 Starpniekserveri # 4 Proxy # 4 Starpniekserveris ##### 4 Review agent configuration parameters Make sure to review [Upgrade notes](/manual/installation/upgrade_notes_700) to check if any changes in the configuration parameters are required. For new optional parameters, see the [What's new](/manual/introduction/whatsnew700) page. ##### 4 Pārskatiet aģenta konfigurācijas parametrus Pārliecinieties, ka pārskatāt [jaunināšanas piezīmes](/manual/installation/upgrade_notes_700), lai pārbaudītu, vai konfigurācijas parametros ir nepieciešamas kādas izmaiņas. Par jauniem izvēles parametriem skatiet lapu [Kas jauns](/manual/introduction/whatsnew700). ##### 4 Review proxy configuration parameters Make sure to review [Upgrade notes](/manual/installation/upgrade_notes_700) to check if any changes in the configuration parameters are required. For new optional parameters, see the [What's new](/manual/introduction/whatsnew700) page. ##### 4 Pārskatiet starpniekservera konfigurācijas parametrus Pārliecinieties, ka pārskatāt [jaunināšanas piezīmes](/manual/installation/upgrade_notes_700), lai pārbaudītu, vai konfigurācijas parametros ir nepieciešamas kādas izmaiņas. Par jauniem neobligātiem parametriem skatiet lapu [Kas jauns](/manual/introduction/whatsnew700). # 4 Secret user macros # 4 Slepenie lietotāja makrosi # 4 SNMP trap # 4 SNMP slazds # 4 Top 100 triggers # 4 Top 100 trigeri # 4 Trigger severity Trigger severity represents the level of importance of a trigger.  Zabbix supports the following default trigger severities. |Severity|Color|Description| |-|-|--------| |Not classified|Gray|Can be used where the severity level of an event is unknown, has not been determined, is not part of the regular monitoring scope, etc., for example, during initial configuration, as a placeholder for future assessment, or as part of an integration process.| |Information|Light blue|Can be used for informational events that do not require immediate attention, but can still provide valuable insights.| |Warning|Yellow|Can be used to indicate a potential issue that might require investigation or action, but that is not critical.| |Average|Orange|Can be used to indicate a significant issue that should be addressed relatively soon to prevent further problems.| |High|Light red|Can be used to indicate critical issues that need immediate attention to avoid significant disruptions.| |Disaster|Red|Can be used to indicate a severe incident that requires immediate action to prevent, for example, system outages or data loss.| ::: noteclassic Trigger severity names and colors can be [customized](/manual/config/triggers/customseverities). ::: Trigger severities are used for: - visual representation of triggers - different colors for different severities; - audio in global alarms - different audio for different severities; - user media - different media (notification channel) for different severities (for example, SMS for triggers of *High* and *Disaster* severity, and Email for triggers of other severities); - limiting actions by conditions against trigger severities. # 4 Trigeru nopietnība Trigeru nopietnība norāda trigeris svarīguma līmeni.  Zabbix atbalsta šādas noklusējuma trigeru nopietnības. |Severity|Color|Description| |-|-|-| |Not classified|Gray|Var izmantot, ja notikuma nopietnības līmenis nav zināms, nav noteikts, nav daļa no regulārās uzraudzības tvēruma utt., piemēram, sākotnējās konfigurācijas laikā, kā vietturis turpmākam novērtējumam vai integrācijas procesa ietvaros.| |Information|Light blue|Var izmantot informatīviem notikumiem, kuriem nav nepieciešama tūlītēja uzmanība, bet kuri joprojām var sniegt vērtīgu ieskatu.| |Warning|Yellow|Var izmantot, lai norādītu uz iespējamu problēmu, kurai var būt nepieciešama izmeklēšana vai rīcība, taču tā nav kritiska.| |Average|Orange|Var izmantot, lai norādītu uz būtisku problēmu, kas būtu jānovērš salīdzinoši drīz, lai novērstu turpmākas problēmas.| |High|Light red|Var izmantot, lai norādītu uz kritiskām problēmām, kurām nepieciešama tūlītēja uzmanība, lai izvairītos no būtiskiem traucējumiem.| |Disaster|Red|Var izmantot, lai norādītu uz smagu incidentu, kuram nepieciešama tūlītēja rīcība, lai novērstu, piemēram, sistēmas darbības pārtraukumus vai datu zudumu.| ::: noteclassic Trigeru nopietnības nosaukumus un krāsas var [pielāgot](/manual/config/triggers/customseverities). ::: Trigeru nopietnības tiek izmantotas šādiem mērķiem: - trigeru vizuālam attēlojumam - dažādas krāsas dažādām nopietnībām; - audio globālajos trauksmes signālos - dažādas skaņas dažādām nopietnībām; - lietotāju medijiem - dažādi mediji (paziņojumu kanāli) dažādām nopietnībām (piemēram, SMS trigeriem ar *High* un *Disaster* nopietnību un e-pasts citu nopietnību trigeriem); - darbību ierobežošanai, izmantojot nosacījumus attiecībā uz trigeru nopietnībām. # 4 Update operations # 4 Atjaunināšanas darbības ##### 4 Update repository configuration package Before proceeding with the upgrade, uninstall your current Zabbix repository package: ```bash rm -Rf /etc/apt/sources.list.d/zabbix.list ``` You may also need to manually remove any old Zabbix packages from your working directory (e.g., ``rm zabbix-release_latest+debian12_all.deb``) before downloading the new one to prevent the package manager from reusing an outdated version during the upgrade process. Then, install the latest repository configuration package to ensure compatibility with the newest packages and to include any recent security patches or bug fixes. On **Debian 12**, run: ```bash wget https://repo.zabbix.com/zabbix/7.0/debian/pool/main/z/zabbix-release/zabbix-release_latest+debian12_all.deb dpkg -i zabbix-release_latest+debian12_all.deb ``` ::: noteclassic For older Debian versions, replace the link above with the correct one from the [Zabbix repository](https://repo.zabbix.com/zabbix/7.0/debian/pool/main/z/zabbix-release/). Note, however, that packages for these versions may not include all Zabbix components, and to upgrade those components from packages, consider upgrading your OS. For a list of components included, see [Zabbix repository](https://repo.zabbix.com/zabbix/7.0/debian/pool/main/z/zabbix-release/). ::: On **Ubuntu 24.04**, run: ```bash wget https://repo.zabbix.com/zabbix/7.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu24.04_all.deb dpkg -i zabbix-release_latest+ubuntu24.04_all.deb ``` On **Ubuntu 22.04**, run: ```bash wget https://repo.zabbix.com/zabbix/7.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu22.04_all.deb dpkg -i zabbix-release_latest+ubuntu22.04_all.deb ``` ::: noteclassic For older Ubuntu versions, replace the link above with the correct one from the [Zabbix repository](https://repo.zabbix.com/zabbix/7.0/ubuntu/pool/main/z/zabbix-release/). Note, however, that packages for these versions may not include all Zabbix components, and to upgrade those components from packages, consider upgrading your OS. For a list of components included, see [Zabbix packages](https://www.zabbix.com/download?zabbix=7.0&os_distribution=ubuntu&os_version=20.04&components=agent&db=&ws=). ::: You may see a prompt about the Zabbix repository configuration: ```bash Configuration file '/etc/apt/sources.list.d/zabbix.list' ==> Deleted (by you or by a script) since installation. ==> Package distributor has shipped an updated version. What would you like to do about it ? Your options are: Y or I : install the package maintainer's version N or O : keep your currently-installed version D : show the differences between the versions Z : start a shell to examine the situation The default action is to keep your current version. *** zabbix.list (Y/I/N/O/D/Z) [default=N] ? ``` Enter `Y` (or `I`) to install the package maintainer's version of the Zabbix repository configuration. Then, update the repository information: ```bash apt update ``` ##### 4 Atjauniniet repozitorija konfigurācijas pakotni Pirms turpināt jaunināšanu, atinstalējiet pašreizējo Zabbix repozitorija pakotni: ```bash rm -Rf /etc/apt/sources.list.d/zabbix.list ``` Iespējams, jums arī manuāli jāizdzēš jebkuras vecās Zabbix pakotnes no darba direktorijas (piem., ``rm zabbix-release_latest+debian12_all.deb``) pirms jaunās lejupielādes, lai pakotņu pārvaldnieks jaunināšanas procesa laikā neizmantotu novecojušu versiju. Pēc tam instalējiet jaunāko repozitorija konfigurācijas pakotni, lai nodrošinātu saderību ar jaunākajām pakotnēm un iekļautu nesenus drošības ielāpus vai kļūdu labojumus. Uz **Debian 12** izpildiet: ```bash wget https://repo.zabbix.com/zabbix/7.0/debian/pool/main/z/zabbix-release/zabbix-release_latest+debian12_all.deb dpkg -i zabbix-release_latest+debian12_all.deb ``` ::: noteclassic Vecākām Debian versijām aizstājiet iepriekš norādīto saiti ar pareizo saiti no [Zabbix repository](https://repo.zabbix.com/zabbix/7.0/debian/pool/main/z/zabbix-release/). Tomēr ņemiet vērā, ka šo versiju pakotnes var neietvert visus Zabbix komponentus, un, lai jauninātu šos komponentus no pakotnēm, apsveriet OS jaunināšanu. Komponentu sarakstu skatiet [Zabbix repository](https://repo.zabbix.com/zabbix/7.0/debian/pool/main/z/zabbix-release/). ::: Uz **Ubuntu 24.04** izpildiet: ```bash wget https://repo.zabbix.com/zabbix/7.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu24.04_all.deb dpkg -i zabbix-release_latest+ubuntu24.04_all.deb ``` Uz **Ubuntu 22.04** izpildiet: ```bash wget https://repo.zabbix.com/zabbix/7.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu22.04_all.deb dpkg -i zabbix-release_latest+ubuntu22.04_all.deb ``` ::: noteclassic Vecākām Ubuntu versijām aizstājiet iepriekš norādīto saiti ar pareizo saiti no [Zabbix repository](https://repo.zabbix.com/zabbix/7.0/ubuntu/pool/main/z/zabbix-release/). Tomēr ņemiet vērā, ka šo versiju pakotnes var neietvert visus Zabbix komponentus, un, lai jauninātu šos komponentus no pakotnēm, apsveriet OS jaunināšanu. Komponentu sarakstu skatiet [Zabbix packages](https://www.zabbix.com/download?zabbix=7.0&os_distribution=ubuntu&os_version=20.04&components=agent&db=&ws=). ::: Var tikt parādīts uzvednis par Zabbix repozitorija konfigurāciju: ```bash Configuration file '/etc/apt/sources.list.d/zabbix.list' ==> Deleted (by you or by a script) since installation. ==> Package distributor has shipped an updated version. What would you like to do about it ? Your options are: Y or I : install the package maintainer's version N or O : keep your currently-installed version D : show the differences between the versions Z : start a shell to examine the situation The default action is to keep your current version. *** zabbix.list (Y/I/N/O/D/Z) [default=N] ? ``` Ievadiet `Y` (vai `I`), lai instalētu pakotnes uzturētāja Zabbix repozitorija konfigurācijas versiju. Pēc tam atjauniniet repozitorija informāciju: ```bash apt update ``` ##### 4 Update repository configuration package Before proceeding with the upgrade, update your current repository package to the latest version to ensure compatibility with the newest packages and to include any recent security patches or bug fixes. On **RHEL 9**, run: ```bash rpm -Uvh https://repo.zabbix.com/zabbix/7.0/rhel/9/x86_64/zabbix-release-latest.el9.noarch.rpm ``` On **RHEL 8**, run: ```bash rpm -Uvh https://repo.zabbix.com/zabbix/7.0/rhel/8/x86_64/zabbix-release-latest.el8.noarch.rpm ``` ::: noteclassic For older RHEL versions or its derivatives, replace the link above with the correct one from the [Zabbix repository](https://repo.zabbix.com/zabbix/7.0/). Note, however, that packages for these versions may not include all Zabbix components, and to upgrade those components from packages, consider upgrading your OS. For a list of components included, see [Zabbix packages](https://www.zabbix.com/download?zabbix=7.0&os_distribution=red_hat_enterprise_linux&os_version=7&components=agent&db=&ws=). ::: Then, clean up the `dnf` package manager's cache (including headers, metadata, and package files downloaded during previous installations or updates): ```bash dnf clean all ``` On the next `dnf` operation, `dnf` will download fresh metadata from the repositories since the old metadata is cleared. See also: [Known issues](/manual/installation/known_issues#expired-signing-key-for-rhel-packages) for updating the repository configuration package on RHEL. ##### 4 Atjauniniet repozitorija konfigurācijas pakotni Pirms turpināt jaunināšanu, atjauniniet pašreizējo repozitorija pakotni uz jaunāko versiju, lai nodrošinātu saderību ar jaunākajām pakotnēm un iekļautu visus nesenos drošības ielāpus vai kļūdu labojumus. **RHEL 9** sistēmā izpildiet: ```bash rpm -Uvh https://repo.zabbix.com/zabbix/7.0/rhel/9/x86_64/zabbix-release-latest.el9.noarch.rpm ``` **RHEL 8** sistēmā izpildiet: ```bash rpm -Uvh https://repo.zabbix.com/zabbix/7.0/rhel/8/x86_64/zabbix-release-latest.el8.noarch.rpm ``` ::: noteclassic Vecākām RHEL versijām vai to atvasinājumiem aizstājiet iepriekš norādīto saiti ar pareizo saiti no [Zabbix repozitorija](https://repo.zabbix.com/zabbix/7.0/). Tomēr ņemiet vērā, ka šo versiju pakotnes var neietvert visus Zabbix komponentus, un, lai atjauninātu šos komponentus no pakotnēm, apsveriet operētājsistēmas jaunināšanu. Komponentu sarakstu skatiet sadaļā [Zabbix pakotnes](https://www.zabbix.com/download?zabbix=7.0&os_distribution=red_hat_enterprise_linux&os_version=7&components=agent&db=&ws=). ::: Pēc tam notīriet `dnf` pakotņu pārvaldnieka kešatmiņu (tostarp galvenes, metadatus un pakotņu failus, kas lejupielādēti iepriekšējo instalēšanu vai atjauninājumu laikā): ```bash dnf clean all ``` Nākamajā `dnf` darbībā `dnf` lejupielādēs svaigus metadatus no repozitorijiem, jo vecie metadati ir notīrīti. Skatiet arī: [Zināmās problēmas](/manual/installation/known_issues#expired-signing-key-for-rhel-packages) par repozitorija konfigurācijas pakotnes atjaunināšanu RHEL sistēmās. # 4 Using macros in messages # 4 Makrosu izmantošana ziņojumos # 4 VMware monitoring setup example # 4 VMware uzraudzības iestatīšanas piemērs # 4 Webhook # 4 Webhook # 4 Zabbix agent 2 plugin protocol Zabbix agent 2 protocol is based on code, size and data model. # 4 Zabbix aģents 2 spraudņa protokols Zabbix aģents 2 protokols ir balstīts uz koda, izmēra un datu modeli. # 4 Zabbix agent 2 (UNIX) # 4 Zabbix aģents 2 (UNIX) # 4 Zabbix overview # 4 Zabbix pārskats # 5 Audit log # 5 Audita žurnāls # 5 Authentication # 5 Autentifikācija # 5 Customizing trigger severities Trigger severity names and colors for severity related GUI elements can be configured in *Administration → General → Trigger displaying options*. Colors are shared among all GUI themes. # 5 Trigeru smaguma pakāpju pielāgošana Trigeru smaguma pakāpju nosaukumus un krāsas ar smaguma pakāpi saistītajiem lietotāja saskarnes elementiem var konfigurēt sadaļā *Administration → General → Trigger displaying options*. Krāsas tiek koplietotas starp visām lietotāja saskarnes tēmām. # 5 Discovery # 5 Atklāšana # 5 Discovery of SNMP OIDs (legacy) # 5 SNMP OID atklāšana (mantotā) # 5 Escalations # 5 Eskalācijas # 5 Event correlation # 5 Notikumu korelācija # 5 Favorite graphs # 5 Iecienītākie grafiki # 5 Favorite graphs # 5 Iecienītākie grafiki # 5 Frontend maintenance mode # 5 Lietotāja saskarnes uzturēšanas režīms # 5 Installation from containers # 5 Instalēšana no konteineriem # 5 Java gateway # 5 Java gateway # 5 JavaScript preprocessing # 5 JavaScript priekšapstrāde # 5 JMX template operation Steps to ensure correct operation of templates that collect metrics by [JMX](/manual/config/items/itemtypes/jmx_monitoring): 1. Make sure that Zabbix [Java gateway](/manual/concepts/java#getting-java-gateway) is installed and set up properly. 2. [Link](/manual/config/templates/linking#linking-a-template) the template to the target host. The host should have the JMX interface set up.<br> If the template is not available in your Zabbix installation, you may need to [import](/manual/config/templates_out_of_the_box#template-upgrade) the template first. 3. If necessary, adjust the values of template macros. 4. Configure the instance being monitored to allow data sharing with Zabbix. A detailed description of a template, including the full list of macros, items, and triggers, is available in the template's README file (accessible by clicking on a template name). The following templates are available: - [Apache ActiveMQ by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/activemq_jmx/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Apache Cassandra by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/cassandra_jmx/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Apache Kafka by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/kafka_jmx/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Apache Tomcat by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/tomcat_jmx/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [GridGain by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/gridgain_jmx/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Ignite by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/ignite_jmx/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Jira Data Center by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/jira_datacenter_jmx/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [WildFly Domain by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/wildfly_domain_jmx/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [WildFly Server by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/wildfly_server_jmx/README.md?at=refs%2Fheads%2Frelease%2F7.0) # 5 JMX veidnes darbība Darbības, kas jāveic, lai nodrošinātu pareizu veidņu darbību, kuras apkopo metriku, izmantojot [JMX](/manual/config/items/itemtypes/jmx_monitoring): 1. Pārliecinieties, ka Zabbix [Java gateway](/manual/concepts/java#getting-java-gateway) ir instalēts un pareizi konfigurēts. 2. [Piesaistiet](/manual/config/templates/linking#linking-a-template) veidni mērķa hostam. Hostam jābūt konfigurētai JMX saskarnei.<br> Ja veidne nav pieejama jūsu Zabbix instalācijā, vispirms, iespējams, būs jāveic veidnes [importēšana](/manual/config/templates_out_of_the_box#template-upgrade). 3. Ja nepieciešams, pielāgojiet veidnes makro vērtības. 4. Konfigurējiet uzraugāmo instanci tā, lai tā atļautu datu koplietošanu ar Zabbix. Detalizēts veidnes apraksts, tostarp pilns makro, vienumu un trigeru saraksts, ir pieejams veidnes README failā (tam var piekļūt, noklikšķinot uz veidnes nosaukuma). Pieejamas šādas veidnes: - [Apache ActiveMQ by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/activemq_jmx/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Apache Cassandra by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/cassandra_jmx/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Apache Kafka by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/kafka_jmx/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Apache Tomcat by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/tomcat_jmx/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [GridGain by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/gridgain_jmx/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Ignite by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/ignite_jmx/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Jira Data Center by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/jira_datacenter_jmx/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [WildFly Domain by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/wildfly_domain_jmx/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [WildFly Server by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/wildfly_server_jmx/README.md?at=refs%2Fheads%2Frelease%2F7.0) # 5 Large file support Large file support, often abbreviated to LFS, is the term applied to the ability to work with files larger than 2 GB on 32-bit operating systems. Support for large files affects at least [log file monitoring](/manual/config/items/itemtypes/zabbix_agent/log_items) and all [vfs.file.\* items](/manual/config/items/itemtypes/zabbix_agent#supported-item-keys). Large file support depends on the capabilities of a system at Zabbix compilation time, but is completely disabled on a 32-bit Solaris due to its incompatibility with procfs and swapctl. # 5 Lielo failu atbalsts Lielo failu atbalsts, ko bieži saīsina kā LFS, ir termins, kas apzīmē iespēju strādāt ar failiem, kas ir lielāki par 2 GB 32 bitu operētājsistēmās. Lielo failu atbalsts ietekmē vismaz [žurnālfaila uzraudzību](/manual/config/items/itemtypes/zabbix_agent/log_items) un visus [vfs.file.\* vienumus](/manual/config/items/itemtypes/zabbix_agent#supported-item-keys). Lielo failu atbalsts ir atkarīgs no sistēmas iespējām Zabbix kompilēšanas laikā, taču 32 bitu Solaris sistēmā tas ir pilnībā atspējots tās nesaderības ar procfs un swapctl dēļ. # 5 Low-level discovery macros # 5 Zema līmeņa atklāšanas makrosi # 5 Maintenance # 5 Uzturēšana ##### 5 Make and install everything ::: noteclassic If installing from [Zabbix Git repository](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse), it is required to run first: `$ make dbschema` ::: make install This step should be run as a user with sufficient permissions (commonly 'root', or by using `sudo`). Running `make install` will by default install the daemon binaries (zabbix\_server, zabbix\_agentd, zabbix\_proxy) in /usr/local/sbin and the client binaries (zabbix\_get, zabbix\_sender) in /usr/local/bin. ::: noteclassic To specify a different location than `/usr/local`, use a `--prefix` key in the previous step of configuring sources, for example, `--prefix=/home/zabbix`. In this case daemon binaries will be installed under `<prefix>/sbin`, while utilities under `<prefix>/bin`. Man pages will be installed under `<prefix>/share`. ::: ##### 5 Izveidojiet un instalējiet visu ::: noteclassic Ja instalējat no [Zabbix Git repozitorija](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse), vispirms ir jāizpilda: `$ make dbschema` ::: make install Šo soli jāizpilda lietotājam ar pietiekamām tiesībām (parasti `root` vai izmantojot `sudo`). Palaižot `make install`, pēc noklusējuma tiks instalēti dēmona binārie faili (zabbix\_server, zabbix\_agentd, zabbix\_proxy) mapē /usr/local/sbin un klienta binārie faili (zabbix\_get, zabbix\_sender) mapē /usr/local/bin. ::: noteclassic Lai norādītu citu atrašanās vietu nekā `/usr/local`, iepriekšējā avotu konfigurēšanas solī izmantojiet `--prefix` atslēgu, piemēram, `--prefix=/home/zabbix`. Šādā gadījumā dēmona binārie faili tiks instalēti zem `<prefix>/sbin`, savukārt utilītas — zem `<prefix>/bin`. Man lapas tiks instalētas zem `<prefix>/share`. ::: # 5 Mass update # 5 Masveida atjaunināšana # 5 Modbus plugin # 5 Modbus spraudnis # 5 Network maps # 5 Tīkla kartes # 5 Notes on low-level discovery # 5 Piezīmes par zema līmeņa atklāšanu # 5 Proxy groups # 5 Starpniekserveru grupas # 5 Quickstart guides After you have [installed Zabbix](/manual/installation) and its [web interface](/manual/installation/frontend), it is time to start monitoring. Use these quick reference guides to start monitoring popular resources: - [Monitor Linux with Zabbix agent](/manual/quickstart/monitor_linux) - [Monitor Windows with Zabbix agent](/manual/quickstart/monitor_windows) - [Monitor Apache via HTTP](/manual/quickstart/monitor_apache) - [Monitor MySQL with Zabbix agent 2](/manual/quickstart/monitor_mysql) - [Monitor VMware with Zabbix](/manual/quickstart/monitor_vmware) - [Monitor network traffic with Zabbix](/manual/quickstart/monitor_traffic) - [Monitor network traffic with Zabbix using active checks](/manual/quickstart/monitor_active) - [Monitor websites with Browser items](/manual/quickstart/monitor_browser) - [Monitor website certificates with Zabbix agent 2 (passive)](/manual/quickstart/monitor_certificate) - [Monitor a network switch or router with Zabbix](/manual/quickstart/monitor_switch) - [Monitor Windows event log using active checks](/manual/quickstart/monitor_windows_eventlog) To better understand the basic elements of monitoring, consult [Basic configuration](/manual/installation/quickstart/basic_config): how to log into Zabbix, add a host, define an item, create a trigger, receive notifications, and save the configuration as a template. # 5 Ātrās darba sākšanas ceļveži Pēc tam, kad esat [instalējis Zabbix](/manual/installation) un tā [lietotāja saskarne](/manual/installation/frontend), ir pienācis laiks sākt uzraudzību. Izmantojiet šos ātrās uzziņas ceļvežus, lai sāktu uzraudzīt populārus resursus: - [Uzraugiet Linux ar Zabbix aģents](/manual/quickstart/monitor_linux) - [Uzraugiet Windows ar Zabbix aģents](/manual/quickstart/monitor_windows) - [Uzraugiet Apache, izmantojot HTTP](/manual/quickstart/monitor_apache) - [Uzraugiet MySQL ar Zabbix aģents 2](/manual/quickstart/monitor_mysql) - [Uzraugiet VMware ar Zabbix](/manual/quickstart/monitor_vmware) - [Uzraugiet tīkla datplūsmu ar Zabbix](/manual/quickstart/monitor_traffic) - [Uzraugiet tīkla datplūsmu ar Zabbix, izmantojot aktīvās pārbaudes](/manual/quickstart/monitor_active) - [Uzraugiet tīmekļa vietnes ar Browser vienumiem](/manual/quickstart/monitor_browser) - [Uzraugiet tīmekļa vietņu sertifikātus ar Zabbix aģents 2 (pasīvi)](/manual/quickstart/monitor_certificate) - [Uzraugiet tīkla komutatoru vai maršrutētāju ar Zabbix](/manual/quickstart/monitor_switch) - [Uzraugiet Windows notikumu žurnālu, izmantojot aktīvās pārbaudes](/manual/quickstart/monitor_windows_eventlog) Lai labāk izprastu uzraudzības pamatelementus, skatiet [Pamata konfigurācija](/manual/installation/quickstart/basic_config): kā pieteikties Zabbix, pievienot hosts, definēt vienumu, izveidot trigeri, saņemt paziņojumus un saglabāt konfigurāciju kā veidni. # 5 Reports # 5 Pārskati ##### 5 Review server configuration parameters Make sure to review [Upgrade notes](/manual/installation/upgrade_notes_700) to check if any changes in the configuration parameters are required. For new optional parameters, see the [What's new](/manual/introduction/whatsnew700) page. ##### 5 Pārskatiet servera konfigurācijas parametrus Noteikti pārskatiet [jaunināšanas piezīmes](/manual/installation/upgrade_notes_700), lai pārbaudītu, vai konfigurācijas parametros ir nepieciešamas kādas izmaiņas. Par jauniem izvēles parametriem skatiet lapu [Kas jauns](/manual/introduction/whatsnew700). # 5 Secure connection to the database # 5 Drošs savienojums ar datubāzi ##### 5 Start new Zabbix agent Start the new Zabbix agent. Check log files to see if the agent has started successfully. ##### 5 Palaidiet jauno Zabbix aģentu Palaidiet jauno Zabbix aģentu. Pārbaudiet žurnālfailus, lai redzētu, vai aģents ir veiksmīgi palaists. ##### 5 Start new Zabbix proxy Start the new Zabbix proxy. Check log files to see if the proxy has started successfully. Zabbix proxy will automatically upgrade the database. Database upgrade takes place similarly as when starting [Zabbix server](/manual/installation/upgrade/sources#start-new-zabbix-binaries). ##### 5 Palaidiet jaunu Zabbix starpniekserveri Palaidiet jauno Zabbix starpniekserveri. Pārbaudiet žurnālfailus, lai redzētu, vai starpniekserveris ir veiksmīgi palaists. Zabbix starpniekserveris automātiski jauninās datubāzi. Datubāzes jaunināšana notiek līdzīgi kā, palaižot [Zabbix serveri](/manual/installation/upgrade/sources#start-new-zabbix-binaries). # 5 Supported functions Click on the respective function group to see more details. |Function group|<|Functions| |-|----------|----------------------------------------| |[Aggregate functions](/manual/appendix/functions/aggregate)|<|avg, bucket\_percentile, count, histogram\_quantile, item\_count, kurtosis, mad, max, min, skewness, stddevpop, stddevsamp, sum, sumofsquares, varpop, varsamp| | |[Foreach functions](/manual/appendix/functions/aggregate/foreach)|avg\_foreach, bucket\_rate\_foreach, count\_foreach, exists\_foreach, last\_foreach, max\_foreach, min\_foreach, sum\_foreach| |[Bitwise functions](/manual/appendix/functions/bitwise)|<|bitand, bitlshift, bitnot, bitor, bitrshift, bitxor| |[Date and time functions](/manual/appendix/functions/time)|<|date, dayofmonth, dayofweek, now, time| |[History functions](/manual/appendix/functions/history)|<|change, changecount, count, countunique, find, first, fuzzytime, last, logeventid, logseverity, logsource, monodec, monoinc, nodata, percentile, rate| |[Trend functions](/manual/appendix/functions/trends)|<|baselinedev, baselinewma, trendavg, trendcount, trendmax, trendmin, trendstl, trendsum| |[Mathematical functions](/manual/appendix/functions/math)|<|abs, acos, asin, atan, atan2, avg, cbrt, ceil, cos, cosh, cot, degrees, e, exp, expm1, floor, log, log10, max, min, mod, pi, power, radians, rand, round, signum, sin, sinh, sqrt, sum, tan, truncate| |[Operator functions](/manual/appendix/functions/operator)|<|between, in| |[Prediction functions](/manual/appendix/functions/prediction)|<|forecast, timeleft| |[String functions](/manual/appendix/functions/string)|<|ascii, bitlength, bytelength, char, concat, insert, jsonpath, left, length, ltrim, mid, repeat, replace, right, rtrim, trim, xmlxpath| Except where stated otherwise, these functions are supported in: - [Trigger expressions](/manual/config/triggers/expression) - [Calculated items](/manual/config/items/itemtypes/calculated) - [Expression macros](/manual/config/macros/expression_macros) Foreach functions are supported only for [aggregate calculations](/manual/config/items/itemtypes/calculated/aggregate). # 5 Atbalstītās funkcijas Noklikšķiniet uz attiecīgās funkciju grupas, lai skatītu vairāk informācijas. |Funkciju grupa|<|Funkcijas| |-|----------|----------------------------------------| |[Agregētās funkcijas](/manual/appendix/functions/aggregate)|<|avg, bucket\_percentile, count, histogram\_quantile, item\_count, kurtosis, mad, max, min, skewness, stddevpop, stddevsamp, sum, sumofsquares, varpop, varsamp| | |[Foreach funkcijas](/manual/appendix/functions/aggregate/foreach)|avg\_foreach, bucket\_rate\_foreach, count\_foreach, exists\_foreach, last\_foreach, max\_foreach, min\_foreach, sum\_foreach| |[Bitu funkcijas](/manual/appendix/functions/bitwise)|<|bitand, bitlshift, bitnot, bitor, bitrshift, bitxor| |[Datuma un laika funkcijas](/manual/appendix/functions/time)|<|date, dayofmonth, dayofweek, now, time| |[Vēstures funkcijas](/manual/appendix/functions/history)|<|change, changecount, count, countunique, find, first, fuzzytime, last, logeventid, logseverity, logsource, monodec, monoinc, nodata, percentile, rate| |[Tendenču funkcijas](/manual/appendix/functions/trends)|<|baselinedev, baselinewma, trendavg, trendcount, trendmax, trendmin, trendstl, trendsum| |[Matemātiskās funkcijas](/manual/appendix/functions/math)|<|abs, acos, asin, atan, atan2, avg, cbrt, ceil, cos, cosh, cot, degrees, e, exp, expm1, floor, log, log10, max, min, mod, pi, power, radians, rand, round, signum, sin, sinh, sqrt, sum, tan, truncate| |[Operatoru funkcijas](/manual/appendix/functions/operator)|<|between, in| |[Prognozēšanas funkcijas](/manual/appendix/functions/prediction)|<|forecast, timeleft| |[Virknes funkcijas](/manual/appendix/functions/string)|<|ascii, bitlength, bytelength, char, concat, insert, jsonpath, left, length, ltrim, mid, repeat, replace, right, rtrim, trim, xmlxpath| Ja nav norādīts citādi, šīs funkcijas tiek atbalstītas šādos gadījumos: - [Trigeru izteiksmēs](/manual/config/triggers/expression) - [Aprēķinātajos vienumos](/manual/config/items/itemtypes/calculated) - [Izteiksmju makrosos](/manual/config/macros/expression_macros) Foreach funkcijas tiek atbalstītas tikai [agregētajiem aprēķiniem](/manual/config/items/itemtypes/calculated/aggregate). # 5 Trend functions Trend functions, in contrast to [history functions](/manual/appendix/functions/history), use [trend](/manual/config/items/history_and_trends#keeping-trends) data for calculations. Trends store hourly aggregate values. Trend functions use these hourly averages, and thus are useful for long-term analysis. Trend function results are cached so multiple calls to the same function with the same parameters fetch info from the database only once. The trend function cache is controlled by the [TrendFunctionCacheSize](/manual/appendix/config/zabbix_server#trendfunctioncachesize) server parameter. Triggers that reference trend functions **only** are evaluated once per the smallest time period in the expression. For instance, a trigger like ```default trendavg(/host/key,1d:now/d) > 1 or trendavg(/host/key2,1w:now/w) > 2 ``` will be evaluated once per day. If the trigger contains both trend and history (or [date and time](/manual/appendix/functions/time) and/or [nodata()](/manual/appendix/functions/history#nodata)) functions, it is calculated in accordance with the [usual principles](/manual/config/triggers#calculation-time). All functions listed here are supported in: - [Trigger expressions](/manual/config/triggers/expression) - [Calculated items](/manual/config/items/itemtypes/calculated) - [Expression macros](/manual/config/macros/expression_macros) The functions are listed without additional information. Click on the function to see the full details. |Function|Description| |--|--------| |[baselinedev](#baselinedev)|Returns the number of deviations (by stddevpop algorithm) between the last data period and the same data periods in preceding seasons.| |[baselinewma](#baselinewma)|Calculates the baseline by averaging data from the same timeframe in multiple equal time periods ('seasons') using the weighted moving average algorithm.| |[trendavg](#trendavg)|The average of trend values within the defined time period.| |[trendcount](#trendcount)|The number of successfully retrieved history values used to calculate the trend value within the defined time period.| |[trendmax](#trendmax)|The maximum in trend values within the defined time period.| |[trendmin](#trendmin)|The minimum in trend values within the defined time period.| |[trendstl](#trendstl)|Returns the rate of anomalies during the detection period - a decimal value between 0 and 1 that is `((the number of anomaly values)/(total number of values))`.| |[trendsum](#trendsum)|The sum of trend values within the defined time period.| # 5 Trend funkcijas Trend funkcijas, atšķirībā no [vēstures funkcijām](/manual/appendix/functions/history), aprēķinos izmanto [trend](/manual/config/items/history_and_trends#keeping-trends) datus. Trend dati glabā stundas agregētās vērtības. Trend funkcijas izmanto šos stundas vidējos rādītājus, tāpēc tās ir noderīgas ilgtermiņa analīzei. Trend funkciju rezultāti tiek kešoti, tāpēc vairāki izsaukumi tai pašai funkcijai ar vienādiem parametriem informāciju no datubāzes iegūst tikai vienu reizi. Trend funkciju kešu kontrolē servera parametrs [TrendFunctionCacheSize](/manual/appendix/config/zabbix_server#trendfunctioncachesize). Trigeri, kas atsaucas tikai uz trend funkcijām, tiek izvērtēti vienu reizi katrā mazākajā laika periodā izteiksmē. Piemēram, trigeris kā ```default trendavg(/host/key,1d:now/d) > 1 or trendavg(/host/key2,1w:now/w) > 2 ``` tiks izvērtēts vienu reizi dienā. Ja trigeris satur gan trend, gan vēstures (vai [datuma un laika](/manual/appendix/functions/time) un/vai [nodata()](/manual/appendix/functions/history#nodata)) funkcijas, tas tiek aprēķināts saskaņā ar [parastajiem principiem](/manual/config/triggers#calculation-time). Visas šeit uzskaitītās funkcijas tiek atbalstītas: - [Trigeru izteiksmēs](/manual/config/triggers/expression) - [Aprēķinātajos vienumos](/manual/config/items/itemtypes/calculated) - [Izteiksmju makrosos](/manual/config/macros/expression_macros) Funkcijas ir uzskaitītas bez papildu informācijas. Noklikšķiniet uz funkcijas, lai skatītu pilnu informāciju. |Function|Description| |--|--------| |[baselinedev](#baselinedev)|Atgriež noviržu skaitu (izmantojot stddevpop algoritmu) starp pēdējo datu periodu un tiem pašiem datu periodiem iepriekšējās sezonās.| |[baselinewma](#baselinewma)|Aprēķina bāzlīniju, vidējo vērtību iegūstot no datiem tajā pašā laika posmā vairākos vienādos laika periodos ("sezonās"), izmantojot svērto slīdošā vidējā algoritmu.| |[trendavg](#trendavg)|Trend vērtību vidējā vērtība noteiktajā laika periodā.| |[trendcount](#trendcount)|Veiksmīgi izgūto vēstures vērtību skaits, kas izmantots trend vērtības aprēķināšanai noteiktajā laika periodā.| |[trendmax](#trendmax)|Maksimālā trend vērtība noteiktajā laika periodā.| |[trendmin](#trendmin)|Minimālā trend vērtība noteiktajā laika periodā.| |[trendstl](#trendstl)|Atgriež anomāliju biežumu noteikšanas periodā - decimāldaļas vērtību no 0 līdz 1, kas ir `((anomālo vērtību skaits)/(kopējais vērtību skaits))`.| |[trendsum](#trendsum)|Trend vērtību summa noteiktajā laika periodā.| ##### 5 Upgrade Zabbix components To upgrade Zabbix components, run: ```bash apt install --only-upgrade zabbix-server-mysql zabbix-frontend-php zabbix-agent ``` - If using PostgreSQL, replace `mysql` with `pgsql` in the command. - If upgrading proxy, replace `server` with `proxy` in the command. - If upgrading Zabbix agent 2, replace `zabbix-agent` with `zabbix-agent2 zabbix-agent2-plugin-*` in the command. ::: noteimportant Upgrading Zabbix agent 2 with the `apt install zabbix-agent2` command could lead to an error. For more information, see [*Known issues*](/manual/installation/known_issues#upgrading-zabbix-agent-2-6.0.5-or-older). ::: You may see a prompt about the Zabbix server (or proxy) configuration: ```bash Configuration file '/etc/zabbix/zabbix_server.conf' ==> Modified (by you or by a script) since installation. ==> Package distributor has shipped an updated version. What would you like to do about it ? Your options are: Y or I : install the package maintainer's version N or O : keep your currently-installed version D : show the differences between the versions Z : start a shell to examine the situation The default action is to keep your current version. *** zabbix_server.conf (Y/I/N/O/D/Z) [default=N] ? ``` Enter the option that best fits your situation. For example, enter `D` to compare the current and new configuration, then decide if you want to install the package maintainer's version (`Y` or `I`). Then, to upgrade Zabbix frontend with Apache and restart Apache, run: ```bash apt install zabbix-apache-conf systemctl restart apache2 ``` ##### 5 Zabbix komponentu jaunināšana Lai jauninātu Zabbix komponentus, izpildiet: ```bash apt install --only-upgrade zabbix-server-mysql zabbix-frontend-php zabbix-agent ``` - Ja izmantojat PostgreSQL, komandā aizstājiet `mysql` ar `pgsql`. - Ja jaunināt starpniekserveri, komandā aizstājiet `server` ar `proxy`. - Ja jaunināt Zabbix aģents 2, komandā aizstājiet `zabbix-agent` ar `zabbix-agent2 zabbix-agent2-plugin-*`. ::: noteimportant Jauninot Zabbix aģents 2 ar komandu `apt install zabbix-agent2`, var rasties kļūda. Plašāku informāciju skatiet sadaļā [*Zināmās problēmas*](/manual/installation/known_issues#upgrading-zabbix-agent-2-6.0.5-or-older). ::: Jūs varat redzēt uzvedni par Zabbix serveris (vai starpniekserveris) konfigurāciju: ```bash Configuration file '/etc/zabbix/zabbix_server.conf' ==> Modified (by you or by a script) since installation. ==> Package distributor has shipped an updated version. What would you like to do about it ? Your options are: Y or I : install the package maintainer's version N or O : keep your currently-installed version D : show the differences between the versions Z : start a shell to examine the situation The default action is to keep your current version. *** zabbix_server.conf (Y/I/N/O/D/Z) [default=N] ? ``` Ievadiet opciju, kas vislabāk atbilst jūsu situācijai. Piemēram, ievadiet `D`, lai salīdzinātu pašreizējo un jauno konfigurāciju, pēc tam izlemiet, vai vēlaties instalēt pakotnes uzturētāja versiju (`Y` vai `I`). Pēc tam, lai jauninātu Zabbix lietotāja saskarne ar Apache un restartētu Apache, izpildiet: ```bash apt install zabbix-apache-conf systemctl restart apache2 ``` ##### 5 Upgrade Zabbix components To upgrade Zabbix components, run: ```bash dnf install zabbix-server-mysql zabbix-web-mysql zabbix-agent ``` - If using PostgreSQL, replace `mysql` with `pgsql` in the command. - If upgrading the proxy, replace `server` with `proxy` in the command. - If upgrading the agent 2, replace `zabbix-agent` with `zabbix-agent2 zabbix-agent2-plugin-*` in the command. ::: noteimportant Upgrading Zabbix agent 2 with the `dnf install zabbix-agent2` command could lead to an error. For more information, see [*Known issues*](/manual/installation/known_issues#upgrading-zabbix-agent-2-6.0.5-or-older). ::: Then, to upgrade Zabbix frontend with Apache and restart Apache, run: ```bash dnf install zabbix-apache-conf systemctl restart httpd ``` ##### 5 Atjauniniet Zabbix komponentus Lai atjauninātu Zabbix komponentus, izpildiet: ```bash dnf install zabbix-server-mysql zabbix-web-mysql zabbix-agent ``` - Ja izmantojat PostgreSQL, komandā aizstājiet `mysql` ar `pgsql`. - Ja atjaunināt starpniekserveri, komandā aizstājiet `server` ar `proxy`. - Ja atjaunināt aģents 2, aizstājiet `zabbix-agent` ar `zabbix-agent2 zabbix-agent2-plugin-*` komandā. ::: noteimportant Zabbix aģents 2 atjaunināšana ar komandu `dnf install zabbix-agent2` var izraisīt kļūdu. Papildinformāciju skatiet sadaļā [*Zināmās problēmas*](/manual/installation/known_issues#upgrading-zabbix-agent-2-6.0.5-or-older). ::: Pēc tam, lai atjauninātu Zabbix lietotāja saskarne ar Apache un restartētu Apache, izpildiet: ```bash dnf install zabbix-apache-conf systemctl restart httpd ``` # 5 User parameters # 5 Lietotāja parametri # 5 Web scenarios # 5 Tīmekļa scenāriji # 5 Web scenarios # 5 Tīmekļa scenāriji # 5 What's new in Zabbix 7.0.0 See [breaking changes](/manual/installation/upgrade_notes_700#breaking-changes) for this version. # 5 Kas jauns Zabbix 7.0.0 Skatiet [nesaderīgās izmaiņas](/manual/installation/upgrade_notes_700#breaking-changes) šai versijai. # 5 Zabbix agent (Windows) # 5 Zabbix aģents (Windows) # 5 Zabbix internal # 5 Zabbix iekšējais # 5 Zabbix sender protocol # 5 Zabbix sender protokols # 6 Action log # 6 Darbību žurnāls # 6 CSV to JSON preprocessing # 6 CSV uz JSON priekšapstrāde # 6 Data collection # 6 Datu vākšana # 6 Discovery of JMX objects # 6 JMX objektu atklāšana # 6 Discovery rules This section provides practical examples of configuring discovery rules for different types of entities, such as filesystems, network interfaces, services, sensors, SNMP objects, Java applications, and databases. Each example illustrates how a discovery rule can be structured, including the item key or query used, the JSON output with LLD macros, and how those results are used to create item, trigger, and graph prototypes. To explore a specific discovery rule type, use the sidebar to navigate to the corresponding page. # 6 Atklāšanas noteikumi Šī sadaļa sniedz praktiskus piemērus, kā konfigurēt atklāšanas noteikumus dažādiem entītiju veidiem, piemēram, failu sistēmām, tīkla saskarnēm, pakalpojumiem, sensoriem, SNMP objektiem, Java lietojumprogrammām un datubāzēm. Katrs piemērs parāda, kā var strukturēt atklāšanas noteikumu, tostarp izmantoto vienuma atslēgu vai vaicājumu, JSON izvadi ar LLD makro un to, kā šie rezultāti tiek izmantoti, lai izveidotu vienumu, trigeris un grafiku prototipus. Lai apskatītu konkrētu atklāšanas noteikuma veidu, izmantojiet sānjoslu, lai pārietu uz atbilstošo lapu. # 6 Event correlation # 6 Notikumu korelācija # 6 Expression macros # 6 Izteiksmju makrosi # 6 Favorite maps # 6 Izlases kartes # 6 Favorite maps # 6 Izlases kartes # 6 Header # 6 Galvene # 6 Macros # 6 Makrosi # 6 Macros It is possible to use out-of-the-box [Supported macros](/manual/appendix/macros/supported_by_location) and [User macros supported by location](/manual/appendix/macros/supported_by_location_user). # 6 Makrosi Ir iespējams izmantot jau gatavus [atbalstītos makrosus](/manual/appendix/macros/supported_by_location) un [lietotāja makrosus, ko atbalsta pēc atrašanās vietas](/manual/appendix/macros/supported_by_location_user). # 6 Mass update # 6 Masveida atjaunināšana # 6 Mathematical functions All functions listed here are supported in: - [Trigger expressions](/manual/config/triggers/expression) - [Calculated items](/manual/config/items/itemtypes/calculated) - [Expression macros](/manual/config/macros/expression_macros) Mathematical functions are supported with float and integer value types, unless stated otherwise. The functions are listed without additional information. Click on the function to see the full details. |Function|Description| |--|--------| |[abs](#abs)|The absolute value of a value.| |[acos](#acos)|The arccosine of a value as an angle, expressed in radians.| |[asin](#asin)|The arcsine of a value as an angle, expressed in radians.| |[atan](#atan)|The arctangent of a value as an angle, expressed in radians.| |[atan2](#atan2)|The arctangent of the ordinate (value) and abscissa coordinates specified as an angle, expressed in radians.| |[avg](#avg)|The average value of the referenced item values.| |[cbrt](#cbrt)|The cube root of a value.| |[ceil](#ceil)|Round the value up to the nearest greater or equal integer.| |[cos](#cos)|The cosine of a value, where the value is an angle expressed in radians.| |[cosh](#cosh)|The hyperbolic cosine of a value.| |[cot](#cot)|The cotangent of a value, where the value is an angle expressed in radians.| |[degrees](#degrees)|Converts a value from radians to degrees.| |[e](#e)|The Euler's number (2.718281828459045).| |[exp](#exp)|The Euler's number at a power of a value.| |[expm1](#expm1)|The Euler's number at a power of a value minus 1.| |[floor](#floor)|Round the value down to the nearest smaller or equal integer.| |[log](#log)|The natural logarithm.| |[log10](#log10)|The decimal logarithm.| |[max](#max)|The highest value of the referenced item values.| |[min](#min)|The lowest value of the referenced item values.| |[mod](#mod)|The division remainder.| |[pi](#pi)|The Pi constant (3.14159265358979).| |[power](#power)|The power of a value.| |[radians](#radians)|Converts a value from degrees to radians.| |[rand](#rand)|Return a random integer value.| |[round](#round)|Round the value to decimal places.| |[signum](#signum)|Returns '-1' if a value is negative, '0' if a value is zero, '1' if a value is positive.| |[sin](#sin)|The sine of a value, where the value is an angle expressed in radians.| |[sinh](#sinh)|The hyperbolical sine of a value, where the value is an angle expressed in radians.| |[sqrt](#sqrt)|The square root of a value.| |[sum](#sum)|The sum of the referenced item values.| |[tan](#tan)|The tangent of a value.| |[truncate](#truncate)|Truncate the value to decimal places.| # 6 Matemātiskās funkcijas Visas šeit uzskaitītās funkcijas tiek atbalstītas: - [Trigeru izteiksmēs](/manual/config/triggers/expression) - [Aprēķinātajos vienumos](/manual/config/items/itemtypes/calculated) - [Izteiksmju makrosos](/manual/config/macros/expression_macros) Matemātiskās funkcijas tiek atbalstītas float un integer vērtību tipiem, ja vien nav norādīts citādi. Funkcijas ir uzskaitītas bez papildu informācijas. Noklikšķiniet uz funkcijas, lai skatītu pilnu informāciju. |Function|Description| |--|--------| |[abs](#abs)|Vērtības absolūtā vērtība.| |[acos](#acos)|Vērtības arkkosinuss kā leņķis, izteikts radiānos.| |[asin](#asin)|Vērtības arksinuss kā leņķis, izteikts radiānos.| |[atan](#atan)|Vērtības arktangenss kā leņķis, izteikts radiānos.| |[atan2](#atan2)|Ordinātas (vērtības) un abscisas koordinātu arktangenss, kas norādīts kā leņķis, izteikts radiānos.| |[avg](#avg)|Atsauces vienumu vērtību vidējā vērtība.| |[cbrt](#cbrt)|Vērtības kubsakne.| |[ceil](#ceil)|Noapaļo vērtību uz augšu līdz tuvākajam lielākajam vai vienādam veselajam skaitlim.| |[cos](#cos)|Vērtības kosinuss, ja vērtība ir leņķis, kas izteikts radiānos.| |[cosh](#cosh)|Vērtības hiperboliskais kosinuss.| |[cot](#cot)|Vērtības kotangenss, ja vērtība ir leņķis, kas izteikts radiānos.| |[degrees](#degrees)|Pārvērš vērtību no radiāniem grādos.| |[e](#e)|Eilera skaitlis (2.718281828459045).| |[exp](#exp)|Eilera skaitlis pakāpē, kas vienāda ar vērtību.| |[expm1](#expm1)|Eilera skaitlis pakāpē, kas vienāda ar vērtību, mīnus 1.| |[floor](#floor)|Noapaļo vērtību uz leju līdz tuvākajam mazākajam vai vienādam veselajam skaitlim.| |[log](#log)|Naturālais logaritms.| |[log10](#log10)|Decimālais logaritms.| |[max](#max)|Atsauces vienumu vērtību lielākā vērtība.| |[min](#min)|Atsauces vienumu vērtību mazākā vērtība.| |[mod](#mod)|Dalīšanas atlikums.| |[pi](#pi)|Pi konstante (3.14159265358979).| |[power](#power)|Vērtības pakāpe.| |[radians](#radians)|Pārvērš vērtību no grādiem radiānos.| |[rand](#rand)|Atgriež nejaušu veselu skaitli.| |[round](#round)|Noapaļo vērtību līdz decimāldaļām.| |[signum](#signum)|Atgriež '-1', ja vērtība ir negatīva, '0', ja vērtība ir nulle, '1', ja vērtība ir pozitīva.| |[sin](#sin)|Vērtības sinuss, ja vērtība ir leņķis, kas izteikts radiānos.| |[sinh](#sinh)|Vērtības hiperboliskais sinuss, ja vērtība ir leņķis, kas izteikts radiānos.| |[sqrt](#sqrt)|Vērtības kvadrātsakne.| |[sum](#sum)|Atsauces vienumu vērtību summa.| |[tan](#tan)|Vērtības tangenss.| |[truncate](#truncate)|Saīsina vērtību līdz decimāldaļām.| # 6 Media types # 6 Mediju tipi # 6 MongoDB plugin # 6 MongoDB spraudnis # 6 ODBC template operation Steps to ensure correct operation of templates that collect metrics via [ODBC monitoring](/manual/config/items/itemtypes/odbc_checks): 1. Make sure that required ODBC driver is installed on Zabbix server or proxy. 2. [Link](/manual/config/templates/linking#linking-a-template) the template to a target host (if the template is not available in your Zabbix installation, you may need to [import](/manual/config/templates_out_of_the_box#template-upgrade) the template first). 3. If necessary, adjust the values of template macros. 4. Configure the instance being monitored to allow data sharing with Zabbix. A detailed description of a template, including the full list of macros, items, and triggers, is available in the template's README file (accessible by clicking on a template name). The following templates are available: - [MSSQL by ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mssql_odbc/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [MySQL by ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mysql_odbc/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Oracle by ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/oracle_odbc/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [PostgreSQL by ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/postgresql_odbc/README.md?at=refs%2Fheads%2Frelease%2F7.0) # 6 ODBC veidnes darbība Darbības soļi, lai nodrošinātu pareizu to veidņu darbību, kas apkopo metriku, izmantojot [ODBC monitoring](/manual/config/items/itemtypes/odbc_checks): 1. Pārliecinieties, ka nepieciešamais ODBC draiveris ir instalēts Zabbix serverī vai starpniekserverī. 2. [Piesaistiet](/manual/config/templates/linking#linking-a-template) veidni mērķa hostam (ja veidne nav pieejama jūsu Zabbix instalācijā, vispirms var būt nepieciešams to [importēt](/manual/config/templates_out_of_the_box#template-upgrade)). 3. Ja nepieciešams, pielāgojiet veidnes makro vērtības. 4. Konfigurējiet uzraudzīto instanci tā, lai tā atļautu datu koplietošanu ar Zabbix. Detalizēts veidnes apraksts, tostarp pilns makro, vienumu un trigeru saraksts, ir pieejams veidnes README failā (tam var piekļūt, noklikšķinot uz veidnes nosaukuma). Pieejamas šādas veidnes: - [MSSQL by ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mssql_odbc/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [MySQL by ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mysql_odbc/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [Oracle by ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/oracle_odbc/README.md?at=refs%2Fheads%2Frelease%2F7.0) - [PostgreSQL by ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/postgresql_odbc/README.md?at=refs%2Fheads%2Frelease%2F7.0) # 6 Page parameters # 6 Lapas parametri ##### 6 Review and edit configuration files - edit the Zabbix agent configuration file **/usr/local/etc/zabbix\_agentd.conf** You need to configure this file for every host with zabbix\_agentd installed. You must specify the Zabbix server **IP address** in the file. Connections from other hosts will be denied. - edit the Zabbix server configuration file **/usr/local/etc/zabbix\_server.conf** You must specify the database name, user and password (if using any). The rest of the parameters will suit you with their defaults if you have a small installation (up to ten monitored hosts). You should change the default parameters if you want to maximize the performance of Zabbix server (or proxy) though. - if you have installed a Zabbix proxy, edit the proxy configuration file **/usr/local/etc/zabbix\_proxy.conf** You must specify the server IP address and proxy hostname (must be known to the server), as well as the database name, user and password (if using any). ::: noteclassic With SQLite the full path to database file must be specified; DB user and password are not required. ::: ##### 6 Pārskatiet un rediģējiet konfigurācijas failus - rediģējiet Zabbix aģenta konfigurācijas failu **/usr/local/etc/zabbix\_agentd.conf** Šis fails ir jākonfigurē katram hostam, kurā ir instalēts zabbix\_agentd. Failā ir jānorāda Zabbix servera **IP adrese**. Savienojumi no citiem hostiem tiks noraidīti. - rediģējiet Zabbix servera konfigurācijas failu **/usr/local/etc/zabbix\_server.conf** Jums ir jānorāda datubāzes nosaukums, lietotājs un parole (ja tāda tiek izmantota). Pārējie parametri ar noklusējuma vērtībām būs piemēroti, ja jums ir neliela instalācija (līdz desmit uzraudzītiem hostiem). Tomēr, ja vēlaties maksimāli palielināt Zabbix servera (vai starpniekservera) veiktspēju, jums vajadzētu mainīt noklusējuma parametrus. - ja esat instalējis Zabbix starpniekserveri, rediģējiet starpniekservera konfigurācijas failu **/usr/local/etc/zabbix\_proxy.conf** Jums ir jānorāda servera IP adrese un starpniekservera hostname (tam jābūt zināmam serverim), kā arī datubāzes nosaukums, lietotājs un parole (ja tāda tiek izmantota). ::: noteclassic Izmantojot SQLite, ir jānorāda pilns ceļš uz datubāzes failu; DB lietotājs un parole nav nepieciešami. ::: ##### 6 Review component configuration parameters Review the relevant [upgrade notes](/manual/installation/upgrade_notes_700) to check if any changes in the configuration parameters are necessary. For new optional parameters, see the [What's new](/manual/introduction/whatsnew700) page. ##### 6 Pārskatiet komponenta konfigurācijas parametrus Pārskatiet attiecīgās [jaunināšanas piezīmes](/manual/installation/upgrade_notes_700), lai pārbaudītu, vai konfigurācijas parametros ir nepieciešamas kādas izmaiņas. Par jauniem neobligātajiem parametriem skatiet lapu [Kas jauns](/manual/introduction/whatsnew700). ##### 6 Review component configuration parameters Review the relevant [upgrade notes](/manual/installation/upgrade_notes_700) to check if any changes in the configuration parameters are necessary. For new optional parameters, see the [What's new](/manual/introduction/whatsnew700) page. ##### 6 Pārskatiet komponenta konfigurācijas parametrus Pārskatiet attiecīgās [jaunināšanas piezīmes](/manual/installation/upgrade_notes_700), lai pārbaudītu, vai konfigurācijas parametros ir nepieciešamas kādas izmaiņas. Par jauniem izvēles parametriem skatiet lapu [Kas jauns](/manual/introduction/whatsnew700). # 6 Sender # 6 Sūtītājs # 6 Sensor # 6 Sensors ##### 6 Start new Zabbix binaries Start new binaries. Check log files to see if the binaries have started successfully. Zabbix server will automatically upgrade the database. When starting up, Zabbix server reports the current (mandatory and optional) and required database versions. If the current mandatory version is older than the required version, Zabbix server automatically executes the required database upgrade patches. The start and progress level (percentage) of the database upgrade is written to the Zabbix server log file. When the upgrade is completed, a "database upgrade fully completed" message is written to the log file. If any of the upgrade patches fail, Zabbix server will not start. Zabbix server will also not start if the current mandatory database version is newer than the required one. Zabbix server will only start if the current mandatory database version corresponds to the required mandatory version. 8673:20161117:104750.259 current database version (mandatory/optional): 03040000/03040000 8673:20161117:104750.259 required mandatory version: 03040000 Before you start the server: - Make sure the database user has enough permissions (create table, drop table, create index, drop index) - Make sure you have enough free disk space. ##### 6 Palaidiet jaunus Zabbix bināros failus Palaidiet jaunus bināros failus. Pārbaudiet žurnālfailus, lai redzētu, vai binārie faili ir veiksmīgi palaisti. Zabbix serveris automātiski jauninās datubāzi. Palaišanas laikā Zabbix serveris ziņo par pašreizējo (obligāto un neobligāto) un nepieciešamo datubāzes versiju. Ja pašreizējā obligātā versija ir vecāka par nepieciešamo versiju, Zabbix serveris automātiski izpilda nepieciešamos datubāzes jaunināšanas ielāpus. Datubāzes jaunināšanas sākums un norises līmenis (procentos) tiek ierakstīts Zabbix servera žurnālfailā. Kad jaunināšana ir pabeigta, žurnālfailā tiek ierakstīts ziņojums "database upgrade fully completed". Ja kāds no jaunināšanas ielāpiem neizdodas, Zabbix serveris netiks palaists. Zabbix serveris arī netiks palaists, ja pašreizējā obligātā datubāzes versija ir jaunāka par nepieciešamo. Zabbix serveris tiks palaists tikai tad, ja pašreizējā obligātā datubāzes versija atbilst nepieciešamajai obligātajai versijai. 8673:20161117:104750.259 current database version (mandatory/optional): 03040000/03040000 8673:20161117:104750.259 required mandatory version: 03040000 Pirms servera palaišanas: - Pārliecinieties, ka datubāzes lietotājam ir pietiekamas atļaujas (create table, drop table, create index, drop index) - Pārliecinieties, ka jums ir pietiekami daudz brīvas vietas diskā. # 6 Tagging # 6 Marķēšana # 6 TimescaleDB setup # 6 TimescaleDB iestatīšana # 6 Web interface installation This section provides step-by-step instructions for installing Zabbix web interface. Zabbix frontend is written in PHP, so to run it a PHP supported webserver is needed. # 6 Lietotāja saskarnes instalēšana Šajā sadaļā ir sniegtas soli pa solim instrukcijas Zabbix lietotāja saskarnes instalēšanai. Zabbix lietotāja saskarne ir rakstīta PHP valodā, tāpēc tās darbībai ir nepieciešams tīmekļa serveris ar PHP atbalstu. # 6 What's new in Zabbix 7.0.1 See [breaking changes](/manual/installation/upgrade_notes_701#breaking-changes) for this version. # 6 Kas jauns Zabbix 7.0.1 Skatiet [pārtraucošās izmaiņas](/manual/installation/upgrade_notes_701#breaking-changes) šajā versijā. # 6 Windows performance counters # 6 Windows veiktspējas skaitītāji # 6 Zabbix agent 2 (Windows) # 6 Zabbix aģents 2 (Windows) # 6 Zabbix appliance # 6 Zabbix ierīce # 6 Zabbix trapper # 6 Zabbix trapper ## 7.0.1 ## 7.0.1 ## 7.0.10 ## 7.0.10 ## 7.0.11 ## 7.0.11 ## 7.0.14 ## 7.0.14 ## 7.0.19 ## 7.0.19 ## 7.0.27 ## 7.0.27 ## 7.0.4 ## 7.0.4 ## 7.0.6 ## 7.0.6 ## 7.0.7 ## 7.0.7 ## 7.0.9 ## 7.0.9 # 7 Alerts # 7 Brīdinājumi # 7 Configuration # 7 Konfigurācija # 7 Custom LLD rules # 7 Pielāgotie LLD noteikumi # 7 Definitions # 7 Definīcijas # 7 Discovery # 7 Atklāšana # 7 Discovery of IPMI sensors # 7 IPMI sensoru atklāšana # 7 Elasticsearch setup ::: noteimportant Elasticsearch support is experimental! ::: Zabbix supports the storage of historical data by means of Elasticsearch instead of a database. Users can choose the storage place for historical data between a compatible database and Elasticsearch. The setup procedure described in this section is applicable to Elasticsearch version 7.X. In case an earlier or later version of Elasticsearch is used, some functionality may not work as intended. ::: notewarning 1\.If all history data is stored in Elasticsearch, trends are **not** calculated nor stored in the database. With no trends calculated and stored, the history storage period may need to be extended.<br> 2\. When Elasticsearch is used, range queries retrieving values from the database are limited by the timestamp of the data storage period. ::: # 7 Elasticsearch iestatīšana ::: noteimportant Elasticsearch atbalsts ir eksperimentāls! ::: Zabbix atbalsta vēsturisko datu glabāšanu, izmantojot Elasticsearch datubāzes vietā. Lietotāji var izvēlēties vēsturisko datu glabāšanas vietu starp saderīgu datubāzi un Elasticsearch. Šajā sadaļā aprakstītā iestatīšanas procedūra ir piemērojama Elasticsearch 7.X versijai. Ja tiek izmantota agrāka vai jaunāka Elasticsearch versija, dažas funkcijas var nedarboties, kā paredzēts. ::: notewarning 1\.Ja visi vēsturiskie dati tiek glabāti Elasticsearch, tendences netiek **aprēķinātas** un netiek glabātas datubāzē. Ja tendences netiek aprēķinātas un glabātas, var būt nepieciešams pagarināt vēsturisko datu glabāšanas periodu.<br> 2\. Ja tiek izmantots Elasticsearch, diapazona vaicājumi, kas izgūst vērtības no datubāzes, ir ierobežoti ar datu glabāšanas perioda laika zīmogu. ::: # 7 External check # 7 Ārējā pārbaude # 7 Gauge # 7 Gauge # 7 Gauge # 7 Gauge # 7 Get # 7 Iegūt ##### 7 Install new Zabbix web interface The minimum required PHP version is 8.0.0. Update if needed and follow [installation instructions](/manual/installation/frontend). ##### 7 Instalēt jaunu Zabbix lietotāja saskarni Minimālā nepieciešamā PHP versija ir 8.0.0. Ja nepieciešams, atjauniniet to un sekojiet [instalēšanas norādījumiem](/manual/installation/frontend). # 7 Mass update # 7 Masveida atjaunināšana # 7 MQTT plugin # 7 MQTT spraudnis # 7 Newline-delimited JSON export protocol This section presents details of the export protocol in a newline-delimited JSON format, used in: - [data export to files](/manual/config/export/files) - [streaming to external systems](/manual/config/export/streaming) The following can be exported: - [trigger events](#trigger-events) - [item values](#item-values) - [trends](#trends) (export to files only) All files have a .ndjson extension. Each line of the export file is a JSON object. # 7 Ar jaunu rindu atdalīts JSON eksporta protokols Šajā sadaļā ir sniegta informācija par eksporta protokolu ar jaunu rindu atdalītā JSON formātā, kas tiek izmantots: - [datu eksportēšanā uz failiem](/manual/config/export/files) - [straumēšanā uz ārējām sistēmām](/manual/config/export/streaming) Var eksportēt šādus datus: - [trigeru notikumus](#trigger-events) - [vienumu vērtības](#item-values) - [tendences](#trends) (tikai eksportēšana uz failiem) Visiem failiem ir .ndjson paplašinājums. Katra eksporta faila rinda ir JSON objekts. # 7 Notes on memtype parameter in proc.mem items # 7 Piezīmes par memtype parametru proc.mem vienumos # 7 Notifications # 7 Paziņojumi # 7 Operator functions All functions listed here are supported in: - [Trigger expressions](/manual/config/triggers/expression) - [Calculated items](/manual/config/items/itemtypes/calculated) - [Expression macros](/manual/config/macros/expression_macros) The functions are listed without additional information. Click on the function to see the full details. |Function|Description| |--|--------| |[between](#between)|Check if the value belongs to the given range.| |[in](#in)|Check if the value is equal to at least one of the listed values.| # 7 Operatora funkcijas Visas šeit uzskaitītās funkcijas tiek atbalstītas: - [Trigeru izteiksmēs](/manual/config/triggers/expression) - [Aprēķinātajos vienumos](/manual/config/items/itemtypes/calculated) - [Izteiksmju makrosos](/manual/config/macros/expression_macros) Funkcijas ir uzskaitītas bez papildu informācijas. Noklikšķiniet uz funkcijas, lai skatītu pilnu informāciju. |Funkcija|Apraksts| |--|--------| |[between](#between)|Pārbauda, vai vērtība pieder dotajam diapazonam.| |[in](#in)|Pārbauda, vai vērtība ir vienāda ar vismaz vienu no uzskaitītajām vērtībām.| # 7 Predictive trigger functions # 7 Prognozējošās trigeru funkcijas # 7 Queue # 7 Rinda # 7 Standardized templates for network devices # 7 Standartizētas veidnes tīkla ierīcēm ##### 7 Start up the daemons Run zabbix\_server on the server side. zabbix_server ::: noteclassic Make sure that your system allows allocation of 36MB (or a bit more) of shared memory, otherwise the server may not start and you will see "Cannot allocate shared memory for <type of cache>." in the server log file. This may happen on FreeBSD, Solaris 8. ::: Run zabbix\_agentd on all the monitored machines. zabbix_agentd ::: noteclassic Make sure that your system allows allocation of 2MB of shared memory, otherwise the agent may not start and you will see "Cannot allocate shared memory for collector." in the agent log file. This may happen on Solaris 8. ::: If you have installed Zabbix proxy, run zabbix\_proxy. zabbix_proxy ##### 7 Palaidiet dēmonus Palaidiet zabbix\_server servera pusē. zabbix_server ::: noteclassic Pārliecinieties, ka jūsu sistēma atļauj piešķirt 36 MB (vai nedaudz vairāk) koplietojamās atmiņas, pretējā gadījumā serveris var netikt palaists, un servera žurnāla failā redzēsiet "Cannot allocate shared memory for <type of cache>.". Tas var notikt FreeBSD, Solaris 8. ::: Palaidiet zabbix\_agentd visos uzraudzītajos datoros. zabbix_agentd ::: noteclassic Pārliecinieties, ka jūsu sistēma atļauj piešķirt 2 MB koplietojamās atmiņas, pretējā gadījumā aģents var netikt palaists, un aģenta žurnāla failā redzēsiet "Cannot allocate shared memory for collector.". Tas var notikt Solaris 8. ::: Ja esat instalējis Zabbix starpniekserveris, palaidiet zabbix\_proxy. zabbix_proxy ##### 7 Start Zabbix processes Start the upgraded Zabbix components: ```bash systemctl start zabbix-server systemctl start zabbix-proxy systemctl start zabbix-agent systemctl start zabbix-agent2 ``` ##### 7 Palaidiet Zabbix procesus Palaidiet atjauninātos Zabbix komponentus: ```bash systemctl start zabbix-server systemctl start zabbix-proxy systemctl start zabbix-agent systemctl start zabbix-agent2 ``` ##### 7 Start Zabbix processes Start the upgraded Zabbix components: ```bash systemctl start zabbix-server systemctl start zabbix-proxy systemctl start zabbix-agent systemctl start zabbix-agent2 ``` ##### 7 Palaidiet Zabbix procesus Palaidiet atjauninātos Zabbix komponentus: ```bash systemctl start zabbix-server systemctl start zabbix-proxy systemctl start zabbix-agent systemctl start zabbix-agent2 ``` # 7 Unit symbols # 7 Vienību simboli # 7 Upgrade procedure # 7 Jaunināšanas procedūra # 7 Visualization # 7 Vizualizācija # 7 What's new in Zabbix 7.0.2 See [breaking changes](/manual/installation/upgrade_notes_702#breaking-changes) for this version. # 7 Kas jauns Zabbix 7.0.2 Skatiet [nesaderīgās izmaiņas](/manual/installation/upgrade_notes_702#breaking-changes) šai versijai. # 7 Zabbix agent 2 plugins # 7 Zabbix aģents 2 spraudņi ##### 8 Clear web browser cookies and cache After the upgrade you may need to clear web browser cookies and web browser cache for the Zabbix web interface to work properly. ##### 8 Notīriet tīmekļa pārlūka sīkdatnes un kešatmiņu Pēc jaunināšanas jums, iespējams, būs jānotīra tīmekļa pārlūka sīkdatnes un tīmekļa pārlūka kešatmiņa, lai Zabbix tīmekļa lietotāja saskarne darbotos pareizi. ##### 8 Clear web browser cookies and cache After the upgrade, you may need to clear web browser cookies and web browser cache for the Zabbix web interface to work properly. ##### 8 Notīriet tīmekļa pārlūka sīkfailus un kešatmiņu Pēc jaunināšanas jums var būt nepieciešams notīrīt tīmekļa pārlūka sīkfailus un tīmekļa pārlūka kešatmiņu, lai Zabbix tīmekļa lietotāja saskarne darbotos pareizi. ##### 8 Clear web browser cookies and cache After the upgrade, you may need to clear web browser cookies and web browser cache for the Zabbix web interface to work properly. ##### 8 Notīriet tīmekļa pārlūka sīkfailus un kešatmiņu Pēc jaunināšanas jums var būt nepieciešams notīrīt tīmekļa pārlūka sīkfailus un tīmekļa pārlūka kešatmiņu, lai Zabbix lietotāja saskarne darbotos pareizi. # 8 Creating your own theme # 8 Savas tēmas izveide # 8 Database monitor # 8 Datu bāzes monitors # 8 Discovery of systemd services # 8 systemd pakalpojumu atklāšana # 8 Distribution-specific notes on setting up Nginx for Zabbix # 8 Ar Zabbix paredzētas Nginx iestatīšanas piezīmes atkarībā no distribūcijas # 8 Geomap # 8 Geomap # 8 Geomap # 8 Geomap # 8 JS # 8 JS # 8 Known issues See also: [Compilation issues](/manual/installation/known_issues/compilation_issues). # 8 Zināmās problēmas Skatiet arī: [Kompilēšanas problēmas](/manual/installation/known_issues/compilation_issues). # 8 MSSQL plugin # 8 MSSQL spraudnis # 8 Notes on selecting processes in proc.mem and proc.num items # 8 Piezīmes par procesu atlasi proc.mem un proc.num vienumos # 8 Prediction functions All functions listed here are supported in: - [Trigger expressions](/manual/config/triggers/expression) - [Calculated items](/manual/config/items/itemtypes/calculated) - [Expression macros](/manual/config/macros/expression_macros) The functions are listed without additional information. Click on the function to see the full details. |Function|Description| |--|--------| |[forecast](#forecast)|The future value, max, min, delta or avg of the item.| |[timeleft](#timeleft)|The time in seconds needed for an item to reach the specified threshold.| # 8 Prognozēšanas funkcijas Visas šeit uzskaitītās funkcijas tiek atbalstītas: - [Trigeru izteiksmēs](/manual/config/triggers/expression) - [Aprēķinātajos vienumos](/manual/config/items/itemtypes/calculated) - [Izteiksmju makrosos](/manual/config/macros/expression_macros) Funkcijas ir uzskaitītas bez papildu informācijas. Noklikšķiniet uz funkcijas, lai skatītu pilnu informāciju. |Function|Description| |--|--------| |[forecast](#forecast)|Vienuma nākotnes vērtība, maksimums, minimums, delta vai vidējā vērtība.| |[timeleft](#timeleft)|Laiks sekundēs, kas nepieciešams, lai vienums sasniegtu norādīto slieksni.| # 8 Service monitoring # 8 Pakalpojumu uzraudzība # 8 Templates and template groups # 8 Veidnes un veidņu grupas # 8 Time period syntax # 8 Laika perioda sintakse # 8 Users # 8 Lietotāji # 8 Value mapping # 8 Vērtību kartēšana # 8 VMware template operation # 8 VMware veidnes darbība # 8 What's new in Zabbix 7.0.3 See [breaking changes](/manual/installation/upgrade_notes_703#breaking-changes) for this version. # 8 Kas jauns Zabbix 7.0.3 Skatiet [nesaderīgās izmaiņas](/manual/installation/upgrade_notes_703#breaking-changes) šai versijai. # 8 Zabbix Java gateway If you use `startup.sh` and `shutdown.sh` scripts for starting [Zabbix Java gateway](/manual/concepts/java), then you can specify the necessary configuration parameters in the `settings.sh` file. The startup and shutdown scripts source the settings file and take care of converting shell variables (listed in the first column) to Java properties (listed in the second column). If you start Zabbix Java gateway manually by running `java` directly, then you specify the corresponding Java properties on the command line. |Variable|Property|Mandatory|Range|Default|Description| |--------|--------|---------|-----|-------|-----------| |LISTEN\_IP|zabbix.listenIP|no| |0.0.0.0|IP address to listen on.| |LISTEN\_PORT|zabbix.listenPort|no|1024-32767|10052|Port to listen on.| |PID\_FILE|zabbix.pidFile|no| |/tmp/zabbix\_java.pid|Name of PID file. If omitted, Zabbix Java Gateway is started as a console application.| |PROPERTIES\_FILE|zabbix.propertiesFile|no| | |Name of properties file. Can be used to set additional properties using a key-value format in such a way that they are not visible on a command line or to overwrite existing ones.<br>For example: "javax.net.ssl.trustStorePassword=<password>"| |START\_POLLERS|zabbix.startPollers|no|1-1000|5|Number of worker threads to start.| |TIMEOUT|zabbix.timeout|no|1-30|3|How long to wait for network operations (in seconds).| ::: notewarning Port 10052 is not [IANA registered](http://www.iana.org/assignments/service-names-port-numbers/service-names-port-numbers.txt). ::: # 8 Zabbix Java gateway Ja izmantojat `startup.sh` un `shutdown.sh` skriptus [Zabbix Java gateway](/manual/concepts/java) palaišanai, tad nepieciešamos konfigurācijas parametrus varat norādīt `settings.sh` failā. Startup un shutdown skripti nolasa iestatījumu failu un parūpējas par čaulas mainīgo (uzskaitīti pirmajā kolonnā) pārveidošanu Java īpašībās (uzskaitītas otrajā kolonnā). Ja Zabbix Java gateway palaižat manuāli, tieši izpildot `java`, tad atbilstošās Java īpašības norādāt komandrindā. |Variable|Property|Mandatory|Range|Default|Description| |--------|--------|---------|-----|-------|-----------| |LISTEN\_IP|zabbix.listenIP|no| |0.0.0.0|IP adrese, uz kuras klausīties.| |LISTEN\_PORT|zabbix.listenPort|no|1024-32767|10052|Ports, uz kura klausīties.| |PID\_FILE|zabbix.pidFile|no| |/tmp/zabbix\_java.pid|PID faila nosaukums. Ja tas tiek izlaists, Zabbix Java Gateway tiek palaists kā konsoles lietojumprogramma.| |PROPERTIES\_FILE|zabbix.propertiesFile|no| | |Īpašību faila nosaukums. To var izmantot, lai iestatītu papildu īpašības, izmantojot atslēgas-vērtības formātu, tādā veidā, lai tās nebūtu redzamas komandrindā, vai lai pārrakstītu esošās.<br>Piemēram: "javax.net.ssl.trustStorePassword=<password>"| |START\_POLLERS|zabbix.startPollers|no|1-1000|5|Darbinieka pavedienu skaits, ko palaist.| |TIMEOUT|zabbix.timeout|no|1-30|3|Cik ilgi gaidīt tīkla operācijas (sekundēs).| ::: notewarning Ports 10052 nav [IANA reģistrēts](http://www.iana.org/assignments/service-names-port-numbers/service-names-port-numbers.txt). ::: # 9 Administration # 9 Administrēšana # 9 Command execution Zabbix uses common functionality for external checks, user parameters, system.run items, custom alert scripts, remote commands and global scripts. # 9 Komandu izpilde Zabbix izmanto kopīgu funkcionalitāti ārējām pārbaudēm, lietotāja parametriem, system.run vienumiem, pielāgotiem brīdinājumu skriptiem, attālinātām komandām un globālajiem skriptiem. # 9 Debug mode # 9 Atkļūdošanas režīms # 9 Discovery of Windows services # 9 Windows servisu atklāšana # 9 Graph # 9 Grafiks # 9 Graph # 9 Grafiks # 9 HTTP agent # 9 HTTP aģents # 9 Implementation details of net.tcp.service and net.udp.service checks Implementation of net.tcp.service and net.udp.service checks is detailed on this page for various services specified in the service parameter. # 9 net.tcp.service un net.udp.service pārbaužu ieviešanas detaļas net.tcp.service un net.udp.service pārbaužu ieviešana ir detalizēti aprakstīta šajā lapā dažādiem pakalpojumiem, kas norādīti service parametrā. # 9 MySQL plugin # 9 MySQL spraudnis # 9 Queue # 9 Rinda # 9 Running agent as root Since Zabbix **5.0.0**, the systemd service file for Zabbix agent in [official packages](https://www.zabbix.com/download) explicitly includes directives for `User` and `Group`. Both are set to `zabbix`. It is no longer possible to configure which user Zabbix agent runs as via `zabbix_agentd.conf` file, because the agent will bypass this configuration and run as the user specified in the systemd service file. To run Zabbix agent as root you need to make the modifications described below. # 9 Aģenta palaišana kā root Kopš Zabbix **5.0.0** sistēmasd pakalpojuma fails Zabbix aģentam [oficiālajās pakotnēs](https://www.zabbix.com/download) skaidri ietver direktīvas `User` un `Group`. Abas ir iestatītas uz `zabbix`. Vairs nav iespējams konfigurēt, ar kādu lietotāju Zabbix aģents tiek palaists, izmantojot `zabbix_agentd.conf` failu, jo aģents apies šo konfigurāciju un tiks palaists kā lietotājs, kas norādīts sistēmasd pakalpojuma failā. Lai palaistu Zabbix aģentu kā root, jums jāveic tālāk aprakstītās izmaiņas. # 9 String functions All functions listed here are supported in: - [Trigger expressions](/manual/config/triggers/expression) - [Calculated items](/manual/config/items/itemtypes/calculated) - [Expression macros](/manual/config/macros/expression_macros) The functions are listed without additional information. Click on the function to see the full details. |Function|Description| |--|--------| |[ascii](#ascii)|The ASCII code of the leftmost character of the value.| |[bitlength](#bitlength)|The length of value in bits.| |[bytelength](#bytelength)|The length of value in bytes.| |[char](#char)|Return the character by interpreting the value as ASCII code.| |[concat](#concat)|The string resulting from concatenating the referenced item values or constant values.| |[insert](#insert)|Insert specified characters or spaces into the character string beginning at the specified position in the string.| |[jsonpath](#jsonpath)|Return the JSONPath result.| |[left](#left)|Return the leftmost characters of the value.| |[length](#length)|The length of value in characters.| |[ltrim](#ltrim)|Remove specified characters from the beginning of string.| |[mid](#mid)|Return a substring of N characters beginning at the character position specified by 'start'.| |[repeat](#repeat)|Repeat a string.| |[replace](#replace)|Find the pattern in the value and replace with replacement.| |[right](#right)|Return the rightmost characters of the value.| |[rtrim](#rtrim)|Remove specified characters from the end of string.| |[trim](#trim)|Remove specified characters from the beginning and end of string.| |[xmlxpath](#xmlxpath)|Return the XML XPath result.| # 9 Virkņu funkcijas Visas šeit uzskaitītās funkcijas tiek atbalstītas šādos gadījumos: - [Trigeru izteiksmes](/manual/config/triggers/expression) - [Aprēķinātie vienumi](/manual/config/items/itemtypes/calculated) - [Izteiksmju makrosi](/manual/config/macros/expression_macros) Funkcijas ir uzskaitītas bez papildu informācijas. Noklikšķiniet uz funkcijas, lai skatītu pilnu informāciju. |Function|Description| |--|--------| |[ascii](#ascii)|ASCII kods vērtības kreisākajam simbolam.| |[bitlength](#bitlength)|Vērtības garums bitos.| |[bytelength](#bytelength)|Vērtības garums baitos.| |[char](#char)|Atgriež simbolu, interpretējot vērtību kā ASCII kodu.| |[concat](#concat)|Virkne, kas iegūta, savienojot norādīto vienumu vērtības vai konstantes vērtības.| |[insert](#insert)|Ievieto norādītos simbolus vai atstarpes rakstzīmju virknē, sākot no norādītās pozīcijas virknē.| |[jsonpath](#jsonpath)|Atgriež JSONPath rezultātu.| |[left](#left)|Atgriež vērtības kreisākos simbolus.| |[length](#length)|Vērtības garums simbolos.| |[ltrim](#ltrim)|Noņem norādītos simbolus no virknes sākuma.| |[mid](#mid)|Atgriež N simbolu apakšvirkni, sākot no rakstzīmes pozīcijas, kas norādīta ar 'start'.| |[repeat](#repeat)|Atkārto virkni.| |[replace](#replace)|Atrod vērtībā norādīto rakstu un aizstāj to ar aizstājošo tekstu.| |[right](#right)|Atgriež vērtības labākos simbolus.| |[rtrim](#rtrim)|Noņem norādītos simbolus no virknes beigām.| |[trim](#trim)|Noņem norādītos simbolus no virknes sākuma un beigām.| |[xmlxpath](#xmlxpath)|Atgriež XML XPath rezultātu.| # 9 Templates out of the box # 9 Gatavas veidnes # 9 Web monitoring # 9 Tīmekļa uzraudzība # 9 Web service # 9 Tīmekļa pakalpojums # 9 What's new in Zabbix 7.0.4 See [breaking changes](/manual/installation/upgrade_notes_704#breaking-changes) for this version. # 9 Kas jauns Zabbix 7.0.4 Skatiet [pārtraucošās izmaiņas](/manual/installation/upgrade_notes_704#breaking-changes) šajā versijā. # 9 Zabbix web service # 9 Zabbix web service #### Absence of data For items with a regular update interval, nothing is displayed in the graph if item data are not collected. However, for trapper items and items with a scheduled update interval (and regular update interval set to 0), a straight line is drawn leading up to the first collected value and from the last collected value to the end of graph; the line is on the level of the first/last value respectively. #### Datu trūkums Vienumiem ar regulāru atjaunināšanas intervālu grafikā nekas netiek attēlots, ja vienuma dati netiek savākti. Tomēr trapper vienumiem un vienumiem ar plānoto atjaunināšanas intervālu (un regulāro atjaunināšanas intervālu, kas iestatīts uz 0) tiek uzzīmēta taisna līnija līdz pirmajai savāktajai vērtībai un no pēdējās savāktās vērtības līdz grafika beigām; līnija attiecīgi atrodas pirmās/pēdējās vērtības līmenī. ##### abs(value) {#abs} The absolute value (from 0) of a value. Parameter: - **value** - the value to check For example, the absolute value of either '3' or '-3' will be '3'. Example: abs(last(/host/key))>10 ##### abs(value) {#abs} Vērtības absolūtā vērtība (no 0). Parametrs: - **value** - pārbaudāmā vērtība Piemēram, gan '3', gan '-3' absolūtā vērtība būs '3'. Piemērs: abs(last(/host/key))>10 ## Access filters tab The *Access filters* tab lets you restrict access to your Zabbix node by IP address or subnet. {width="600"} To configure an access filter, complete the following fields: - *Type* - use the dropdown to choose which Zabbix component to limit: frontend/API only, server only, or both. - *IP address or CIDR* - enter the IP address or CIDR manually, or complete the field automatically by selecting the relevant option. - *Optional IP address or CIDR description* - add an optional description for each IP or subnet. After completing the fields, click *Add filter*. Added filters appear in the table below, showing status, type, IP address or subnet, and description. ::: notewarning During node initialization, an access filter is automatically created for the IP address you used. If you later connect from a different IP or network, you must add that address here or you will be blocked. ::: You can: - {width="30"} - edit a filter. - {width="30"} - delete a filter or multiple filters using the checkboxes. ## Piekļuves filtru cilne Cilne *Piekļuves filtri* ļauj ierobežot piekļuvi jūsu Zabbix mezglam pēc IP adreses vai apakštīkla. {width="600"} Lai konfigurētu piekļuves filtru, aizpildiet šādus laukus: - *Tips* — izmantojiet nolaižamo sarakstu, lai izvēlētos, kuru Zabbix komponentu ierobežot: tikai lietotāja saskarne/API, tikai serveris vai abus. - *IP adrese vai CIDR* — ievadiet IP adresi vai CIDR manuāli vai aizpildiet lauku automātiski, atlasot atbilstošo opciju. - *Neobligāts IP adreses vai CIDR apraksts* — pievienojiet neobligātu aprakstu katrai IP adresei vai apakštīklam. Pēc lauku aizpildīšanas noklikšķiniet uz *Pievienot filtru*. Pievienotie filtri tiek parādīti zemāk esošajā tabulā, norādot statusu, tipu, IP adresi vai apakštīklu un aprakstu. ::: notewarning Mezgla inicializācijas laikā piekļuves filtrs tiek automātiski izveidots tai IP adresei, kuru izmantojāt. Ja vēlāk pieslēgsieties no citas IP adreses vai tīkla, šī adrese šeit ir jāpievieno, pretējā gadījumā piekļuve tiks bloķēta. ::: Jūs varat: - {width="30"} — rediģēt filtru. - {width="30"} — dzēst filtru vai vairākus filtrus, izmantojot izvēles rūtiņas. #### Access from several user groups A user may belong to any number of user groups. These groups may have different access permissions to hosts or templates. Therefore, it is important to know what entities an unprivileged user will be able to access as a result. For example, let us consider how access to host **X** (in Hostgroup 1) will be affected in various situations for a user who is in user groups A and B. - If Group A has only *Read* access to Hostgroup 1, but Group B *Read-write* access to Hostgroup 1, the user will get **Read-write** access to 'X'. ::: noteimportant "Read-write" permissions have precedence over "Read" permissions. ::: - In the same scenario as above, if 'X' is simultaneously also in Hostgroup 2 that is **denied** to Group A or B, access to 'X' will be **unavailable**, despite a *Read-write* access to Hostgroup 1. - If Group A has no permissions defined and Group B has a *Read-write* access to Hostgroup 1, the user will get **Read-write** access to 'X'. - If Group A has *Deny* access to Hostgroup 1 and Group B has a *Read-write* access to Hostgroup 1, the user will get access to 'X' **denied**. #### Piekļuve no vairākām lietotāju grupām Lietotājs var piederēt jebkuram lietotāju grupu skaitam. Šīm grupām var būt atšķirīgas piekļuves atļaujas hosts vai veidnēm. Tāpēc ir svarīgi zināt, kādiem objektiem nepilnvarots lietotājs rezultātā varēs piekļūt. Piemēram, aplūkosim, kā piekļuve hosts **X** (Hostgroup 1) tiks ietekmēta dažādās situācijās lietotājam, kurš ir lietotāju grupās A un B. - Ja Group A ir tikai *Read* piekļuve Hostgroup 1, bet Group B ir *Read-write* piekļuve Hostgroup 1, lietotājs iegūs **Read-write** piekļuvi 'X'. ::: noteimportant "Read-write" atļaujām ir prioritāte pār "Read" atļaujām. ::: - Tajā pašā iepriekš aprakstītajā scenārijā, ja 'X' vienlaikus ir arī Hostgroup 2, kas ir **liegta** Group A vai B, piekļuve 'X' būs **nav pieejama**, neskatoties uz *Read-write* piekļuvi Hostgroup 1. - Ja Group A nav definētas nekādas atļaujas un Group B ir *Read-write* piekļuve Hostgroup 1, lietotājs iegūs **Read-write** piekļuvi 'X'. - Ja Group A ir *Deny* piekļuve Hostgroup 1 un Group B ir *Read-write* piekļuve Hostgroup 1, lietotājam piekļuve 'X' tiks **liegta**. #### Access Host dashboards can be accessed: - after searching for a host name in [global search](/manual/web_interface/global_search) (click the *Dashboards* link provided in the search results); - after clicking a host name in *Inventory → [Hosts](/manual/web_interface/frontend_sections/inventory/hosts)* (click the *Dashboards* link provided in the host overview); - from the [host menu](/manual/web_interface/menu/host_menu) by clicking *Dashboards*.  Note that host dashboards *cannot* be directly accessed in the *[Dashboards](/manual/web_interface/frontend_sections/dashboards)* section, which is reserved for global dashboards. #### Piekļuve Hostu paneļiem var piekļūt: - pēc hosta nosaukuma meklēšanas [globālajā meklēšanā](/manual/web_interface/global_search) (meklēšanas rezultātos noklikšķiniet uz saites *Dashboards*); - pēc noklikšķināšanas uz hosta nosaukuma sadaļā *Inventārs → [Hosti](/manual/web_interface/frontend_sections/inventory/hosts)* (hosta pārskatā noklikšķiniet uz saites *Dashboards*); - no [hosta izvēlnes](/manual/web_interface/menu/host_menu), noklikšķinot uz *Dashboards*.  Ņemiet vērā, ka hostu paneļiem *nevar* piekļūt tieši sadaļā *[Dashboards](/manual/web_interface/frontend_sections/dashboards)*, jo tā ir paredzēta globālajiem paneļiem. #### Access permissions Make sure that the 'zabbix' user has execute permissions for configured commands. One may be interested in using **sudo** to give access to privileged commands. To configure access, execute as root: visudo Example lines that could be used in *sudoers* file: # allows 'zabbix' user to run all commands without password. zabbix ALL=NOPASSWD: ALL # allows 'zabbix' user to restart apache without password. zabbix ALL=NOPASSWD: /etc/init.d/apache restart ::: notetip On some systems *sudoers* file will prevent non-local users from executing commands. To change this, comment out **requiretty** option in */etc/sudoers*. ::: #### Piekļuves atļaujas Pārliecinieties, ka lietotājam 'zabbix' ir izpildes atļaujas konfigurētajām komandām. Var būt lietderīgi izmantot **sudo**, lai piešķirtu piekļuvi priviliģētām komandām. Lai konfigurētu piekļuvi, izpildiet kā root: visudo Piemēra rindas, ko varētu izmantot *sudoers* failā: # ļauj lietotājam 'zabbix' palaist visas komandas bez paroles. zabbix ALL=NOPASSWD: ALL # ļauj lietotājam 'zabbix' pārstartēt apache bez paroles. zabbix ALL=NOPASSWD: /etc/init.d/apache restart ::: notetip Dažās sistēmās *sudoers* fails neļaus nelokāliem lietotājiem izpildīt komandas. Lai to mainītu, izkomentējiet opciju **requiretty** failā */etc/sudoers*. ::: #### Access to hosts Access to any host and template data in Zabbix is granted to [user groups](/manual/config/users_and_usergroups/usergroup) on the host/template group level only. That means that an individual user cannot be directly granted access to a host (or host group). It can only be granted access to a host by being part of a user group that is granted access to the host group that contains the host. Similarly, a user can only be granted access to a template by being part of a user group that is granted access to the template group that contains the template. #### Piekļuve hostiem Piekļuve jebkura hosta un veidnes datiem Zabbix sistēmā tiek piešķirta [lietotāju grupām](/manual/config/users_and_usergroups/usergroup) tikai hostu/veidņu grupu līmenī. Tas nozīmē, ka atsevišķam lietotājam nevar tieši piešķirt piekļuvi hostam (vai hostu grupai). Piekļuvi hostam var piešķirt tikai tad, ja lietotājs ir daļa no lietotāju grupas, kurai ir piešķirta piekļuve hostu grupai, kurā atrodas šis hosts. Līdzīgi lietotājam piekļuvi veidnei var piešķirt tikai tad, ja viņš ir daļa no lietotāju grupas, kurai ir piešķirta piekļuve veidņu grupai, kurā atrodas šī veidne. #### Access to UI elements with MariaDB 10.5.1-10.5.9 Accessing the Zabbix web frontend with a role other than Super Admin may result in the message: "System error occurred. Please contact Zabbix administrator.". This issue affects installations using [MariaDB versions](/manual/installation/requirements#third-party-external-surrounding-software) 10.5.1 through 10.5.9. To avoid this issue, update MariaDB to a version later than 10.5.9. For more details, see [ZBX-25746](https://support.zabbix.com/browse/ZBX-25746). #### Piekļuve UI elementiem ar MariaDB 10.5.1-10.5.9 Piekļūstot Zabbix lietotāja saskarnei ar lomu, kas nav Super Admin, var tikt parādīts ziņojums: "System error occurred. Please contact Zabbix administrator.". Šī problēma ietekmē instalācijas, kurās tiek izmantotas [MariaDB versijas](/manual/installation/requirements#third-party-external-surrounding-software) no 10.5.1 līdz 10.5.9. Lai izvairītos no šīs problēmas, atjauniniet MariaDB uz versiju, kas ir jaunāka par 10.5.9. Plašāku informāciju skatiet [ZBX-25746](https://support.zabbix.com/browse/ZBX-25746). #### Accidental installation of EPEL Zabbix packages If the EPEL repository is installed and enabled, installing Zabbix packages may pull EPEL versions instead of the official Zabbix packages. To resolve this: 1\. Remove any Zabbix packages installed from EPEL: ```bash dnf remove zabbix-server-mysql ``` 2\. Exclude Zabbix packages from EPEL by adding the following line to `/etc/yum.repos.d/epel.repo` file: ```ini [epel] ... excludepkgs=zabbix* ``` 3\. Reinstall the official Zabbix server package: ```bash dnf install zabbix-server-mysql ``` During installation, official Zabbix packages include the word `release` in their version string (e.g., `7.0.0-release1.el8`), distinguishing them from EPEL packages. #### Nejauša EPEL Zabbix pakotņu instalēšana Ja EPEL repozitorijs ir instalēts un iespējots, instalējot Zabbix pakotnes, oficiālo Zabbix pakotņu vietā var tikt instalētas EPEL versijas. Lai to novērstu: 1\. Noņemiet visas no EPEL instalētās Zabbix pakotnes: ```bash dnf remove zabbix-server-mysql ``` 2\. Izslēdziet Zabbix pakotnes no EPEL, pievienojot šādu rindu failam `/etc/yum.repos.d/epel.repo`: ```ini [epel] ... excludepkgs=zabbix* ``` 3.\ Atkārtoti instalējiet oficiālo Zabbix serveris pakotni: ```bash dnf install zabbix-server-mysql ``` Instalēšanas laikā oficiālo Zabbix pakotņu versijas virknē ir iekļauts vārds `release` (piemēram, `7.0.0-release1.el8`), kas tās atšķir no EPEL pakotnēm. #### Acknowledge and suppress an event Acknowledge one or more events, add a message, and suppress them in the same request. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "event.acknowledge", "params": { "eventids": [ "20427", "20428" ], "action": 38, "message": "Suppressing during planned maintenance.", "suppress_until": 0 }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "eventids": [ 20427, 20428 ] }, "id": 1 } ``` #### Apstiprināt un slāpēt notikumu Apstipriniet vienu vai vairākus notikumus, pievienojiet ziņojumu un slāpējiet tos vienā pieprasījumā. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "event.acknowledge", "params": { "eventids": [ "20427", "20428" ], "action": 38, "message": "Slāpēšana plānotas apkopes laikā.", "suppress_until": 0 }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "eventids": [ 20427, 20428 ] }, "id": 1 } ``` #### Acknowledging an event Acknowledge a single event and leave a message. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "event.acknowledge", "params": { "eventids": "20427", "action": 6, "message": "Problem resolved." }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "eventids": [ "20427" ] }, "id": 1 } ``` #### Notikuma apstiprināšana Apstipriniet vienu notikumu un atstājiet ziņojumu. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "event.acknowledge", "params": { "eventids": "20427", "action": 6, "message": "Problem resolved." }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "eventids": [ "20427" ] }, "id": 1 } ``` ##### acos(value) {#acos} The arccosine of a value as an angle, expressed in radians. Parameter: - **value** - the value to check The value must be between -1 and 1. For example, the arccosine of a value '0.5' will be '2.0943951'. Example: acos(last(/host/key)) ##### acos(value) {#acos} Vērtības arkuskosinuss kā leņķis, izteikts radiānos. Parametrs: - **value** - pārbaudāmā vērtība Vērtībai jābūt no -1 līdz 1. Piemēram, vērtības '0.5' arkuskosinuss būs '2.0943951'. Piemērs: acos(last(/host/key)) # action.create # action.create # action.delete # action.delete #### Action filter condition The action filter condition object defines a specific condition that must be checked before running the action operations. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |conditiontype|integer|Type of condition.<br><br>Possible values if `eventsource` of [Action object](#action) is set to "event created by a trigger":<br>0 - host group;<br>1 - host;<br>2 - trigger;<br>3 - event name;<br>4 - trigger severity;<br>6 - time period;<br>13 - host template;<br>16 - problem is suppressed;<br>25 - event tag;<br>26 - event tag value.<br><br>Possible values if `eventsource` of [Action object](#action) is set to "event created by a discovery rule":<br>7 - host IP;<br>8 - discovered service type;<br>9 - discovered service port;<br>10 - discovery status;<br>11 - uptime or downtime duration;<br>12 - received value;<br>18 - discovery rule;<br>19 - discovery check;<br>20 - proxy;<br>21 - discovery object.<br><br>Possible values if `eventsource` of [Action object](#action) is set to "event created by active agent autoregistration":<br>20 - proxy;<br>22 - host name;<br>24 - host metadata.<br><br>Possible values if `eventsource` of [Action object](#action) is set to "internal event":<br>0 - host group;<br>1 - host;<br>13 - host template;<br>23 - event type;<br>25 - event tag;<br>26 - event tag value.<br><br>Possible values if `eventsource` of [Action object](#action) is set to "event created on service status update":<br>25 - event tag;<br>26 - event tag value;<br>27 - service;<br>28 - service name.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |value|string|Value to compare with.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |value2|string|Secondary value to compare with.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `eventsource` of [Action object](#action) is set to "event created by a trigger", `conditiontype` is set to any possible value for trigger actions, and the type of condition (see below) is "26"<br>- *required* if `eventsource` of [Action object](#action) is set to "internal event", `conditiontype` is set to any possible value for internal actions, and the type of condition (see below) is "26"<br>- *required* if `eventsource` of [Action object](#action) is set to "event created on service status update", `conditiontype` is set to any possible value for service actions, and the type of condition (see below) is "26"| |formulaid|string|Arbitrary unique ID that is used to reference the condition from a custom expression. Can only contain capital-case letters. The ID must be defined by the user when modifying filter conditions, but will be generated anew when requesting them afterward.| |operator|integer|Condition [operator](/manual/config/notifications/action/conditions).<br><br>Possible values:<br>0 - *(default)* equals;<br>1 - does not equal;<br>2 - contains;<br>3 - does not contain;<br>4 - in;<br>5 - is greater than or equals;<br>6 - is less than or equals;<br>7 - not in;<br>8 - matches;<br>9 - does not match;<br>10 - Yes;<br>11 - No.| ::: notetip To better understand how to use filters with various types of expressions, see examples on the [action.get](get#retrieve-discovery-actions) and [action.create](create#using-a-custom-expression-filter) method pages. ::: The following operators and values are supported for each condition type. |Condition|Condition name|Supported operators|Expected value| |-|--|--|------| |0|Host group|equals,<br>does not equal|Host group ID.| |1|Host|equals,<br>does not equal|Host ID.| |2|Trigger|equals,<br>does not equal|Trigger ID.| |3|Event name|contains,<br>does not contain|Event name.| |4|Trigger severity|equals,<br>does not equal,<br>is greater than or equals,<br>is less than or equals|Trigger severity. Refer to the [trigger `severity` property](/manual/api/reference/trigger/object#trigger) for a list of supported trigger severities.| |5|Trigger value|equals|Trigger value. Refer to the [trigger `value` property](/manual/api/reference/trigger/object#trigger) for a list of supported trigger values.| |6|Time period|in, not in|Time when the event was triggered as a [time period](/manual/appendix/time_period).| |7|Host IP|equals,<br>does not equal|One or several IP ranges to check, separated by commas. Refer to the [network discovery configuration](/manual/discovery/network_discovery/rule) section for more information on supported formats of IP ranges.| |8|Discovered service type|equals,<br>does not equal|Type of discovered service. The type of service matches the type of the discovery check used to detect the service. Refer to the [discovery check `type` property](/manual/api/reference/dcheck/object#discovery-check) for a list of supported types.| |9|Discovered service port|equals,<br>does not equal|One or several port ranges, separated by commas.| |10|Discovery status|equals|Status of a discovered object.<br><br>Possible values:<br>0 - host or service up;<br>1 - host or service down;<br>2 - host or service discovered;<br>3 - host or service lost.| |11|Uptime or downtime duration|is greater than or equals,<br>is less than or equals|Time indicating how long has the discovered object been in the current status in seconds.| |12|Received values|equals,<br>does not equal,<br>is greater than or equals,<br>is less than or equals,<br>contains,<br>does not contain|Value returned when performing a Zabbix agent, SNMPv1, SNMPv2 or SNMPv3 discovery check.| |13|Host template|equals,<br>does not equal|Linked template ID.| |16|Problem is suppressed|Yes, No|No value required: using the "Yes" operator means that problem must be suppressed, "No" - not suppressed.| |18|Discovery rule|equals,<br>does not equal|ID of the discovery rule.| |19|Discovery check|equals,<br>does not equal|ID of the discovery check.| |20|Proxy|equals,<br>does not equal|ID of the proxy.| |21|Discovery object|equals|Type of object that triggered the discovery event.<br><br>Possible values:<br>1 - discovered host;<br>2 - discovered service.| |22|Host name|contains,<br>does not contain,<br>matches,<br>does not match|Host name.<br>Using a regular expression is supported for operators *matches* and *does not match* in autoregistration conditions.| |23|Event type|equals|Specific internal event.<br><br>Possible values:<br>0 - item in "not supported" state;<br>1 - item in "normal" state;<br>2 - LLD rule in "not supported" state;<br>3 - LLD rule in "normal" state;<br>4 - trigger in "unknown" state;<br>5 - trigger in "normal" state.| |24|Host metadata|contains,<br>does not contain,<br>matches,<br>does not match|Metadata of the auto-registered host.<br>Using a regular expression is supported for operators *matches* and *does not match*.| |25|Tag|equals,<br>does not equal,<br>contains,<br>does not contain|Event tag.| |26|Tag value|equals,<br>does not equal,<br>contains,<br>does not contain|Event tag value.| |27|Service|equals,<br>does not equal|Service ID.| |28|Service name|equals,<br>does not equal|Service name.| #### Darbības filtra nosacījums Darbības filtra nosacījuma objekts definē konkrētu nosacījumu, kas jāpārbauda pirms darbības operāciju izpildes. |Īpašība|[Type](/manual/api/reference_commentary#data-types)|Apraksts| |--|--|------| |conditiontype|integer|Nosacījuma tips.<br><br>Iespējamās vērtības, ja [Darbības objekta](#action) `eventsource` ir iestatīts uz "notikums, ko izveidojis trigeris":<br>0 - hostu grupa;<br>1 - hosts;<br>2 - trigeris;<br>3 - notikuma nosaukums;<br>4 - trigera nopietnība;<br>6 - laika periods;<br>13 - hosta veidne;<br>16 - problēma ir apspiesta;<br>25 - notikuma tags;<br>26 - notikuma taga vērtība.<br><br>Iespējamās vērtības, ja [Darbības objekta](#action) `eventsource` ir iestatīts uz "notikums, ko izveidojis atklāšanas noteikums":<br>7 - hosta IP;<br>8 - atklātā servisa tips;<br>9 - atklātā servisa ports;<br>10 - atklāšanas statuss;<br>11 - darbības vai dīkstāves ilgums;<br>12 - saņemtā vērtība;<br>18 - atklāšanas noteikums;<br>19 - atklāšanas pārbaude;<br>20 - starpniekserveris;<br>21 - atklāšanas objekts.<br><br>Iespējamās vērtības, ja [Darbības objekta](#action) `eventsource` ir iestatīts uz "notikums, ko izveidojusi aktīva aģenta automātiskā reģistrācija":<br>20 - starpniekserveris;<br>22 - hosta nosaukums;<br>24 - hosta metadati.<br><br>Iespējamās vērtības, ja [Darbības objekta](#action) `eventsource` ir iestatīts uz "iekšējais notikums":<br>0 - hostu grupa;<br>1 - hosts;<br>13 - hosta veidne;<br>23 - notikuma tips;<br>25 - notikuma tags;<br>26 - notikuma taga vērtība.<br><br>Iespējamās vērtības, ja [Darbības objekta](#action) `eventsource` ir iestatīts uz "notikums, kas izveidots servisa statusa atjaunināšanas laikā":<br>25 - notikuma tags;<br>26 - notikuma taga vērtība;<br>27 - serviss;<br>28 - servisa nosaukums.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāts*| |value|string|Vērtība, ar ko salīdzināt.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāts*| |value2|string|Sekundārā vērtība, ar ko salīdzināt.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāts*, ja [Darbības objekta](#action) `eventsource` ir iestatīts uz "notikums, ko izveidojis trigeris", `conditiontype` ir iestatīts uz jebkuru iespējamo vērtību trigeru darbībām un nosacījuma tips (skatīt zemāk) ir "26"<br>- *obligāts*, ja [Darbības objekta](#action) `eventsource` ir iestatīts uz "iekšējais notikums", `conditiontype` ir iestatīts uz jebkuru iespējamo vērtību iekšējām darbībām un nosacījuma tips (skatīt zemāk) ir "26"<br>- *obligāts*, ja [Darbības objekta](#action) `eventsource` ir iestatīts uz "notikums, kas izveidots servisa statusa atjaunināšanas laikā", `conditiontype` ir iestatīts uz jebkuru iespējamo vērtību servisu darbībām un nosacījuma tips (skatīt zemāk) ir "26"| |formulaid|string|Patvaļīgs unikāls ID, ko izmanto, lai atsauktos uz nosacījumu no pielāgotas izteiksmes. Var saturēt tikai lielos burtus. Lietotājam šis ID jādefinē, modificējot filtra nosacījumus, taču pēc tam, kad tie tiek pieprasīti atkārtoti, tas tiks ģenerēts no jauna.| |operator|integer|Nosacījuma [operators](/manual/config/notifications/action/conditions).<br><br>Iespējamās vērtības:<br>0 - *(noklusējums)* vienāds ar;<br>1 - nav vienāds ar;<br>2 - satur;<br>3 - nesatur;<br>4 - ir iekš;<br>5 - ir lielāks vai vienāds ar;<br>6 - ir mazāks vai vienāds ar;<br>7 - nav iekš;<br>8 - atbilst;<br>9 - neatbilst;<br>10 - Jā;<br>11 - Nē.| ::: notetip Lai labāk saprastu, kā izmantot filtrus ar dažādiem izteiksmju tipiem, skatiet piemērus metožu [action.get](get#retrieve-discovery-actions) un [action.create](create#using-a-custom-expression-filter) lapās. ::: Tālāk norādīti operatori un vērtības, kas tiek atbalstīti katram nosacījuma tipam. |Nosacījums|Nosacījuma nosaukums|Atbalstītie operatori|Sagaidāmā vērtība| |-|--|--|------| |0|Hostu grupa|vienāds ar,<br>nav vienāds ar|Hostu grupas ID.| |1|Hosts|vienāds ar,<br>nav vienāds ar|Hosta ID.| |2|Trigeris|vienāds ar,<br>nav vienāds ar|Trigera ID.| |3|Notikuma nosaukums|satur,<br>nesatur|Notikuma nosaukums.| |4|Trigera nopietnība|vienāds ar,<br>nav vienāds ar,<br>ir lielāks vai vienāds ar,<br>ir mazāks vai vienāds ar|Trigera nopietnība. Atbalstīto trigera nopietnības vērtību sarakstu skatiet [trigera `severity` īpašībā](/manual/api/reference/trigger/object#trigger).| |5|Trigera vērtība|vienāds ar|Trigera vērtība. Atbalstīto trigera vērtību sarakstu skatiet [trigera `value` īpašībā](/manual/api/reference/trigger/object#trigger).| |6|Laika periods|ir iekš, nav iekš|Laiks, kad notikums tika aktivizēts, kā [laika periods](/manual/appendix/time_period).| |7|Hosta IP|vienāds ar,<br>nav vienāds ar|Viens vai vairāki pārbaudāmi IP diapazoni, atdalīti ar komatiem. Plašāku informāciju par atbalstītajiem IP diapazonu formātiem skatiet sadaļā [tīkla atklāšanas konfigurācija](/manual/discovery/network_discovery/rule).| |8|Atklātā servisa tips|vienāds ar,<br>nav vienāds ar|Atklātā servisa tips. Servisa tips atbilst atklāšanas pārbaudes tipam, kas izmantots servisa noteikšanai. Atbalstīto tipu sarakstu skatiet [atklāšanas pārbaudes `type` īpašībā](/manual/api/reference/dcheck/object#discovery-check).| |9|Atklātā servisa ports|vienāds ar,<br>nav vienāds ar|Viens vai vairāki portu diapazoni, atdalīti ar komatiem.| |10|Atklāšanas statuss|vienāds ar|Atklātā objekta statuss.<br><br>Iespējamās vērtības:<br>0 - hosts vai serviss darbojas;<br>1 - hosts vai serviss nedarbojas;<br>2 - hosts vai serviss atklāts;<br>3 - hosts vai serviss zaudēts.| |11|Darbības vai dīkstāves ilgums|ir lielāks vai vienāds ar,<br>ir mazāks vai vienāds ar|Laiks sekundēs, kas norāda, cik ilgi atklātais objekts ir bijis pašreizējā statusā.| |12|Saņemtās vērtības|vienāds ar,<br>nav vienāds ar,<br>ir lielāks vai vienāds ar,<br>ir mazāks vai vienāds ar,<br>satur,<br>nesatur|Vērtība, kas atgriezta, izpildot Zabbix aģenta, SNMPv1, SNMPv2 vai SNMPv3 atklāšanas pārbaudi.| |13|Hosta veidne|vienāds ar,<br>nav vienāds ar|Piesaistītās veidnes ID.| |16|Problēma ir apspiesta|Jā, Nē|Vērtība nav nepieciešama: operatora "Jā" izmantošana nozīmē, ka problēmai jābūt apspiestai, "Nē" - neapspiestai.| |18|Atklāšanas noteikums|vienāds ar,<br>nav vienāds ar|Atklāšanas noteikuma ID.| |19|Atklāšanas pārbaude|vienāds ar,<br>nav vienāds ar|Atklāšanas pārbaudes ID.| |20|Starpniekserveris|vienāds ar,<br>nav vienāds ar|Starpniekservera ID.| |21|Atklāšanas objekts|vienāds ar|Objekta tips, kas izraisīja atklāšanas notikumu.<br><br>Iespējamās vērtības:<br>1 - atklāts hosts;<br>2 - atklāts serviss.| |22|Hosta nosaukums|satur,<br>nesatur,<br>atbilst,<br>neatbilst|Hosta nosaukums.<br>Operatoriem *atbilst* un *neatbilst* automātiskās reģistrācijas nosacījumos tiek atbalstīta regulārās izteiksmes izmantošana.| |23|Notikuma tips|vienāds ar|Konkrēts iekšējais notikums.<br><br>Iespējamās vērtības:<br>0 - vienums stāvoklī "nav atbalstīts";<br>1 - vienums stāvoklī "normāls";<br>2 - LLD noteikums stāvoklī "nav atbalstīts";<br>3 - LLD noteikums stāvoklī "normāls";<br>4 - trigeris stāvoklī "nezināms";<br>5 - trigeris stāvoklī "normāls".| |24|Hosta metadati|satur,<br>nesatur,<br>atbilst,<br>neatbilst|Automātiski reģistrētā hosta metadati.<br>Operatoriem *atbilst* un *neatbilst* tiek atbalstīta regulārās izteiksmes izmantošana.| |25|Tags|vienāds ar,<br>nav vienāds ar,<br>satur,<br>nesatur|Notikuma tags.| |26|Taga vērtība|vienāds ar,<br>nav vienāds ar,<br>satur,<br>nesatur|Notikuma taga vērtība.| |27|Serviss|vienāds ar,<br>nav vienāds ar|Servisa ID.| |28|Servisa nosaukums|vienāds ar,<br>nav vienāds ar|Servisa nosaukums.| ### Action filter The action filter object defines a set of conditions that must be met to perform the configured action operations. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |conditions|array|Set of [filter conditions](#action-filter-condition) to use for filtering results. The conditions will be sorted in the order of their placement in the formula.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |evaltype|integer|Filter condition [evaluation method](/manual/config/notifications/action/conditions#type-of-calculation).<br><br>Possible values:<br>0 - And/Or;<br>1 - And;<br>2 - Or;<br>3 - Custom expression.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |eval\_formula|string|Generated expression that will be used for evaluating filter conditions. The expression contains IDs that reference specific filter conditions by its `formulaid`. The value of `eval_formula` is equal to the value of `formula` for filters with a custom expression.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |formula|string|User-defined expression to be used for evaluating conditions of filters with a custom expression. The expression must contain IDs that reference specific filter conditions by its `formulaid`. The IDs used in the expression must exactly match the ones defined in the filter conditions: no condition can remain unused or omitted.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `evaltype` is set to "custom expression"| ### Darbības filtrs Darbības filtra objekts definē nosacījumu kopu, kam jābūt izpildītai, lai veiktu konfigurētās darbības operācijas. Tam ir šādas īpašības. |Īpašība|[Tips](/manual/api/reference_commentary#data-types)|Apraksts| |--|--|------| |conditions|array|[Filtra nosacījumu](#action-filter-condition) kopa, ko izmantot rezultātu filtrēšanai. Nosacījumi tiks sakārtoti to izvietojuma secībā formulā.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāta*| |evaltype|integer|Filtra nosacījumu [novērtēšanas metode](/manual/config/notifications/action/conditions#type-of-calculation).<br><br>Iespējamās vērtības:<br>0 - Un/Vai;<br>1 - Un;<br>2 - Vai;<br>3 - Pielāgota izteiksme.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāta*| |eval\_formula|string|Ģenerēta izteiksme, kas tiks izmantota filtra nosacījumu novērtēšanai. Izteiksme satur ID, kas atsaucas uz konkrētiem filtra nosacījumiem pēc to `formulaid`. `eval_formula` vērtība ir vienāda ar `formula` vērtību filtriem ar pielāgotu izteiksmi.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *tikai lasāma*| |formula|string|Lietotāja definēta izteiksme, kas tiks izmantota filtru ar pielāgotu izteiksmi nosacījumu novērtēšanai. Izteiksmei jāsatur ID, kas atsaucas uz konkrētiem filtra nosacījumiem pēc to `formulaid`. Izteiksmē izmantotajiem ID precīzi jāsakrīt ar tiem, kas definēti filtra nosacījumos: neviens nosacījums nedrīkst palikt neizmantots vai izlaists.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāta*, ja `evaltype` ir iestatīts uz "pielāgota izteiksme"| ##### Action for active agent autoregistration When server receives an autoregistration request from an agent it calls an [action](/manual/config/notifications/action). An action of event source "Autoregistration" must be configured for agent autoregistration. ::: noteclassic Setting up [network discovery](network_discovery) is not required to have active agents autoregister. ::: In the Zabbix frontend, go to *Alerts → Actions*, select *Autoregistration actions* and click on *Create action*: - In the Action tab, give your action a name - Optionally specify [conditions](/manual/config/notifications/action/conditions#autoregistration-actions). You can do a substring match or regular expression match in the conditions for host name/host metadata. If you are going to use the "Host metadata" condition, see the next section. - In the Operations tab, add relevant operations, such as - 'Add host', 'Add to host group' (for example, *Discovered hosts*), 'Link templates', etc. ::: notetip If the hosts that will be autoregistering are likely to be supported for active monitoring only (such as hosts that are firewalled from your Zabbix server) then you might want to create a specific template like *Template\_Linux-active* to link to. ::: Created hosts are added to the *Discovered hosts* group (by default, configurable in *Administration* > *General* > *[Other](/manual/web_interface/frontend_sections/administration/general#other-parameters)*). If you wish hosts to be added to another group, add a *Remove from host group* operation (specifying "Discovered hosts") and also add an *Add to host group* operation (specifying another host group), because a host must belong to a host group. ##### Darbība aktīvā aģenta automātiskai reģistrācijai Kad serveris saņem automātiskās reģistrācijas pieprasījumu no aģenta, tas izsauc [darbību](/manual/config/notifications/action). Aģenta automātiskajai reģistrācijai ir jākonfigurē darbība ar notikuma avotu "Autoregistration". ::: noteclassic Lai aktīvie aģenti varētu automātiski reģistrēties, nav nepieciešams iestatīt [tīkla atklāšanu](network_discovery). ::: Zabbix lietotāja saskarnē dodieties uz *Alerts → Actions*, atlasiet *Autoregistration actions* un noklikšķiniet uz *Create action*: - Cilnē Action piešķiriet savai darbībai nosaukumu - Pēc izvēles norādiet [nosacījumus](/manual/config/notifications/action/conditions#autoregistration-actions). Nosacījumos host nosaukumam/host metadatiem varat izmantot apakšvirknes atbilstību vai regulārās izteiksmes atbilstību. Ja plānojat izmantot nosacījumu "Host metadata", skatiet nākamo sadaļu. - Cilnē Operations pievienojiet atbilstošas darbības, piemēram, 'Add host', 'Add to host group' (piemēram, *Discovered hosts*), 'Link templates' utt. ::: notetip Ja hosts, kas tiks automātiski reģistrēti, visticamāk, būs atbalstīti tikai aktīvai uzraudzībai (piemēram, hosts, kas no jūsu Zabbix serveris ir aiz ugunsmūra), iespējams, vēlēsities izveidot konkrētu veidni, piemēram, *Template\_Linux-active*, ko piesaistīt. ::: Izveidotie hosts tiek pievienoti grupai *Discovered hosts* (pēc noklusējuma; to var konfigurēt sadaļā *Administration* > *General* > *[Other](/manual/web_interface/frontend_sections/administration/general#other-parameters)*). Ja vēlaties, lai hosts tiktu pievienoti citai grupai, pievienojiet darbību *Remove from host group* (norādot "Discovered hosts") un arī darbību *Add to host group* (norādot citu host grupu), jo hostam ir jāpieder host grupai. # action.get # action.get # Action object The following objects are directly related to the `action` API. # Darbības objekts Tālāk norādītie objekti ir tieši saistīti ar `action` API. #### Action operation condition The action operation condition object defines a condition that must be met to perform the current operation. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |conditiontype|integer|Type of condition.<br><br>Possible values:<br>14 - event acknowledged.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |value|string|Value to compare with.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |operator|integer|Condition operator.<br><br>Possible values:<br>0 - *(default)* =| The following operators and values are supported for each operation condition type. |Condition|Condition name|Supported operators|Expected value| |---------|--------------|-------------------|--------------| |14|Event acknowledged|=|Whether the event is acknowledged.<br><br>Possible values:<br>0 - not acknowledged;<br>1 - acknowledged.| #### Darbības operācijas nosacījums Darbības operācijas nosacījuma objekts definē nosacījumu, kam jābūt izpildītam, lai veiktu pašreizējo operāciju. Tam ir šādas īpašības. |Īpašība|[Type](/manual/api/reference_commentary#data-types)|Apraksts| |--|--|------| |conditiontype|integer|Nosacījuma tips.<br><br>Iespējamās vērtības:<br>14 - notikums apstiprināts.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāts*| |value|string|Vērtība, ar ko salīdzināt.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāts*| |operator|integer|Nosacījuma operators.<br><br>Iespējamās vērtības:<br>0 - *(noklusējums)* =| Tālāk ir norādīti operatori un vērtības, kas tiek atbalstītas katram operācijas nosacījuma tipam. |Nosacījums|Nosacījuma nosaukums|Atbalstītie operatori|Sagaidāmā vērtība| |---------|--------------|-------------------|--------------| |14|Notikums apstiprināts|=|Vai notikums ir apstiprināts.<br><br>Iespējamās vērtības:<br>0 - nav apstiprināts;<br>1 - apstiprināts.| #### Action operation message The operation message object contains data about the message that will be sent by the operation. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |default\_msg|integer|Whether to use the default action message text and subject.<br><br>Possible values:<br>0 - use the data from the operation;<br>1 - *(default)* use the data from the media type.| |mediatypeid|ID|ID of the media type that will be used to send the message.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `operationtype` of [Action operation object](#action-operation), [Action recovery operation object](#action-recovery-operation), or [Action update operation object](#action-update-operation) is set to "send message", or if `operationtype` of [Action update operation object](#action-update-operation) is set to "notify all involved"| |message|string|Operation message text.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `default_msg` is set to "use the data from the operation"| |subject|string|Operation message subject.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `default_msg` is set to "use the data from the operation"| #### Darbības operācijas ziņojums Operācijas ziņojuma objekts satur datus par ziņojumu, kas tiks nosūtīts ar operāciju. Tam ir šādas īpašības. |Īpašība|[Tips](/manual/api/reference_commentary#data-types)|Apraksts| |--|--|------| |default\_msg|integer|Vai izmantot noklusējuma darbības ziņojuma tekstu un tematu.<br><br>Iespējamās vērtības:<br>0 - izmantot datus no operācijas;<br>1 - *(noklusējums)* izmantot datus no medija tipa.| |mediatypeid|ID|Ziņojuma nosūtīšanai izmantotā medija tipa ID.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *atbalstīts*, ja [Darbības operācijas objekta](#action-operation), [Darbības atkopšanas operācijas objekta](#action-recovery-operation) vai [Darbības atjaunināšanas operācijas objekta](#action-update-operation) `operationtype` ir iestatīts uz "send message", vai ja [Darbības atjaunināšanas operācijas objekta](#action-update-operation) `operationtype` ir iestatīts uz "notify all involved"| |message|string|Operācijas ziņojuma teksts.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *atbalstīts*, ja `default_msg` ir iestatīts uz "use the data from the operation"| |subject|string|Operācijas ziņojuma temats.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *atbalstīts*, ja `default_msg` ir iestatīts uz "use the data from the operation"| ### Action operation The action operation object defines an operation that will be performed when an action is executed. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |operationtype|integer|Type of operation.<br><br>Possible values:<br>0 - send message;<br>1 - global script;<br>2 - add host;<br>3 - remove host;<br>4 - add to host group;<br>5 - remove from host group;<br>6 - link template;<br>7 - unlink template;<br>8 - enable host;<br>9 - disable host;<br>10 - set host inventory mode;<br>13 - add host tags;<br>14 - remove host tags.<br><br>Possible values if `eventsource` of [Action object](#action) is set to "event created by a trigger" or "event created on service status update":<br>0 - "send message";<br>1 - "global script".<br><br>Possible values if `eventsource` of [Action object](#action) is set to "internal event":<br>0 - "send message".<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |esc\_period|string|Duration of an escalation step in seconds. Must be greater than 60 seconds. Accepts seconds, time unit with suffix, or a user macro. If set to 0 or 0s, the default action escalation period will be used.<br><br>Default: 0s.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `eventsource` of [Action object](#action) is set to "event created by a trigger", "internal event", or "event created on service status update"| |esc\_step\_from|integer|Step to start escalation from.<br><br>Default: 1.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `eventsource` of [Action object](#action) is set to "event created by a trigger", "internal event", or "event created on service status update"| |esc\_step\_to|integer|Step to end escalation at.<br><br>Default: 1.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `eventsource` of [Action object](#action) is set to "event created by a trigger", "internal event", or "event created on service status update"| |evaltype|integer|Operation condition [evaluation method](/manual/config/notifications/action/conditions#type-of-calculation).<br><br>Possible values:<br>0 - *(default)* And/Or;<br>1 - And;<br>2 - Or.| |opcommand|object|Global script to execute.<br><br>The global script must have the `scriptid` property defined.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `operationtype` is set to "global script"| |opcommand\_grp|array|Host groups to run global scripts on.<br><br>The host groups must have the `groupid` property defined.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `operationtype` is set to "global script" and `opcommand_hst` is not set| |opcommand\_hst|array|Host to run global scripts on.<br><br>The hosts must have the `hostid` property defined.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `operationtype` is set to "global script" and `opcommand_grp` is not set| |opconditions|array|Operation conditions used for trigger actions.<br><br>The operation condition object is [described in detail below](/manual/api/reference/action/object#action-operation-condition).| |opgroup|array|Host groups to add hosts to.<br><br>The host groups must have the `groupid` property defined.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `operationtype` is set to "add to host group" or "remove from host group"| |opmessage|object|Object containing the data about the message sent by the operation.<br><br>The operation message object is [described in detail below](/manual/api/reference/action/object#action-operation-message).<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `operationtype` is set to "send message"| |opmessage\_grp|array|User groups to send messages to.<br><br>The user groups must have the `usrgrpid` property defined.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `operationtype` is set to "send message" and `opmessage_usr` is not set| |opmessage\_usr|array|Users to send messages to.<br><br>The users must have the `userid` property defined.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `operationtype` is set to "send message" and `opmessage_grp` is not set| |optemplate|array|Templates to link to the hosts.<br><br>The templates must have the `templateid` property defined.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `operationtype` is set to "link template" or "unlink template"| |opinventory|object|Inventory mode set host to.<br><br>The inventory must have the `inventory_mode` property defined.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `operationtype` is set to "set host inventory mode"| |optag|array|Host tags to add or remove.<br><br>Tags must have `tag` property defined.<br>The `value` property is optional. <br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `operationtype` is set to "add host tags" or "remove host tags".| ### Darbības operācija Darbības operācijas objekts definē operāciju, kas tiks izpildīta, kad darbība tiek izpildīta. Tam ir šādas īpašības. |Īpašība|[Tips](/manual/api/reference_commentary#data-types)|Apraksts| |--|--|------| |operationtype|integer|Operācijas tips.<br><br>Iespējamās vērtības:<br>0 - sūtīt ziņojumu;<br>1 - globālais skripts;<br>2 - pievienot hostu;<br>3 - noņemt hostu;<br>4 - pievienot hostu grupai;<br>5 - noņemt no hostu grupas;<br>6 - saistīt veidni;<br>7 - atsaistīt veidni;<br>8 - iespējot hostu;<br>9 - atspējot hostu;<br>10 - iestatīt hosta inventarizācijas režīmu;<br>13 - pievienot hosta tagus;<br>14 - noņemt hosta tagus.<br><br>Iespējamās vērtības, ja [Darbības objekta](#action) `eventsource` ir iestatīts uz "event created by a trigger" vai "event created on service status update":<br>0 - "send message";<br>1 - "global script".<br><br>Iespējamās vērtības, ja [Darbības objekta](#action) `eventsource` ir iestatīts uz "internal event":<br>0 - "send message".<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *required*| |esc\_period|string|Eskalācijas soļa ilgums sekundēs. Tam jābūt lielākam par 60 sekundēm. Pieņem sekundes, laika vienību ar sufiksu vai lietotāja makrosu. Ja iestatīts uz 0 vai 0s, tiks izmantots noklusējuma darbības eskalācijas periods.<br><br>Noklusējums: 0s.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *supported* ja [Darbības objekta](#action) `eventsource` ir iestatīts uz "event created by a trigger", "internal event" vai "event created on service status update"| |esc\_step\_from|integer|Solis, no kura sākt eskalāciju.<br><br>Noklusējums: 1.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *supported* ja [Darbības objekta](#action) `eventsource` ir iestatīts uz "event created by a trigger", "internal event" vai "event created on service status update"| |esc\_step\_to|integer|Solis, kurā beigt eskalāciju.<br><br>Noklusējums: 1.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *supported* ja [Darbības objekta](#action) `eventsource` ir iestatīts uz "event created by a trigger", "internal event" vai "event created on service status update"| |evaltype|integer|Operācijas nosacījuma [novērtēšanas metode](/manual/config/notifications/action/conditions#type-of-calculation).<br><br>Iespējamās vērtības:<br>0 - *(noklusējums)* Un/Vai;<br>1 - Un;<br>2 - Vai.| |opcommand|object|Izpildāmais globālais skripts.<br><br>Globālajam skriptam jābūt definētai `scriptid` īpašībai.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *required* ja `operationtype` ir iestatīts uz "global script"| |opcommand\_grp|array|Hostu grupas, uz kurām palaist globālos skriptus.<br><br>Hostu grupām jābūt definētai `groupid` īpašībai.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *required* ja `operationtype` ir iestatīts uz "global script" un `opcommand_hst` nav iestatīts| |opcommand\_hst|array|Hosts, uz kura palaist globālos skriptus.<br><br>Hostiem jābūt definētai `hostid` īpašībai.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *required* ja `operationtype` ir iestatīts uz "global script" un `opcommand_grp` nav iestatīts| |opconditions|array|Operācijas nosacījumi, kas tiek izmantoti trigeru darbībām.<br><br>Operācijas nosacījuma objekts ir [detalizēti aprakstīts zemāk](/manual/api/reference/action/object#action-operation-condition).| |opgroup|array|Hostu grupas, kurām pievienot hostus.<br><br>Hostu grupām jābūt definētai `groupid` īpašībai.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *required* ja `operationtype` ir iestatīts uz "add to host group" vai "remove from host group"| |opmessage|object|Objekts, kas satur datus par operācijas nosūtīto ziņojumu.<br><br>Operācijas ziņojuma objekts ir [detalizēti aprakstīts zemāk](/manual/api/reference/action/object#action-operation-message).<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *required* ja `operationtype` ir iestatīts uz "send message"| |opmessage\_grp|array|Lietotāju grupas, kurām sūtīt ziņojumus.<br><br>Lietotāju grupām jābūt definētai `usrgrpid` īpašībai.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *required* ja `operationtype` ir iestatīts uz "send message" un `opmessage_usr` nav iestatīts| |opmessage\_usr|array|Lietotāji, kuriem sūtīt ziņojumus.<br><br>Lietotājiem jābūt definētai `userid` īpašībai.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *required* ja `operationtype` ir iestatīts uz "send message" un `opmessage_grp` nav iestatīts| |optemplate|array|Veidnes, ko saistīt ar hostiem.<br><br>Veidnēm jābūt definētai `templateid` īpašībai.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *required* ja `operationtype` ir iestatīts uz "link template" vai "unlink template"| |opinventory|object|Inventarizācijas režīms, uz kuru iestatīt hostu.<br><br>Inventarizācijai jābūt definētai `inventory_mode` īpašībai.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *required* ja `operationtype` ir iestatīts uz "set host inventory mode"| |optag|array|Hosta tagi, ko pievienot vai noņemt.<br><br>Tagiem jābūt definētai `tag` īpašībai.<br>`value` īpašība nav obligāta. <br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *supported* ja `operationtype` ir iestatīts uz "add host tags" vai "remove host tags".| ### Action recovery operation The action recovery operation object defines an operation that will be performed when a problem is resolved. Recovery operations are possible **only** for trigger, internal and service actions. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |operationtype|integer|Type of operation.<br><br>Possible values if `eventsource` of [Action object](#action) is set to "event created by a trigger" or "event created on service status update":<br>0 - send message;<br>1 - global script;<br>11 - notify all involved.<br><br>Possible values if `eventsource` of [Action object](#action) is set to "internal event":<br>0 - send message;<br>11 - notify all involved.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |opcommand|object|Global script to execute.<br><br>The global script must have the `scriptid` property defined.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `operationtype` is set to "global script"| |opcommand\_grp|array|Host groups to run global scripts on.<br><br>The host groups must have the `groupid` property defined.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `eventsource` of [Action object](#action) is set to "event created by a trigger", and `operationtype` is set to "global script", and `opcommand_hst` is not set| |opcommand\_hst|array|Host to run global scripts on.<br><br>The hosts must have the `hostid` property defined.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `eventsource` of [Action object](#action) is set to "event created by a trigger", and `operationtype` is set to "global script", and `opcommand_grp` is not set| |opmessage|object|Object containing the data about the message sent by the recovery operation.<br><br>The operation message object is [described in detail above](/manual/api/reference/action/object#action-operation-message).<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `operationtype` is set to "send message"| |opmessage\_grp|array|User groups to send messages to.<br><br>The user groups must have the `usrgrpid` property defined.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `operationtype` is set to "send message" and `opmessage_usr` is not set| |opmessage\_usr|array|Users to send messages to.<br><br>The users must have the `userid` property defined.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `operationtype` is set to "send message" and `opmessage_grp` is not set| ### Darbības atkopšanas operācija Darbības atkopšanas operācijas objekts definē operāciju, kas tiks izpildīta, kad problēma būs novērsta. Atkopšanas operācijas ir iespējamas **tikai** trigeru, iekšējo un pakalpojumu darbībām. Tam ir šādas īpašības. |Īpašība|[Tips](/manual/api/reference_commentary#data-types)|Apraksts| |--|--|------| |operationtype|integer|Operācijas tips.<br><br>Iespējamās vērtības, ja [Darbības objekta](#action) `eventsource` ir iestatīts uz "notikums, ko izveidojis trigeris" vai "notikums, kas izveidots pakalpojuma statusa atjaunināšanas laikā":<br>0 - sūtīt ziņojumu;<br>1 - globālais skripts;<br>11 - paziņot visiem iesaistītajiem.<br><br>Iespējamās vērtības, ja [Darbības objekta](#action) `eventsource` ir iestatīts uz "iekšējais notikums":<br>0 - sūtīt ziņojumu;<br>11 - paziņot visiem iesaistītajiem.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāts*| |opcommand|object|Izpildāmais globālais skripts.<br><br>Globālajam skriptam jābūt definētai īpašībai `scriptid`.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāts*, ja `operationtype` ir iestatīts uz "globālais skripts"| |opcommand\_grp|array|Hostu grupas, kurās palaist globālos skriptus.<br><br>Hostu grupām jābūt definētai īpašībai `groupid`.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāts*, ja [Darbības objekta](#action) `eventsource` ir iestatīts uz "notikums, ko izveidojis trigeris", un `operationtype` ir iestatīts uz "globālais skripts", un `opcommand_hst` nav iestatīts| |opcommand\_hst|array|Hosts, kurā palaist globālos skriptus.<br><br>Hostiem jābūt definētai īpašībai `hostid`.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāts*, ja [Darbības objekta](#action) `eventsource` ir iestatīts uz "notikums, ko izveidojis trigeris", un `operationtype` ir iestatīts uz "globālais skripts", un `opcommand_grp` nav iestatīts| |opmessage|object|Objekts, kas satur datus par ziņojumu, ko nosūta atkopšanas operācija.<br><br>Operācijas ziņojuma objekts ir [detalizēti aprakstīts iepriekš](/manual/api/reference/action/object#action-operation-message).<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāts*, ja `operationtype` ir iestatīts uz "sūtīt ziņojumu"| |opmessage\_grp|array|Lietotāju grupas, kurām sūtīt ziņojumus.<br><br>Lietotāju grupām jābūt definētai īpašībai `usrgrpid`.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāts*, ja `operationtype` ir iestatīts uz "sūtīt ziņojumu" un `opmessage_usr` nav iestatīts| |opmessage\_usr|array|Lietotāji, kuriem sūtīt ziņojumus.<br><br>Lietotājiem jābūt definētai īpašībai `userid`.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāts*, ja `operationtype` ir iestatīts uz "sūtīt ziņojumu" un `opmessage_grp` nav iestatīts| # Actions Actions are responsible for 'business logic' of the module. An action usually consists of a [controller](#controller) and an [action view](views#action-view). A module can: - Call actions that are already defined in Zabbix frontend. - Override default actions with custom actions. - Define completely new actions. To override a default action behavior with some custom behavior, define an action with the same name in the module configuration. When the action is called, the module action will be executed instead of the default Zabbix action. Action files should be stored in the *actions* folder. The actions need to be specified in the [manifest.json](manifest). # Darbības Darbības ir atbildīgas par moduļa “biznesa loģiku”. Darbība parasti sastāv no [kontroliera](#controller) un [darbības skata](views#action-view). Modulis var: - Izsaukt darbības, kas jau ir definētas Zabbix lietotāja saskarnē. - Aizstāt noklusējuma darbības ar pielāgotām darbībām. - Definēt pilnīgi jaunas darbības. Lai aizstātu noklusējuma darbības uzvedību ar pielāgotu uzvedību, moduļa konfigurācijā definējiet darbību ar tādu pašu nosaukumu. Kad darbība tiek izsaukta, noklusējuma Zabbix darbības vietā tiks izpildīta moduļa darbība. Darbību faili jāglabā mapē *actions*. Darbības jānorāda [manifest.json](manifest). ### actions Actions to register with the module. Defining *class* object key for each action is required, other action keys are optional. *Type*: Object Supported object keys if *[type](#type)* is *module*: - **write.your.action.name** (object) - action name, should be written in lowercase [a-z], separating words with dots. Supports the keys: - **class** (string; required) - action class name. - **layout** (string) - action layout. Supported values: *layout.json*, *layout.htmlpage* (default), *null*. - **view** (string) - action view. *Example*: ```json "actions": { "module.example.list": { "class": "ExampleList", "view": "example.list", "layout": "layout.htmlpage" } } ``` Supported object keys if *[type](#type)* is *widget*: - **widget.{id}.view** (object) - file and class name for widget view. Replace **{id}** with the widget's [id](#id) value (for example, *widget.example_clock.view*). Supports the keys: - **class** (string; required) - action class name for widget view mode to extend the default CControllerDashboardWidgetView class. The class source file must be located in the *actions* directory. - **view** (string) - widget view. Must be located in the *views* directory. If the view file is *widget.view.php*, which is expected by default, this parameter maybe omitted. If using a different name, specify it here. - **widget.{id}.edit** (object) - file name for widget configuration view. Replace **{id}** with the widget's [id](#id) value (for example, *widget.example_clock.edit*). Supports the keys: - **class** (string; required) - action class name for widget configuration view mode. The class source file must be located in the *actions* directory. - **view** (string) - widget configuration view. Must be located in the *views* directory. If the view file is *widget.edit.php*, which is expected by default, this parameter maybe omitted. If using a different name, specify it here. *Example*: ```json "actions": { "widget.tophosts.view": { "class": "WidgetView" }, "widget.tophosts.column.edit": { "class": "ColumnEdit", "view": "column.edit", "layout": "layout.json" } } ``` ### darbības Darbības, kas jāreģistrē modulī. Katrai darbībai ir obligāti jādefinē *class* objekta atslēga, pārējās darbību atslēgas ir neobligātas. *Tips*: Object Atbalstītās objekta atslēgas, ja *[type](#type)* ir *module*: - **write.your.action.name** (object) - darbības nosaukums; tas jāraksta ar mazajiem burtiem [a-z], atdalot vārdus ar punktiem. Atbalsta šādas atslēgas: - **class** (string; required) - darbības klases nosaukums. - **layout** (string) - darbības izkārtojums. Atbalstītās vērtības: *layout.json*, *layout.htmlpage* (noklusējums), *null*. - **view** (string) - darbības skats. *Piemērs*: ```json "actions": { "module.example.list": { "class": "ExampleList", "view": "example.list", "layout": "layout.htmlpage" } } ``` Atbalstītās objekta atslēgas, ja *[type](#type)* ir *widget*: - **widget.{id}.view** (object) - faila un klases nosaukums logrīka skatam. Aizstājiet **{id}** ar logrīka [id](#id) vērtību (piemēram, *widget.example_clock.view*). Atbalsta šādas atslēgas: - **class** (string; required) - darbības klases nosaukums logrīka skata režīmam, lai paplašinātu noklusēto CControllerDashboardWidgetView klasi. Klases pirmkoda failam jāatrodas direktorijā *actions*. - **view** (string) - logrīka skats. Tam jāatrodas direktorijā *views*. Ja skata fails ir *widget.view.php*, kas pēc noklusējuma tiek sagaidīts, šo parametru var izlaist. Ja tiek izmantots cits nosaukums, norādiet to šeit. - **widget.{id}.edit** (object) - faila nosaukums logrīka konfigurācijas skatam. Aizstājiet **{id}** ar logrīka [id](#id) vērtību (piemēram, *widget.example_clock.edit*). Atbalsta šādas atslēgas: - **class** (string; required) - darbības klases nosaukums logrīka konfigurācijas skata režīmam. Klases pirmkoda failam jāatrodas direktorijā *actions*. - **view** (string) - logrīka konfigurācijas skats. Tam jāatrodas direktorijā *views*. Ja skata fails ir *widget.edit.php*, kas pēc noklusējuma tiek sagaidīts, šo parametru var izlaist. Ja tiek izmantots cits nosaukums, norādiet to šeit. *Piemērs*: ```json "actions": { "widget.tophosts.view": { "class": "WidgetView" }, "widget.tophosts.column.edit": { "class": "ColumnEdit", "view": "column.edit", "layout": "layout.json" } } ``` #### Actions and alerts Define actions and operations to notify users about certain events or automatically execute remote commands. Gain access to information about generated alerts and their receivers. [Action API](/manual/api/reference/action) | [Alert API](/manual/api/reference/alert) #### Darbības un brīdinājumi Definējiet darbības un operācijas, lai paziņotu lietotājiem par noteiktiem notikumiem vai automātiski izpildītu attālinātās komandas. Iegūstiet piekļuvi informācijai par ģenerētajiem brīdinājumiem un to saņēmējiem. [Darbību API](/manual/api/reference/action) | [Brīdinājumu API](/manual/api/reference/alert) #### Actions Discovery events can be the basis of relevant [actions](/manual/config/notifications/action), such as: - Sending notifications - Adding/removing hosts - Enabling/disabling hosts - Adding hosts to a group - Removing hosts from a group - Adding tags to a host - Removing tags from a host - Linking a template to hosts/unlinking a template from hosts - Executing remote scripts These actions can be configured with respect to the device type, IP, status, uptime/downtime, etc. For full details on configuring actions for network-discovery based events, see action [operation](/manual/config/notifications/action/operation) and [conditions](/manual/config/notifications/action/conditions) pages. Since network discovery actions are event-based, they will be triggered both when a discovered host is online and when it is offline. It is highly recommended to add an action [condition](/manual/config/notifications/action/conditions) *Discovery status: up* to avoid such actions as *Add host* being triggered upon *Service Lost*/*Service Down* events. Otherwise, if a discovered host is manually removed, it will still generate *Service Lost*/*Service Down* events and will be recreated during the next discovery cycle. ::: noteclassic Linking templates to a discovered host will fail collectively if any of the linkable templates has a unique entity (e.g. item key) that is the same as a unique entity (e.g. item key) already existing on the host or on another of the linkable templates. ::: #### Darbības Atklāšanas notikumi var būt par pamatu atbilstošām [darbībām](/manual/config/notifications/action), piemēram: - Paziņojumu sūtīšana - Hostu pievienošana/noņemšana - Hostu iespējošana/atspējošana - Hostu pievienošana grupai - Hostu noņemšana no grupas - Birku pievienošana hostam - Birku noņemšana no hosta - Veidnes piesaistīšana hostiem/veidnes atsaistīšana no hostiem - Attālo skriptu izpilde Šīs darbības var konfigurēt atbilstoši ierīces tipam, IP, statusam, darbības laikam/dīkstāves laikam utt. Pilnu informāciju par darbību konfigurēšanu uz tīkla atklāšanu balstītiem notikumiem skatiet lapās par darbību [operācijām](/manual/config/notifications/action/operation) un [nosacījumiem](/manual/config/notifications/action/conditions). Tā kā tīkla atklāšanas darbības ir balstītas uz notikumiem, tās tiks izpildītas gan tad, kad atklātais hosts ir tiešsaistē, gan tad, kad tas ir bezsaistē. Ir ļoti ieteicams pievienot darbības [nosacījumu](/manual/config/notifications/action/conditions) *Atklāšanas statuss: darbojas*, lai izvairītos no tā, ka tādas darbības kā *Pievienot hostu* tiek izpildītas pie *Pakalpojums zaudēts*/*Pakalpojums nedarbojas* notikumiem. Pretējā gadījumā, ja atklātais hosts tiek noņemts manuāli, tas joprojām ģenerēs *Pakalpojums zaudēts*/*Pakalpojums nedarbojas* notikumus un tiks izveidots no jauna nākamajā atklāšanas ciklā. ::: noteclassic Veidņu piesaistīšana atklātam hostam kolektīvi neizdosies, ja kādai no piesaistāmajām veidnēm ir unikāla entītija (piemēram, vienuma atslēga), kas sakrīt ar unikālu entītiju (piemēram, vienuma atslēgu), kura jau pastāv hostā vai citā no piesaistāmajām veidnēm. ::: #### Actions if communication fails between agent and server Each matching line from `log[]` and `logrt[]` item and a result of each `log.count[]` and `logrt.count[]` item check requires a free slot in the designated 50% area in the agent send buffer. The buffer elements are regularly sent to server (or proxy) and the buffer slots are free again. While there are free slots in the designated log area in the agent send buffer and communication fails between agent and server (or proxy) the log monitoring results are accumulated in the send buffer. This helps to mitigate short communication failures. During longer communication failures all log slots get occupied and the following actions are taken: - `log[]` and `logrt[]` item checks are stopped. When communication is restored and free slots in the buffer are available the checks are resumed from the previous position. No matching lines are lost, they are just reported later. - `log.count[]` and `logrt.count[]` checks are stopped if `maxdelay = 0` (default). Behavior is similar to `log[]` and `logrt[]` items as described above. Note that this can affect `log.count[]` and `logrt.count[]` results: for example, one check counts 100 matching lines in a log file, but as there are no free slots in the buffer the check is stopped. When communication is restored the agent counts the same 100 matching lines and also 70 new matching lines. The agent now sends count = 170 as if they were found in one check. - `log.count[]` and `logrt.count[]` checks with `maxdelay` > 0: if there was no "jump" during the check, then behavior is similar to described above. If a "jump" over log file lines took place then the position after "jump" is kept and the counted result is discarded. So, the agent tries to keep up with a growing log file even in case of communication failure. #### Darbības, ja saziņa starp aģentu un serveri neizdodas Katra atbilstošā rinda no `log[]` un `logrt[]` vienuma, kā arī katra `log.count[]` un `logrt.count[]` vienuma pārbaudes rezultāts prasa brīvu slotu aģenta nosūtīšanas bufera norādītajā 50% zonā. Bufera elementi tiek regulāri nosūtīti uz serveri (vai starpniekserveri), un bufera sloti atkal kļūst brīvi. Kamēr aģenta nosūtīšanas bufera norādītajā logu zonā ir brīvi sloti un saziņa starp aģentu un serveri (vai starpniekserveri) neizdodas, logu uzraudzības rezultāti tiek uzkrāti nosūtīšanas buferī. Tas palīdz mazināt īslaicīgas saziņas kļūmes. Ilgāku saziņas kļūmju laikā visi logu sloti tiek aizņemti, un tiek veiktas šādas darbības: - `log[]` un `logrt[]` vienuma pārbaudes tiek apturētas. Kad saziņa tiek atjaunota un buferī ir pieejami brīvi sloti, pārbaudes tiek atsāktas no iepriekšējās pozīcijas. Neviena atbilstošā rinda netiek zaudēta, tā vienkārši tiek ziņota vēlāk. - `log.count[]` un `logrt.count[]` pārbaudes tiek apturētas, ja `maxdelay = 0` (noklusējums). Uzvedība ir līdzīga `log[]` un `logrt[]` vienumiem, kā aprakstīts iepriekš. Ņemiet vērā, ka tas var ietekmēt `log.count[]` un `logrt.count[]` rezultātus: piemēram, viena pārbaude saskaita 100 atbilstošas rindas žurnāla failā, bet, tā kā buferī nav brīvu slotu, pārbaude tiek apturēta. Kad saziņa tiek atjaunota, aģents saskaita tās pašas 100 atbilstošās rindas un arī 70 jaunas atbilstošas rindas. Tagad aģents nosūta count = 170 tā, it kā tās būtu atrastas vienā pārbaudē. - `log.count[]` un `logrt.count[]` pārbaudes ar `maxdelay` > 0: ja pārbaudes laikā nebija "lēciens", tad uzvedība ir līdzīga iepriekš aprakstītajai. Ja notika "lēciens" pāri žurnāla faila rindām, tad pozīcija pēc "lēciena" tiek saglabāta, un saskaitītais rezultāts tiek atmests. Tādējādi aģents cenšas neatpalikt no augoša žurnāla faila pat saziņas kļūmes gadījumā. #### Actions In [actions](/manual/config/notifications/action), user macros can be used in the following fields: |Location|<|Multiple macros/mix with text^[1](supported_by_location_user#footnotes)^| |-|------------------------------|----------| |Trigger-based notifications and commands|<|yes| |Trigger-based internal notifications|<|yes| |Problem update notifications|<|yes| |Service-based notifications and commands|<|yes| |Service update notifications|<|yes| |Time period condition|<|no| |*Operations*|<|<| | |Default operation step duration|no| |^|Step duration|no| #### Darbības [Aktivitātēs](/manual/config/notifications/action) lietotāja makrosus var izmantot šādos laukos: |Atrašanās vieta|<|Vairāki makrosi/sajaukums ar tekstu^[1](supported_by_location_user#footnotes)^| |-|------------------------------|----------| |Uz trigeriem balstīti paziņojumi un komandas|<|jā| |Uz trigeriem balstīti iekšējie paziņojumi|<|jā| |Problēmas atjaunināšanas paziņojumi|<|jā| |Uz pakalpojumiem balstīti paziņojumi un komandas|<|jā| |Pakalpojuma atjaunināšanas paziņojumi|<|jā| |Laika perioda nosacījums|<|nē| |*Darbības*|<|<| | |Noklusējuma darbības soļa ilgums|nē| |^|Soļa ilgums|nē| ### Actions |Macro|Supported in|Description| |--|--------|--------| |{ACTION.ID}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Discovery notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications|*Numeric ID of the triggered action.*| |{ACTION.NAME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Discovery notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications|*Name of the triggered action.*| |{ALERT.MESSAGE}|→ Alert script parameters<br>→ Webhook parameters|*'Default message' value from action configuration.*| |{ALERT.SENDTO}|→ Alert script parameters<br>→ Webhook parameters|*'Send to' value from user media configuration.*| |{ALERT.SUBJECT}|→ Alert script parameters<br>→ Webhook parameters|*'Default subject' value from action configuration.*| |{ESC.HISTORY} |→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Internal notifications |*Escalation history. Log of previously sent messages.*<br>Shows previously sent notifications, on which escalation step they were sent and their status (*sent*, *in progress* or *failed*).| ### Darbības |Makro|Atbalstīts|Apraksts| |--|--------|--------| |{ACTION.ID}|→ Uz trigeri balstīti paziņojumi un komandas<br>→ Problēmas atjaunināšanas paziņojumi un komandas<br>→ Uz pakalpojumu balstīti paziņojumi un komandas<br>→ Pakalpojuma atjaunināšanas paziņojumi un komandas<br>→ Atklāšanas paziņojumi un komandas<br>→ Autoreģistrācijas paziņojumi un komandas<br>→ Iekšējie paziņojumi|*Aktivizētās darbības skaitliskais ID.*| |{ACTION.NAME}|→ Uz trigeri balstīti paziņojumi un komandas<br>→ Problēmas atjaunināšanas paziņojumi un komandas<br>→ Uz pakalpojumu balstīti paziņojumi un komandas<br>→ Pakalpojuma atjaunināšanas paziņojumi un komandas<br>→ Atklāšanas paziņojumi un komandas<br>→ Autoreģistrācijas paziņojumi un komandas<br>→ Iekšējie paziņojumi|*Aktivizētās darbības nosaukums.*| |{ALERT.MESSAGE}|→ Brīdinājuma skripta parametri<br>→ webhook parametri|*Vērtība "Noklusējuma ziņojums" no darbības konfigurācijas.*| |{ALERT.SENDTO}|→ Brīdinājuma skripta parametri<br>→ webhook parametri|*Vērtība "Sūtīt uz" no lietotāja multivides konfigurācijas.*| |{ALERT.SUBJECT}|→ Brīdinājuma skripta parametri<br>→ webhook parametri|*Vērtība "Noklusējuma temats" no darbības konfigurācijas.*| |{ESC.HISTORY} |→ Uz trigeri balstīti paziņojumi un komandas<br>→ Problēmas atjaunināšanas paziņojumi un komandas<br>→ Uz pakalpojumu balstīti paziņojumi un komandas<br>→ Pakalpojuma atjaunināšanas paziņojumi un komandas<br>→ Iekšējie paziņojumi |*Eskalācijas vēsture. Iepriekš nosūtīto ziņojumu žurnāls.*<br>Parāda iepriekš nosūtītos paziņojumus, uz kuru eskalācijas soli tie tika nosūtīti un to statusu (*nosūtīts*, *notiek* vai *neizdevās*).| #### Actions numbered where media type/script is used The actions where a media type/script is used are now preceded by a number indicating the total number of such actions. See [Media types](/manual/web_interface/frontend_sections/alerts/mediatypes)/[Scripts](/manual/web_interface/frontend_sections/alerts/scripts). #### Darbības, kas numurētas, ja tiek izmantots mediju tips/skripts Darbībām, kurās tiek izmantots mediju tips/skripts, tagad priekšā ir numurs, kas norāda šādu darbību kopējo skaitu. Skatiet [Mediju tipi](/manual/web_interface/frontend_sections/alerts/mediatypes)/[Skripti](/manual/web_interface/frontend_sections/alerts/scripts). ### Action The action object has the following properties. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |actionid|ID|ID of the action.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*<br>- *required* for update operations| |esc\_period|string|Default operation step duration. Must be at least 60 seconds. Accepts seconds, time unit with suffix, or a user macro.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `eventsource` is set to "event created by a trigger", "internal event", or "event created on service status update"| |eventsource|integer|Type of events that the action will handle.<br><br>Refer to the [event `source` property](/manual/api/reference/event/object#event) for a list of supported event types.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *constant*<br>- *required* for create operations| |name|string|Name of the action.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |status|integer|Whether the action is enabled or disabled.<br><br>Possible values:<br>0 - *(default)* enabled;<br>1 - disabled.| |pause\_symptoms|integer|Whether to pause escalation if event is a symptom event.<br><br>Possible values:<br>0 - Don't pause escalation for symptom problems;<br>1 - *(default)* Pause escalation for symptom problems.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `eventsource` is set to "event created by a trigger"| |pause\_suppressed|integer|Whether to pause escalation during maintenance periods or not.<br><br>Possible values:<br>0 - Don't pause escalation;<br>1 - *(default)* Pause escalation.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `eventsource` is set to "event created by a trigger"| |notify\_if\_canceled|integer|Whether to notify when escalation is canceled.<br><br>Possible values:<br>0 - Don't notify when escalation is canceled;<br>1 - *(default)* Notify when escalation is canceled.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `eventsource` is set to "event created by a trigger"| ### Darbība Darbības objektam ir šādas īpašības. |Īpašība|[Tips](/manual/api/reference_commentary#data-types)|Apraksts| |--|--|------| |actionid|ID|Darbības ID.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *tikai lasāms*<br>- *obligāts* atjaunināšanas operācijām| |esc\_period|string|Noklusējuma operācijas soļa ilgums. Tam jābūt vismaz 60 sekundēm. Pieņem sekundes, laika vienību ar sufiksu vai lietotāja makrosu.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *atbalstīts*, ja `eventsource` ir iestatīts uz "notikums, ko izveidojis trigeris", "iekšējs notikums" vai "notikums, kas izveidots pakalpojuma statusa atjaunināšanas laikā"| |eventsource|integer|Notikumu tips, ko apstrādās darbība.<br><br>Atbalstīto notikumu tipu sarakstu skatiet [notikuma `source` īpašībā](/manual/api/reference/event/object#event).<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *konstants*<br>- *obligāts* izveides operācijām| |name|string|Darbības nosaukums.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāts* izveides operācijām| |status|integer|Vai darbība ir iespējota vai atspējota.<br><br>Iespējamās vērtības:<br>0 - *(noklusējums)* iespējota;<br>1 - atspējota.| |pause\_symptoms|integer|Vai apturēt eskalāciju, ja notikums ir simptoma notikums.<br><br>Iespējamās vērtības:<br>0 - Neapturēt eskalāciju simptomu problēmām;<br>1 - *(noklusējums)* Apturēt eskalāciju simptomu problēmām.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *atbalstīts*, ja `eventsource` ir iestatīts uz "notikums, ko izveidojis trigeris"| |pause\_suppressed|integer|Vai apturēt eskalāciju apkopes periodu laikā vai ne.<br><br>Iespējamās vērtības:<br>0 - Neapturēt eskalāciju;<br>1 - *(noklusējums)* Apturēt eskalāciju.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *atbalstīts*, ja `eventsource` ir iestatīts uz "notikums, ko izveidojis trigeris"| |notify\_if\_canceled|integer|Vai sūtīt paziņojumu, kad eskalācija tiek atcelta.<br><br>Iespējamās vērtības:<br>0 - Nesūtīt paziņojumu, kad eskalācija tiek atcelta;<br>1 - *(noklusējums)* Sūtīt paziņojumu, kad eskalācija tiek atcelta.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *atbalstīts*, ja `eventsource` ir iestatīts uz "notikums, ko izveidojis trigeris"| #### Action The action object has the following properties: |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |name|string|Name of the action.<br><br>Possible values if `type` of the [Role](#role) object is set to "User", "Admin", or "Super admin:<br>`edit_dashboards` - Create and edit dashboards;<br>`edit_maps` - Create and edit maps;<br>`add_problem_comments` - Add problem comments;<br>`change_severity` - Change problem severity;<br>`acknowledge_problems` - Acknowledge problems;<br>`suppress_problems` - Suppress problems;<br>`close_problems` - Close problems;<br>`execute_scripts` - Execute scripts;<br>`manage_api_tokens` - Manage API tokens;<br>`change_problem_ranking` - Change the problem ranking from cause to symptom, and vice versa.<br><br>Possible values if `type` of the [Role](#role) object is set to "Admin" or "Super admin":<br>`edit_maintenance` - Create and edit maintenances;<br>`manage_scheduled_reports` - Manage scheduled reports,<br>`manage_sla` - Manage SLA.<br><br>Possible values if `type` of the [Role](#role) object is set to "User" or "Admin":<br>`invoke_execute_now` - allows to execute item checks for users that have only read permissions on host.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |status|integer|Whether access to perform the action is enabled.<br><br>Possible values:<br>0 - Disabled;<br>1 - *(default)* Enabled.| #### Darbība Darbības objektam ir šādas īpašības: |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |name|string|Darbības nosaukums.<br><br>Iespējamās vērtības, ja [Role](#role) objekta `type` ir iestatīts uz "User", "Admin" vai "Super admin":<br>`edit_dashboards` - Izveidot un rediģēt paneļus;<br>`edit_maps` - Izveidot un rediģēt kartes;<br>`add_problem_comments` - Pievienot problēmu komentārus;<br>`change_severity` - Mainīt problēmas smagumu;<br>`acknowledge_problems` - Apstiprināt problēmas;<br>`suppress_problems` - Slāpēt problēmas;<br>`close_problems` - Aizvērt problēmas;<br>`execute_scripts` - Izpildīt skriptus;<br>`manage_api_tokens` - Pārvaldīt API žetonus;<br>`change_problem_ranking` - Mainīt problēmas prioritātes secību no cēloņa uz simptomu un otrādi.<br><br>Iespējamās vērtības, ja [Role](#role) objekta `type` ir iestatīts uz "Admin" vai "Super admin":<br>`edit_maintenance` - Izveidot un rediģēt apkopi;<br>`manage_scheduled_reports` - Pārvaldīt plānotos pārskatus,<br>`manage_sla` - Pārvaldīt SLA.<br><br>Iespējamās vērtības, ja [Role](#role) objekta `type` ir iestatīts uz "User" vai "Admin":<br>`invoke_execute_now` - ļauj izpildīt vienumu pārbaudes lietotājiem, kuriem uz host ir tikai lasīšanas tiesības.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |status|integer|Vai piekļuve darbības veikšanai ir iespējota.<br><br>Iespējamās vērtības:<br>0 - Atspējots;<br>1 - *(default)* Iespējots.| # Action This class is designed to work with actions. Object references: - [Action](/manual/api/reference/action/object#action) - [Action operation](/manual/api/reference/action/object#action-operation) - [Action operation message](/manual/api/reference/action/object#action-operation-message) - [Action operation condition](/manual/api/reference/action/object#action-operation-condition) - [Action recovery operation](/manual/api/reference/action/object#action-recovery-operation) - [Action update operation](/manual/api/reference/action/object#action-update-operation) - [Action filter](/manual/api/reference/action/object#action-filter) - [Action filter condition](/manual/api/reference/action/object#action-filter-condition) Available methods: - [action.create](/manual/api/reference/action/create) - create new actions - [action.delete](/manual/api/reference/action/delete) - delete actions - [action.get](/manual/api/reference/action/get) - retrieve actions - [action.update](/manual/api/reference/action/update) - update actions # Darbība Šī klase ir paredzēta darbam ar darbībām. Objektu atsauces: - [Darbība](/manual/api/reference/action/object#action) - [Darbības operācija](/manual/api/reference/action/object#action-operation) - [Darbības operācijas ziņojums](/manual/api/reference/action/object#action-operation-message) - [Darbības operācijas nosacījums](/manual/api/reference/action/object#action-operation-condition) - [Darbības atkopšanas operācija](/manual/api/reference/action/object#action-recovery-operation) - [Darbības atjaunināšanas operācija](/manual/api/reference/action/object#action-update-operation) - [Darbības filtrs](/manual/api/reference/action/object#action-filter) - [Darbības filtra nosacījums](/manual/api/reference/action/object#action-filter-condition) Pieejamās metodes: - [action.create](/manual/api/reference/action/create) - izveidot jaunas darbības - [action.delete](/manual/api/reference/action/delete) - dzēst darbības - [action.get](/manual/api/reference/action/get) - izgūt darbības - [action.update](/manual/api/reference/action/update) - atjaunināt darbības # action.update # action.update ### Action update operation The action update operation object defines an operation that will be performed when a problem is updated (commented upon, acknowledged, severity changed, or manually closed). Update operations are possible **only** for trigger and service actions. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |operationtype|integer|Type of operation.<br><br>Possible values:<br>0 - send message;<br>1 - global script;<br>12 - notify all involved.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |opcommand|object|Global script to execute.<br><br>The global script must have the `scriptid` property defined.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `operationtype` is set to "global script"| |opcommand\_grp|array|Host groups to run global scripts on.<br><br>The host groups must have the `groupid` property defined.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `eventsource` of [Action object](#action) is set to "event created by a trigger", and `operationtype` is set to "global script", and `opcommand_hst` is not set| |opcommand\_hst|array|Host to run global scripts on.<br><br>The hosts must have the `hostid` property defined.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `eventsource` of [Action object](#action) is set to "event created by a trigger", and `operationtype` is set to "global script", and `opcommand_grp` is not set| |opmessage|object|Object containing the data about the message sent by the update operation.<br><br>The operation message object is [described in detail above](/manual/api/reference/action/object#action-operation-message).| |opmessage\_grp|array|User groups to send messages to.<br><br>The user groups must have the `usrgrpid` property defined.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `operationtype` is set to "send message" and `opmessage_usr` is not set| |opmessage\_usr|array|Users to send messages to.<br><br>The users must have the `userid` property defined.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `operationtype` is set to "send message" and `opmessage_grp` is not set| ### Darbības atjaunināšanas operācija Darbības atjaunināšanas operācijas objekts definē operāciju, kas tiks izpildīta, kad problēma tiek atjaunināta (tai pievienots komentārs, tā ir apstiprināta, mainīta tās nopietnība vai tā ir manuāli aizvērta). Atjaunināšanas operācijas ir iespējamas **tikai** trigeru un pakalpojumu darbībām. Tam ir šādas īpašības. |Īpašība|[Tips](/manual/api/reference_commentary#data-types)|Apraksts| |--|--|------| |operationtype|integer|Operācijas tips.<br><br>Iespējamās vērtības:<br>0 - sūtīt ziņojumu;<br>1 - globālais skripts;<br>12 - paziņot visiem iesaistītajiem.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāta*| |opcommand|object|Izpildāmais globālais skripts.<br><br>Globālajam skriptam jābūt definētai `scriptid` īpašībai.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāta*, ja `operationtype` ir iestatīts uz "globālais skripts"| |opcommand\_grp|array|Hostu grupas, kurās palaist globālos skriptus.<br><br>Hostu grupām jābūt definētai `groupid` īpašībai.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāta*, ja [Darbības objekta](#action) `eventsource` ir iestatīts uz "notikums, ko izveidojis trigeris", `operationtype` ir iestatīts uz "globālais skripts" un `opcommand_hst` nav iestatīts| |opcommand\_hst|array|Hosts, kurā palaist globālos skriptus.<br><br>Hostiem jābūt definētai `hostid` īpašībai.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāta*, ja [Darbības objekta](#action) `eventsource` ir iestatīts uz "notikums, ko izveidojis trigeris", `operationtype` ir iestatīts uz "globālais skripts" un `opcommand_grp` nav iestatīts| |opmessage|object|Objekts, kas satur datus par ziņojumu, ko nosūta atjaunināšanas operācija.<br><br>Operācijas ziņojuma objekts ir [detalizēti aprakstīts iepriekš](/manual/api/reference/action/object#action-operation-message).| |opmessage\_grp|array|Lietotāju grupas, kurām sūtīt ziņojumus.<br><br>Lietotāju grupām jābūt definētai `usrgrpid` īpašībai.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāta*, ja `operationtype` ir iestatīts uz "sūtīt ziņojumu" un `opmessage_usr` nav iestatīts| |opmessage\_usr|array|Lietotāji, kuriem sūtīt ziņojumus.<br><br>Lietotājiem jābūt definētai `userid` īpašībai.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāta*, ja `operationtype` ir iestatīts uz "sūtīt ziņojumu" un `opmessage_grp` nav iestatīts| ### Action view This is a reference file for defining an action view. ````php <?php declare(strict_types = 1); /** * @var CView $this */ $this->includeJsFile('example.something.view.js.php'); (new CWidget()) ->setTitle(_('Something view')) ->addItem(new CDiv($data['name'])) ->addItem(new CPartial('module.example.something.reusable', [ 'contacts' => $data['contacts'] ]) ->show(); ```` ### Darbības skats Šis ir atsauces fails darbības skata definēšanai. ````php <?php declare(strict_types = 1); /** * @var CView $this */ $this->includeJsFile('example.something.view.js.php'); (new CWidget()) ->setTitle(_('Something view')) ->addItem(new CDiv($data['name'])) ->addItem(new CPartial('module.example.something.reusable', [ 'contacts' => $data['contacts'] ]) ->show(); ```` #### action [ZBXNEXT-6524](https://support.zabbix.com/browse/ZBXNEXT-6524) Added support of two new values in `operationtype` property (13 - Add host tags, 14 - Remove host tags) and new property `optag` for two `eventsource` action types (1 - Discovery, 2 - Autoregistration) available only in the `operations` property.<br> [ZBX-21850](https://support.zabbix.com/browse/ZBX-21850) `action.get`: Filter conditions will be sorted in the order of their placement in the formula. #### darbība [ZBXNEXT-6524](https://support.zabbix.com/browse/ZBXNEXT-6524) Pievienots atbalsts divām jaunām vērtībām `operationtype` īpašībā (13 - Pievienot host tagus, 14 - Noņemt host tagus) un jaunai īpašībai `optag` diviem `eventsource` darbības tipiem (1 - Atklāšana, 2 - Automātiskā reģistrācija), kas pieejama tikai `operations` īpašībā.<br> [ZBX-21850](https://support.zabbix.com/browse/ZBX-21850) `action.get`: Filtra nosacījumi tiks sakārtoti tādā secībā, kādā tie ir izvietoti formulā. #### Active agent autoregistration events Active agent autoregistration creates events in Zabbix. If configured, active agent autoregistration event is created when a previously unknown active agent asks for checks or if the host metadata has changed. The server adds a new auto-registered host, using the received IP address and port of the agent. For more information, see the [active agent autoregistration](/manual/discovery/auto_registration) page. #### Aktīvā aģenta automātiskās reģistrācijas notikumi Aktīvā aģenta automātiskā reģistrācija izveido notikumus Zabbix. Ja tas ir konfigurēts, aktīvā aģenta automātiskās reģistrācijas notikums tiek izveidots, kad iepriekš nezināms aktīvais aģents pieprasa pārbaudes vai ja ir mainījušies hosta metadati. Serveris pievieno jaunu automātiski reģistrētu hostu, izmantojot saņemto aģenta IP adresi un portu. Plašāku informāciju skatiet lapā [aktīvā aģenta automātiskā reģistrācija](/manual/discovery/auto_registration). ##### Active check interface [Active checks](/manual/appendix/items/activepassive#active-checks) in the cloud automatically create a host interface with an IP unrelated to your on-premise network. By default, this IP may be external. To maintain consistency, you can manually delete or adjust the host interface after creation. ##### Aktīvo pārbaužu saskarne Mākonī [aktīvās pārbaudes](/manual/appendix/items/activepassive#active-checks) automātiski izveido hosta saskarni ar IP adresi, kas nav saistīta ar jūsu lokālo tīklu. Pēc noklusējuma šī IP adrese var būt ārēja. Lai saglabātu konsekvenci, pēc izveides varat manuāli dzēst vai pielāgot hosta saskarni. ### Active checks ### Aktīvās pārbaudes #### Active checks Active checks require more complex processing. The agent must first retrieve from the server/proxy a list of items and/or [remote commands](/manual/config/notifications/action/operation/remote_command) for independent processing. The servers/proxies to get the active checks from are listed in the 'ServerActive' parameter of the agent [configuration file](/manual/appendix/config/zabbix_agent2). The frequency of asking for these checks is set by the 'RefreshActiveChecks' parameter in the same configuration file. However, if refreshing active checks fails, it is retried after hardcoded 60 seconds. #### Aktīvās pārbaudes Aktīvās pārbaudes prasa sarežģītāku apstrādi. Aģentam vispirms no servera/starpniekservera ir jāiegūst vienumu saraksts un/vai [attālinātās komandas](/manual/config/notifications/action/operation/remote_command) neatkarīgai apstrādei. Serveri/starpniekserveri, no kuriem iegūt aktīvās pārbaudes, ir norādīti aģenta [konfigurācijas faila](/manual/appendix/config/zabbix_agent2) parametrā 'ServerActive'. Šo pārbaužu pieprasīšanas biežumu nosaka tas pats konfigurācijas fails parametrs 'RefreshActiveChecks'. Tomēr, ja aktīvo pārbaužu atsvaidzināšana neizdodas, mēģinājums tiek atkārtots pēc fiksētām 60 sekundēm. #### Active proxy #### Aktīvais starpniekserveris ##### Add a blank module to Zabbix frontend 1. Create a directory *MyAddress* in the *modules* directory of your Zabbix frontend installation (for example, *zabbix/ui/modules*). 2. Create a *manifest.json* file with basic module metadata (see the description of supported [parameters](../file_structure/manifest)). **ui/modules/MyAddress/manifest.json** ```json { "manifest_version": 2.0, "id": "my-address", "name": "My IP Address", "version": "1.0", "namespace": "MyAddress", "description": "My External IP Address." } ``` 3. In Zabbix frontend, go to *Administration → General → Modules* section and click on the *Scan directory* button.  4. Locate the new module *My IP Address* in the list and click on the "Disabled" hyperlink to change the module's status from "Disabled" to "Enabled" (if the module is not listed, see [troubleshooting](/manual/extensions/frontendmodules#installation) section). {width="600"} The module is now registered in the frontend. However, it is not visible yet, because you still need to define the module functionality. Once you add content to the module directory, you will immediately see the changes in Zabbix frontend upon refreshing the page. ##### Pievienot tukšu moduli Zabbix lietotāja saskarnei 1. Izveidojiet direktoriju *MyAddress* direktorijā *modules* savā Zabbix lietotāja saskarnes instalācijā (piemēram, *zabbix/ui/modules*). 2. Izveidojiet failu *manifest.json* ar pamata moduļa metadatiem (skatiet atbalstīto [parametru](../file_structure/manifest) aprakstu). **ui/modules/MyAddress/manifest.json** ```json { "manifest_version": 2.0, "id": "my-address", "name": "My IP Address", "version": "1.0", "namespace": "MyAddress", "description": "My External IP Address." } ``` 3. Zabbix lietotāja saskarnē dodieties uz sadaļu *Administration → General → Modules* un noklikšķiniet uz pogas *Scan directory*.  4. Sarakstā atrodiet jauno moduli *My IP Address* un noklikšķiniet uz hipersaites "Disabled", lai mainītu moduļa statusu no "Disabled" uz "Enabled" (ja modulis nav sarakstā, skatiet sadaļu [troubleshooting](/manual/extensions/frontendmodules#installation)). {width="600"} Modulis tagad ir reģistrēts lietotāja saskarnē. Tomēr tas vēl nav redzams, jo joprojām ir jādefinē moduļa funkcionalitāte. Kad moduļa direktorijā pievienosiet saturu, pēc lapas atsvaidzināšanas Zabbix lietotāja saskarnē nekavējoties redzēsiet izmaiņas. ### Add a blank widget to Zabbix frontend 1. Create a directory *lesson_gauge_chart* in the *modules* directory of your Zabbix frontend installation (for example, *zabbix/ui/modules*). ::: noteclassic All custom widgets are treated as external modules and must be added to the *modules* directory of your Zabbix frontend installation (for example, *zabbix/ui/modules*). The directory *zabbix/ui/widgets* is reserved for Zabbix built-in widgets and gets updated along with Zabbix UI. ::: 2. Create a *manifest.json* file with basic widget metadata (see the description of supported [parameters](../file_structure/manifest)). **ui/modules/lesson_gauge_chart/manifest.json** ```json { "manifest_version": 2.0, "id": "lesson_gauge_chart", "type": "widget", "name": "Gauge chart", "namespace": "LessonGaugeChart", "version": "1.1", "author": "Zabbix" } ``` 3. In Zabbix frontend, go to *Administration → General → Modules* section and click on the *Scan directory* button.  4. Locate the new module *Gauge chart* in the list and click on the "Disabled" hyperlink to change the module's status from "Disabled" to "Enabled" (if the module is not listed, see [troubleshooting](/manual/extensions/frontendmodules#installation) section). {width="600"} 5. Open a dashboard, switch it to the edit mode and add a new widget. In the *Type* field, select "Gauge chart". {width="600"} 6. At this point, the *Gauge chart* widget configuration contains only common widget fields *Name* and *Refresh interval*. Click on *Add* to add the widget to the dashboard. {width="600"} 7. A blank widget should appear on the dashboard. Click on *Save changes* in the top right corner to save the dashboard. {width="600"} ### Pievienojiet tukšu logrīku Zabbix lietotāja saskarnei 1. Izveidojiet direktoriju *lesson_gauge_chart* direktorijā *modules* savā Zabbix lietotāja saskarnes instalācijā (piemēram, *zabbix/ui/modules*). ::: noteclassic Visi pielāgotie logrīki tiek uzskatīti par ārējiem moduļiem, un tie ir jāpievieno Zabbix lietotāja saskarnes instalācijas direktorijam *modules* (piemēram, *zabbix/ui/modules*). Direktorijs *zabbix/ui/widgets* ir rezervēts Zabbix iebūvētajiem logrīkiem un tiek atjaunināts kopā ar Zabbix lietotāja saskarni. ::: 2. Izveidojiet failu *manifest.json* ar pamata logrīka metadatiem (skatiet atbalstīto [parametru](../file_structure/manifest) aprakstu). **ui/modules/lesson_gauge_chart/manifest.json** ```json { "manifest_version": 2.0, "id": "lesson_gauge_chart", "type": "widget", "name": "Gauge chart", "namespace": "LessonGaugeChart", "version": "1.1", "author": "Zabbix" } ``` 3. Zabbix lietotāja saskarnē dodieties uz sadaļu *Administration → General → Modules* un noklikšķiniet uz pogas *Scan directory*.  4. Sarakstā atrodiet jauno moduli *Gauge chart* un noklikšķiniet uz hipersaites "Disabled", lai mainītu moduļa statusu no "Disabled" uz "Enabled" (ja modulis nav uzskaitīts, skatiet sadaļu [troubleshooting](/manual/extensions/frontendmodules#installation)). {width="600"} 5. Atveriet paneli, pārslēdziet to rediģēšanas režīmā un pievienojiet jaunu logrīku. Laukā *Type* atlasiet "Gauge chart". {width="600"} 6. Šajā brīdī *Gauge chart* logrīka konfigurācijā ir tikai kopīgie logrīka lauki *Name* un *Refresh interval*. Noklikšķiniet uz *Add*, lai pievienotu logrīku panelim. {width="600"} 7. Panelī jāparādās tukšam logrīkam. Augšējā labajā stūrī noklikšķiniet uz *Save changes*, lai saglabātu paneli. {width="600"} ### Add advanced configuration settings to a configuration view In this section, you will learn how to add an expandable/collapsible *Advanced configuration* section with optional parameters, such as color, minimum and maximum values, units and the *Description* field created earlier. 1. Create a *Widget.php* file in the main widget directory *lesson_gauge_chart* to create a new class *Widget*. The *Widget* class will extend the *CWidget* base class to add/override the default widget settings (in this case - translations). JavaScript, provided below, displays the string "No data" in case of missing data. The "No data" string is present in the Zabbix UI translation files. If there are any widget constants, it is recommended to also specify them in the *Widget* class. **ui/modules/lesson_gauge_chart/Widget.php** ```php <?php namespace Modules\LessonGaugeChart; use Zabbix\Core\CWidget; class Widget extends CWidget { public const UNIT_AUTO = 0; public const UNIT_STATIC = 1; public function getTranslationStrings(): array { return [ 'class.widget.js' => [ 'No data' => _('No data') ] ]; } } ``` 2. Open *includes/WidgetForm.php* and add the new fields *Color* (color picker), *Min* (numeric field), *Max* (numeric field), and *Units* (select), and define the default color palette for the color picker, so that it can be used in the next steps. **ui/modules/lesson_gauge_chart/includes/WidgetForm.php** ```php <?php namespace Modules\LessonGaugeChart\Includes; use Modules\LessonGaugeChart\Widget; use Zabbix\Widgets\{ CWidgetField, CWidgetForm }; use Zabbix\Widgets\Fields\{ CWidgetFieldColor, CWidgetFieldMultiSelectItem, CWidgetFieldNumericBox, CWidgetFieldSelect, CWidgetFieldTextBox }; /** * Gauge chart widget form. */ class WidgetForm extends CWidgetForm { public const DEFAULT_COLOR_PALETTE = [ 'FF465C', 'B0AF07', '0EC9AC', '524BBC', 'ED1248', 'D1E754', '2AB5FF', '385CC7', 'EC1594', 'BAE37D', '6AC8FF', 'EE2B29', '3CA20D', '6F4BBC', '00A1FF', 'F3601B', '1CAE59', '45CFDB', '894BBC', '6D6D6D' ]; public function addFields(): self { return $this ->addField( (new CWidgetFieldMultiSelectItem('itemid', _('Item'))) ->setFlags(CWidgetField::FLAG_NOT_EMPTY | CWidgetField::FLAG_LABEL_ASTERISK) ->setMultiple(false) ) ->addField( (new CWidgetFieldColor('chart_color', _('Color')))->setDefault('FF0000') ) ->addField( (new CWidgetFieldNumericBox('value_min', _('Min'))) ->setDefault(0) ->setFlags(CWidgetField::FLAG_NOT_EMPTY | CWidgetField::FLAG_LABEL_ASTERISK) ) ->addField( (new CWidgetFieldNumericBox('value_max', _('Max'))) ->setDefault(100) ->setFlags(CWidgetField::FLAG_NOT_EMPTY | CWidgetField::FLAG_LABEL_ASTERISK) ) ->addField( (new CWidgetFieldSelect('value_units', _('Units'), [ Widget::UNIT_AUTO => _x('Auto', 'history source selection method'), Widget::UNIT_STATIC => _x('Static', 'history source selection method') ]))->setDefault(Widget::UNIT_AUTO) ) ->addField( (new CWidgetFieldTextBox('value_static_units')) ) ->addField( new CWidgetFieldTextBox('description', _('Description')) ); } } ``` 3. Open *views/widget.edit.php* and add the field visual components to the configuration view. **ui/modules/lesson_gauge_chart/views/widget.edit.php** ```php <?php /** * Gauge chart widget form view. * * @var CView $this * @var array $data */ $lefty_units = new CWidgetFieldSelectView($data['fields']['value_units']); $lefty_static_units = (new CWidgetFieldTextBoxView($data['fields']['value_static_units'])) ->setPlaceholder(_('value')) ->setWidth(ZBX_TEXTAREA_TINY_WIDTH); (new CWidgetFormView($data)) ->addField( (new CWidgetFieldMultiSelectItemView($data['fields']['itemid'])) ->setPopupParameter('numeric', true) ) ->addFieldset( (new CWidgetFormFieldsetCollapsibleView(_('Advanced configuration'))) ->addField( new CWidgetFieldColorView($data['fields']['chart_color']) ) ->addField( new CWidgetFieldNumericBoxView($data['fields']['value_min']) ) ->addField( new CWidgetFieldNumericBoxView($data['fields']['value_max']) ) ->addItem([ $lefty_units->getLabel(), (new CFormField([ $lefty_units->getView()->addClass(ZBX_STYLE_FORM_INPUT_MARGIN), $lefty_static_units->getView() ])) ]) ->addField( new CWidgetFieldTextBoxView($data['fields']['description']) ) ) ->show(); ``` ::: noteclassic The *addField()* method of the *CWidgetFormView* class takes a CSS class string as the second parameter. ::: 4. Return to the dashboard, switch to the edit mode and click on the gear icon in the widget to open the widget configuration form. The widget configuration form now contains a new expandable/collapsible section *Advanced configuration*. {width="600"} 5. Expand the *Advanced configuration* section to see additional widget configuration fields. Note that the field *Color* has no color picker yet. This is because the color picker must be initialized with JavaScript, which will be added in the next section - [*Add JavaScript to the widget*](#add-javascript-to-the-widget). {width="600"} ### Pievienot papildu konfigurācijas iestatījumus konfigurācijas skatam Šajā sadaļā jūs uzzināsiet, kā pievienot izvēršamu/savēršamu *Advanced configuration* sadaļu ar izvēles parametriem, piemēram, krāsu, minimālajām un maksimālajām vērtībām, vienībām un iepriekš izveidoto lauku *Description*. 1. Izveidojiet failu *Widget.php* galvenajā logrīka direktorijā *lesson_gauge_chart*, lai izveidotu jaunu klasi *Widget*. Klase *Widget* paplašinās bāzes klasi *CWidget*, lai pievienotu/pārrakstītu noklusējuma logrīka iestatījumus (šajā gadījumā - tulkojumus). Tālāk norādītais JavaScript parāda virkni "No data", ja dati nav pieejami. Virkne "No data" ir iekļauta Zabbix lietotāja saskarnes tulkojumu failos. Ja ir kādas logrīka konstantes, ieteicams tās norādīt arī klasē *Widget*. **ui/modules/lesson_gauge_chart/Widget.php** ```php <?php namespace Modules\LessonGaugeChart; use Zabbix\Core\CWidget; class Widget extends CWidget { public const UNIT_AUTO = 0; public const UNIT_STATIC = 1; public function getTranslationStrings(): array { return [ 'class.widget.js' => [ 'No data' => _('No data') ] ]; } } ``` 2. Atveriet *includes/WidgetForm.php* un pievienojiet jaunus laukus *Color* (krāsu izvēlne), *Min* (skaitlisks lauks), *Max* (skaitlisks lauks) un *Units* (izvēlne), kā arī definējiet noklusējuma krāsu paleti krāsu izvēlnei, lai to varētu izmantot nākamajās darbībās. **ui/modules/lesson_gauge_chart/includes/WidgetForm.php** ```php <?php namespace Modules\LessonGaugeChart\Includes; use Modules\LessonGaugeChart\Widget; use Zabbix\Widgets\{ CWidgetField, CWidgetForm }; use Zabbix\Widgets\Fields\{ CWidgetFieldColor, CWidgetFieldMultiSelectItem, CWidgetFieldNumericBox, CWidgetFieldSelect, CWidgetFieldTextBox }; /** * Gauge chart widget form. */ class WidgetForm extends CWidgetForm { public const DEFAULT_COLOR_PALETTE = [ 'FF465C', 'B0AF07', '0EC9AC', '524BBC', 'ED1248', 'D1E754', '2AB5FF', '385CC7', 'EC1594', 'BAE37D', '6AC8FF', 'EE2B29', '3CA20D', '6F4BBC', '00A1FF', 'F3601B', '1CAE59', '45CFDB', '894BBC', '6D6D6D' ]; public function addFields(): self { return $this ->addField( (new CWidgetFieldMultiSelectItem('itemid', _('Item'))) ->setFlags(CWidgetField::FLAG_NOT_EMPTY | CWidgetField::FLAG_LABEL_ASTERISK) ->setMultiple(false) ) ->addField( (new CWidgetFieldColor('chart_color', _('Color')))->setDefault('FF0000') ) ->addField( (new CWidgetFieldNumericBox('value_min', _('Min'))) ->setDefault(0) ->setFlags(CWidgetField::FLAG_NOT_EMPTY | CWidgetField::FLAG_LABEL_ASTERISK) ) ->addField( (new CWidgetFieldNumericBox('value_max', _('Max'))) ->setDefault(100) ->setFlags(CWidgetField::FLAG_NOT_EMPTY | CWidgetField::FLAG_LABEL_ASTERISK) ) ->addField( (new CWidgetFieldSelect('value_units', _('Units'), [ Widget::UNIT_AUTO => _x('Auto', 'history source selection method'), Widget::UNIT_STATIC => _x('Static', 'history source selection method') ]))->setDefault(Widget::UNIT_AUTO) ) ->addField( (new CWidgetFieldTextBox('value_static_units')) ) ->addField( new CWidgetFieldTextBox('description', _('Description')) ); } } ``` 3. Atveriet *views/widget.edit.php* un pievienojiet lauku vizuālos komponentus konfigurācijas skatam. **ui/modules/lesson_gauge_chart/views/widget.edit.php** ```php <?php /** * Gauge chart widget form view. * * @var CView $this * @var array $data */ $lefty_units = new CWidgetFieldSelectView($data['fields']['value_units']); $lefty_static_units = (new CWidgetFieldTextBoxView($data['fields']['value_static_units'])) ->setPlaceholder(_('value')) ->setWidth(ZBX_TEXTAREA_TINY_WIDTH); (new CWidgetFormView($data)) ->addField( (new CWidgetFieldMultiSelectItemView($data['fields']['itemid'])) ->setPopupParameter('numeric', true) ) ->addFieldset( (new CWidgetFormFieldsetCollapsibleView(_('Advanced configuration'))) ->addField( new CWidgetFieldColorView($data['fields']['chart_color']) ) ->addField( new CWidgetFieldNumericBoxView($data['fields']['value_min']) ) ->addField( new CWidgetFieldNumericBoxView($data['fields']['value_max']) ) ->addItem([ $lefty_units->getLabel(), (new CFormField([ $lefty_units->getView()->addClass(ZBX_STYLE_FORM_INPUT_MARGIN), $lefty_static_units->getView() ])) ]) ->addField( new CWidgetFieldTextBoxView($data['fields']['description']) ) ) ->show(); ``` ::: noteclassic Metode *addField()* klasē *CWidgetFormView* kā otro parametru pieņem CSS klases virkni. ::: 4. Atgriezieties informācijas panelī, pārslēdzieties rediģēšanas režīmā un noklikšķiniet uz zobrata ikonas logrīkā, lai atvērtu logrīka konfigurācijas formu. Tagad logrīka konfigurācijas forma satur jaunu izvēršamu/savēršamu sadaļu *Advanced configuration*. {width="600"} 5. Izvēršiet sadaļu *Advanced configuration*, lai redzētu papildu logrīka konfigurācijas laukus. Ņemiet vērā, ka laukam *Color* vēl nav krāsu izvēlnes. Tas ir tāpēc, ka krāsu izvēlne ir jāinicializē ar JavaScript, kas tiks pievienots nākamajā sadaļā - [*Pievienot JavaScript logrīkam*](#add-javascript-to-the-widget). {width="600"} ##### Add a new web scenario Go to *Data collection → Hosts*, pick a host and click on *Web* in the row of that host. Then click on *Create web scenario*. {width="600"} In the new scenario form, fill out the following fields: - **Name** - Frontend check - **Update interval** - 1m - **Attempts** - 1 - **Agent** - Zabbix In the *Variables* section, add two variables: *{password}* and *{user}*. Enter your existing Zabbix user credentials as values. For safety reasons, it is recommended to create a separate user with minimal permissions to use for monitoring purposes. Optionally, switch to the *Tags* tab and add web scenario tags. :::notetip Once fully configured, this web scenario will automatically add a Zabbix trapper item to the host. You can use web scenario tags to quickly identify related items and triggers or search through collected data. For example, suitable tags for this tutorial are `component: web-scenario` and/or `target: frontend`. ::: ##### Pievienot jaunu tīmekļa scenāriju Dodieties uz *Datu vākšana → Hosts*, izvēlieties hostu un šī hosta rindā noklikšķiniet uz *Web*. Pēc tam noklikšķiniet uz *Izveidot tīmekļa scenāriju*. {width="600"} Jaunā scenārija formā aizpildiet šādus laukus: - **Nosaukums** - Frontend pārbaude - **Atjaunināšanas intervāls** - 1m - **Mēģinājumi** - 1 - **Aģents** - Zabbix Sadaļā *Mainīgie* pievienojiet divus mainīgos: *{password}* un *{user}*. Kā vērtības ievadiet savus esošos Zabbix lietotāja akreditācijas datus. Drošības apsvērumu dēļ ieteicams izveidot atsevišķu lietotāju ar minimālām tiesībām, ko izmantot uzraudzības nolūkiem. Pēc izvēles pārslēdzieties uz cilni *Tagi* un pievienojiet tīmekļa scenārija tagus. :::notetip Kad konfigurācija būs pabeigta, šis tīmekļa scenārijs automātiski pievienos hostam Zabbix trapper vienumu. Varat izmantot tīmekļa scenārija tagus, lai ātri identificētu saistītos vienumus un trigerus vai meklētu savāktajos datos. Piemēram, šai pamācībai piemēroti tagi ir `component: web-scenario` un/vai `target: frontend`. ::: #### Add a proxy to a proxy group Update proxy with ID "5" and add it to proxy group with ID "1". [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "proxy.create", "params": { "proxyid": "5", "proxy_groupid": "1", "local_address": "127.0.0.1" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "proxyids": [ "5" ] }, "id": 1 } ``` #### Pievienot starpniekserveri starpniekserveru grupai Atjauniniet starpniekserveri ar ID "5" un pievienojiet to starpniekserveru grupai ar ID "1". [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "proxy.create", "params": { "proxyid": "5", "proxy_groupid": "1", "local_address": "127.0.0.1" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "proxyids": [ "5" ] }, "id": 1 } ``` ### Add a widget view :::noteclassic The widget's **view** file should be located in the *views* directory (for this tutorial, *ui/modules/lesson_gauge_chart/views/*). If the file has the default name *widget.view.php*, you do not need to register it in the *manifest.json* file. If the file has a different name, specify it in the *actions/widget.lesson_gauge_chart.view* section of the [manifest.json](/devel/modules/file_structure/manifest) file. ::: 1. Create a directory *views* in the *lesson_gauge_chart* directory. 2. Create a *widget.view.php* file in the *views* directory. **ui/modules/lesson_gauge_chart/views/widget.view.php** ```php <?php /** * Gauge chart widget view. * * @var CView $this * @var array $data */ (new CWidgetView($data)) ->addItem( new CTag('h1', true, 'Hello, world!') ) ->show(); ``` 3. Refresh the dashboard. The *Gauge chart* widget now displays "Hello, world!". {width="600"} ### Pievienojiet logrīka skatu :::noteclassic Logrīka **skata** failam jāatrodas direktorijā *views* (šajā pamācībā — *ui/modules/lesson_gauge_chart/views/*). Ja failam ir noklusējuma nosaukums *widget.view.php*, tas nav jāreģistrē failā *manifest.json*. Ja failam ir cits nosaukums, norādiet to faila [manifest.json](/devel/modules/file_structure/manifest) sadaļā *actions/widget.lesson_gauge_chart.view*. ::: 1. Izveidojiet direktoriju *views* direktorijā *lesson_gauge_chart*. 2. Izveidojiet failu *widget.view.php* direktorijā *views*. **ui/modules/lesson_gauge_chart/views/widget.view.php** ```php <?php /** * Gauge chart logrīka skats. * * @var CView $this * @var array $data */ (new CWidgetView($data)) ->addItem( new CTag('h1', true, 'Hello, world!') ) ->show(); ``` 3. Atsvaidziniet paneli. Logrīks *Gauge chart* tagad attēlo "Hello, world!". {width="600"} ### Add CSS styles to the widget In this section you will learn how to add custom CSS styles to make the widget look more appealing. 1. For widget styles, create a new directory *css* in the *assets* directory. 2. Create a *widget.css* file in the *assets/css* directory. To style widget elements, use the selector *div.dashboard-widget-{widget id}*. To configure CSS for the whole widget, use the selector *form.dashboard-widget-{widget id}* **ui/modules/lesson_gauge_chart/assets/css/widget.css** ```css div.dashboard-widget-lesson_gauge_chart { display: grid; grid-template-rows: 1fr; padding: 0; } div.dashboard-widget-lesson_gauge_chart .chart { display: grid; align-items: center; justify-items: center; } div.dashboard-widget-lesson_gauge_chart .chart canvas { background: white; } div.dashboard-widget-lesson_gauge_chart .description { padding-bottom: 8px; font-size: 1.750em; line-height: 1.2; text-align: center; } .dashboard-grid-widget-hidden-header div.dashboard-widget-lesson_gauge_chart .chart { margin-top: 8px; } ``` 3. Open *manifest.json* and add the CSS file name (*widget.css*) to the array in the *assets/css* section. This will allow the CSS styles defined in *widget.css* to load with the dashboard page. **ui/modules/lesson_gauge_chart/manifest.json** ```json { "manifest_version": 2.0, "id": "lesson_gauge_chart", "type": "widget", "name": "Gauge chart", "namespace": "LessonGaugeChart", "version": "1.0", "author": "Zabbix", "actions": { "widget.lesson_gauge_chart.view": { "class": "WidgetView" } }, "widget": { "js_class": "WidgetLessonGaugeChart" }, "assets": { "css": ["widget.css"], "js": ["class.widget.js"] } } ``` 4. Refresh the dashboard page to see the finished version of the widget. {width="600"} ### Pievienojiet logrīkam CSS stilus Šajā sadaļā jūs uzzināsiet, kā pievienot pielāgotus CSS stilus, lai logrīks izskatītos pievilcīgāk. 1. Logrīka stiliem izveidojiet jaunu direktoriju *css* direktorijā *assets*. 2. Izveidojiet failu *widget.css* direktorijā *assets/css*. Lai stilizētu logrīka elementus, izmantojiet selektoru *div.dashboard-widget-{widget id}*. Lai konfigurētu CSS visam logrīkam, izmantojiet selektoru *form.dashboard-widget-{widget id}* **ui/modules/lesson_gauge_chart/assets/css/widget.css** ```css div.dashboard-widget-lesson_gauge_chart { display: grid; grid-template-rows: 1fr; padding: 0; } div.dashboard-widget-lesson_gauge_chart .chart { display: grid; align-items: center; justify-items: center; } div.dashboard-widget-lesson_gauge_chart .chart canvas { background: white; } div.dashboard-widget-lesson_gauge_chart .description { padding-bottom: 8px; font-size: 1.750em; line-height: 1.2; text-align: center; } .dashboard-grid-widget-hidden-header div.dashboard-widget-lesson_gauge_chart .chart { margin-top: 8px; } ``` 3. Atveriet *manifest.json* un pievienojiet CSS faila nosaukumu (*widget.css*) masīvam sadaļā *assets/css*. Tas ļaus failā *widget.css* definētajiem CSS stiliem ielādēties kopā ar paneļa lapu. **ui/modules/lesson_gauge_chart/manifest.json** ```json { "manifest_version": 2.0, "id": "lesson_gauge_chart", "type": "widget", "name": "Gauge chart", "namespace": "LessonGaugeChart", "version": "1.0", "author": "Zabbix", "actions": { "widget.lesson_gauge_chart.view": { "class": "WidgetView" } }, "widget": { "js_class": "WidgetLessonGaugeChart" }, "assets": { "css": ["widget.css"], "js": ["class.widget.js"] } } ``` 4. Atsvaidziniet paneļa lapu, lai redzētu pabeigto logrīka versiju. {width="600"} #### Adding a filter to an LLD rule Add a filter so that the contents of the *{\#FSTYPE}* macro would match the *\@File systems for discovery* regexp. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "discoveryrule.update", "params": { "itemid": "22450", "filter": { "evaltype": 1, "conditions": [ { "macro": "{#FSTYPE}", "value": "@File systems for discovery" } ] } }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "22450" ] }, "id": 1 } ``` #### Filtra pievienošana LLD kārtulai Pievienojiet filtru, lai makrosa *{\#FSTYPE}* saturs atbilstu regulārajai izteiksmei *\@File systems for discovery*. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "discoveryrule.update", "params": { "itemid": "22450", "filter": { "evaltype": 1, "conditions": [ { "macro": "{#FSTYPE}", "value": "@File systems for discovery" } ] } }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "22450" ] }, "id": 1 } ``` ## Adding a module Open *Administration→General→Modules* page and press *Scan directory*.  Locate your module in the list and activate it. To activate a module, press on the *Disabled* hyperlink - the module's state will change to *Enabled*. Press on the module name to view additional information about the module, such as author, version, or short description (if defined in the manifest). ## Moduļa pievienošana Atveriet lapu *Administration→General→Modules* un nospiediet *Scan directory*.  Atrodiet savu moduli sarakstā un aktivizējiet to. Lai aktivizētu moduli, nospiediet uz hipersaites *Disabled* - moduļa statuss tiks mainīts uz *Enabled*. Nospiediet uz moduļa nosaukuma, lai skatītu papildu informāciju par moduli, piemēram, autoru, versiju vai īsu aprakstu (ja tas ir definēts manifestā). #### Adding a scheduled downtime Add a downtime for service with ID "4" scheduled weekly from Monday 22:00 till Tuesday 10:00. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "service.update", "params": { "serviceid": "4", "times": [ { "type": "1", "ts_from": "165600", "ts_to": "201600" } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "serviceids": [ "4" ] }, "id": 1 } ``` #### Plānotas dīkstāves pievienošana Pievienojiet dīkstāvi pakalpojumam ar ID "4", kas ir ieplānota katru nedēļu no pirmdienas 22:00 līdz otrdienas 10:00. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "service.update", "params": { "serviceid": "4", "times": [ { "type": "1", "ts_from": "165600", "ts_to": "201600" } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "serviceids": [ "4" ] }, "id": 1 } ``` #### Adding dashboards To add dashboards to a template in *Data collection* → *Templates*, do the following: 1. Click on *Dashboards* in the row of the template. 2. Configure a dashboard following the guidelines of [configuring dashboards](/manual/web_interface/frontend_sections/dashboards). ::: noteimportant When configuring widgets on a template dashboard (instead of a global dashboard), the host-related parameters are not available, and some parameters have a different label. This is because template dashboards display data only from the host that the template is linked to. For example, the parameters *Host groups*, *Exclude host groups* and *Hosts* in the [*Problems*](/manual/web_interface/frontend_sections/dashboards/widgets/problems) widget are not available, the parameter *Host groups* in the [*Host availability*](/manual/web_interface/frontend_sections/dashboards/widgets/host_availability) widget is not available, and the parameter *Show hosts in maintenance* is renamed to *Show data in maintenance*, etc. For more information on the availability of parameters in template dashboard widgets, see specific parameters for each [dashboard widget](/manual/web_interface/frontend_sections/dashboards/widgets). ::: ::: notetip For details on accessing host dashboards that are created from template dashboards, see the [host dashboards](/manual/web_interface/frontend_sections/monitoring/hosts/dashboards#access) section. ::: #### Paneļu pievienošana Lai pievienotu paneļus veidnei sadaļā *Datu vākšana* → *Veidnes*, rīkojieties šādi: 1. Noklikšķiniet uz *Paneļi* veidnes rindā. 2. Konfigurējiet paneli, ievērojot norādījumus par [paneļu konfigurēšanu](/manual/web_interface/frontend_sections/dashboards). ::: noteimportant Konfigurējot logrīkus veidnes panelī (nevis globālajā panelī), ar hostu saistītie parametri nav pieejami, un dažiem parametriem ir atšķirīgs nosaukums. Tas ir tāpēc, ka veidnes paneļi rāda datus tikai no hosta, ar kuru veidne ir saistīta. Piemēram, parametri *Host groups*, *Exclude host groups* un *Hosts* logrīkā [*Problems*](/manual/web_interface/frontend_sections/dashboards/widgets/problems) nav pieejami, parametrs *Host groups* logrīkā [*Host availability*](/manual/web_interface/frontend_sections/dashboards/widgets/host_availability) nav pieejams, un parametrs *Show hosts in maintenance* ir pārdēvēts par *Show data in maintenance* utt. Lai iegūtu vairāk informācijas par parametru pieejamību veidnes paneļa logrīkos, skatiet konkrētos parametrus katram [paneļa logrīkam](/manual/web_interface/frontend_sections/dashboards/widgets). ::: ::: notetip Sīkāku informāciju par piekļuvi hostu paneļiem, kas ir izveidoti no veidnes paneļiem, skatiet sadaļā [hostu paneļi](/manual/web_interface/frontend_sections/monitoring/hosts/dashboards#access). ::: #### Adding elements To add an element, click on *Add* next to `Map element`. The new element will appear at the top left corner of the map. Drag and drop it wherever you like. Note that with the Grid option "On", elements will always align to the grid (you can pick various grid sizes from the dropdown, also hide/show the grid). If you want to put elements anywhere without alignment, turn the option to "Off". (You can align random elements to the grid later, by clicking on *Align map elements*.) Now that you have some elements in place, you may want to start differentiating them by giving names, etc. By clicking on the element, a form is displayed and you can set the element type, give a name, choose a different icon, etc. {width="600"} Map element attributes: |Parameter|Description| |--|--------| |*Type*|Type of the element:<br>**Host** - icon representing status of all triggers of the selected host<br>**Map** - icon representing status of all elements of a map<br>**Trigger** - icon representing status of one or more triggers<br>**[Host group](/manual/config/visualization/maps/host_groups)** - icon representing status of all triggers of all hosts belonging to the selected group<br>**Image** - an icon, not linked to any resource| |*Label*|Icon label, any string.<br>Macros and multiline strings can be used.<br>Expression [macros](/manual/appendix/macros/supported_by_location) are supported in this field, but only with `avg`, `last`, `min` and `max` functions, with time as parameter (for example, `{?avg(/host/key,1h)}`).<br>For a full list of supported macros, see [supported macros](/manual/appendix/macros/supported_by_location) and search for 'map element labels'.| |*Label location*|Label location in relation to the icon:<br>**Default** - map's default label location<br>**Bottom** - beneath the icon<br>**Left** - to the left<br>**Right** - to the right<br>**Top** - above the icon| |*Host*|Enter the host if the element type is 'Host'. This field is auto-complete so starting to type the name of a host will offer a dropdown of matching hosts. Scroll down to select. Click on 'x' to remove the selected.| |*Map*|Select the map if the element type is 'Map'. This field is auto-complete so starting to type the name of a map will offer a dropdown of matching maps. Scroll down to select. Click on 'x' to remove the selected.| |*Triggers*|If the element type is 'Trigger', select one or more triggers in the *New triggers* field below and click on *Add*.<br>The order of selected triggers can be changed, but only within the same severity of triggers. Multiple trigger selection also affects {HOST.\*} macro resolution both in the editing and view modes.<br>In editing mode, the first displayed {HOST.\*} macros will be resolved depending on the first trigger in the list (based on trigger severity).<br>View mode depends on the [Display problems](/manual/config/visualization/maps/map#creating-a-map) parameter in General map attributes:<br>- If *Expand single problem* mode is chosen, the first displayed {HOST.\*} macros will be resolved depending on the latest detected problem trigger (not mattering the severity) or the first trigger in the list (in case no problem detected).<br>- If *Number of problems and expand most critical one* mode is chosen, the first displayed {HOST.\*} macros will be resolved depending on the trigger severity.<br>| |*Host group*|Enter the host group if the element type is 'Host group'. This field is auto-complete so starting to type the name of a group will offer a dropdown of matching groups. Scroll down to select. Click on 'x' to remove the selected.| |*Tags*|Specify tags to limit the number of problems displayed in the widget. It is possible to include as well as exclude specific tags and tag values. Several conditions can be set. Tag name matching is always case-sensitive.<br>There are several operators available for each condition:<br>**Exists** - include the specified tag names<br>**Equals** - include the specified tag names and values (case-sensitive)<br>**Contains** - include the specified tag names where the tag values contain the entered string (substring match, case-insensitive)<br>**Does not exist** - exclude the specified tag names<br>**Does not equal** - exclude the specified tag names and values (case-sensitive)<br>**Does not contain** - exclude the specified tag names where the tag values contain the entered string (substring match, case-insensitive)<br>There are two calculation types for conditions:<br>**And/Or** - all conditions must be met, conditions having the same tag name will be grouped by the Or condition<br>**Or** - enough if one condition is met<br>This field is available for host and host group element types.| |*Automatic icon selection*|In this case an icon mapping will be used to determine which icon to display.| |*Icons*|You can choose to display different icons for the element in these cases: default, problem, maintenance, disabled.| |*Coordinate X*|X coordinate of the map element.| |*Coordinate Y*|Y coordinate of the map element.| |*URLs*|Element-specific URLs (up to 2048 characters) can be set for the element. A label for the URL can also be defined. These will be displayed as links when a user clicks on the element in the map viewing mode. If the element has its own URLs and there are map level URLs for its type defined, they will be combined in the same menu.<br>Macros can be used in map element names and values. For a full list, see [supported macros](/manual/appendix/macros/supported_by_location) and search for 'map URL names and values'.| ::: noteimportant Added elements are not automatically saved. If you navigate away from the page, all changes may be lost. Therefore, it is a good idea to click on the **Update** button in the upper-right corner. Once clicked, the changes are saved regardless of what you choose in the following popup. Selected grid options are also saved with each map. ::: #### Elementu pievienošana Lai pievienotu elementu, noklikšķiniet uz *Add* blakus `Map element`. Jaunais elements parādīsies kartes augšējā kreisajā stūrī. Velciet un nometiet to jebkurā vēlamajā vietā. Ņemiet vērā, ka, ja režģa opcija ir "On", elementi vienmēr tiks izlīdzināti pēc režģa (no nolaižamā saraksta varat izvēlēties dažādus režģa izmērus, kā arī paslēpt/parādīt režģi). Ja vēlaties novietot elementus jebkur bez izlīdzināšanas, pārslēdziet opciju uz "Off". (Vēlāk varat izlīdzināt nejauši novietotus elementus pēc režģa, noklikšķinot uz *Align map elements*.) Tagad, kad jums jau ir izvietoti daži elementi, iespējams, vēlēsieties tos sākt atšķirt, piešķirot tiem nosaukumus utt. Noklikšķinot uz elementa, tiek parādīta forma, kurā varat iestatīt elementa tipu, piešķirt nosaukumu, izvēlēties citu ikonu utt. {width="600"} Kartes elementa atribūti: |Parameter|Description| |--|--------| |*Type*|Elementa tips:<br>**Host** - ikona, kas attēlo atlasītā hosts visu trigeru statusu<br>**Map** - ikona, kas attēlo kartes visu elementu statusu<br>**Trigger** - ikona, kas attēlo viena vai vairāku trigeru statusu<br>**[Host group](/manual/config/visualization/maps/host_groups)** - ikona, kas attēlo visu atlasītajai grupai piederošo hostu visu trigeru statusu<br>**Image** - ikona, kas nav saistīta ar nevienu resursu| |*Label*|Ikonas etiķete, jebkura virkne.<br>Var izmantot makro un vairākrindu virknes.<br>Šajā laukā tiek atbalstīti izteiksmes [makro](/manual/appendix/macros/supported_by_location), bet tikai ar funkcijām `avg`, `last`, `min` un `max`, izmantojot laiku kā parametru (piemēram, `{?avg(/host/key,1h)}`).<br>Pilnu atbalstīto makro sarakstu skatiet sadaļā [supported macros](/manual/appendix/macros/supported_by_location) un meklējiet "map element labels".| |*Label location*|Etiķetes novietojums attiecībā pret ikonu:<br>**Default** - kartes noklusējuma etiķetes novietojums<br>**Bottom** - zem ikonas<br>**Left** - pa kreisi<br>**Right** - pa labi<br>**Top** - virs ikonas| |*Host*|Ievadiet hostu, ja elementa tips ir 'Host'. Šis lauks piedāvā automātisko pabeigšanu, tāpēc, sākot rakstīt hosta nosaukumu, tiks parādīts nolaižamais saraksts ar atbilstošajiem hostiem. Ritiniet uz leju, lai atlasītu. Noklikšķiniet uz 'x', lai noņemtu atlasīto.| |*Map*|Atlasiet karti, ja elementa tips ir 'Map'. Šis lauks piedāvā automātisko pabeigšanu, tāpēc, sākot rakstīt kartes nosaukumu, tiks parādīts nolaižamais saraksts ar atbilstošajām kartēm. Ritiniet uz leju, lai atlasītu. Noklikšķiniet uz 'x', lai noņemtu atlasīto.| |*Triggers*|Ja elementa tips ir 'Trigger', zemāk laukā *New triggers* atlasiet vienu vai vairākus trigerus un noklikšķiniet uz *Add*.<br>Atlasīto trigeru secību var mainīt, taču tikai vienas un tās pašas trigeru nopietnības ietvaros. Vairāku trigeru atlase ietekmē arī {HOST.\*} makro atrisināšanu gan rediģēšanas, gan skatīšanas režīmā.<br>Rediģēšanas režīmā pirmais parādītais {HOST.\*} makro tiks atrisināts atkarībā no sarakstā pirmā trigera (pamatojoties uz trigera nopietnību).<br>Skatīšanas režīms ir atkarīgs no parametra [Display problems](/manual/config/visualization/maps/map#creating-a-map) sadaļā General map attributes:<br>- Ja ir izvēlēts režīms *Expand single problem*, pirmais parādītais {HOST.\*} makro tiks atrisināts atkarībā no pēdējā konstatētā problēmu trigera (neatkarīgi no nopietnības) vai sarakstā pirmā trigera (ja problēma nav konstatēta).<br>- Ja ir izvēlēts režīms *Number of problems and expand most critical one*, pirmais parādītais {HOST.\*} makro tiks atrisināts atkarībā no trigera nopietnības.<br>| |*Host group*|Ievadiet hostu grupu, ja elementa tips ir 'Host group'. Šis lauks piedāvā automātisko pabeigšanu, tāpēc, sākot rakstīt grupas nosaukumu, tiks parādīts nolaižamais saraksts ar atbilstošajām grupām. Ritiniet uz leju, lai atlasītu. Noklikšķiniet uz 'x', lai noņemtu atlasīto.| |*Tags*|Norādiet tagus, lai ierobežotu widget parādīto problēmu skaitu. Ir iespējams iekļaut, kā arī izslēgt konkrētus tagus un tagu vērtības. Var iestatīt vairākus nosacījumus. Tagu nosaukumu atbilstība vienmēr ir reģistrjutīga.<br>Katram nosacījumam ir pieejami vairāki operatori:<br>**Exists** - iekļaut norādītos tagu nosaukumus<br>**Equals** - iekļaut norādītos tagu nosaukumus un vērtības (reģistrjutīgi)<br>**Contains** - iekļaut norādītos tagu nosaukumus, kuru tagu vērtības satur ievadīto virkni (apakšvirknes atbilstība, nereģistrjutīgi)<br>**Does not exist** - izslēgt norādītos tagu nosaukumus<br>**Does not equal** - izslēgt norādītos tagu nosaukumus un vērtības (reģistrjutīgi)<br>**Does not contain** - izslēgt norādītos tagu nosaukumus, kuru tagu vērtības satur ievadīto virkni (apakšvirknes atbilstība, nereģistrjutīgi)<br>Nosacījumu aprēķināšanai ir divi tipi:<br>**And/Or** - jāizpildās visiem nosacījumiem, nosacījumi ar vienādu taga nosaukumu tiks grupēti pēc Or nosacījuma<br>**Or** - pietiek, ja izpildās viens nosacījums<br>Šis lauks ir pieejams hosta un hostu grupas elementu tipiem.| |*Automatic icon selection*|Šajā gadījumā tiks izmantota ikonu kartēšana, lai noteiktu, kuru ikonu rādīt.| |*Icons*|Varat izvēlēties rādīt dažādas ikonas elementam šādos gadījumos: default, problem, maintenance, disabled.| |*Coordinate X*|Kartes elementa X koordināta.| |*Coordinate Y*|Kartes elementa Y koordināta.| |*URLs*|Elementam var iestatīt elementam specifiskus URL (līdz 2048 rakstzīmēm). Var definēt arī URL etiķeti. Tie tiks parādīti kā saites, kad lietotājs kartes skatīšanas režīmā noklikšķinās uz elementa. Ja elementam ir savi URL un tā tipam ir definēti kartes līmeņa URL, tie tiks apvienoti vienā izvēlnē.<br>Makro var izmantot kartes elementu nosaukumos un vērtībās. Pilnu sarakstu skatiet sadaļā [supported macros](/manual/appendix/macros/supported_by_location) un meklējiet "map URL names and values".| ::: noteimportant Pievienotie elementi netiek automātiski saglabāti. Ja jūs pametat lapu, visas izmaiņas var tikt zaudētas. Tāpēc ir ieteicams noklikšķināt uz pogas **Update** augšējā labajā stūrī. Pēc noklikšķināšanas izmaiņas tiek saglabātas neatkarīgi no tā, ko jūs izvēlēsieties nākamajā uznirstošajā logā. Atlasītās režģa opcijas tiek saglabātas arī katrai kartei. ::: ##### Adding host Hosts are added during the discovery process, as soon as a host is discovered, rather than at the end of the discovery process. ::: notetip As network discovery can take some time due to many unavailable hosts/services having patience and using reasonable IP ranges is advisable. ::: When adding a host, its name is decided by the standard **gethostbyname** function. If the host can be resolved, resolved name is used. If not, the IP address is used. Besides, if IPv6 address must be used for a host name, then all ":" (colons) are replaced by "\_" (underscores), since colons are not allowed in host names. ::: noteimportant If performing discovery by a proxy, currently hostname lookup still takes place on Zabbix server. ::: ::: noteimportant If a host already exists in Zabbix configuration with the same name as a newly discovered one, Zabbix will add **\_N** to the hostname, where **N** is increasing number, starting with 2. ::: ##### Hosts pievienošana Hosts tiek pievienoti atklāšanas procesa laikā, tiklīdz hosts ir atklāts, nevis atklāšanas procesa beigās. ::: notetip Tā kā tīkla atklāšana var aizņemt kādu laiku daudzu nepieejamu hostu/pakalpojumu dēļ, ieteicams būt pacietīgiem un izmantot saprātīgus IP diapazonus. ::: Pievienojot hostu, tā nosaukumu nosaka standarta **gethostbyname** funkcija. Ja hostu var atrisināt, tiek izmantots atrisinātais nosaukums. Ja nē, tiek izmantota IP adrese. Turklāt, ja hosta nosaukumam jāizmanto IPv6 adrese, tad visas ":" (kolonas) tiek aizstātas ar "\_" (pasvītrojuma zīmēm), jo kolonas hostu nosaukumos nav atļautas. ::: noteimportant Ja atklāšana tiek veikta, izmantojot starpniekserveri, pašlaik resursdatora nosaukuma uzmeklēšana joprojām notiek Zabbix serverī. ::: ::: noteimportant Ja Zabbix konfigurācijā jau pastāv hosts ar tādu pašu nosaukumu kā jaunatklātajam hostam, Zabbix pievienos **\_N** hosta nosaukumam, kur **N** ir pieaugošs skaitlis, sākot ar 2. ::: #### Adding host Information about configured hosts in Zabbix is available in the *Data collection* > *Hosts* menu section, as well as the *Monitoring* > *Hosts* menu section. There is already one pre-defined host, called "Zabbix server", but we want to learn adding another. To add a new host, click on *Create host*. This will present us with a host configuration form.  All mandatory input fields are marked with a red asterisk. The bare minimum to enter here is: ***Host name*** - Enter a host name. Alphanumerics, spaces, dots, dashes and underscores are allowed. ***Host groups*** - Select one or several existing groups by clicking the *Select* button or enter a non-existing group name to create a new group. ::: noteclassic All access permissions are assigned to host groups, not individual hosts. That is why a host must belong to at least one group. ::: ***Interfaces: IP address*** - Although not a required field technically, a host interface is necessary for collecting certain metrics. To use Zabbix agent passive checks, specify the agent's IP or DNS in this field. Note that you should also specify Zabbix server's IP or DNS in the Zabbix agent [configuration file](/manual/appendix/config/zabbix_agentd) 'Server' directive. If Zabbix agent and Zabbix server are installed on the same machine, you need to specify the same IP/DNS in both places. [Other options](/manual/config/hosts/host#configuration) will suit us with their defaults for now. When done, click *Add*. Your new host should be visible in the host list. {width="600"} The *Availability* column contains indicators of host availability per each interface. When a Zabbix agent interface is defined, we can use the agent availability icon (labeled *ZBX*) to determine the host's availability: -  - host status has not been established; no metric check has happened yet. -  - host is available, a metric check has been successful. -  - host is unavailable, a metric check has failed (move your mouse cursor over the icon to see the error message). There might be some error with communication, possibly caused by incorrect interface credentials. Check that Zabbix server is running, and try refreshing the page later as well. #### Hosts pievienošana Informācija par konfigurētajiem hosts Zabbix ir pieejama izvēlnes sadaļās *Data collection* > *Hosts* un *Monitoring* > *Hosts*. Jau ir viens iepriekš definēts hosts ar nosaukumu "Zabbix server", taču mēs vēlamies iemācīties pievienot vēl vienu. Lai pievienotu jaunu hosts, noklikšķiniet uz *Create host*. Tiks atvērta hosts konfigurācijas forma.  Visi obligātie ievades lauki ir atzīmēti ar sarkanu zvaigznīti. Minimālais nepieciešamais ievadāmais saturs ir: ***Host name*** - Ievadiet hosts nosaukumu. Atļauti ir burti un cipari, atstarpes, punkti, domuzīmes un pasvītras. ***Host groups*** - Atlasiet vienu vai vairākas esošas grupas, noklikšķinot uz pogas *Select*, vai ievadiet neesošas grupas nosaukumu, lai izveidotu jaunu grupu. ::: noteclassic Visas piekļuves atļaujas tiek piešķirtas host grupām, nevis atsevišķiem hosts. Tāpēc hosts jābūt vismaz vienā grupā. ::: ***Interfaces: IP address*** - Lai gan tehniski tas nav obligāts lauks, hosts interfeiss ir nepieciešams noteiktu metriku vākšanai. Lai izmantotu Zabbix aģents pasīvos pārbaužu veidus, šajā laukā norādiet aģenta IP vai DNS. Ņemiet vērā, ka Zabbix aģents [konfigurācijas failā](/manual/appendix/config/zabbix_agentd) sadaļā 'Server' jānorāda arī Zabbix serveris IP vai DNS. Ja Zabbix aģents un Zabbix serveris ir instalēti vienā un tajā pašā datorā, abās vietās jānorāda viens un tas pats IP/DNS. [Other options](/manual/config/hosts/host#configuration) pagaidām mums derēs ar noklusējuma iestatījumiem. Kad esat pabeidzis, noklikšķiniet uz *Add*. Jūsu jaunajam hosts vajadzētu būt redzamam hosts sarakstā. {width="600"} Kolonnā *Availability* ir redzami katra interfeisa hosts pieejamības indikatori. Ja ir definēts Zabbix aģents interfeiss, varam izmantot aģenta pieejamības ikonu (apzīmētu ar *ZBX*), lai noteiktu hosts pieejamību: -  - hosts statuss vēl nav noteikts; metriku pārbaude vēl nav veikta. -  - hosts ir pieejams, metriku pārbaude ir veiksmīga. -  - hosts nav pieejams, metriku pārbaude ir neveiksmīga (pārvietojiet peles kursoru virs ikonas, lai redzētu kļūdas ziņojumu). Var būt radusies saziņas kļūda, iespējams, nepareizu interfeisa akreditācijas datu dēļ. Pārbaudiet, vai Zabbix serveris darbojas, un mēģiniet vēlāk atsvaidzināt lapu. #### Adding hosts to host groups Add two hosts to host groups with IDs 5 and 6. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "hostgroup.massadd", "params": { "groups": [ { "groupid": "5" }, { "groupid": "6" } ], "hosts": [ { "hostid": "30050" }, { "hostid": "30001" } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "groupids": [ "5", "6" ] }, "id": 1 } ``` #### Hostu pievienošana hostu grupām Pievienojiet divus hostus hostu grupām ar ID 5 un 6. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "hostgroup.massadd", "params": { "groups": [ { "groupid": "5" }, { "groupid": "6" } ], "hosts": [ { "hostid": "30050" }, { "hostid": "30001" } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "groupids": [ "5", "6" ] }, "id": 1 } ``` #### Adding host tags during discovery/autoregistration Additional operations are now available for discovery and autoregistration events: - Add host tags - Remove host tags #### Hostu tagu pievienošana atklāšanas/autoreģistrācijas laikā Tagad atklāšanas un autoreģistrācijas notikumiem ir pieejamas papildu darbības: - Pievienot hostu tagus - Noņemt hostu tagus #### Adding item All items are grouped around hosts. That is why to configure a sample item we go to *Data collection → Hosts* and find the "New host" we have created. Click on the *Items* link in the row of "New host", and then click on *Create item*. This will present us with an item configuration form. {width="600"} All mandatory input fields are marked with a red asterisk. For our sample item, the essential information to enter is: ***Name*** - Enter *CPU load* as the value. This will be the item name displayed in lists and elsewhere. ***Key*** - Manually enter *system.cpu.load* as the value. This is the technical name of an item that identifies the type of information that will be gathered. The particular key is just one of [pre-defined keys](/manual/config/items/itemtypes/zabbix_agent) that come with Zabbix agent. ***Type of information*** - This attribute defines the format of the expected data. For the *system.cpu.load* key, this field will be automatically set to *Numeric (float)*. ::: noteclassic You may also want to reduce the number of days [item history](/manual/config/items/history_and_trends) will be kept, to 7 or 14. This is good practice to relieve the database from keeping lots of historical values. ::: [Other options](/manual/config/items/item#configuration) will suit us with their defaults for now. When done, click *Add*. The new item should appear in the item list, and you should see a success message.  #### Vienuma pievienošana Visi vienumi ir grupēti ap hostiem. Tāpēc, lai konfigurētu parauga vienumu, mēs ejam uz *Datu vākšana → Hosts* un atrodam izveidoto "New host". Noklikšķiniet uz saites *Items* rindā "New host", un pēc tam noklikšķiniet uz *Create item*. Tiks atvērta vienuma konfigurācijas forma. {width="600"} Visi obligātie ievades lauki ir atzīmēti ar sarkanu zvaigznīti. Mūsu parauga vienumam ievadāmā būtiskā informācija ir: ***Name*** - Ievadiet vērtību *CPU load*. Tas būs vienuma nosaukums, kas tiks rādīts sarakstos un citur. ***Key*** - Manuāli ievadiet vērtību *system.cpu.load*. Tas ir vienuma tehniskais nosaukums, kas identificē informācijas veidu, kas tiks vākts. Konkrētais atslēgas nosaukums ir tikai viena no [iepriekš definētajām atslēgām](/manual/config/items/itemtypes/zabbix_agent), kas ir iekļautas Zabbix aģents. ***Type of information*** - Šis atribūts nosaka sagaidāmo datu formātu. Atslēgai *system.cpu.load* šis lauks tiks automātiski iestatīts uz *Numeric (float)*. ::: noteclassic Iespējams, vēlēsieties arī samazināt dienu skaitu, cik ilgi tiks glabāta [vienuma vēsture](/manual/config/items/history_and_trends), līdz 7 vai 14. Tā ir laba prakse, lai atvieglotu datubāzes slodzi, neglabājot lielu vēsturisko vērtību apjomu. ::: [Citām opcijām](/manual/config/items/item#configuration) pagaidām pietiks ar noklusējuma iestatījumiem. Kad esat pabeidzis, noklikšķiniet uz *Add*. Jaunajam vienumam vajadzētu parādīties vienumu sarakstā, un jums vajadzētu redzēt veiksmīgas darbības paziņojumu.  #### Adding items, triggers, graphs ::: noteimportant Items have to be added to a template first. Triggers and graphs cannot be added without the corresponding item. ::: You can add existing items to a template or [create new items](/manual/config/items/item). To add items to the template: 1. Go to *Data collection* > *Hosts* (or *Templates*). 2. Click *Items* in the row of the required host/template. 3. Mark the checkboxes of items you want to add to the template. 4. Click *Copy* below the item list. 5. Select the template (or group of templates) the items should be copied to and click *Copy*.<br> All the selected items should be copied to the template. Adding triggers and graphs is done in a similar fashion (from the list of triggers and graphs respectively), again, keeping in mind that they can only be added if the required items are added first. #### Vienumu, trigeru un grafiku pievienošana ::: noteimportant Vienumi vispirms jāpievieno veidnei. Trigerus un grafikus nevar pievienot bez atbilstošā vienuma. ::: Varat pievienot esošos vienumus veidnei vai [izveidot jaunus vienumus](/manual/config/items/item). Lai pievienotu vienumus veidnei: 1. Dodieties uz *Data collection* > *Hosts* (vai *Templates*). 2. Rindā ar nepieciešamo hostu/veidni noklikšķiniet uz *Items*. 3. Atzīmējiet to vienumu izvēles rūtiņas, kurus vēlaties pievienot veidnei. 4. Noklikšķiniet uz *Copy* zem vienumu saraksta. 5. Atlasiet veidni (vai veidņu grupu), uz kuru vienumi jākopē, un noklikšķiniet uz *Copy*.<br> Visi atlasītie vienumi ir jākopē veidnei. Trigeru un grafiku pievienošana notiek līdzīgā veidā (attiecīgi no trigeru un grafiku saraksta), atkal ņemot vērā, ka tos var pievienot tikai tad, ja vispirms ir pievienoti nepieciešamie vienumi. ##### Adding JMX agent item For each JMX counter you are interested in you add **JMX agent** item attached to that interface. The key in the screenshot below says `jmx["java.lang:type=Memory","HeapMemoryUsage.used"]`. {width="600"} All mandatory input fields are marked with a red asterisk. The fields that require specific information for JMX items are: | | | |--|--------| |*Type*|Set **JMX agent** here.| |*Key*|The `jmx[]` item key contains three parameters:<br>**object name** - the object name of an MBean<br>**attribute name** - an MBean attribute name with optional composite data field names separated by dots<br>**unique short description** - a unique description that allows multiple JMX items with the same object name and attribute name on the host (optional)<br>See below for more detail on JMX item keys.<br>You may discover MBeans and MBean attributes using a `jmx.discovery[]` [low-level discovery](/manual/discovery/low_level_discovery/examples/jmx) item.| |*JMX endpoint*|You may specify a custom JMX endpoint. Make sure that JMX endpoint connection parameters match the JMX interface. This can be achieved by using {HOST.\*} macros as done in the default JMX endpoint.<br>{HOST.\*} [macros](/manual/appendix/macros/supported_by_location) and user macros are supported.| |*User name*|Specify the user name (up to 255 characters), if you have configured authentication on your Java application.<br>User macros are supported.| |*Password*|Specify the password (up to 255 characters), if you have configured authentication on your Java application.<br>User macros are supported.| If you wish to monitor a Boolean counter that is either "true" or "false", then you specify type of information as "Numeric (unsigned)" and select "Boolean to decimal" preprocessing step in the Preprocessing tab. Server will store Boolean values as 1 or 0, respectively. ##### JMX aģenta vienuma pievienošana Katram JMX skaitītājam, kas jūs interesē, pievienojiet **JMX aģenta** vienumu, kas piesaistīts šai saskarnei. Atslēga zemāk redzamajā ekrānuzņēmumā ir `jmx["java.lang:type=Memory","HeapMemoryUsage.used"]`. {width="600"} Visi obligātie ievades lauki ir atzīmēti ar sarkanu zvaigznīti. Lauki, kuriem JMX vienumiem nepieciešama specifiska informācija, ir šādi: | | | |--|--------| |*Type*|Šeit iestatiet **JMX aģents**.| |*Key*|`jmx[]` vienuma atslēga satur trīs parametrus:<br>**objekta nosaukums** — MBean objekta nosaukums<br>**atribūta nosaukums** — MBean atribūta nosaukums ar neobligātiem salikto datu lauku nosaukumiem, kas atdalīti ar punktiem<br>**unikāls īss apraksts** — unikāls apraksts, kas ļauj hostā izmantot vairākus JMX vienumus ar vienādu objekta nosaukumu un atribūta nosaukumu (neobligāti)<br>Sīkāku informāciju par JMX vienumu atslēgām skatiet zemāk.<br>Jūs varat atklāt MBean un MBean atribūtus, izmantojot `jmx.discovery[]` [zema līmeņa atklāšanas](/manual/discovery/low_level_discovery/examples/jmx) vienumu.| |*JMX endpoint*|Varat norādīt pielāgotu JMX galapunktu. Pārliecinieties, ka JMX galapunkta savienojuma parametri atbilst JMX saskarnei. To var panākt, izmantojot {HOST.\*} makrosus, kā tas darīts noklusējuma JMX galapunktā.<br>Tiek atbalstīti {HOST.\*} [makrosi](/manual/appendix/macros/supported_by_location) un lietotāja makrosi.| |*User name*|Norādiet lietotājvārdu (līdz 255 rakstzīmēm), ja jūsu Java lietojumprogrammai ir konfigurēta autentifikācija.<br>Tiek atbalstīti lietotāja makrosi.| |*Password*|Norādiet paroli (līdz 255 rakstzīmēm), ja jūsu Java lietojumprogrammai ir konfigurēta autentifikācija.<br>Tiek atbalstīti lietotāja makrosi.| Ja vēlaties uzraudzīt Būla skaitītāju, kura vērtība ir vai nu "true", vai "false", tad norādiet informācijas tipu kā "Numeric (unsigned)" un cilnē Preprocessing atlasiet priekšapstrādes soli "Boolean to decimal". Serveris saglabās Būla vērtības attiecīgi kā 1 vai 0. #### Adding lines In addition to shapes, it is also possible to add some lines. Lines can be used to link elements or shapes in a map. To add a line, click on *Add* next to Shape. A new shape will appear at the top left corner of the map. Select it and click on *Line* in the editing form to change the shape into a line. Then adjust line properties, such as line type, width, color, etc. {width="600"} #### Līniju pievienošana Papildus formām ir iespējams pievienot arī dažas līnijas. Līnijas var izmantot, lai kartē savienotu elementus vai formas. Lai pievienotu līniju, noklikšķiniet uz *Add* blakus Shape. Kartes augšējā kreisajā stūrī parādīsies jauna forma. Atlasiet to un rediģēšanas formā noklikšķiniet uz *Line*, lai pārveidotu formu par līniju. Pēc tam pielāgojiet līnijas īpašības, piemēram, līnijas tipu, platumu, krāsu utt. {width="600"} #### Adding LLD macro paths [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "discoveryrule.update", "params": { "itemid": "22450", "lld_macro_paths": [ { "lld_macro": "{#MACRO1}", "path": "$.json.path" } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "22450" ] }, "id": 1 } ``` #### LLD makro ceļu pievienošana [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "discoveryrule.update", "params": { "itemid": "22450", "lld_macro_paths": [ { "lld_macro": "{#MACRO1}", "path": "$.json.path" } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "22450" ] }, "id": 1 } ``` #### Adding macros Add two new macros to two hosts. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "host.massadd", "params": { "hosts": [ { "hostid": "10160" }, { "hostid": "10167" } ], "macros": [ { "macro": "{$TEST1}", "value": "MACROTEST1" }, { "macro": "{$TEST2}", "value": "MACROTEST2", "description": "Test description" } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10160", "10167" ] }, "id": 1 } ``` #### Makrosu pievienošana Pievienojiet divus jaunus makrosus diviem hostiem. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "host.massadd", "params": { "hosts": [ { "hostid": "10160" }, { "hostid": "10167" } ], "macros": [ { "macro": "{$TEST1}", "value": "MACROTEST1" }, { "macro": "{$TEST2}", "value": "MACROTEST2", "description": "Testa apraksts" } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10160", "10167" ] }, "id": 1 } ``` #### Adding pages To add a new page to a dashboard: - Make sure the dashboard is in the [editing mode](#viewing-a-dashboard) - Click on the arrow next to the *Add* button and select the *Add page* option  - Fill the general page parameters and click on *Apply*. If you leave the name empty, the page will be added with a `Page N` name where 'N' is the incremental number of the page. The page display period allows to customize how long a page is displayed in a slideshow.  A new page will be added, indicated by a new tab (*Page 2*).  The pages can be reordered by dragging-and-dropping the page tabs. Reordering maintains the original page naming. It is always possible to go to each page by clicking on its tab. When a new page is added, it is empty. You can add widgets to it as described above. #### Lapu pievienošana Lai pievienotu jaunu lapu panelim: - Pārliecinieties, ka panelis ir [rediģēšanas režīmā](#viewing-a-dashboard) - Noklikšķiniet uz bultiņas blakus pogai *Add* un atlasiet opciju *Add page*  - Aizpildiet vispārīgos lapas parametrus un noklikšķiniet uz *Apply*. Ja atstāsiet nosaukumu tukšu, lapa tiks pievienota ar nosaukumu `Page N`, kur 'N' ir lapas kārtas numurs. Lapas attēlošanas periods ļauj pielāgot, cik ilgi lapa tiek rādīta slaidrādē.  Tiks pievienota jauna lapa, ko norādīs jauna cilne (*Page 2*).  Lapas var pārkārtot, velkot un nometot lapu cilnes. Pārkārtošana saglabā sākotnējo lapas nosaukumu. Vienmēr ir iespējams pāriet uz katru lapu, noklikšķinot uz tās cilnes. Kad tiek pievienota jauna lapa, tā ir tukša. Tai var pievienot logrīkus, kā aprakstīts iepriekš. ##### Adding permissions By default, a new user has no permissions to access hosts and templates. To grant the user rights, click on the group of the user in the *Groups* column (in this case - 'Zabbix administrators'). In the group properties form, go to the *Host permissions* tab to assign permissions to host groups. Click on {class="nozoom"} for the host group selection field to be displayed: {width="600"} Then click on *Select* next to the field to see the list of the host groups. This user is to have read-only access to *Linux servers* group, so mark the appropriate checkbox in the list and click on *Select* to confirm your choice. {width="600"} Click the *Read* button to set the permission level and then *Update* to save the changes made to the user group configuration. To grant permissions to templates, you will need to switch to the *Template permissions* tab and specify template groups. ::: noteimportant In Zabbix, access rights to hosts and templates are assigned to [user groups](/manual/config/users_and_usergroups/usergroup), not individual users. ::: Done! You may try to log in using the credentials of the new user. ##### Atļauju pievienošana Pēc noklusējuma jaunam lietotājam nav atļauju piekļūt hosts un veidnēm. Lai piešķirtu lietotājam tiesības, noklikšķiniet uz lietotāja grupas kolonnā *Groups* (šajā gadījumā - 'Zabbix administrators'). Grupas īpašību formā dodieties uz cilni *Host permissions*, lai piešķirtu atļaujas hostu grupām. Noklikšķiniet uz {class="nozoom"}, lai tiktu parādīts hostu grupas atlases lauks: {width="600"} Pēc tam noklikšķiniet uz *Select* blakus laukam, lai skatītu hostu grupu sarakstu. Šim lietotājam jābūt tikai lasīšanas piekļuvei grupai *Linux servers*, tāpēc atzīmējiet atbilstošo izvēles rūtiņu sarakstā un noklikšķiniet uz *Select*, lai apstiprinātu savu izvēli. {width="600"} Noklikšķiniet uz pogas *Read*, lai iestatītu atļauju līmeni, un pēc tam uz *Update*, lai saglabātu lietotāju grupas konfigurācijā veiktās izmaiņas. Lai piešķirtu atļaujas veidnēm, jums būs jāpārslēdzas uz cilni *Template permissions* un jānorāda veidņu grupas. ::: noteimportant Zabbix piekļuves tiesības hosts un veidnēm tiek piešķirtas [user groups](/manual/config/users_and_usergroups/usergroup), nevis atsevišķiem lietotājiem. ::: Gatavs! Varat mēģināt pieteikties, izmantojot jaunā lietotāja akreditācijas datus. ##### Adding proxies To configure a proxy in Zabbix frontend: - Go to: *Administration → Proxies* - Click on *Create proxy* {width="600"} |Parameter|<|Description| |-|----------|----------------------------------------| |*Proxy name*|<|Enter the proxy name. It must be the same name as in the *Hostname* parameter in the proxy configuration file.| |*Proxy group*|<|Select one proxy group for proxy [load balancing/high availability](/manual/distributed_monitoring/proxies/ha).| |*Address for active agents*|<|Enter address the monitored active agents or senders must connect to. Supported **only** for Zabbix 7.0 agents or later.<br>This address is used to connect to both active and passive proxies. This field is only available if a proxy group is selected in the *Proxy group* field.| | |*Address*|IP address/DNS name to connect to.| |^|*Port*|TCP port number (10051 by default) to connect to. User macros are supported.| |*Proxy mode*|<|Select the proxy mode.<br>**Active** - the proxy will connect to the Zabbix server and request configuration data<br>**Passive** - Zabbix server connects to the proxy<br>*Note* that without encrypted communications (sensitive) proxy configuration data may become available to parties having access to the Zabbix server trapper port when using an active proxy. This is possible because anyone may pretend to be an active proxy and request configuration data if authentication does not take place or proxy addresses are not limited in the *Proxy address* field.| |*Proxy address*|<|If specified then active proxy requests are only accepted from this list of comma-delimited IP addresses, optionally in CIDR notation, or DNS names of active Zabbix proxy.<br>This field is only available if an active proxy is selected in the *Proxy mode* field. Macros are not supported.| |*Interface*|<|Enter interface details for a passive proxy.<br>This field is only available if a passive proxy is selected in the Proxy mode field.| | |*Address*|IP address/DNS name of the passive proxy.| |^|*Port*|TCP port number of the passive proxy (10051 by default). User macros are supported.| |*Description*|<|Enter the proxy description.| The **Encryption** tab allows you to require [encrypted connections](/manual/encryption) with the proxy. |Parameter|Description| |--|--------| |*Connections to proxy*|How the server connects to the passive proxy: no encryption (default), using PSK (pre-shared key) or certificate.| |*Connections from proxy*|Select what type of connections are allowed from the active proxy. Several connection types can be selected at the same time (useful for testing and switching to other connection type). Default is "No encryption".| |*Issuer*|Allowed issuer of certificate. Certificate is first validated with CA (certificate authority). If it is valid, signed by the CA, then the *Issuer* field can be used to further restrict allowed CA. This field is optional, intended to use if your Zabbix installation uses certificates from multiple CAs.| |*Subject*|Allowed subject of certificate. Certificate is first validated with CA. If it is valid, signed by the CA, then the *Subject* field can be used to allow only one value of *Subject* string. If this field is empty then any valid certificate signed by the configured CA is accepted.| |*PSK identity*|Pre-shared key identity string.<br>Do not put sensitive information in the PSK identity, it is transmitted unencrypted over the network to inform a receiver which PSK to use.| |*PSK*|Pre-shared key (hex-string). Maximum length: 512 hex-digits (256-byte PSK) if Zabbix uses GnuTLS or OpenSSL library, 64 hex-digits (32-byte PSK) if Zabbix uses mbed TLS (PolarSSL) library. Example: 1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952| The **Timeouts** tab allows you to override [global](/manual/web_interface/frontend_sections/administration/general#timeouts) timeouts for item types that support it. {width="600"} |Parameter|Description| |--|--------| |*Timeouts for item types*|Select the timeout option:<br>**Global** - global timeout is used (displayed in the grayed out *Timeout* field for each item type);<br>**Override** - custom timeout is used (set in the *Timeout* field for each item type). Allowed range: 1 - 600s (default: inherited from [global](/manual/web_interface/frontend_sections/administration/general#timeouts) timeouts). [Time suffixes](/manual/appendix/suffixes#time-suffixes), e.g. 30s, 1m, and [user macros](/manual/config/macros/user_macros) are supported.<br><br>Clicking the *Global timeouts* link allows you to configure [global](/manual/web_interface/frontend_sections/administration/general#timeouts) timeouts. Note that the *Global timeouts* link is visible only to users of *Super admin* type with permissions to the *Administration* → [*General*](/manual/web_interface/frontend_sections/administration/general) frontend section.<br><br>Supported item types:<br>- [Zabbix agent](/manual/config/items/itemtypes/zabbix_agent) (both passive and active checks)<br>- [Simple check](/manual/config/items/itemtypes/simple_checks) (except `icmpping*`, `vmware.*` items)<br>- [SNMP agent](/manual/config/items/itemtypes/snmp) (only for SNMP `walk[OID]` and `get[OID]` items)<br>- [External check](/manual/config/items/itemtypes/external)<br>- [Database monitor](/manual/config/items/itemtypes/odbc_checks)<br>- [HTTP agent](/manual/config/items/itemtypes/http)<br>- [SSH agent](/manual/config/items/itemtypes/ssh_checks)<br>- [TELNET agent](/manual/config/items/itemtypes/telnet_checks)<br>- [Script](/manual/config/items/itemtypes/script)<br>- [Browser](/manual/config/items/itemtypes/browser)<br><br>Note that the timeouts set under **Override** will prevail over the global ones but will be overridden by individual item timeouts if those are set under [item configuration](/manual/config/items/item#configuration).| ::: noteclassic If proxy major version does not match server major version, {class="nozoom"} icon will be displayed next to *Timeouts for item types*, with the hover message "Timeouts disabled because the proxy and server versions do not match". In such cases, the proxy will use the [`Timeout`](/manual/appendix/config/zabbix_proxy#timeout) parameter from the proxy configuration file. ::: The editing form of an existing proxy has the following additional buttons: - *Refresh configuration* - refresh configuration of the proxy - *Clone* - create a new proxy based on the properties of the existing proxy - *Delete* - delete the proxy ##### Starpniekserveru pievienošana Lai konfigurētu starpniekserveri Zabbix lietotāja saskarnē: - Dodieties uz: *Administration → Proxies* - Noklikšķiniet uz *Create proxy* {width="600"} |Parameter|<|Description| |-|----------|----------------------------------------| |*Proxy name*|<|Ievadiet starpniekservera nosaukumu. Tam jābūt tādam pašam kā *Hostname* parametram starpniekservera konfigurācijas failā.| |*Proxy group*|<|Atlasiet vienu starpniekservera grupu starpniekserveru [slodzes balansēšanai/augstai pieejamībai](/manual/distributed_monitoring/proxies/ha).| |*Address for active agents*|<|Ievadiet adresi, ar kuru jāizveido savienojums uzraudzītajiem aktīvajiem aģentiem vai sūtītājiem. Atbalstīts **tikai** Zabbix 7.0 aģentiem vai jaunākiem.<br>Šī adrese tiek izmantota, lai izveidotu savienojumu gan ar aktīvajiem, gan pasīvajiem starpniekserveriem. Šis lauks ir pieejams tikai tad, ja *Proxy group* laukā ir atlasīta starpniekservera grupa.| | |*Address*|IP adrese/DNS nosaukums, ar kuru izveidot savienojumu.| |^|*Port*|TCP porta numurs (pēc noklusējuma 10051), ar kuru izveidot savienojumu. Tiek atbalstīti lietotāja makrosi.| |*Proxy mode*|<|Atlasiet starpniekservera režīmu.<br>**Active** - starpniekserveris izveidos savienojumu ar Zabbix serveri un pieprasīs konfigurācijas datus<br>**Passive** - Zabbix serveris izveido savienojumu ar starpniekserveri<br>*Piezīme*: ja netiek izmantota šifrēta saziņa, (sensitīvie) starpniekservera konfigurācijas dati var kļūt pieejami personām, kurām ir piekļuve Zabbix servera trapper portam, izmantojot aktīvo starpniekserveri. Tas ir iespējams tāpēc, ka jebkurš var uzdoties par aktīvu starpniekserveri un pieprasīt konfigurācijas datus, ja autentifikācija nenotiek vai starpniekserveru adreses nav ierobežotas laukā *Proxy address*.| |*Proxy address*|<|Ja norādīts, aktīvā starpniekservera pieprasījumi tiek pieņemti tikai no šī ar komatiem atdalīto IP adrešu saraksta, pēc izvēles CIDR notācijā, vai aktīvā Zabbix starpniekservera DNS nosaukumiem.<br>Šis lauks ir pieejams tikai tad, ja laukā *Proxy mode* ir atlasīts aktīvais starpniekserveris. Makrosi netiek atbalstīti.| |*Interface*|<|Ievadiet pasīvā starpniekservera interfeisa informāciju.<br>Šis lauks ir pieejams tikai tad, ja laukā Proxy mode ir atlasīts pasīvais starpniekserveris.| | |*Address*|Pasīvā starpniekservera IP adrese/DNS nosaukums.| |^|*Port*|Pasīvā starpniekservera TCP porta numurs (pēc noklusējuma 10051). Tiek atbalstīti lietotāja makrosi.| |*Description*|<|Ievadiet starpniekservera aprakstu.| Cilne **Encryption** ļauj pieprasīt [šifrētus savienojumus](/manual/encryption) ar starpniekserveri. |Parameter|Description| |--|--------| |*Connections to proxy*|Kā serveris izveido savienojumu ar pasīvo starpniekserveri: bez šifrēšanas (noklusējums), izmantojot PSK (iepriekš koplietotu atslēgu) vai sertifikātu.| |*Connections from proxy*|Atlasiet, kāda veida savienojumi ir atļauti no aktīvā starpniekservera. Vienlaikus var atlasīt vairākus savienojumu veidus (noderīgi testēšanai un pārslēgšanai uz citu savienojuma veidu). Noklusējums ir "No encryption".| |*Issuer*|Atļautais sertifikāta izdevējs. Sertifikāts vispirms tiek validēts ar CA (sertifikātu centru). Ja tas ir derīgs un parakstīts ar CA, tad lauku *Issuer* var izmantot, lai papildus ierobežotu atļauto CA. Šis lauks nav obligāts un paredzēts izmantošanai, ja jūsu Zabbix instalācijā tiek izmantoti vairāku CA sertifikāti.| |*Subject*|Atļautais sertifikāta subjekts. Sertifikāts vispirms tiek validēts ar CA. Ja tas ir derīgs un parakstīts ar CA, tad lauku *Subject* var izmantot, lai atļautu tikai vienu *Subject* virknes vērtību. Ja šis lauks ir tukšs, tiek pieņemts jebkurš derīgs sertifikāts, ko parakstījis konfigurētais CA.| |*PSK identity*|Iepriekš koplietotās atslēgas identitātes virkne.<br>Nevietojiet sensitīvu informāciju PSK identitātē, jo tā tiek pārsūtīta tīklā nešifrētā veidā, lai saņēmējam norādītu, kuru PSK izmantot.| |*PSK*|Iepriekš koplietotā atslēga (heksadecimāla virkne). Maksimālais garums: 512 heksadecimālie cipari (256 baitu PSK), ja Zabbix izmanto GnuTLS vai OpenSSL bibliotēku, 64 heksadecimālie cipari (32 baitu PSK), ja Zabbix izmanto mbed TLS (PolarSSL) bibliotēku. Piemērs: 1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952| Cilne **Timeouts** ļauj pārrakstīt [globālos](/manual/web_interface/frontend_sections/administration/general#timeouts) noildzes laikus vienumu tipiem, kas to atbalsta. {width="600"} |Parameter|Description| |--|--------| |*Timeouts for item types*|Atlasiet noildzes opciju:<br>**Global** - tiek izmantots globālais noildzes laiks (katram vienuma tipam tas tiek parādīts pelēkajā laukā *Timeout*);<br>**Override** - tiek izmantots pielāgots noildzes laiks (iestatīts laukā *Timeout* katram vienuma tipam). Atļautais diapazons: 1 - 600s (noklusējums: mantots no [globālajiem](/manual/web_interface/frontend_sections/administration/general#timeouts) noildzes laikiem). Tiek atbalstīti [laika sufiksi](/manual/appendix/suffixes#time-suffixes), piemēram, 30s, 1m, un [lietotāja makrosi](/manual/config/macros/user_macros).<br><br>Noklikšķinot uz saites *Global timeouts*, varat konfigurēt [globālos](/manual/web_interface/frontend_sections/administration/general#timeouts) noildzes laikus. Ņemiet vērā, ka saite *Global timeouts* ir redzama tikai lietotājiem ar *Super admin* tipu un tiesībām uz *Administration* → [*General*](/manual/web_interface/frontend_sections/administration/general) lietotāja saskarnes sadaļu.<br><br>Atbalstītie vienumu tipi:<br>- [Zabbix agent](/manual/config/items/itemtypes/zabbix_agent) (gan pasīvās, gan aktīvās pārbaudes)<br>- [Simple check](/manual/config/items/itemtypes/simple_checks) (izņemot `icmpping*`, `vmware.*` vienumus)<br>- [SNMP agent](/manual/config/items/itemtypes/snmp) (tikai SNMP `walk[OID]` un `get[OID]` vienumiem)<br>- [External check](/manual/config/items/itemtypes/external)<br>- [Database monitor](/manual/config/items/itemtypes/odbc_checks)<br>- [HTTP agent](/manual/config/items/itemtypes/http)<br>- [SSH agent](/manual/config/items/itemtypes/ssh_checks)<br>- [TELNET agent](/manual/config/items/itemtypes/telnet_checks)<br>- [Script](/manual/config/items/itemtypes/script)<br>- [Browser](/manual/config/items/itemtypes/browser)<br><br>Ņemiet vērā, ka noildzes laiki, kas iestatīti sadaļā **Override**, būs prioritāri pār globālajiem, taču tos var pārrakstīt atsevišķi vienuma noildzes laiki, ja tie ir iestatīti [vienuma konfigurācijā](/manual/config/items/item#configuration).| ::: noteclassic Ja starpniekservera galvenā versija neatbilst servera galvenajai versijai, blakus *Timeouts for item types* tiks parādīta {class="nozoom"} ikona ar uznirstošo ziņojumu "Timeouts disabled because the proxy and server versions do not match". Šādos gadījumos starpniekserveris izmantos [`Timeout`](/manual/appendix/config/zabbix_proxy#timeout) parametru no starpniekservera konfigurācijas faila. ::: Esoša starpniekservera rediģēšanas formā ir pieejamas šādas papildu pogas: - *Refresh configuration* - atsvaidzināt starpniekservera konfigurāciju - *Clone* - izveidot jaunu starpniekserveri, pamatojoties uz esošā starpniekservera īpašībām - *Delete* - dzēst starpniekserveri #### Adding shapes In addition to map elements, it is also possible to add some shapes. Shapes are not map elements; they are just a visual representation. For example, a rectangle shape can be used as a background to group some hosts. Rectangle and ellipse shapes can be added. To add a shape, click on *Add* next to Shape. The new shape will appear at the top left corner of the map. Drag and drop it wherever you like. A new shape is added with default colors. By clicking on the shape, a form is displayed and you can customize the way a shape looks, add text, etc. {width="600"} To select shapes, select one and then hold down *Ctrl* to select the others. With several shapes selected, common properties can be mass updated, similarly as with elements. Text can be added in the shapes. Expression [macros](/manual/appendix/macros/supported_by_location) are supported in the text, but only with `avg`, `last`, `min` and `max` functions, with time as parameter (for example, `{?avg(/host/key,1h)}`). To display text only, the shape can be made invisible by removing the shape border (select 'None' in the *Border* field). For example, take note of how the {MAP.NAME} macro, visible in the screenshot above, is actually a rectangle shape with text, which can be seen when clicking on the macro:  {MAP.NAME} resolves to the configured map name when viewing the map. If hyperlinks are used in the text, they become clickable when viewing the map. Line wrapping for text is always "on" within shapes. However, within an ellipse, the lines are wrapped as though the ellipse were a rectangle. Word wrapping is not implemented, so long words (words that do not fit the shape) are not wrapped, but are masked (on map editing page) or clipped (other pages with maps). #### Formu pievienošana Papildus kartes elementiem ir iespējams pievienot arī dažādas formas. Formas nav kartes elementi; tās ir tikai vizuāls attēlojums. Piemēram, taisnstūra forma var tikt izmantota kā fons, lai grupētu dažus hosts. Var pievienot taisnstūra un elipses formas. Lai pievienotu formu, noklikšķiniet uz *Add* blakus Shape. Jaunā forma parādīsies kartes augšējā kreisajā stūrī. Velciet un nometiet to jebkurā vietā. Jauna forma tiek pievienota ar noklusējuma krāsām. Noklikšķinot uz formas, tiek parādīta forma, kurā varat pielāgot formas izskatu, pievienot tekstu utt. {width="600"} Lai atlasītu formas, atlasiet vienu un pēc tam turiet nospiestu *Ctrl*, lai atlasītu pārējās. Ja ir atlasītas vairākas formas, kopīgās īpašības var masveidā atjaunināt līdzīgi kā elementiem. Formās var pievienot tekstu. Tekstā tiek atbalstīti izteiksmes [makrosi](/manual/appendix/macros/supported_by_location), taču tikai ar funkcijām `avg`, `last`, `min` un `max`, izmantojot laiku kā parametru (piemēram, `{?avg(/host/key,1h)}`). Lai attēlotu tikai tekstu, formu var padarīt neredzamu, noņemot formas apmali (laukam *Border* izvēloties 'None'). Piemēram, pievērsiet uzmanību tam, ka {MAP.NAME} makross, kas redzams iepriekš redzamajā ekrānuzņēmumā, patiesībā ir taisnstūra forma ar tekstu, ko var redzēt, noklikšķinot uz makrosa:  {MAP.NAME} kartes skatīšanas laikā tiek aizstāts ar konfigurēto kartes nosaukumu. Ja tekstā tiek izmantotas hipersaites, tās kartes skatīšanas laikā kļūst klikšķināmas. Teksta rindkopu pārnešana formas iekšpusē vienmēr ir ieslēgta. Tomēr elipses iekšpusē rindas tiek pārnestas tā, it kā elipse būtu taisnstūris. Vārdu pārnešana nav ieviesta, tāpēc gari vārdi (vārdi, kas neietilpst formā) netiek pārnesti, bet tiek maskēti (kartes rediģēšanas lapā) vai apgriezti (citās lapās ar kartēm). #### Adding templates to template groups Add two templates to template groups with IDs 12 and 13. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "templategroup.massadd", "params": { "groups": [ { "groupid": "12" }, { "groupid": "13" } ], "templates": [ { "templateid": "10486" }, { "templateid": "10487" } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "groupids": [ "12", "13" ] }, "id": 1 } ``` #### Veidņu pievienošana veidņu grupām Pievienojiet divas veidnes veidņu grupām ar ID 12 un 13. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "templategroup.massadd", "params": { "groups": [ { "groupid": "12" }, { "groupid": "13" } ], "templates": [ { "templateid": "10486" }, { "templateid": "10487" } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "groupids": [ "12", "13" ] }, "id": 1 } ``` # Adding users # Lietotāju pievienošana ## Adding users to nodes To add the user to the node: 1. Go to the *Nodes* tab. 2. Click *Grant Access*. 3. Select a user [added to the organization](#adding-users-to-organizations) from the dropdown. 4. Click *Grant access*. {width="600"} Alternatively, you can grant access from the [*Node configuration*](/cloud/node_configuration) window: 1. Click the {width="30"} settings button. 2. Select *Add user*. 3. Choose a user and click *Grant access*. Invited users must accept the invitation by creating a Zabbix Cloud account using the same email address where the invitation was sent. If the user already has a Zabbix Cloud account under that email, they must sign in and confirm the invitation. Invitations are tied to a specific email address and cannot be accepted from a different account. ## Lietotāju pievienošana mezgliem Lai pievienotu lietotāju mezglam: 1. Atveriet cilni *Mezgli*. 2. Noklikšķiniet uz *Piešķirt piekļuvi*. 3. Nolaižamajā sarakstā atlasiet lietotāju, kas [pievienots organizācijai](#adding-users-to-organizations). 4. Noklikšķiniet uz *Piešķirt piekļuvi*. {width="600"} Alternatīvi, piekļuvi var piešķirt logā [*Mezgla konfigurācija*](/cloud/node_configuration): 1. Noklikšķiniet uz iestatījumu pogas {width="30"}. 2. Atlasiet *Pievienot lietotāju*. 3. Izvēlieties lietotāju un noklikšķiniet uz *Piešķirt piekļuvi*. Uzaicinātajiem lietotājiem ir jāpieņem uzaicinājums, izveidojot Zabbix Cloud kontu ar to pašu e-pasta adresi, uz kuru tika nosūtīts uzaicinājums. Ja lietotājam jau ir Zabbix Cloud konts ar šo e-pasta adresi, viņam jāpierakstās un jāapstiprina uzaicinājums. Uzaicinājumi ir piesaistīti konkrētai e-pasta adresei, un tos nevar pieņemt no cita konta. ## Adding users to organizations Similar to [users](/manual/config/users_and_usergroups) in Zabbix, you can create users in Zabbix Cloud and assign them roles to control what they can do within an organization and its nodes. To add users to your organization: 1\. Open the *All organizations* page. 2\. Click the {width="30"} settings button of the particular organization to enter its management menu. {width="600"} 3\. In the *Users* or *Admins* tab, click *Add new user*. 4\. Enter the user's email and select a role: *Administrator* or *User*. Note that selecting the *User* role adds the user to the organization, but does not [grant access](#adding-users-to-nodes) to any nodes. Each role grants a different level of access: - **User** - can access nodes they're assigned to and can perform configuration tasks that do not generate charges, for example: - Manage [access filters](/cloud/node_configuration#access-filters-tab) - Configure [encryption](/cloud/node_configuration#encryption-tab) - Set [history/trend](/cloud/node_configuration#history-tab) retention periods - Schedule [maintenance](/cloud/node_configuration#maintenance-tab) - **Administrator** - has all User permissions and can also perform actions that may generate charges, for example: - Create and restore [backups](/cloud/node_configuration#backups-tab) - [Upgrade or downgrade](/cloud/node_configuration#upgrade-tab) node resources (compute tier and disk size) - Cancel subscriptions - **Owner** - has full control over the organization. In addition to all Administrator permissions, the Owner can: - [Create and destroy](/cloud/node_configuration) nodes - Add or remove Users and Administrators - Rename or delete the organization - Manage billing details ::: noteimportant The Owner's payment method is charged for all services. If bank confirmation is required, the Owner must authorize the transaction, even if it was initiated by an Administrator. ::: The invited user will be added with a *Pending* status. You can revoke the invite or resend it (resending is available once every 10 minutes—the button will be disabled if this limit is reached). {width="600"} ## Lietotāju pievienošana organizācijām Līdzīgi kā [lietotāji](/manual/config/users_and_usergroups) Zabbix vidē, jūs varat izveidot lietotājus Zabbix Cloud un piešķirt tiem lomas, lai kontrolētu, ko viņi var darīt organizācijā un tās mezglos. Lai pievienotu lietotājus savai organizācijai: 1\. Atveriet lapu *All organizations*. 2\. Noklikšķiniet uz konkrētās organizācijas iestatījumu pogas {width="30"}, lai atvērtu tās pārvaldības izvēlni. {width="600"} 3\. Cilnē *Users* vai *Admins* noklikšķiniet uz *Add new user*. 4\. Ievadiet lietotāja e-pasta adresi un izvēlieties lomu: *Administrator* vai *User*. Ņemiet vērā, ka, izvēloties lomu *User*, lietotājs tiek pievienots organizācijai, taču viņam netiek [piešķirta piekļuve](#adding-users-to-nodes) nevienam mezglam. Katra loma piešķir atšķirīgu piekļuves līmeni: - **User** — var piekļūt mezgliem, kuriem tas ir piešķirts, un var veikt konfigurēšanas uzdevumus, kas nerada papildu izmaksas, piemēram: - Pārvaldīt [piekļuves filtrus](/cloud/node_configuration#access-filters-tab) - Konfigurēt [šifrēšanu](/cloud/node_configuration#encryption-tab) - Iestatīt [vēstures/tendenču](/cloud/node_configuration#history-tab) glabāšanas periodus - Plānot [apkopes](/cloud/node_configuration#maintenance-tab) - **Administrator** — ir visas User atļaujas un var arī veikt darbības, kas var radīt papildu izmaksas, piemēram: - Izveidot un atjaunot [rezerves kopijas](/cloud/node_configuration#backups-tab) - [Palielināt vai samazināt](/cloud/node_configuration#upgrade-tab) mezgla resursus (skaitļošanas līmeni un diska izmēru) - Atcelt abonementus - **Owner** — ir pilnīga kontrole pār organizāciju. Papildus visām Administrator atļaujām Owner var: - [Izveidot un dzēst](/cloud/node_configuration) mezglus - Pievienot vai noņemt Users un Administrators - Pārdēvēt vai dzēst organizāciju - Pārvaldīt norēķinu informāciju ::: noteimportant Par visiem pakalpojumiem maksa tiek iekasēta no Owner maksājuma metodes. Ja ir nepieciešams bankas apstiprinājums, Owner ir jāautorizē darījums, pat ja to ir iniciējis Administrator. ::: Uzaicinātais lietotājs tiks pievienots ar statusu *Pending*. Jūs varat atsaukt uzaicinājumu vai nosūtīt to atkārtoti (atkārtota nosūtīšana ir pieejama reizi 10 minūtēs — poga būs atspējota, ja šis ierobežojums būs sasniegts). {width="600"} #### Adding user To view information about users, go to *Users → Users*. {width="600"} To add a new user, click on *Create user*. In the new user form, make sure to add your user to one of the existing [user groups](/manual/config/users_and_usergroups/usergroup), for example 'Zabbix administrators'.  All mandatory input fields are marked with a red asterisk. By default, new users have no media (notification delivery methods) defined for them. To create one, go to the 'Media' tab and click on *Add*.  In this pop-up, enter an email address for the user. You can specify a time period when the medium will be active (see [Time period specification](/manual/appendix/time_period) page for a description of the format), by default a medium is always active. You can also customize [trigger severity](/manual/config/triggers/severity) levels for which the medium will be active, but leave all of them enabled for now. Click on *Add* to save the medium, then go to the Permissions tab. Permissions tab has a mandatory field *Role*. The role determines which frontend elements the user can view and which actions he is allowed to perform. Press Select and select one of the roles from the list. For example, select *Admin role* to allow access to all Zabbix frontend sections, except Administration. Later on, you can modify permissions or create more user roles. Upon selecting a role, permissions will appear in the same tab: {width="600"} Click *Add* in the user properties form to save the user. The new user appears in the userlist. {width="600"} #### Lietotāja pievienošana Lai skatītu informāciju par lietotājiem, dodieties uz *Users → Users*. {width="600"} Lai pievienotu jaunu lietotāju, noklikšķiniet uz *Create user*. Jaunā lietotāja formā noteikti pievienojiet lietotāju vienai no esošajām [user groups](/manual/config/users_and_usergroups/usergroup), piemēram, 'Zabbix administrators'.  Visi obligātie ievades lauki ir atzīmēti ar sarkanu zvaigznīti. Pēc noklusējuma jauniem lietotājiem nav definēti mediji (paziņojumu piegādes metodes). Lai izveidotu mediju, dodieties uz cilni 'Media' un noklikšķiniet uz *Add*.  Šajā uznirstošajā logā ievadiet lietotāja e-pasta adresi. Varat norādīt laika periodu, kad medijs būs aktīvs (formāta aprakstu skatiet lapā [Time period specification](/manual/appendix/time_period)); pēc noklusējuma medijs vienmēr ir aktīvs. Varat arī pielāgot [trigger severity](/manual/config/triggers/severity) līmeņus, kuriem medijs būs aktīvs, taču pagaidām atstājiet visus iespējotus. Noklikšķiniet uz *Add*, lai saglabātu mediju, pēc tam dodieties uz cilni Permissions. Cilnē Permissions ir obligāts lauks *Role*. Loma nosaka, kurus lietotāja saskarnes elementus lietotājs var skatīt un kādas darbības viņam ir atļauts veikt. Nospiediet Select un izvēlieties vienu no lomām sarakstā. Piemēram, izvēlieties *Admin role*, lai atļautu piekļuvi visām Zabbix lietotāja saskarnes sadaļām, izņemot Administration. Vēlāk varēsiet mainīt atļaujas vai izveidot papildu lietotāju lomas. Pēc lomas izvēles atļaujas parādīsies tajā pašā cilnē: {width="600"} Noklikšķiniet uz *Add* lietotāja īpašību formā, lai saglabātu lietotāju. Jaunais lietotājs parādīsies lietotāju sarakstā. {width="600"} #### Adding web scenarios To add web scenarios to a template in *Data collection* → *Templates*, do the following: 1. Click on *Web* in the row of the template. 2. Configure a web scenario following the usual method of [configuring web scenarios](/manual/web_monitoring#configuring-a-web-scenario). #### Tīmekļa scenāriju pievienošana Lai pievienotu tīmekļa scenārijus veidnei sadaļā *Data collection* → *Templates*, rīkojieties šādi: 1. Noklikšķiniet uz *Web* veidnes rindā. 2. Konfigurējiet tīmekļa scenāriju, ievērojot parasto [tīmekļa scenāriju konfigurēšanas](/manual/web_monitoring#configuring-a-web-scenario) metodi. #### Adding widgets You can add various [widgets](/manual/web_interface/frontend_sections/dashboards/widgets) (Action log, Clock, Discovery status, etc.) to a dashboard. Widgets can be added in two ways: - Click the *Add* button or the arrow next to it, then select *Add widget* from the action menu. After configuring the widget, it will be added in its default size and placed after any existing widget.  - Move the mouse to an empty spot on the dashboard. Notice a placeholder appear, then click on it to open the widget configuration form. After configuring the widget, it will be added in its default size or resized to fit the available space. Alternatively, drag the placeholder to determine the widget size and release it to open the widget configuration form (if a widget is [copied](#copyingpasting-widgets) to the clipboard, you will first be prompted to choose between *Add widget* or *Paste widget*). | | | |-|-| ||| In the widget configuration form: 1. Select the widget type. 2. Configure widget parameters. 3. Click *Add* to add the widget to the dashboard. {width="600"} #### Editing widgets Each widget includes controls in its upper-right corner: -  - edit the widget -  - open the [widget menu](#widget-menu) After editing, click *Apply* in the widget, then *Save changes* in the upper-right corner of the dashboard to apply your changes. #### Pievienojot logrīkus Jūs varat pievienot dažādus [logrīkus](/manual/web_interface/frontend_sections/dashboards/widgets) (Action log, Clock, Discovery status u.c.) informācijas panelim. Logrīkus var pievienot divos veidos: - Noklikšķiniet uz pogas *Add* vai uz bultiņas blakus tai, pēc tam darbību izvēlnē atlasiet *Add widget*. Pēc logrīka konfigurēšanas tas tiks pievienots ar noklusējuma izmēru un novietots aiz jebkura esoša logrīka.  - Pārvietojiet peli uz tukšu vietu informācijas panelī. Pamanīsiet, ka parādās vietturis, pēc tam noklikšķiniet uz tā, lai atvērtu logrīka konfigurācijas formu. Pēc logrīka konfigurēšanas tas tiks pievienots ar noklusējuma izmēru vai mainīts tā izmērs, lai tas ietilptu pieejamajā vietā. Alternatīvi, velciet vietturi, lai noteiktu logrīka izmēru, un atlaidiet to, lai atvērtu logrīka konfigurācijas formu (ja logrīks ir [kopēts](#copyingpasting-widgets) starpliktuvē, vispirms tiks piedāvāts izvēlēties starp *Add widget* vai *Paste widget*). | | | |-|-| ||| Logrīka konfigurācijas formā: 1. Atlasiet logrīka tipu. 2. Konfigurējiet logrīka parametrus. 3. Noklikšķiniet uz *Add*, lai pievienotu logrīku informācijas panelim. {width="600"} #### Logrīku rediģēšana Katram logrīkam augšējā labajā stūrī ir vadīklas: -  - rediģēt logrīku -  - atvērt [logrīka izvēlni](#widget-menu) Pēc rediģēšanas noklikšķiniet uz *Apply* logrīkā, pēc tam uz *Save changes* informācijas paneļa augšējā labajā stūrī, lai piemērotu izmaiņas. #### Additional examples The table below shows more examples of using macro functions. :::noteinfo `{#IFALIAS}` is an [LLD macros](/manual/config/macros/lld_macros) and is only defined in low-level discovery contexts (discovery rules, prototypes and the items/triggers created from them). Using it outside LLD will leave the token unexpanded. ::: |Macro function|Received value|Output| |-------------|----|-------------| |`{{ITEM.VALUE}.regsub(^[0-9]+, Problem)}`|`123Log line`|`Problem`| |`{{ITEM.VALUE}.regsub("^([0-9]+)", "Problem")}`|`123 Log line`|`Problem`| |`{{ITEM.VALUE}.regsub(".*", "Problem ID: \1")}`|`Log line`|`Problem ID: `| |`{{ITEM.VALUE}.regsub("^(\w+).*?([0-9]+)", " Problem ID: \1_\2 ")}`|`MySQL crashed errno 123`|` Problem ID: MySQL_123 `| |`{{ITEM.VALUE}.regsub("([1-9]+", "Problem ID: \1")}`|`123 Log line`|`*UNKNOWN*` (invalid regular expression)| |`{{#IFALIAS}.regsub("(.*)_([0-9]+)", \1)}`|`customername_1`|`customername`| |`{{#IFALIAS}.regsub("(.*)_([0-9]+)", \2)}`|`customername_1`|`1`| |`{{#IFALIAS}.regsub("(.*)_([0-9]+", \1)}`|`customername_1`|`{{#IFALIAS}.regsub("(.*)_([0-9]+", \1)}` (invalid regular expression)| |`{$MACRO:"{{#IFALIAS}.regsub(\"(.*)_([0-9]+)\", \1)}"}`|`customername_1`|`{$MACRO:"customername"}`| |`{$MACRO:"{{#IFALIAS}.regsub(\"(.*)_([0-9]+)\", \2)}"}`|`customername_1`|`{$MACRO:"1"}`| |`{$MACRO:"{{#IFALIAS}.regsub(\"(.*)_([0-9]+\", \1)}"}`|`customername_1`|`{$MACRO:"{{#IFALIAS}.regsub(\"(.*)_([0-9]+\", \1)}"}` (invalid regular expression)| |`"{$MACRO:"\{{#IFALIAS}.regsub("(.*)_([0-9]+)", \1)}\"}"`|`customername_1`|`"{$MACRO:"\customername\"}"`| |`"{$MACRO:"\{{#IFALIAS}.regsub("(.*)_([0-9]+)", \2)}\"}"`|`customername_1`|`"{$MACRO:"\1\"}"`| |`"{$MACRO:\"{{#IFALIAS}.regsub(\\"(.*)_([0-9]+\\", \1)}\"}"`|`customername_1`|`"{$MACRO:\"{{#IFALIAS}.regsub(\\"(.*)_([0-9]+\\", \1)}\"}"` (invalid regular expression)| ##### Seeing full item values Long values of resolved {ITEM.VALUE} and {ITEM.LASTVALUE} macros for text/log items are truncated to 20 characters in some frontend locations. To see the full values of these macros you may use macro functions, e.g.: ```default {{ITEM.VALUE}.regsub("(.*)", \1)} {{ITEM.LASTVALUE}.regsub("(.*)", \1)} ``` See also: {ITEM.VALUE} and {ITEM.LASTVALUE} [macro details](/manual/appendix/macros/supported_by_location). #### Papildu piemēri Tālāk esošajā tabulā ir parādīti vēl vairāki makro funkciju lietošanas piemēri. :::noteinfo `{#IFALIAS}` ir [LLD makro](/manual/config/macros/lld_macros) un ir definēts tikai zema līmeņa atklāšanas kontekstos (atklāšanas noteikumos, prototipos un no tiem izveidotajos vienumos/trigeros). Ja to izmantosiet ārpus LLD, tokens netiks izvērsts. ::: |Makro funkcija|Saņemtā vērtība|Izvade| |-------------|----|-------------| |`{{ITEM.VALUE}.regsub(^[0-9]+, Problem)}`|`123Log line`|`Problem`| |`{{ITEM.VALUE}.regsub("^([0-9]+)", "Problem")}`|`123 Log line`|`Problem`| |`{{ITEM.VALUE}.regsub(".*", "Problem ID: \1")}`|`Log line`|`Problem ID: `| |`{{ITEM.VALUE}.regsub("^(\w+).*?([0-9]+)", " Problem ID: \1_\2 ")}`|`MySQL crashed errno 123`|` Problem ID: MySQL_123 `| |`{{ITEM.VALUE}.regsub("([1-9]+", "Problem ID: \1")}`|`123 Log line`|`*UNKNOWN*` (nederīga regulārā izteiksme)| |`{{#IFALIAS}.regsub("(.*)_([0-9]+)", \1)}`|`customername_1`|`customername`| |`{{#IFALIAS}.regsub("(.*)_([0-9]+)", \2)}`|`customername_1`|`1`| |`{{#IFALIAS}.regsub("(.*)_([0-9]+", \1)}`|`customername_1`|`{{#IFALIAS}.regsub("(.*)_([0-9]+", \1)}` (nederīga regulārā izteiksme)| |`{$MACRO:"{{#IFALIAS}.regsub(\"(.*)_([0-9]+)\", \1)}"}`|`customername_1`|`{$MACRO:"customername"}`| |`{$MACRO:"{{#IFALIAS}.regsub(\"(.*)_([0-9]+)\", \2)}"}`|`customername_1`|`{$MACRO:"1"}`| |`{$MACRO:"{{#IFALIAS}.regsub(\"(.*)_([0-9]+\", \1)}"}`|`customername_1`|`{$MACRO:"{{#IFALIAS}.regsub(\"(.*)_([0-9]+\", \1)}"}` (nederīga regulārā izteiksme)| |`"{$MACRO:"\{{#IFALIAS}.regsub("(.*)_([0-9]+)", \1)}\"}"`|`customername_1`|`"{$MACRO:"\customername\"}"`| |`"{$MACRO:"\{{#IFALIAS}.regsub("(.*)_([0-9]+)", \2)}\"}"`|`customername_1`|`"{$MACRO:"\1\"}"`| |`"{$MACRO:\"{{#IFALIAS}.regsub(\\"(.*)_([0-9]+\\", \1)}\"}"`|`customername_1`|`"{$MACRO:\"{{#IFALIAS}.regsub(\\"(.*)_([0-9]+\\", \1)}\"}"` (nederīga regulārā izteiksme)| ##### Pilnu vienuma vērtību skatīšana Atrisināto {ITEM.VALUE} un {ITEM.LASTVALUE} makro garās vērtības teksta/žurnāla vienumiem dažās lietotāja saskarnes vietās tiek saīsinātas līdz 20 rakstzīmēm. Lai redzētu šo makro pilnās vērtības, varat izmantot makro funkcijas, piemēram: ```default {{ITEM.VALUE}.regsub("(.*)", \1)} {{ITEM.LASTVALUE}.regsub("(.*)", \1)} ``` Skatiet arī: {ITEM.VALUE} un {ITEM.LASTVALUE} [makro detaļas](/manual/appendix/macros/supported_by_location). #### Additional parameters **bucket\_rate\_foreach** A third optional parameter is supported by the `bucket_rate_foreach` function: ```default bucket_rate_foreach(item filter,time period,<parameter number>) ``` where `<parameter number>` is the position of the "bucket" value in the item key. For example, if the "bucket" value in `myItem[aaa,0.2]` is `0.2`, then its position is 2. The default value of <parameter number> is `1`. **count\_foreach** Third and fourth optional parameters are supported by the `count_foreach` function: ```default count_foreach(item filter,time period,<operator>,<pattern>) ``` Where: - **operator** is the conditional operator for item values (must be double-quoted). Supported `operators`:<br>*eq* - equal<br>*ne* - not equal<br>*gt* - greater<br>*ge* - greater or equal<br>*lt* - less<br>*le* - less or equal<br>*like* - matches if contains pattern (case-sensitive)<br>*bitand* - bitwise AND<br>*regexp* - case-sensitive match of the regular expression given in `pattern`<br>*iregexp* - case-insensitive match of the regular expression given in `pattern`.<br> - **pattern** is the required pattern (string arguments must be double-quoted); supported if *operator* is specified in the third parameter. Comments: - Optional parameters *operator* or *pattern* can't be left empty after a comma, only fully omitted. - With *bitand* as the third parameter, the fourth `pattern` parameter can be specified as two numbers, separated by '/': **number_to_compare_with/mask**. `count_foreach()` calculates "bitwise AND" from the value and the *mask* and compares the result to *number_to_compare_with*. If the result of "bitwise AND" is equal to *number_to_compare_with*, the value is counted.<br>If *number_to_compare_with* and *mask* are equal, only the *mask* need be specified (without '/'). - With *regexp* or *iregexp* as the third parameter, the fourth `pattern` parameter can be an ordinary or [global](/manual/regular_expressions#global-regular-expressions) (starting with '@') regular expression. In case of global regular expressions case sensitivity is inherited from global regular expression settings. For the purpose of regexp matching, float values will always be represented with 4 decimal digits after '.'. Also note that for large numbers difference in decimal (stored in database) and binary (used by Zabbix server) representation may affect the 4th decimal digit. See [aggregate calculations](/manual/config/items/itemtypes/calculated/aggregate) for more details and examples on using foreach functions. #### Papildu parametri **bucket\_rate\_foreach** Funkcija *bucket\_rate\_foreach* atbalsta trešo neobligāto parametru: bucket_rate_foreach(item filter,time period,<parameter number>) kur <parameter number> ir "bucket" vērtības pozīcija vienuma atslēgā. Piemēram, ja "bucket" vērtība myItem\[aaa,0.2\] ir '0.2', tad tās pozīcija ir 2. Noklusējuma vērtība <parameter number> ir '1'. **count\_foreach** Funkcija *count\_foreach* atbalsta trešo un ceturto neobligāto parametru: count_foreach(item filter,time period,<operator>,<pattern>) Kur: - **operator** ir nosacījuma operators vienuma vērtībām (jābūt dubultpēdiņās). Atbalstītie `operators`:<br>*eq* - vienāds<br>*ne* - nav vienāds<br>*gt* - lielāks<br>*ge* - lielāks vai vienāds<br>*lt* - mazāks<br>*le* - mazāks vai vienāds<br>*like* - atbilst, ja satur šablonu (reģistrjutīgs)<br>*bitand* - bitu AND<br>*regexp* - reģistrjutīga atbilstība regulārajai izteiksmei, kas norādīta `pattern`<br>*iregexp* - reģistrnejutīga atbilstība regulārajai izteiksmei, kas norādīta `pattern`<br> - **pattern** ir obligātais šablons (virknes argumentiem jābūt dubultpēdiņās); tiek atbalstīts, ja *operator* ir norādīts trešajā parametrā. Komentāri: - Neobligātos parametrus *operator* vai *pattern* nevar atstāt tukšus aiz komata, tos var tikai pilnībā izlaist. - Ja kā trešais parametrs ir *bitand*, ceturto `pattern` parametru var norādīt kā divus skaitļus, kas atdalīti ar '/': **number_to_compare_with/mask**. count\_foreach() aprēķina "bitwise AND" no vērtības un *mask* un salīdzina rezultātu ar *number_to_compare_with*. Ja "bitwise AND" rezultāts ir vienāds ar *number_to_compare_with*, vērtība tiek ieskaitīta.<br>Ja *number_to_compare_with* un *mask* ir vienādi, var norādīt tikai *mask* (bez '/'). - Ja kā trešais parametrs ir *regexp* vai *iregexp*, ceturtais `pattern` parametrs var būt parasta vai [globāla](/manual/regular_expressions#global-regular-expressions) (sākas ar '@') regulārā izteiksme. Globālo regulāro izteiksmju gadījumā reģistrjutība tiek pārmantota no globālās regulārās izteiksmes iestatījumiem. Regexp atbilstības vajadzībām peldošā komata vērtības vienmēr tiks attēlotas ar 4 zīmēm aiz '.'. Ņemiet vērā arī to, ka lieliem skaitļiem atšķirība starp decimālo (glabājas datubāzē) un bināro (izmanto Zabbix serveris) attēlojumu var ietekmēt 4. zīmi aiz komata. Plašāku informāciju un piemērus par foreach funkciju izmantošanu skatiet sadaļā [aggregate calculations](/manual/config/items/itemtypes/calculated/aggregate). #### Additional role support for Oracle plugin Oracle plugin [items](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#oracle.diskgroups.stats) for Zabbix agent 2 now support additional roles such as SysBACKUP, SysDG, SysKM, or SysRAC in the login options. #### Papildu lomu atbalsts Oracle spraudnim Oracle spraudņa [vienumi](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#oracle.diskgroups.stats) Zabbix aģentam 2 tagad atbalsta papildu lomas, piemēram, SysBACKUP, SysDG, SysKM vai SysRAC pieteikšanās opcijās. ### Add JavaScript to the widget In this section, you will learn how to add a gauge chart - made using JavaScript - that shows if the latest value is normal or too high/too low. 1. Create a *widget.edit.js.php* file in the *views* directory. JavaScript will be responsible for initializing the color picker in the configuration view. **ui/modules/lesson_gauge_chart/views/widget.edit.js.php** ```php <?php use Modules\LessonGaugeChart\Widget; ?> window.widget_lesson_gauge_chart_form = new class { init({color_palette}) { this._unit_select = document.getElementById('value_units'); this._unit_value = document.getElementById('value_static_units'); this._unit_select.addEventListener('change', () => this.updateForm()); colorPalette.setThemeColors(color_palette); for (const colorpicker of jQuery('.<?= ZBX_STYLE_COLOR_PICKER ?> input')) { jQuery(colorpicker).colorpicker(); } const overlay = overlays_stack.getById('widget_properties'); for (const event of ['overlay.reload', 'overlay.close']) { overlay.$dialogue[0].addEventListener(event, () => { jQuery.colorpicker('hide'); }); } this.updateForm(); } updateForm() { this._unit_value.disabled = this._unit_select.value == <?= Widget::UNIT_AUTO ?>; } }; ``` 2. Open *views/widget.edit.php* and add the *widget.edit.js.php* file with the JavaScript to the configuration view. To do this, use the *includeJsFile()* method. To add inline JavaScript, use the *addJavaScript()* method. **ui/modules/lesson_gauge_chart/views/widget.edit.php** ```php <?php /** * Gauge chart widget form view. * * @var CView $this * @var array $data */ use Modules\LessonGaugeChart\Includes\WidgetForm; $lefty_units = new CWidgetFieldSelectView($data['fields']['value_units']); $lefty_static_units = (new CWidgetFieldTextBoxView($data['fields']['value_static_units'])) ->setPlaceholder(_('value')) ->setWidth(ZBX_TEXTAREA_TINY_WIDTH); (new CWidgetFormView($data)) ->addField( (new CWidgetFieldMultiSelectItemView($data['fields']['itemid'])) ->setPopupParameter('numeric', true) ) ->addFieldset( (new CWidgetFormFieldsetCollapsibleView(_('Advanced configuration'))) ->addField( new CWidgetFieldColorView($data['fields']['chart_color']) ) ->addField( new CWidgetFieldNumericBoxView($data['fields']['value_min']) ) ->addField( new CWidgetFieldNumericBoxView($data['fields']['value_max']) ) ->addItem([ $lefty_units->getLabel(), (new CFormField([ $lefty_units->getView()->addClass(ZBX_STYLE_FORM_INPUT_MARGIN), $lefty_static_units->getView() ])) ]) ->addField( new CWidgetFieldTextBoxView($data['fields']['description']) ) ) ->includeJsFile('widget.edit.js.php') ->addJavaScript('widget_lesson_gauge_chart_form.init('.json_encode([ 'color_palette' => WidgetForm::DEFAULT_COLOR_PALETTE ], JSON_THROW_ON_ERROR).');') ->show(); ``` 3. Return to the dashboard, click on the gear icon in the widget to open the widget configuration form. Now, expand the *Advanced configuration* section to see the initialized color picker. Fill in the fields with values and select a color for the gauge chart. {width="600"} 4. Click on *Apply* in the widget configuration form. Then click on *Save changes* in the top right corner to save the dashboard. 5. Open *actions/WidgetView.php* and update the controller. The **$this->fields_values** property now contains the values of all the *Advanced configuration* fields. Finalize the controller to enable passing the configuration and selected item value to the widget view. **ui/modules/lesson_gauge_chart/actions/WidgetView.php** ```php <?php namespace Modules\LessonGaugeChart\Actions; use API, CControllerDashboardWidgetView, CControllerResponseData; class WidgetView extends CControllerDashboardWidgetView { protected function doAction(): void { $db_items = API::Item()->get([ 'output' => ['itemid', 'value_type', 'name', 'units'], 'itemids' => $this->fields_values['itemid'], 'webitems' => true, 'filter' => [ 'value_type' => [ITEM_VALUE_TYPE_UINT64, ITEM_VALUE_TYPE_FLOAT] ] ]); $history_value = null; if ($db_items) { $item = $db_items[0]; $history = API::History()->get([ 'output' => API_OUTPUT_EXTEND, 'itemids' => $item['itemid'], 'history' => $item['value_type'], 'sortfield' => 'clock', 'sortorder' => ZBX_SORT_DOWN, 'limit' => 1 ]); if ($history) { $history_value = convertUnitsRaw([ 'value' => $history[0]['value'], 'units' => $item['units'] ]); } } $this->setResponse(new CControllerResponseData([ 'name' => $this->getInput('name', $this->widget->getName()), 'history' => $history_value, 'fields_values' => $this->fields_values, 'user' => [ 'debug_mode' => $this->getDebugMode() ] ])); } } ``` 6. Open and modify *views/widget.view.php*. You need to create a container for the gauge chart, which you will draw in the next steps, and a container for the description. To pass values to JavaScript as a JSON object, use the *setVar()* method. **ui/modules/lesson_gauge_chart/views/widget.view.php** ```php <?php /** * Gauge chart widget view. * * @var CView $this * @var array $data */ (new CWidgetView($data)) ->addItem([ (new CDiv())->addClass('chart'), $data['fields_values']['description'] ? (new CDiv($data['fields_values']['description']))->addClass('description') : null ]) ->setVar('history', $data['history']) ->setVar('fields_values', $data['fields_values']) ->show(); ``` 7. Create a new directory *assets* in the *lesson_gauge_chart* directory. This directory will be used for storing JavaScript, CSS, and potentially any other assets, such as fonts or images. 8. For widget view JavaScript, create a directory *js* in the *assets* directory. 9. Create a *class.widget.js* file in the *assets/js* directory. This JavaScript widget class will extend the base JavaScript class of all dashboard widgets - *CWidget*. The dashboard relies on a correct implementation of a widget and communicates any relevant information to the widget through calling the respective JavaScript methods. The dashboard also expects the widget to generate events when some interaction occurs. Thus, the *CWidget* class contains a set of methods with the default implementation of widget behavior, which can be customized by extending the class. In this case, some customization is necessary, therefore custom logic will be implemented for the following widget behavior: - widget initialization that is responsible for defining the initial state of the widget (see the *onInitialize()* method); - displaying widget contents (that is, drawing the gauge chart) if the widget update process has been successful and without errors (see the *processUpdateResponse(response)* method and the related *\_resizeChart()* and *\_updatedChart()* methods) - resizing the widget (see the *onResize()* method and the related *\_resizeChart()* method) For other aspects of the gauge chart widget, the default implementation for widget behavior will be used. To learn more about the JavaScript methods of the *CWidget* class, see: [JavaScript](/devel/modules/widgets/presentation/javascript). Since this JavaScript is required for the widget view, it should be loaded with the dashboard page. To enable JavaScript loading, you will need to update the *assets/js* and *js_class* parameters in the ***manifest.json*** file as shown in step 10. **ui/modules/lesson_gauge_chart/assets/js/class.widget.js** ```js class WidgetLessonGaugeChart extends CWidget { static UNIT_AUTO = 0; static UNIT_STATIC = 1; onInitialize() { super.onInitialize(); this._refresh_frame = null; this._chart_container = null; this._canvas = null; this._chart_color = null; this._min = null; this._max = null; this._value = null; this._last_value = null; this._units = ''; } processUpdateResponse(response) { if (response.history === null) { this._value = null; this._units = ''; } else { this._value = Number(response.history.value); this._units = response.fields_values.value_units == WidgetLessonGaugeChart.UNIT_AUTO ? response.history.units : response.fields_values.value_static_units; } this._chart_color = response.fields_values.chart_color; this._min = Number(response.fields_values.value_min); this._max = Number(response.fields_values.value_max); super.processUpdateResponse(response); } setContents(response) { if (this._canvas === null) { super.setContents(response); this._chart_container = this._body.querySelector('.chart'); this._chart_container.style.height = `${this._getContentsSize().height - this._body.querySelector('.description').clientHeight}px`; this._canvas = document.createElement('canvas'); this._chart_container.appendChild(this._canvas); this._resizeChart(); } this._updatedChart(); } onResize() { super.onResize(); if (this._state === WIDGET_STATE_ACTIVE) { this._resizeChart(); } } _resizeChart() { const ctx = this._canvas.getContext('2d'); const dpr = window.devicePixelRatio; this._canvas.style.display = 'none'; const size = Math.min(this._chart_container.offsetWidth, this._chart_container.offsetHeight); this._canvas.style.display = ''; this._canvas.width = size * dpr; this._canvas.height = size * dpr; ctx.scale(dpr, dpr); this._canvas.style.width = `${size}px`; this._canvas.style.height = `${size}px`; this._refresh_frame = null; this._updatedChart(); } _updatedChart() { if (this._last_value === null) { this._last_value = this._min; } const start_time = Date.now(); const end_time = start_time + 400; const animate = () => { const time = Date.now(); if (time <= end_time) { const progress = (time - start_time) / (end_time - start_time); const smooth_progress = 0.5 + Math.sin(Math.PI * (progress - 0.5)) / 2; let value = this._value !== null ? this._value : this._min; value = (this._last_value + (value - this._last_value) * smooth_progress - this._min) / (this._max - this._min); const ctx = this._canvas.getContext('2d'); const size = this._canvas.width; const char_weight = size / 12; const char_shadow = 3; const char_x = size / 2; const char_y = size / 2; const char_radius = (size - char_weight) / 2 - char_shadow; const font_ratio = 32 / 100; ctx.clearRect(0, 0, size, size); ctx.beginPath(); ctx.shadowBlur = char_shadow; ctx.shadowColor = '#bbb'; ctx.strokeStyle = '#eee'; ctx.lineWidth = char_weight; ctx.lineCap = 'round'; ctx.arc(char_x, char_y, char_radius, Math.PI * 0.749, Math.PI * 2.251, false); ctx.stroke(); ctx.beginPath(); ctx.strokeStyle = `#${this._chart_color}`; ctx.lineWidth = char_weight - 2; ctx.lineCap = 'round'; ctx.arc(char_x, char_y, char_radius, Math.PI * 0.75, Math.PI * (0.75 + (1.5 * Math.min(1, Math.max(0, value)))), false ); ctx.stroke(); ctx.shadowBlur = 2; ctx.fillStyle = '#1f2c33'; ctx.font = `${(char_radius * font_ratio)|0}px Arial`; ctx.textAlign = 'center'; ctx.textBaseline = 'middle'; ctx.fillText(`${this._value !== null ? this._value : t('No data')}${this._units}`, char_x, char_y, size - char_shadow * 4 - char_weight * 2 ); ctx.fillStyle = '#768d99'; ctx.font = `${(char_radius * font_ratio * .5)|0}px Arial`; ctx.textBaseline = 'top'; ctx.textAlign = 'left'; ctx.fillText(`${this._min}${this._min != '' ? this._units : ''}`, char_weight * .75, size - char_weight * 1.25, size / 2 - char_weight ); ctx.textAlign = 'right'; ctx.fillText(`${this._max}${this._max != '' ? this._units : ''}`, size - char_weight * .75, size - char_weight * 1.25, size / 2 - char_weight ); requestAnimationFrame(animate); } else { this._last_value = this._value; } }; requestAnimationFrame(animate); } } ``` 10. Open *manifest.json* and add: - file name (*class.widget.js*) to the array in the *assets/js* section; - class name (*WidgetLessonGaugeChart*) to the *js_class* parameter in the *widget* section. The *WidgetLessonGaugeChart* class will now be automatically loaded with the dashboard. **ui/modules/lesson_gauge_chart/manifest.json** ```json { "manifest_version": 2.0, "id": "lesson_gauge_chart", "type": "widget", "name": "Gauge chart", "namespace": "LessonGaugeChart", "version": "1.0", "author": "Zabbix", "actions": { "widget.lesson_gauge_chart.view": { "class": "WidgetView" } }, "widget": { "js_class": "WidgetLessonGaugeChart" }, "assets": { "js": ["class.widget.js"] } } ``` ### Pievienot JavaScript sīklietotnei Šajā sadaļā jūs uzzināsiet, kā pievienot mēraparāta diagrammu, kas izveidota, izmantojot JavaScript, un parāda, vai jaunākā vērtība ir normāla vai pārāk augsta/pārāk zema. 1. Izveidojiet failu *widget.edit.js.php* direktorijā *views*. JavaScript būs atbildīgs par krāsu izvēlētāja inicializēšanu konfigurācijas skatā. **ui/modules/lesson_gauge_chart/views/widget.edit.js.php** ```php <?php use Modules\LessonGaugeChart\Widget; ?> window.widget_lesson_gauge_chart_form = new class { init({color_palette}) { this._unit_select = document.getElementById('value_units'); this._unit_value = document.getElementById('value_static_units'); this._unit_select.addEventListener('change', () => this.updateForm()); colorPalette.setThemeColors(color_palette); for (const colorpicker of jQuery('.<?= ZBX_STYLE_COLOR_PICKER ?> input')) { jQuery(colorpicker).colorpicker(); } const overlay = overlays_stack.getById('widget_properties'); for (const event of ['overlay.reload', 'overlay.close']) { overlay.$dialogue[0].addEventListener(event, () => { jQuery.colorpicker('hide'); }); } this.updateForm(); } updateForm() { this._unit_value.disabled = this._unit_select.value == <?= Widget::UNIT_AUTO ?>; } }; ``` 2. Atveriet *views/widget.edit.php* un pievienojiet failu *widget.edit.js.php* ar JavaScript konfigurācijas skatam. Lai to izdarītu, izmantojiet metodi *includeJsFile()*. Lai pievienotu iebūvētu JavaScript, izmantojiet metodi *addJavaScript()*. **ui/modules/lesson_gauge_chart/views/widget.edit.php** ```php <?php /** * Gauge chart widget form view. * * @var CView $this * @var array $data */ use Modules\LessonGaugeChart\Includes\WidgetForm; $lefty_units = new CWidgetFieldSelectView($data['fields']['value_units']); $lefty_static_units = (new CWidgetFieldTextBoxView($data['fields']['value_static_units'])) ->setPlaceholder(_('value')) ->setWidth(ZBX_TEXTAREA_TINY_WIDTH); (new CWidgetFormView($data)) ->addField( (new CWidgetFieldMultiSelectItemView($data['fields']['itemid'])) ->setPopupParameter('numeric', true) ) ->addFieldset( (new CWidgetFormFieldsetCollapsibleView(_('Advanced configuration'))) ->addField( new CWidgetFieldColorView($data['fields']['chart_color']) ) ->addField( new CWidgetFieldNumericBoxView($data['fields']['value_min']) ) ->addField( new CWidgetFieldNumericBoxView($data['fields']['value_max']) ) ->addItem([ $lefty_units->getLabel(), (new CFormField([ $lefty_units->getView()->addClass(ZBX_STYLE_FORM_INPUT_MARGIN), $lefty_static_units->getView() ])) ]) ->addField( new CWidgetFieldTextBoxView($data['fields']['description']) ) ) ->includeJsFile('widget.edit.js.php') ->addJavaScript('widget_lesson_gauge_chart_form.init('.json_encode([ 'color_palette' => WidgetForm::DEFAULT_COLOR_PALETTE ], JSON_THROW_ON_ERROR).');') ->show(); ``` 3. Atgriezieties informācijas panelī, noklikšķiniet uz zobrata ikonas sīklietotnē, lai atvērtu sīklietotnes konfigurācijas formu. Pēc tam izvērsiet sadaļu *Advanced configuration*, lai redzētu inicializēto krāsu izvēlētāju. Aizpildiet laukus ar vērtībām un izvēlieties krāsu mēraparāta diagrammai. {width="600"} 4. Sīklietotnes konfigurācijas formā noklikšķiniet uz *Apply*. Pēc tam augšējā labajā stūrī noklikšķiniet uz *Save changes*, lai saglabātu informācijas paneli. 5. Atveriet *actions/WidgetView.php* un atjauniniet kontrolieri. Īpašums **$this->fields_values** tagad satur visu lauku *Advanced configuration* vērtības. Pabeidziet kontrolieri, lai nodrošinātu konfigurācijas un atlasītās vienuma vērtības nodošanu sīklietotnes skatam. **ui/modules/lesson_gauge_chart/actions/WidgetView.php** ```php <?php namespace Modules\LessonGaugeChart\Actions; use API, CControllerDashboardWidgetView, CControllerResponseData; class WidgetView extends CControllerDashboardWidgetView { protected function doAction(): void { $db_items = API::Item()->get([ 'output' => ['itemid', 'value_type', 'name', 'units'], 'itemids' => $this->fields_values['itemid'], 'webitems' => true, 'filter' => [ 'value_type' => [ITEM_VALUE_TYPE_UINT64, ITEM_VALUE_TYPE_FLOAT] ] ]); $history_value = null; if ($db_items) { $item = $db_items[0]; $history = API::History()->get([ 'output' => API_OUTPUT_EXTEND, 'itemids' => $item['itemid'], 'history' => $item['value_type'], 'sortfield' => 'clock', 'sortorder' => ZBX_SORT_DOWN, 'limit' => 1 ]); if ($history) { $history_value = convertUnitsRaw([ 'value' => $history[0]['value'], 'units' => $item['units'] ]); } } $this->setResponse(new CControllerResponseData([ 'name' => $this->getInput('name', $this->widget->getName()), 'history' => $history_value, 'fields_values' => $this->fields_values, 'user' => [ 'debug_mode' => $this->getDebugMode() ] ])); } } ``` 6. Atveriet un modificējiet *views/widget.view.php*. Jums jāizveido konteiners mēraparāta diagrammai, kuru zīmēsiet nākamajās darbībās, un konteiners aprakstam. Lai nodotu vērtības JavaScript kā JSON objektu, izmantojiet metodi *setVar()*. **ui/modules/lesson_gauge_chart/views/widget.view.php** ```php <?php /** * Gauge chart widget view. * * @var CView $this * @var array $data */ (new CWidgetView($data)) ->addItem([ (new CDiv())->addClass('chart'), $data['fields_values']['description'] ? (new CDiv($data['fields_values']['description']))->addClass('description') : null ]) ->setVar('history', $data['history']) ->setVar('fields_values', $data['fields_values']) ->show(); ``` 7. Izveidojiet jaunu direktoriju *assets* direktorijā *lesson_gauge_chart*. Šī direktorija tiks izmantota JavaScript, CSS un, iespējams, citu resursu, piemēram, fontu vai attēlu, glabāšanai. 8. Sīklietotnes skata JavaScript izveidojiet direktoriju *js* direktorijā *assets*. 9. Izveidojiet failu *class.widget.js* direktorijā *assets/js*. Šī JavaScript sīklietotnes klase paplašinās visu informācijas paneļa sīklietotņu pamata JavaScript klasi - *CWidget*. Informācijas panelis paļaujas uz pareizu sīklietotnes implementāciju un sazinās ar sīklietotni, nododot tai atbilstošu informāciju, izmantojot attiecīgās JavaScript metodes. Informācijas panelis arī sagaida, ka sīklietotne ģenerēs notikumus, kad notiek kāda mijiedarbība. Tādējādi klase *CWidget* satur metožu kopu ar sīklietotnes uzvedības noklusējuma implementāciju, ko var pielāgot, paplašinot klasi. Šajā gadījumā ir nepieciešama noteikta pielāgošana, tāpēc pielāgota loģika tiks ieviesta šādai sīklietotnes uzvedībai: - sīklietotnes inicializēšana, kas ir atbildīga par sīklietotnes sākotnējā stāvokļa definēšanu (skatiet metodi *onInitialize()*); - sīklietotnes satura attēlošana (tas ir, mēraparāta diagrammas zīmēšana), ja sīklietotnes atjaunināšanas process ir bijis veiksmīgs un bez kļūdām (skatiet metodi *processUpdateResponse(response)* un saistītās metodes *_resizeChart()* un *_updatedChart()*) - sīklietotnes izmēra maiņa (skatiet metodi *onResize()* un saistīto metodi *_resizeChart()*) Pārējiem mēraparāta diagrammas sīklietotnes aspektiem tiks izmantota sīklietotnes uzvedības noklusējuma implementācija. Lai uzzinātu vairāk par klases *CWidget* JavaScript metodēm, skatiet: [JavaScript](/devel/modules/widgets/presentation/javascript). Tā kā šis JavaScript ir nepieciešams sīklietotnes skatam, tas ir jāielādē kopā ar informācijas paneļa lapu. Lai iespējotu JavaScript ielādi, jums būs jāatjaunina parametri *assets/js* un *js_class* failā ***manifest.json***, kā parādīts 10. darbībā. **ui/modules/lesson_gauge_chart/assets/js/class.widget.js** ```js class WidgetLessonGaugeChart extends CWidget { static UNIT_AUTO = 0; static UNIT_STATIC = 1; onInitialize() { super.onInitialize(); this._refresh_frame = null; this._chart_container = null; this._canvas = null; this._chart_color = null; this._min = null; this._max = null; this._value = null; this._last_value = null; this._units = ''; } processUpdateResponse(response) { if (response.history === null) { this._value = null; this._units = ''; } else { this._value = Number(response.history.value); this._units = response.fields_values.value_units == WidgetLessonGaugeChart.UNIT_AUTO ? response.history.units : response.fields_values.value_static_units; } this._chart_color = response.fields_values.chart_color; this._min = Number(response.fields_values.value_min); this._max = Number(response.fields_values.value_max); super.processUpdateResponse(response); } setContents(response) { if (this._canvas === null) { super.setContents(response); this._chart_container = this._body.querySelector('.chart'); this._chart_container.style.height = `${this._getContentsSize().height - this._body.querySelector('.description').clientHeight}px`; this._canvas = document.createElement('canvas'); this._chart_container.appendChild(this._canvas); this._resizeChart(); } this._updatedChart(); } onResize() { super.onResize(); if (this._state === WIDGET_STATE_ACTIVE) { this._resizeChart(); } } _resizeChart() { const ctx = this._canvas.getContext('2d'); const dpr = window.devicePixelRatio; this._canvas.style.display = 'none'; const size = Math.min(this._chart_container.offsetWidth, this._chart_container.offsetHeight); this._canvas.style.display = ''; this._canvas.width = size * dpr; this._canvas.height = size * dpr; ctx.scale(dpr, dpr); this._canvas.style.width = `${size}px`; this._canvas.style.height = `${size}px`; this._refresh_frame = null; this._updatedChart(); } _updatedChart() { if (this._last_value === null) { this._last_value = this._min; } const start_time = Date.now(); const end_time = start_time + 400; const animate = () => { const time = Date.now(); if (time <= end_time) { const progress = (time - start_time) / (end_time - start_time); const smooth_progress = 0.5 + Math.sin(Math.PI * (progress - 0.5)) / 2; let value = this._value !== null ? this._value : this._min; value = (this._last_value + (value - this._last_value) * smooth_progress - this._min) / (this._max - this._min); const ctx = this._canvas.getContext('2d'); const size = this._canvas.width; const char_weight = size / 12; const char_shadow = 3; const char_x = size / 2; const char_y = size / 2; const char_radius = (size - char_weight) / 2 - char_shadow; const font_ratio = 32 / 100; ctx.clearRect(0, 0, size, size); ctx.beginPath(); ctx.shadowBlur = char_shadow; ctx.shadowColor = '#bbb'; ctx.strokeStyle = '#eee'; ctx.lineWidth = char_weight; ctx.lineCap = 'round'; ctx.arc(char_x, char_y, char_radius, Math.PI * 0.749, Math.PI * 2.251, false); ctx.stroke(); ctx.beginPath(); ctx.strokeStyle = `#${this._chart_color}`; ctx.lineWidth = char_weight - 2; ctx.lineCap = 'round'; ctx.arc(char_x, char_y, char_radius, Math.PI * 0.75, Math.PI * (0.75 + (1.5 * Math.min(1, Math.max(0, value)))), false ); ctx.stroke(); ctx.shadowBlur = 2; ctx.fillStyle = '#1f2c33'; ctx.font = `${(char_radius * font_ratio)|0}px Arial`; ctx.textAlign = 'center'; ctx.textBaseline = 'middle'; ctx.fillText(`${this._value !== null ? this._value : t('No data')}${this._units}`, char_x, char_y, size - char_shadow * 4 - char_weight * 2 ); ctx.fillStyle = '#768d99'; ctx.font = `${(char_radius * font_ratio * .5)|0}px Arial`; ctx.textBaseline = 'top'; ctx.textAlign = 'left'; ctx.fillText(`${this._min}${this._min != '' ? this._units : ''}`, char_weight * .75, size - char_weight * 1.25, size / 2 - char_weight ); ctx.textAlign = 'right'; ctx.fillText(`${this._max}${this._max != '' ? this._units : ''}`, size - char_weight * .75, size - char_weight * 1.25, size / 2 - char_weight ); requestAnimationFrame(animate); } else { this._last_value = this._value; } }; requestAnimationFrame(animate); } } ``` 10. Atveriet *manifest.json* un pievienojiet: - faila nosaukumu (*class.widget.js*) masīvam sadaļā *assets/js*; - klases nosaukumu (*WidgetLessonGaugeChart*) parametram *js_class* sadaļā *widget*. Klase *WidgetLessonGaugeChart* tagad tiks automātiski ielādēta kopā ar informācijas paneli. **ui/modules/lesson_gauge_chart/manifest.json** ```json { "manifest_version": 2.0, "id": "lesson_gauge_chart", "type": "widget", "name": "Gauge chart", "namespace": "LessonGaugeChart", "version": "1.0", "author": "Zabbix", "actions": { "widget.lesson_gauge_chart.view": { "class": "WidgetView" } }, "widget": { "js_class": "WidgetLessonGaugeChart" }, "assets": { "js": ["class.widget.js"] } } ``` ### Add settings to a configuration view and use them in a widget view In this section, you will learn how to add a widget configuration field and show the entered value in the widget view as text. The widget configuration consists of a form (*Zabbix\\Widgets\\CWidgetForm*) and a widget form view (*widget.edit.php*). To add fields (*Zabbix\\Widgets\\CWidgetField*), you need to create a *WidgetForm* class, which will extend *Zabbix\\Widgets\\CWidgetForm*. The form contains the set of fields (*Zabbix\\Widgets\\CWidgetField*) of various types, which are used to validate user-entered values. The form field (*Zabbix\\Widgets\\CWidgetField*) for each input element type converts the value into a single format to store it in the database. :::noteclassic The widget's **form** file should be located in the *includes* directory (for this tutorial, *ui/modules/lesson_gauge_chart/includes/*). If the file has the default name *WidgetForm.php*, you do not need to register it in the *manifest.json* file. If the file has a different name, specify it in the *widget/form_class* section of the [manifest.json](/devel/modules/file_structure/manifest) file. ::: 1. Create a new directory *includes* in the *lesson_gauge_chart* directory. 2. Create a *WidgetForm.php* file in the *includes* directory. **ui/modules/lesson_gauge_chart/includes/WidgetForm.php** ```php <?php namespace Modules\LessonGaugeChart\Includes; use Zabbix\Widgets\CWidgetForm; class WidgetForm extends CWidgetForm { } ``` 3. Add a *Description* field to widget configuration form. This is a regular text field, where a user can enter any character set. You can use the *CWidgetFieldTextBox* class for it. **ui/modules/lesson_gauge_chart/includes/WidgetForm.php** ```php <?php namespace Modules\LessonGaugeChart\Includes; use Zabbix\Widgets\CWidgetForm; use Zabbix\Widgets\Fields\CWidgetFieldTextBox; class WidgetForm extends CWidgetForm { public function addFields(): self { return $this ->addField( new CWidgetFieldTextBox('description', _('Description')) ); } } ``` 4. In the *views* directory, create a widget configuration view file *widget.edit.php* and add a view for the new *Description* field. For the *CWidgetFieldTextBox* field class, the view is *CWidgetFieldTextBoxView.* **ui/modules/lesson_gauge_chart/views/widget.edit.php** ```php <?php /** * Gauge chart widget form view. * * @var CView $this * @var array $data */ (new CWidgetFormView($data)) ->addField( new CWidgetFieldTextBoxView($data['fields']['description']) ) ->show(); ``` 5. Go to the dashboard and click on the gear icon in the widget to open the widget configuration form. 6. The widget configuration form now contains a new *Description* text field. Enter any value, for example, *Gauge chart description*. {width="600"} 7. Click on *Apply* in the widget configuration form. Then click on *Save changes* in the top right corner to save the dashboard. Note that the new description is not visible anywhere, and the widget still displays "Hello, world!". For the new description to appear in the widget, the *Description* field value needs to be retrieved from the database and passed to the widget view. For that, you need to create an action class. 8. Create a new directory *actions* in the *lesson_gauge_chart* directory. 9. Create a *WidgetView.php* file in the *actions* directory. The *WidgetView* action class will extend the *CControllerDashboardWidgetView* class. Values of the widget configuration fields are stored in the **$fields_values** property of the action class. **ui/modules/lesson_gauge_chart/actions/WidgetView.php** ```php <?php namespace Modules\LessonGaugeChart\Actions; use CControllerDashboardWidgetView, CControllerResponseData; class WidgetView extends CControllerDashboardWidgetView { protected function doAction(): void { $this->setResponse(new CControllerResponseData([ 'name' => $this->getInput('name', $this->widget->getName()), 'description' => $this->fields_values['description'], 'user' => [ 'debug_mode' => $this->getDebugMode() ] ])); } } ``` 10. Open *manifest.json* and register *WidgetView* as an action class in the *actions/widget.lesson_gauge_chart.view* section. **ui/modules/lesson_gauge_chart/manifest.json** ```json { "manifest_version": 2.0, "id": "lesson_gauge_chart", "type": "widget", "name": "Gauge chart", "namespace": "LessonGaugeChart", "version": "1.0", "author": "Zabbix", "actions": { "widget.lesson_gauge_chart.view": { "class": "WidgetView" } } } ``` 11. Now you can use the value of the description field, contained in *$data['description']*, in the widget view. Open *views/widget.view.php* and replace the static text "Hello, world!" with *$data['description']*. **ui/modules/lesson_gauge_chart/views/widget.view.php** ```php <?php /** * Gauge chart widget view. * * @var CView $this * @var array $data */ (new CWidgetView($data)) ->addItem( new CTag('h1', true, $data['description']) ) ->show(); ``` 12. Refresh the dashboard page. You should now see the widget description text instead of "Hello, world!". {width="600"} ### Pievienot iestatījumus konfigurācijas skatam un izmantot tos logrīka skatā Šajā sadaļā jūs uzzināsiet, kā pievienot logrīka konfigurācijas lauku un parādīt ievadīto vērtību logrīka skatā kā tekstu. Logrīka konfigurācija sastāv no formas (*Zabbix\\Widgets\\CWidgetForm*) un logrīka formas skata (*widget.edit.php*). Lai pievienotu laukus (*Zabbix\\Widgets\\CWidgetField*), jums ir jāizveido *WidgetForm* klase, kas paplašinās *Zabbix\\Widgets\\CWidgetForm*. Forma satur dažādu tipu lauku kopu (*Zabbix\\Widgets\\CWidgetField*), kas tiek izmantoti lietotāja ievadīto vērtību validēšanai. Formas lauks (*Zabbix\\Widgets\\CWidgetField*) katram ievades elementa tipam pārveido vērtību vienotā formātā, lai to saglabātu datubāzē. :::noteclassic Logrīka **formas** failam jāatrodas *includes* direktorijā (šajā pamācībā - *ui/modules/lesson_gauge_chart/includes/*). Ja failam ir noklusējuma nosaukums *WidgetForm.php*, tas nav jāreģistrē *manifest.json* failā. Ja failam ir cits nosaukums, norādiet to *widget/form_class* sadaļā [manifest.json](/devel/modules/file_structure/manifest) failā. ::: 1. Izveidojiet jaunu direktoriju *includes* direktorijā *lesson_gauge_chart*. 2. Izveidojiet failu *WidgetForm.php* direktorijā *includes*. **ui/modules/lesson_gauge_chart/includes/WidgetForm.php** ```php <?php namespace Modules\LessonGaugeChart\Includes; use Zabbix\Widgets\CWidgetForm; class WidgetForm extends CWidgetForm { } ``` 3. Pievienojiet *Description* lauku logrīka konfigurācijas formai. Tas ir parasts teksta lauks, kurā lietotājs var ievadīt jebkuru rakstzīmju kopu. Šim nolūkam varat izmantot klasi *CWidgetFieldTextBox*. **ui/modules/lesson_gauge_chart/includes/WidgetForm.php** ```php <?php namespace Modules\LessonGaugeChart\Includes; use Zabbix\Widgets\CWidgetForm; use Zabbix\Widgets\Fields\CWidgetFieldTextBox; class WidgetForm extends CWidgetForm { public function addFields(): self { return $this ->addField( new CWidgetFieldTextBox('description', _('Description')) ); } } ``` 4. Direktorijā *views* izveidojiet logrīka konfigurācijas skata failu *widget.edit.php* un pievienojiet skatu jaunajam *Description* laukam. Klases *CWidgetFieldTextBox* lauka skatam ir *CWidgetFieldTextBoxView*. **ui/modules/lesson_gauge_chart/views/widget.edit.php** ```php <?php /** * Gauge chart widget form view. * * @var CView $this * @var array $data */ (new CWidgetFormView($data)) ->addField( new CWidgetFieldTextBoxView($data['fields']['description']) ) ->show(); ``` 5. Dodieties uz informācijas paneli un noklikšķiniet uz zobrata ikonas logrīkā, lai atvērtu logrīka konfigurācijas formu. 6. Logrīka konfigurācijas forma tagad satur jaunu teksta lauku *Description*. Ievadiet jebkuru vērtību, piemēram, *Gauge chart description*. {width="600"} 7. Logrīka konfigurācijas formā noklikšķiniet uz *Apply*. Pēc tam augšējā labajā stūrī noklikšķiniet uz *Save changes*, lai saglabātu informācijas paneli. Ņemiet vērā, ka jaunais apraksts nekur nav redzams, un logrīks joprojām rāda "Hello, world!". Lai jaunais apraksts parādītos logrīkā, lauka *Description* vērtība ir jāiegūst no datubāzes un jānodod logrīka skatam. Lai to izdarītu, jums ir jāizveido darbības klase. 8. Izveidojiet jaunu direktoriju *actions* direktorijā *lesson_gauge_chart*. 9. Izveidojiet failu *WidgetView.php* direktorijā *actions*. Darbības klase *WidgetView* paplašinās klasi *CControllerDashboardWidgetView*. Logrīka konfigurācijas lauku vērtības tiek glabātas darbības klases rekvizītā **$fields_values**. **ui/modules/lesson_gauge_chart/actions/WidgetView.php** ```php <?php namespace Modules\LessonGaugeChart\Actions; use CControllerDashboardWidgetView, CControllerResponseData; class WidgetView extends CControllerDashboardWidgetView { protected function doAction(): void { $this->setResponse(new CControllerResponseData([ 'name' => $this->getInput('name', $this->widget->getName()), 'description' => $this->fields_values['description'], 'user' => [ 'debug_mode' => $this->getDebugMode() ] ])); } } ``` 10. Atveriet *manifest.json* un reģistrējiet *WidgetView* kā darbības klasi sadaļā *actions/widget.lesson_gauge_chart.view*. **ui/modules/lesson_gauge_chart/manifest.json** ```json { "manifest_version": 2.0, "id": "lesson_gauge_chart", "type": "widget", "name": "Gauge chart", "namespace": "LessonGaugeChart", "version": "1.0", "author": "Zabbix", "actions": { "widget.lesson_gauge_chart.view": { "class": "WidgetView" } } } ``` 11. Tagad logrīka skatā varat izmantot lauka *description* vērtību, kas atrodas *$data['description']*. Atveriet *views/widget.view.php* un aizstājiet statisko tekstu "Hello, world!" ar *$data['description']*. **ui/modules/lesson_gauge_chart/views/widget.view.php** ```php <?php /** * Gauge chart widget view. * * @var CView $this * @var array $data */ (new CWidgetView($data)) ->addItem( new CTag('h1', true, $data['description']) ) ->show(); ``` 12. Atsvaidziniet informācijas paneļa lapu. Tagad jums vajadzētu redzēt logrīka apraksta tekstu "Hello, world!" vietā. {width="600"} ## Administration With the Zabbix API you can change administration settings of your monitoring system. ## Administrēšana Ar Zabbix API jūs varat mainīt savas uzraudzības sistēmas administrēšanas iestatījumus. #### Advanced configuration Advanced configuration options are available in a collapsible *Advanced configuration* section: {width="600"} |Parameter|Description| |----------|----------------------------------------| |*Enable user input*|Mark the checkbox to enable manual user input before executing the script.<br>Manual user input will replace the {MANUALINPUT} macro value in the script.<br>See also: [Manual user input](#manual-user-input).| |*Input prompt*|Enter custom text prompting for custom user input. This text will be displayed above the input field in the *Manual input* popup.<br>To see a preview of the *Manual input* popup, click on *Test user input*. The preview also allows to test if the input string complies with the input validation rule (see parameters below).<br>Macro and user macro support depends on the scope of the script (see *Scope* in general script configuration parameters).| |*Input type*|Select the manual input type:<br>**String** - single string;<br>**Dropdown** - value is selected from multiple dropdown options.| |*Dropdown options*|Enter unique values for the user input dropdown in a comma-delimited list.<br>To include an empty option in the dropdown, add an extra comma at the beginning, middle, or end of the list.<br>This field is displayed only if 'Dropdown' is selected as *Input type*.| |*Default input string*|Enter the default string for user input (or none).<br>This field will be validated against the regular expression provided in the *Input validation rule* field.<br>The value entered here will be displayed by default in the *Manual input* popup.<br>This field is displayed only if 'String' is selected as *Input type*.| |*Input validation rule*|Enter a regular expression to validate the user input string.<br>Global regular expressions are supported.<br>This field is displayed only if 'String' is selected as *Input type*.| |*Enable confirmation*|Mark the checkbox to display a confirmation message before executing the script. This feature might be especially useful with potentially dangerous operations (like a reboot script) or ones that might take a long time.| |*Confirmation text*|Enter custom confirmation text for the confirmation popup enabled with the checkbox above (for example, *Remote system will be rebooted. Are you sure?*). To see how the text will look like, click on *Test confirmation* next to the field.<br>[Macros](/manual/appendix/macros/supported_by_location) and custom [user macros](/manual/config/macros/user_macros) are supported.<br>*Note:* the macros will not be expanded when testing the confirmation message.| If both manual user input and a confirmation message are configured, they will be displayed in consecutive popup windows. #### Papildu konfigurācija Papildu konfigurācijas opcijas ir pieejamas salokāmā *Papildu konfigurācija* sadaļā: {width="600"} |Parameter|Description| |----------|----------------------------------------| |*Enable user input*|Atzīmējiet izvēles rūtiņu, lai pirms skripta izpildes iespējotu manuālu lietotāja ievadi.<br>Manuālā lietotāja ievade skriptā aizstās {MANUALINPUT} makro vērtību.<br>Skatiet arī: [Manuāla lietotāja ievade](#manual-user-input).| |*Input prompt*|Ievadiet pielāgotu tekstu, kas aicina ievadīt pielāgotu lietotāja ievadi. Šis teksts tiks parādīts virs ievades lauka uznirstošajā logā *Manuālā ievade*.<br>Lai redzētu uznirstošā loga *Manuālā ievade* priekšskatījumu, noklikšķiniet uz *Test user input*. Priekšskatījums arī ļauj pārbaudīt, vai ievades virkne atbilst ievades validācijas noteikumam (skatiet tālāk norādītos parametrus).<br>Makro un lietotāja makro atbalsts ir atkarīgs no skripta tvēruma (skatiet *Scope* vispārīgajos skripta konfigurācijas parametros).| |*Input type*|Atlasiet manuālās ievades tipu:<br>**String** - viena virkne;<br>**Dropdown** - vērtība tiek izvēlēta no vairākām nolaižamā saraksta opcijām.| |*Dropdown options*|Ievadiet unikālas vērtības lietotāja ievades nolaižamajam sarakstam ar komatiem atdalītā sarakstā.<br>Lai nolaižamajā sarakstā iekļautu tukšu opciju, saraksta sākumā, vidū vai beigās pievienojiet papildu komatu.<br>Šis lauks tiek rādīts tikai tad, ja kā *Input type* ir atlasīts 'Dropdown'.| |*Default input string*|Ievadiet noklusējuma virkni lietotāja ievadei (vai neko).<br>Šis lauks tiks validēts, izmantojot regulāro izteiksmi, kas norādīta laukā *Input validation rule*.<br>Šeit ievadītā vērtība pēc noklusējuma tiks parādīta uznirstošajā logā *Manuālā ievade*.<br>Šis lauks tiek rādīts tikai tad, ja kā *Input type* ir atlasīts 'String'.| |*Input validation rule*|Ievadiet regulāro izteiksmi, lai validētu lietotāja ievades virkni.<br>Tiek atbalstītas globālās regulārās izteiksmes.<br>Šis lauks tiek rādīts tikai tad, ja kā *Input type* ir atlasīts 'String'.| |*Enable confirmation*|Atzīmējiet izvēles rūtiņu, lai pirms skripta izpildes parādītu apstiprinājuma ziņojumu. Šī funkcija var būt īpaši noderīga potenciāli bīstamām darbībām (piemēram, pārstartēšanas skriptam) vai darbībām, kas var aizņemt ilgu laiku.| |*Confirmation text*|Ievadiet pielāgotu apstiprinājuma tekstu apstiprinājuma uznirstošajam logam, kas tiek iespējots ar iepriekš minēto izvēles rūtiņu (piemēram, *Attālinātā sistēma tiks pārstartēta. Vai esat pārliecināts?*). Lai redzētu, kā teksts izskatīsies, noklikšķiniet uz *Test confirmation* blakus laukam.<br>[Makro](/manual/appendix/macros/supported_by_location) un pielāgoti [lietotāja makro](/manual/config/macros/user_macros) tiek atbalstīti.<br>*Piezīme:* testējot apstiprinājuma ziņojumu, makro netiks izvērsti.| Ja ir konfigurēta gan manuāla lietotāja ievade, gan apstiprinājuma ziņojums, tie tiks parādīti secīgos uznirstošajos logos. ##### Advanced configuration Advanced configuration options are available in the collapsible *Advanced configuration* section and only for elements selected in the *Show* field (see above) and the background color or thresholds for honeycomb cells. {width="600"} | | | |--|--------| |***Primary/Secondary label***|<| |*Type*|Select the label type:<br>**Text** - the label will display the text specified for the *Text* parameter;<br>**Value** - the label will display the item value with decimal places as specified for the *Decimal places* parameter.| |*Text*|Enter the label text. This text may override the default item name.<br>Multiline text is supported. A combination of text and [supported macros](/manual/appendix/macros/supported_by_location) is possible.<br>`{HOST.\*}`, `{ITEM.\*}`, `{INVENTORY.\*}`, and [user macros](/manual/appendix/macros/supported_by_location_user#other-locations) are supported.<br>Honeycomb cells are ordered alphabetically by host name, and, within each host, by item name.<br>This parameter is available if *Type* is set to *Text*.| |*Decimal places*|Enter the number of decimal places to display with the value.<br>This parameter is available if *Type* is set to *Value*, and affects only items that return [numeric (float)](/manual/config/items/item#configuration) data.| |*Size*|Select the label size:<br>**Auto** - use automatically adjusted label size;<br>**Custom** - enter a custom label size (in percent, relative to the honeycomb cell size).<br>Note that labels that do not fit the honeycomb cell size are truncated.| |*Bold*|Mark the checkbox to display labels in bold.| |*Color*|Select the label color from the color picker.<br>"D" stands for the default color, which depends on the frontend theme. To return to the default color, click the *Use default* button in the color picker.| |***Units***|<| |*Units*|Mark the checkbox to display units with the item value.<br>If you enter a unit name, it will override the units set in the [item configuration](/manual/config/items/item#configuration).<br>This parameter is available if *Type* is set to *Value*.| |*Position*|Select the position of the item units (before or after the item value).<br>This parameter is ignored for the following [time-related units](/manual/config/items/item#configuration): unixtime, uptime, s.<br>This parameter is available if *Type* is set to *Value* and the *Units* option is selected.| |***Background color***|<| |*Background color*|Select the honeycomb cells background color from the color picker.<br>"D" stands for the default color, which depends on the frontend theme. To return to the default color, click the *Use default* button in the color picker.| |***Thresholds***|<| |*Color interpolation*|Mark the checkbox to enable smooth transitioning between threshold colors for honeycomb cells.<br>This parameter is available if two or more thresholds are set.| |*Threshold*|Click *Add* to add a threshold, select a threshold color from the color picker, and specify a numeric value.<br>The thresholds list will be sorted in ascending order when saved.<br>Note that the colors configured as thresholds will be displayed correctly only for numeric items.<br>[Suffixes](/manual/appendix/suffixes) (for example, "1d", "2w", "4K", "8G") are supported. [Value mappings](/manual/config/items/mapping) are supported.| ##### Paplašinātā konfigurācija Paplašinātās konfigurācijas opcijas ir pieejamas salokāmajā sadaļā *Paplašinātā konfigurācija* un tikai tiem elementiem, kas atlasīti laukā *Rādīt* (skatīt iepriekš), kā arī šūnveida šūnu fona krāsai vai sliekšņiem. {width="600"} | | | |--|--------| |***Primārā/sekundārā etiķete***|<| |*Tips*|Atlasiet etiķetes tipu:<br>**Teksts** — etiķetē tiks parādīts teksts, kas norādīts parametram *Teksts*;<br>**Vērtība** — etiķetē tiks parādīta vienuma vērtība ar decimālzīmju skaitu, kas norādīts parametram *Decimālzīmes*.| |*Teksts*|Ievadiet etiķetes tekstu. Šis teksts var aizstāt noklusējuma vienuma nosaukumu.<br>Tiek atbalstīts vairākrindu teksts. Ir iespējama teksta un [atbalstīto makrosu](/manual/appendix/macros/supported_by_location) kombinācija.<br>Tiek atbalstīti `{HOST.\*}`, `{ITEM.\*}`, `{INVENTORY.\*}` un [lietotāja makrosi](/manual/appendix/macros/supported_by_location_user#other-locations).<br>Šūnveida šūnas tiek kārtotas alfabētiskā secībā pēc hosta nosaukuma un katra hosta ietvaros — pēc vienuma nosaukuma.<br>Šis parametrs ir pieejams, ja *Tips* ir iestatīts uz *Teksts*.| |*Decimālzīmes*|Ievadiet decimālzīmju skaitu, kas jāparāda kopā ar vērtību.<br>Šis parametrs ir pieejams, ja *Tips* ir iestatīts uz *Vērtība*, un ietekmē tikai vienumus, kas atgriež [skaitliskus (peldošā komata)](/manual/config/items/item#configuration) datus.| |*Izmērs*|Atlasiet etiķetes izmēru:<br>**Automātiski** — izmantot automātiski pielāgotu etiķetes izmēru;<br>**Pielāgots** — ievadīt pielāgotu etiķetes izmēru (procentos attiecībā pret šūnveida šūnas izmēru).<br>Ņemiet vērā, ka etiķetes, kas neietilpst šūnveida šūnas izmērā, tiek saīsinātas.| |*Treknraksts*|Atzīmējiet izvēles rūtiņu, lai etiķetes tiktu parādītas treknrakstā.| |*Krāsa*|Atlasiet etiķetes krāsu krāsu atlasītājā.<br>"D" apzīmē noklusējuma krāsu, kas ir atkarīga no lietotāja saskarnes tēmas. Lai atgrieztos pie noklusējuma krāsas, krāsu atlasītājā noklikšķiniet uz pogas *Izmantot noklusējumu*.| |***Mērvienības***|<| |*Mērvienības*|Atzīmējiet izvēles rūtiņu, lai kopā ar vienuma vērtību parādītu mērvienības.<br>Ja ievadīsiet mērvienības nosaukumu, tas aizstās mērvienības, kas iestatītas [vienuma konfigurācijā](/manual/config/items/item#configuration).<br>Šis parametrs ir pieejams, ja *Tips* ir iestatīts uz *Vērtība*.| |*Pozīcija*|Atlasiet vienuma mērvienību novietojumu (pirms vai pēc vienuma vērtības).<br>Šis parametrs tiek ignorēts šādām [ar laiku saistītām mērvienībām](/manual/config/items/item#configuration): unixtime, uptime, s.<br>Šis parametrs ir pieejams, ja *Tips* ir iestatīts uz *Vērtība* un ir atlasīta opcija *Mērvienības*.| |***Fona krāsa***|<| |*Fona krāsa*|Atlasiet šūnveida šūnu fona krāsu krāsu atlasītājā.<br>"D" apzīmē noklusējuma krāsu, kas ir atkarīga no lietotāja saskarnes tēmas. Lai atgrieztos pie noklusējuma krāsas, krāsu atlasītājā noklikšķiniet uz pogas *Izmantot noklusējumu*.| |***Sliekšņi***|<| |*Krāsu interpolācija*|Atzīmējiet izvēles rūtiņu, lai iespējotu vienmērīgu pāreju starp šūnveida šūnu sliekšņu krāsām.<br>Šis parametrs ir pieejams, ja ir iestatīti divi vai vairāki sliekšņi.| |*Slieksnis*|Noklikšķiniet uz *Pievienot*, lai pievienotu slieksni, atlasiet sliekšņa krāsu krāsu atlasītājā un norādiet skaitlisku vērtību.<br>Saglabājot sliekšņu saraksts tiks sakārtots augošā secībā.<br>Ņemiet vērā, ka kā sliekšņi konfigurētās krāsas tiks pareizi parādītas tikai skaitliskiem vienumiem.<br>Tiek atbalstīti [sufiksi](/manual/appendix/suffixes) (piemēram, "1d", "2w", "4K", "8G"). Tiek atbalstītas [vērtību kartēšanas](/manual/config/items/mapping).| #### Advanced configuration Advanced configuration options are available in the collapsible *Advanced configuration* section, and only for those elements that are selected in the *Show* field (see above). Additionally, advanced configuration allows to change the background color for the whole widget. {width=600} | | | |--|--------| |*Background color* |Select the background color from the color picker.<br>`D` stands for default color (depends on the frontend theme). To return to the default value, click the *Use default* button in the color picker. | |_**Date**_ || |*Bold* |Mark the checkbox to display date in bold type. | |*Color* |Select the date color from the color picker.<br>`D` stands for default color (depends on the frontend theme). To return to the default value, click the *Use default* button in the color picker. | |_**Time**_ || |*Bold* |Mark the checkbox to display time in bold type. | |*Color* |Select the time color from the color picker.<br>`D` stands for default color (depends on the frontend theme). To return to the default value, click the *Use default* button in the color picker. | |*Seconds* |Mark the checkbox to display seconds. Otherwise only hours and minutes will be displayed.| |*Format* |Select to display a 24-hour or 12-hour time. | |_**Time zone**_ || |*Bold* |Mark the checkbox to display time zone in bold type. | |*Color* |Select the time zone color from the color picker.<br>`D` stands for default color (depends on the frontend theme). To return to the default value, click the *Use default* button in the color picker. | |*Time zone*|Select the time zone.| |*Format* |Select to display time zone in short format (e.g. `New York`) or full format (e.g.`(UTC-04:00) America/New York`). | #### Papildu konfigurācija Papildu konfigurācijas opcijas ir pieejamas sakļaujamajā sadaļā *Papildu konfigurācija*, un tikai tiem elementiem, kas ir atlasīti laukā *Rādīt* (skatīt iepriekš). Papildus tam papildu konfigurācija ļauj mainīt visa logrīka fona krāsu. {width=600} | | | |--|--------| |*Fona krāsa* |Atlasiet fona krāsu krāsu atlasītājā.<br>`D` apzīmē noklusējuma krāsu (atkarīga no lietotāja saskarnes tēmas). Lai atgrieztos pie noklusējuma vērtības, krāsu atlasītājā noklikšķiniet uz pogas *Use default*. | |_**Datums**_ || |*Treknraksts* |Atzīmējiet izvēles rūtiņu, lai datumu attēlotu treknrakstā. | |*Krāsa* |Atlasiet datuma krāsu krāsu atlasītājā.<br>`D` apzīmē noklusējuma krāsu (atkarīga no lietotāja saskarnes tēmas). Lai atgrieztos pie noklusējuma vērtības, krāsu atlasītājā noklikšķiniet uz pogas *Use default*. | |_**Laiks**_ || |*Treknraksts* |Atzīmējiet izvēles rūtiņu, lai laiku attēlotu treknrakstā. | |*Krāsa* |Atlasiet laika krāsu krāsu atlasītājā.<br>`D` apzīmē noklusējuma krāsu (atkarīga no lietotāja saskarnes tēmas). Lai atgrieztos pie noklusējuma vērtības, krāsu atlasītājā noklikšķiniet uz pogas *Use default*. | |*Sekundes* |Atzīmējiet izvēles rūtiņu, lai attēlotu sekundes. Pretējā gadījumā tiks attēlotas tikai stundas un minūtes.| |*Formāts* |Atlasiet, vai attēlot laiku 24 stundu vai 12 stundu formātā. | |_**Laika josla**_ || |*Treknraksts* |Atzīmējiet izvēles rūtiņu, lai laika joslu attēlotu treknrakstā. | |*Krāsa* |Atlasiet laika joslas krāsu krāsu atlasītājā.<br>`D` apzīmē noklusējuma krāsu (atkarīga no lietotāja saskarnes tēmas). Lai atgrieztos pie noklusējuma vērtības, krāsu atlasītājā noklikšķiniet uz pogas *Use default*. | |*Laika josla*|Atlasiet laika joslu.| |*Formāts* |Atlasiet, vai attēlot laika joslu īsajā formātā (piemēram, `New York`) vai pilnajā formātā (piemēram, `(UTC-04:00) America/New York`). | #### Advanced configuration Advanced configuration options are available in the collapsible *Advanced configuration* section, and only for those elements that are selected in the *Show* field (see above). Additionally, advanced configuration allows to change the background color (static or dynamic) for the whole widget. {width="600"} | | | |--|--------| |***Description***|<| |*Description* |Enter the item description. This description may override the default item name. Multiline descriptions are supported. A combination of text and supported macros is possible.<br>{HOST.\*}, {ITEM.\*}, {INVENTORY.\*} and user macros are supported. | |*Horizontal position* |Select horizontal position of the item description - left, right or center. | |*Vertical position* |Select vertical position of the item description - top, bottom or middle. | |*Size* |Enter font size height for the item description (in percent relative to total widget height). | |*Bold* |Mark the checkbox to display item description in bold type. | |*Color* |Select the item description color from the color picker.<br>`D` stands for default color (depends on the frontend theme). To return to the default value, click the *Use default* button in the color picker. | |***Value***|<| |*Decimal places* |Select how many decimal places will be displayed with the value. This value will affect only float items. For items with units set to "s", if this value is greater than 0 (the default is 2), the widget rounds the most significant time unit and displays a numeric value (e.g. "10.43m") instead of converting the value into a full time string. When set to 0, the seconds are converted to a human-readable time string (for example, "4h 56m 30s"). | |*Size* |Enter font size height for the decimal places (in percent relative to total widget height). | |*Horizontal position* |Select horizontal position of the item value - left, right or center. | |*Vertical position* |Select vertical position of the item value - top, bottom or middle. | |*Size* |Enter font size height for the item value (in percent relative to total widget height).<br>Note that the size of item value is prioritized; other elements have to concede space for the value. With the change indicator though, if the value is too large, it will be truncated to show the change indicator. | |*Bold* |Mark the checkbox to display item value in bold type. | |*Color* |Select the item value color from the color picker.<br>`D` stands for default color (depends on the frontend theme). To return to the default value, click the *Use default* button in the color picker. | |***Units***|<| |*Units* |Mark the checkbox to display units with the item value. If you enter a unit name, it will override the unit from item configuration. | |*Position* |Select the item unit position - above, below, before or after the value. | |*Size* |Enter font size height for the item unit (in percent relative to total widget height). | |*Bold* |Mark the checkbox to display item unit in bold type. | |*Color* |Select the item unit color from the color picker.<br>`D` stands for default color (depends on the frontend theme). To return to the default value, click the *Use default* button in the color picker. | |***Time*** *(clock value from item history)*|<| |*Horizontal position* |Select horizontal position of the time - left, right or center. | |*Vertical position* |Select vertical position of the time - top, bottom or middle. | |*Size* |Enter font size height for the time (in percent relative to total widget height). | |*Bold* |Mark the checkbox to display time in bold type. | |*Color* |Select the time color from the color picker.<br>`D` stands for default color (depends on the frontend theme). To return to the default value, click the *Use default* button in the color picker. | |***Change indicator***|Select the color of change indicators from the color picker. The change indicators are as follows:<br>**↑** - item value is up (for numeric items)<br>**↓** - item value is down (for numeric items)<br>**↕** - item value has changed (for string items and items with value mapping)<br>`D` stands for default color (depends on the frontend theme). To return to the default value, click the *Use default* button in the color picker.<br>Vertical size of the change indicator is equal to the size of the value (integer part of the value for numeric items).<br>Note that up and down indicators are not shown with just one value. | |***Background color***|Select the background color for the whole widget from the color picker.<br>`D` stands for default color (depends on the frontend theme). To return to the default value, click the *Use default* button in the color picker. | |***Thresholds***|Configure the dynamic background color for the whole widget. Click *Add* to add a threshold, select the background color from the color picker, and specify a numeric value. Once the item value equals or is greater than the threshold value, the background color will change.<br>The list will be sorted in ascending order when saved.<br>Note that the dynamic background color will be displayed correctly only for numeric items.| |***Aggregation function***|Specify which aggregation function to use within the selected *Time period*:<br>**min** - display the smallest value;<br>**max** - display the largest value;<br>**avg** - display the average value;<br>**count** - display the count of values;<br>**sum** - display the sum of values;<br>**first** - display the first value;<br>**last** - display the last value.<br>If **not used** is selected, the most recent value is displayed (no aggregation).<br><br>Aggregation allows to display an aggregated value for the chosen interval (5 minutes, an hour, a day), instead of the most recent value.<br>Only numeric data can be displayed for *min*, *max*, *avg* and *sum*. For *count*, non-numeric data will be changed to numeric.| |***Time period***|Specify the time period to use for aggregating values:<br>**Dashboard** - use time period of the dashboard;<br>**Widget** - use time period of the specified widget;<br>**Custom** - use a custom time period.<br>This parameter is hidden when *Aggregation function* is set to "not used". | |*Widget*|Select the widget.<br>This parameter will only be displayed if *Time period* is set to "Widget".| |*From*|Select the time period from (default value `now-1h`). See [relative time syntax](/manual/web_interface/time_period_selector).<br>This parameter will only be displayed if *Time period* is set to "Custom".| |*To*|Select the time period to (default value `now`). See [relative time syntax](/manual/web_interface/time_period_selector).<br>This parameter will only be displayed if *Time period* is set to "Custom".| |***History data***|Take data from history or trends:<br>**Auto** - automatic selection;<br>**History** - take history data;<br>**Trends** - take trend data.<br><br>This setting applies only to numeric data. Non-numeric data will always be taken from history.| Note that multiple elements cannot occupy the same space; if they are placed in the same space, an error message will be displayed. #### Papildu konfigurācija Papildu konfigurācijas opcijas ir pieejamas salokāmajā *Papildu konfigurācija* sadaļā un tikai tiem elementiem, kas ir atlasīti laukā *Rādīt* (skatiet iepriekš). Turklāt papildu konfigurācija ļauj mainīt visa sīkrīka fona krāsu (statisku vai dinamisku). {width="600"} | | | |--|--------| |***Apraksts***|<| |*Apraksts* |Ievadiet vienuma aprakstu. Šis apraksts var aizstāt noklusējuma vienuma nosaukumu. Tiek atbalstīti vairāku rindu apraksti. Iespējama teksta un atbalstīto makro kombinācija.<br>{HOST.\*}, {ITEM.\*}, {INVENTORY.\*} un lietotāja makro tiek atbalstīti. | |*Horizontālā pozīcija* |Atlasiet vienuma apraksta horizontālo pozīciju - pa kreisi, pa labi vai centrā. | |*Vertikālā pozīcija* |Atlasiet vienuma apraksta vertikālo pozīciju - augšā, apakšā vai vidū. | |*Izmērs* |Ievadiet vienuma apraksta fonta lielumu (procentos no kopējā sīkrīka augstuma). | |*Treknraksts* |Atzīmējiet izvēles rūtiņu, lai vienuma apraksts tiktu rādīts treknrakstā. | |*Krāsa* |Atlasiet vienuma apraksta krāsu krāsu atlasītājā.<br>`D` apzīmē noklusējuma krāsu (atkarīga no lietotāja saskarnes motīva). Lai atgrieztos pie noklusējuma vērtības, krāsu atlasītājā noklikšķiniet uz pogas *Lietot noklusējumu*. | |***Vērtība***|<| |*Decimāldaļu skaits* |Atlasiet, cik decimāldaļas tiks rādītas kopā ar vērtību. Šī vērtība ietekmēs tikai peldošā komata vienumus. Vienumiem ar vienībām, kas iestatītas uz "s", ja šī vērtība ir lielāka par 0 (noklusējums ir 2), sīkrīks noapaļo nozīmīgāko laika vienību un parāda skaitlisku vērtību (piem., "10.43m"), nevis pārvērš vērtību pilnā laika virknē. Ja iestatīts 0, sekundes tiek pārvērstas cilvēkam saprotamā laika virknē (piemēram, "4h 56m 30s"). | |*Izmērs* |Ievadiet decimāldaļu fonta lielumu (procentos no kopējā sīkrīka augstuma). | |*Horizontālā pozīcija* |Atlasiet vienuma vērtības horizontālo pozīciju - pa kreisi, pa labi vai centrā. | |*Vertikālā pozīcija* |Atlasiet vienuma vērtības vertikālo pozīciju - augšā, apakšā vai vidū. | |*Izmērs* |Ievadiet vienuma vērtības fonta lielumu (procentos no kopējā sīkrīka augstuma).<br>Ņemiet vērā, ka vienuma vērtības izmēram ir prioritāte; citiem elementiem ir jāatbrīvo vieta vērtībai. Tomēr ar izmaiņu indikatoru, ja vērtība ir pārāk liela, tā tiks saīsināta, lai parādītu izmaiņu indikatoru. | |*Treknraksts* |Atzīmējiet izvēles rūtiņu, lai vienuma vērtība tiktu rādīta treknrakstā. | |*Krāsa* |Atlasiet vienuma vērtības krāsu krāsu atlasītājā.<br>`D` apzīmē noklusējuma krāsu (atkarīga no lietotāja saskarnes motīva). Lai atgrieztos pie noklusējuma vērtības, krāsu atlasītājā noklikšķiniet uz pogas *Lietot noklusējumu*. | |***Vienības***|<| |*Vienības* |Atzīmējiet izvēles rūtiņu, lai kopā ar vienuma vērtību rādītu vienības. Ja ievadīsiet vienības nosaukumu, tas aizstās vienību no vienuma konfigurācijas. | |*Pozīcija* |Atlasiet vienuma vienības pozīciju - virs, zem, pirms vai pēc vērtības. | |*Izmērs* |Ievadiet vienuma vienības fonta lielumu (procentos no kopējā sīkrīka augstuma). | |*Treknraksts* |Atzīmējiet izvēles rūtiņu, lai vienuma vienība tiktu rādīta treknrakstā. | |*Krāsa* |Atlasiet vienuma vienības krāsu krāsu atlasītājā.<br>`D` apzīmē noklusējuma krāsu (atkarīga no lietotāja saskarnes motīva). Lai atgrieztos pie noklusējuma vērtības, krāsu atlasītājā noklikšķiniet uz pogas *Lietot noklusējumu*. | |***Laiks*** *(pulksteņa vērtība no vienuma vēstures)*|<| |*Horizontālā pozīcija* |Atlasiet laika horizontālo pozīciju - pa kreisi, pa labi vai centrā. | |*Vertikālā pozīcija* |Atlasiet laika vertikālo pozīciju - augšā, apakšā vai vidū. | |*Izmērs* |Ievadiet laika fonta lielumu (procentos no kopējā sīkrīka augstuma). | |*Treknraksts* |Atzīmējiet izvēles rūtiņu, lai laiks tiktu rādīts treknrakstā. | |*Krāsa* |Atlasiet laika krāsu krāsu atlasītājā.<br>`D` apzīmē noklusējuma krāsu (atkarīga no lietotāja saskarnes motīva). Lai atgrieztos pie noklusējuma vērtības, krāsu atlasītājā noklikšķiniet uz pogas *Lietot noklusējumu*. | |***Izmaiņu indikators***|Atlasiet izmaiņu indikatoru krāsu krāsu atlasītājā. Izmaiņu indikatori ir šādi:<br>**↑** - vienuma vērtība pieaug (skaitliskiem vienumiem)<br>**↓** - vienuma vērtība samazinās (skaitliskiem vienumiem)<br>**↕** - vienuma vērtība ir mainījusies (teksta vienumiem un vienumiem ar vērtību kartējumu)<br>`D` apzīmē noklusējuma krāsu (atkarīga no lietotāja saskarnes motīva). Lai atgrieztos pie noklusējuma vērtības, krāsu atlasītājā noklikšķiniet uz pogas *Lietot noklusējumu*.<br>Izmaiņu indikatora vertikālais izmērs ir vienāds ar vērtības izmēru (skaitlisku vienumu vērtības veselā skaitļa daļai).<br>Ņemiet vērā, ka augšup un lejup indikatori netiek rādīti tikai ar vienu vērtību. | |***Fona krāsa***|Atlasiet visa sīkrīka fona krāsu krāsu atlasītājā.<br>`D` apzīmē noklusējuma krāsu (atkarīga no lietotāja saskarnes motīva). Lai atgrieztos pie noklusējuma vērtības, krāsu atlasītājā noklikšķiniet uz pogas *Lietot noklusējumu*. | |***Sliekšņi***|Konfigurējiet visa sīkrīka dinamisko fona krāsu. Noklikšķiniet uz *Pievienot*, lai pievienotu slieksni, atlasiet fona krāsu krāsu atlasītājā un norādiet skaitlisku vērtību. Tiklīdz vienuma vērtība ir vienāda ar sliekšņa vērtību vai to pārsniedz, fona krāsa mainīsies.<br>Saglabājot saraksts tiks sakārtots augošā secībā.<br>Ņemiet vērā, ka dinamiskā fona krāsa tiks pareizi parādīta tikai skaitliskiem vienumiem.| |***Agregācijas funkcija***|Norādiet, kuru agregācijas funkciju izmantot atlasītajā *Laika periodā*:<br>**min** - parādīt mazāko vērtību;<br>**max** - parādīt lielāko vērtību;<br>**avg** - parādīt vidējo vērtību;<br>**count** - parādīt vērtību skaitu;<br>**sum** - parādīt vērtību summu;<br>**first** - parādīt pirmo vērtību;<br>**last** - parādīt pēdējo vērtību.<br>Ja ir atlasīts **netiek izmantots**, tiek parādīta jaunākā vērtība (bez agregācijas).<br><br>Agregācija ļauj parādīt agregētu vērtību izvēlētajam intervālam (5 minūtes, stunda, diena), nevis jaunāko vērtību.<br>Tikai skaitliskus datus var parādīt *min*, *max*, *avg* un *sum*. *count* gadījumā neskaitliskie dati tiks pārveidoti par skaitliskiem.| |***Laika periods***|Norādiet laika periodu, ko izmantot vērtību agregēšanai:<br>**Panelis** - izmantot paneļa laika periodu;<br>**Sīkrīks** - izmantot norādītā sīkrīka laika periodu;<br>**Pielāgots** - izmantot pielāgotu laika periodu.<br>Šis parametrs ir paslēpts, ja *Agregācijas funkcija* ir iestatīta uz "netiek izmantots". | |*Sīkrīks*|Atlasiet sīkrīku.<br>Šis parametrs tiks rādīts tikai tad, ja *Laika periods* ir iestatīts uz "Sīkrīks".| |*No*|Atlasiet laika periodu no (noklusējuma vērtība `now-1h`). Skatiet [relatīvā laika sintaksi](/manual/web_interface/time_period_selector).<br>Šis parametrs tiks rādīts tikai tad, ja *Laika periods* ir iestatīts uz "Pielāgots".| |*Līdz*|Atlasiet laika periodu līdz (noklusējuma vērtība `now`). Skatiet [relatīvā laika sintaksi](/manual/web_interface/time_period_selector).<br>Šis parametrs tiks rādīts tikai tad, ja *Laika periods* ir iestatīts uz "Pielāgots".| |***Vēstures dati***|Ņemt datus no vēstures vai tendencēm:<br>**Auto** - automātiska atlase;<br>**Vēsture** - ņemt vēstures datus;<br>**Tendences** - ņemt tendenču datus.<br><br>Šis iestatījums attiecas tikai uz skaitliskiem datiem. Neskaitliskie dati vienmēr tiks ņemti no vēstures.| Ņemiet vērā, ka vairāki elementi nevar aizņemt vienu un to pašu vietu; ja tie tiks novietoti vienā un tajā pašā vietā, tiks parādīts kļūdas ziņojums. ##### Advanced configuration Advanced configuration options are available in the collapsible *Advanced configuration* section: {width="600"} | | | |--|--------| |*Angle*|Select the gauge angle (180° or 270°).| |***Description***|<| |*Description*|Enter the item description. This description may override the default item name.<br>Multiline descriptions are supported. A combination of text and supported macros is possible.<br>{HOST.\*}, {ITEM.\*}, {INVENTORY.\*} and user macros are supported.| |*Size*|Enter the font size height for the item description (in percent, relative to the total widget height).| |*Vertical position*|Select the vertical position of the item description (top or bottom, relative to the gauge arc).| |*Bold*|Mark the checkbox to display the item description in bold.| |*Color*|Select the item description color from the color picker.<br>"D" stands for the default color, which depends on the frontend theme. To return to the default color, click the *Use default* button in the color picker.| |***Value***|<| |*Decimal places*|Enter the number of decimal places to display with the value.<br>This option affects only items that return [numeric (float)](/manual/config/items/item#configuration) data.| |*Size*|Enter the font size height for the value (in percent, relative to the gauge arc height).| |*Bold*|Mark the checkbox to display the value in bold.| |*Color*|Select the value color from the color picker.<br>"D" stands for the default color, which depends on the frontend theme. To return to the default color, click the *Use default* button in the color picker.| |***Units***|<| |*Units*|Mark the checkbox to display units with the item value.<br>If you enter a unit name, it will override the units set in the [item configuration](/manual/config/items/item#configuration).| |*Size*|Enter the font size height for the item units (in percent, relative to the gauge arc height).| |*Bold*|Mark the checkbox to display item units in bold.| |*Position*|Select the position of the item units (above, below, before or after, relative to the item value).<br>This option is ignored for the following [time-related units](/manual/config/items/item#configuration): unixtime, uptime, s.| |*Color*|Select the item units color from the color picker.<br>"D" stands for the default color, which depends on the frontend theme. To return to the default color, click the *Use default* button in the color picker.| |***Value arc***|<| |*Arc size*|Enter the size height of the gauge value arc (in percent, relative to the gauge arc radius).| |***Needle***|<| |*Color*|Select the gauge needle color from the color picker.<br>"D" stands for the default color, which depends on the frontend theme. If *Thresholds* are set, the default color for the needle depends on the threshold color. To return to the default color, click the *Use default* button in the color picker.| |***Scale***|<| |*Show units*|Mark the checkbox to display units with the minimum and maximum value of the gauge.| |*Size*|Enter the font size height for the minimum and maximum value of the gauge (in percent, relative to the gauge arc height).| |*Decimal places*|Enter the number of decimal places to display with the minimum and maximum value of the gauge.<br>This option affects only items that return [numeric (float)](/manual/config/items/item#configuration) data.| |***Thresholds***|<| |*Thresholds*|Click *Add* to add a threshold, select a threshold color from the color picker, and specify a numeric value.<br>The thresholds list will be sorted in ascending order when saved.<br>Note that the colors configured as thresholds will be displayed correctly only for numeric items.<br>[Suffixes](/manual/appendix/suffixes) (for example, "1d", "2w", "4K", "8G") are supported. [Value mappings](/manual/config/items/mapping) are supported.| |*Show labels*|Mark the checkbox to display threshold values as labels on the gauge scale.| |*Show arc*|Mark the checkbox to display the gauge thresholds arc.| |*Arc size*|Enter the size height of the gauge thresholds arc (in percent, relative to the gauge arc radius).| ##### Papildu konfigurācija Papildu konfigurācijas opcijas ir pieejamas salokāmajā sadaļā *Papildu konfigurācija*: {width="600"} | | | |--|--------| |*Leņķis*|Izvēlieties mērierīces leņķi (180° vai 270°).| |***Apraksts***|<| |*Apraksts*|Ievadiet vienuma aprakstu. Šis apraksts var aizstāt noklusējuma vienuma nosaukumu.<br>Tiek atbalstīti vairākrindu apraksti. Ir iespējama teksta un atbalstīto makrosu kombinācija.<br>Tiek atbalstīti {HOST.\*}, {ITEM.\*}, {INVENTORY.\*} un lietotāja makrosi.| |*Izmērs*|Ievadiet vienuma apraksta fonta izmēra augstumu (procentos attiecībā pret kopējo logrīka augstumu).| |*Vertikālā pozīcija*|Izvēlieties vienuma apraksta vertikālo pozīciju (augšā vai apakšā attiecībā pret mērierīces loku).| |*Treknraksts*|Atzīmējiet izvēles rūtiņu, lai vienuma aprakstu attēlotu treknrakstā.| |*Krāsa*|Izvēlieties vienuma apraksta krāsu krāsu atlasītājā.<br>"D" apzīmē noklusējuma krāsu, kas ir atkarīga no lietotāja saskarnes tēmas. Lai atgrieztos pie noklusējuma krāsas, krāsu atlasītājā noklikšķiniet uz pogas *Use default*.| |***Vērtība***|<| |*Decimālzīmes*|Ievadiet ar vērtību attēlojamo zīmju skaitu aiz komata.<br>Šī opcija ietekmē tikai vienumus, kas atgriež [numeric (float)](/manual/config/items/item#configuration) datus.| |*Izmērs*|Ievadiet vērtības fonta izmēra augstumu (procentos attiecībā pret mērierīces loka augstumu).| |*Treknraksts*|Atzīmējiet izvēles rūtiņu, lai vērtību attēlotu treknrakstā.| |*Krāsa*|Izvēlieties vērtības krāsu krāsu atlasītājā.<br>"D" apzīmē noklusējuma krāsu, kas ir atkarīga no lietotāja saskarnes tēmas. Lai atgrieztos pie noklusējuma krāsas, krāsu atlasītājā noklikšķiniet uz pogas *Use default*.| |***Mērvienības***|<| |*Mērvienības*|Atzīmējiet izvēles rūtiņu, lai kopā ar vienuma vērtību attēlotu mērvienības.<br>Ja ievadīsiet mērvienības nosaukumu, tas aizstās [vienuma konfigurācijā](/manual/config/items/item#configuration) iestatītās mērvienības.| |*Izmērs*|Ievadiet vienuma mērvienību fonta izmēra augstumu (procentos attiecībā pret mērierīces loka augstumu).| |*Treknraksts*|Atzīmējiet izvēles rūtiņu, lai vienuma mērvienības attēlotu treknrakstā.| |*Pozīcija*|Izvēlieties vienuma mērvienību pozīciju (virs, zem, pirms vai pēc attiecībā pret vienuma vērtību).<br>Šī opcija tiek ignorēta šādām ar laiku saistītām [mērvienībām](/manual/config/items/item#configuration): unixtime, uptime, s.| |*Krāsa*|Izvēlieties vienuma mērvienību krāsu krāsu atlasītājā.<br>"D" apzīmē noklusējuma krāsu, kas ir atkarīga no lietotāja saskarnes tēmas. Lai atgrieztos pie noklusējuma krāsas, krāsu atlasītājā noklikšķiniet uz pogas *Use default*.| |***Vērtības loks***|<| |*Loka izmērs*|Ievadiet mērierīces vērtības loka izmēra augstumu (procentos attiecībā pret mērierīces loka rādiusu).| |***Rādītājs***|<| |*Krāsa*|Izvēlieties mērierīces rādītāja krāsu krāsu atlasītājā.<br>"D" apzīmē noklusējuma krāsu, kas ir atkarīga no lietotāja saskarnes tēmas. Ja ir iestatīti *Sliekšņi*, rādītāja noklusējuma krāsa ir atkarīga no sliekšņa krāsas. Lai atgrieztos pie noklusējuma krāsas, krāsu atlasītājā noklikšķiniet uz pogas *Use default*.| |***Skala***|<| |*Rādīt mērvienības*|Atzīmējiet izvēles rūtiņu, lai kopā ar mērierīces minimālo un maksimālo vērtību attēlotu mērvienības.| |*Izmērs*|Ievadiet mērierīces minimālās un maksimālās vērtības fonta izmēra augstumu (procentos attiecībā pret mērierīces loka augstumu).| |*Decimālzīmes*|Ievadiet ar mērierīces minimālo un maksimālo vērtību attēlojamo zīmju skaitu aiz komata.<br>Šī opcija ietekmē tikai vienumus, kas atgriež [numeric (float)](/manual/config/items/item#configuration) datus.| |***Sliekšņi***|<| |*Sliekšņi*|Noklikšķiniet uz *Add*, lai pievienotu slieksni, izvēlieties sliekšņa krāsu krāsu atlasītājā un norādiet skaitlisku vērtību.<br>Saglabājot sliekšņu saraksts tiks sakārtots augošā secībā.<br>Ņemiet vērā, ka kā sliekšņi konfigurētās krāsas tiks attēlotas pareizi tikai skaitliskiem vienumiem.<br>Tiek atbalstīti [sufiksi](/manual/appendix/suffixes) (piemēram, "1d", "2w", "4K", "8G"). Tiek atbalstītas [vērtību kartēšanas](/manual/config/items/mapping).| |*Rādīt etiķetes*|Atzīmējiet izvēles rūtiņu, lai sliekšņu vērtības attēlotu kā etiķetes uz mērierīces skalas.| |*Rādīt loku*|Atzīmējiet izvēles rūtiņu, lai attēlotu mērierīces sliekšņu loku.| |*Loka izmērs*|Ievadiet mērierīces sliekšņu loka izmēra augstumu (procentos attiecībā pret mērierīces loka rādiusu).| #### Advanced configuration Advanced configuration options are available in the collapsible *Advanced configuration* section:  | | | |--|--------| |*New values*|Select where new item values should be added:<br>**Top** - at the top of columns;<br>**Bottom** - at the bottom of columns.| |*Show timestamp*|Mark this checkbox to display the timestamp column (unmarked by default).| |*Show column header*|Select the column header orientation:<br>**Off** - hide the header;<br>**Horizontal** - display the header horizontally;<br>**Vertical** - display the header vertically.| |[*Time period*](/manual/web_interface/frontend_sections/dashboards/widgets#dynamic-parameters)|Select the data source for the time period:<br>**Dashboard** - set the [*Time period* selector](/manual/web_interface/time_period_selector) as the data source;<br>**Widget** - set a compatible widget specified in the *Widget* parameter as the data source;<br>**Custom** - set the time period specified in the *From* and *To* parameters as the data source; if set, a clock icon will be displayed in the top right corner of the widget, indicating the set time on mouseover.| |*Widget*|Enter or select a compatible widget (*Graph*, *Graph (classic)*, *Graph prototype*) as the data source for the time period.<br>This parameter is available if *Time period* is set to "Widget".| |*From*|Enter or select the start of the time period.<br>[Relative time syntax](/manual/web_interface/time_period_selector) (`now`, `now/d`, `now/w-1w`, etc.) is supported.<br>This parameter is available if *Time period* is set to "Custom".| |*To*|Enter or select the end of the time period.<br>[Relative time syntax](/manual/web_interface/time_period_selector) (`now`, `now/d`, `now/w-1w`, etc.) is supported.<br>This parameter is available if *Time period* is set to "Custom".| #### Papildu konfigurācija Papildu konfigurācijas opcijas ir pieejamas salokāmajā *Papildu konfigurācija* sadaļā:  | | | |--|--------| |*Jaunās vērtības*|Atlasiet, kur jāpievieno jaunas vienuma vērtības:<br>**Top** - kolonnu augšpusē;<br>**Bottom** - kolonnu apakšpusē.| |*Rādīt laika zīmogu*|Atzīmējiet šo izvēles rūtiņu, lai parādītu laika zīmoga kolonnu (pēc noklusējuma nav atzīmēta).| |*Rādīt kolonnas galveni*|Atlasiet kolonnas galvenes orientāciju:<br>**Off** - paslēpt galveni;<br>**Horizontal** - rādīt galveni horizontāli;<br>**Vertical** - rādīt galveni vertikāli.| |[*Laika periods*](/manual/web_interface/frontend_sections/dashboards/widgets#dynamic-parameters)|Atlasiet datu avotu laika periodam:<br>**Dashboard** - iestatiet [*Laika perioda* atlasītāju](/manual/web_interface/time_period_selector) kā datu avotu;<br>**Widget** - iestatiet ar *Widget* parametru norādītu saderīgu logrīku kā datu avotu;<br>**Custom** - iestatiet laika periodu, kas norādīts parametros *From* un *To*, kā datu avotu; ja tas ir iestatīts, logrīka augšējā labajā stūrī tiks parādīta pulksteņa ikona, norādot iestatīto laiku, kad uz tās novieto peles kursoru.| |*Widget*|Ievadiet vai atlasiet saderīgu logrīku (*Graph*, *Graph (classic)*, *Graph prototype*) kā laika perioda datu avotu.<br>Šis parametrs ir pieejams, ja *Laika periods* ir iestatīts uz "Widget".| |*From*|Ievadiet vai atlasiet laika perioda sākumu.<br>Tiek atbalstīta [relatīvā laika sintakse](/manual/web_interface/time_period_selector) (`now`, `now/d`, `now/w-1w` u. c.).<br>Šis parametrs ir pieejams, ja *Laika periods* ir iestatīts uz "Custom".| |*To*|Ievadiet vai atlasiet laika perioda beigas.<br>Tiek atbalstīta [relatīvā laika sintakse](/manual/web_interface/time_period_selector) (`now`, `now/d`, `now/w-1w` u. c.).<br>Šis parametrs ir pieejams, ja *Laika periods* ir iestatīts uz "Custom".| #### Advanced configuration {width=600} |Parameter|Description| |--|--------| |_**Additional rules**_|Click on *Add* to configure additional status calculation rules.| |*Set status to*|Set service status to either *OK* (default), *Not classified*, *Information*, *Warning*, *Average*, *High* or *Disaster* in case of a condition match.| |*Condition*|Select the condition for direct child services:<br>**if at least (N) child services have (Status) status or above**<br>**if at least (N%) of child services have (Status) status or above**<br>**if less than (N) child services have (Status) status or below**<br>**if less than (N%) of child services have (Status) status or below**<br>**if weight of child services with (Status) status or above is at least (W)**<br>**if weight of child services with (Status) status or above is at least (N%)**<br>**if weight of child services with (Status) status or below is less than (W)**<br>**if weight of child services with (Status) status or below is less than (N%)** <br><br> If several conditions are specified and the situation matches more than one condition, the highest severity will be set.| |*N (W)*|Set the value of N or W (1-100000), or N% (1-100) in the condition.| |*Status*|Select the value of *Status* in the condition: *OK* (default), *Not classified*, *Information*, *Warning*, *Average*, *High* or *Disaster*.| |_**Status propagation rule**_|Rule for propagating the service status to the parent service:<br>**As is** - the status is propagated without change<br>**Increase by** - you may increase the propagated status by 1 to 5 severities<br>**Decrease by** - you may decrease the propagated status by 1 to 5 severities<br>**Ignore this service** - the status is not propagated to the parent service at all<br>**Fixed status** - the status is propagated statically, i.e. as always the same| |_**Weight**_|Weight of the service (integer in the range from 0 (default) to 1000000).| :::noteclassic Additional status calculation rules can only be used to increase severity level over the level calculated according to the main *Status calculation rule* parameter. If according to additional rules the status should be Warning, but according to the *Status calculation rule* the status is Disaster - the service will have status Disaster. ::: #### Papildu konfigurācija {width=600} |Parametrs|Apraksts| |--|--------| |_**Papildu noteikumi**_|Noklikšķiniet uz *Add*, lai konfigurētu papildu statusa aprēķināšanas noteikumus.| |*Iestatīt statusu uz*|Iestatiet pakalpojuma statusu uz *OK* (noklusējums), *Not classified*, *Information*, *Warning*, *Average*, *High* vai *Disaster* gadījumā, ja nosacījums sakrīt.| |*Nosacījums*|Atlasiet nosacījumu tiešajiem pakārtotajiem pakalpojumiem:<br>**ja vismaz (N) pakārtotajiem pakalpojumiem ir statuss (Status) vai augstāks**<br>**ja vismaz (N%) pakārtoto pakalpojumu ir statuss (Status) vai augstāks**<br>**ja mazāk nekā (N) pakārtotajiem pakalpojumiem ir statuss (Status) vai zemāks**<br>**ja mazāk nekā (N%) pakārtoto pakalpojumu ir statuss (Status) vai zemāks**<br>**ja pakārtoto pakalpojumu svars ar statusu (Status) vai augstāku ir vismaz (W)**<br>**ja pakārtoto pakalpojumu svars ar statusu (Status) vai augstāku ir vismaz (N%)**<br>**ja pakārtoto pakalpojumu svars ar statusu (Status) vai zemāku ir mazāks par (W)**<br>**ja pakārtoto pakalpojumu svars ar statusu (Status) vai zemāku ir mazāks par (N%)** <br><br> Ja ir norādīti vairāki nosacījumi un situācija atbilst vairāk nekā vienam nosacījumam, tiks iestatīta visaugstākā nopietnības pakāpe.| |*N (W)*|Iestatiet N vai W vērtību (1-100000) vai N% (1-100) nosacījumā.| |*Statuss*|Atlasiet nosacījumā vērtību *Status*: *OK* (noklusējums), *Not classified*, *Information*, *Warning*, *Average*, *High* vai *Disaster*.| |_**Statusa pārmantošanas noteikums**_|Noteikums pakalpojuma statusa pārmantošanai uz vecāko pakalpojumu:<br>**Kā ir** - statuss tiek pārmantots bez izmaiņām<br>**Palielināt par** - varat palielināt pārmantoto statusu par 1 līdz 5 nopietnības pakāpēm<br>**Samazināt par** - varat samazināt pārmantoto statusu par 1 līdz 5 nopietnības pakāpēm<br>**Ignorēt šo pakalpojumu** - statuss vispār netiek pārmantots uz vecāko pakalpojumu<br>**Fiksēts statuss** - statuss tiek pārmantots statiski, t. i., vienmēr kā viens un tas pats| |_**Svars**_|Pakalpojuma svars (vesels skaitlis diapazonā no 0 (noklusējums) līdz 1000000).| :::noteclassic Papildu statusa aprēķināšanas noteikumus var izmantot tikai, lai palielinātu nopietnības līmeni virs līmeņa, kas aprēķināts saskaņā ar galveno parametru *Status calculation rule*. Ja saskaņā ar papildu noteikumiem statusam jābūt Warning, bet saskaņā ar parametru *Status calculation rule* statuss ir Disaster - pakalpojumam būs statuss Disaster. ::: #### Advanced configuration The following advanced configuration parameters are supported for the *Gauge* widget. ::: noteclassic The number in the *Thresholds* property name (e.g. thresholds.0.color) references the threshold place in a list, sorted in ascending order. However, if thresholds are configured in a different order, the values will be sorted in ascending order after updating widget configuration in Zabbix frontend (e.g. `"thresholds.0.threshold":"5"` → `"thresholds.0.threshold":"1"`; `"thresholds.1.threshold":"1"` → `"thresholds.1.threshold": "5"`). ::: |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Angle*|0|angle|Possible values: 180 *(default)* or 270.| |***Description***|<|<|<| |*Description*|1|description|Any string value, including macros.<br>Supported macros: {HOST.\*}, {ITEM.\*}, {INVENTORY.\*}, user macros.<br><br>Default: {ITEM.NAME}.| |*Size*|0|desc_size|Possible values range from 1-100.<br><br>Default: 15.| |*Vertical position*|0|desc_v_pos|0 - Top;<br>1 - *(default)* Bottom.| |*Bold*|0|desc_bold|0 - *(default)* Disabled;<br>1 - Enabled.| |*Color*|1|desc_color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `""` (empty).| |***Value***|<|<|<| |*Decimal places*|0|decimal_places|Possible values range from 1-10.<br><br>Default: 2.| |*Size*|0|value_size|Possible values range from 1-100.<br><br>Default: 25.| |*Bold*|0|value_bold|0 - *(default)* Disabled;<br>1 - Enabled.| |*Color*|1|value_color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `""` (empty).| |***Units***|<|<|<| |*Units* (checkbox)|0|units_show|0 - Disabled;<br>1 - *(default)* Enabled.| |*Units* (value)|1|units|Any string value.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Units* (checkbox) is set to "Enabled"| |*Size*|0|units_size|Possible values range from 1-100.<br><br>Default: 25.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Units* (checkbox) is set to "Enabled"| |*Bold*|0|units_bold|0 - *(default)* Disabled;<br>1 - Enabled.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Units* (checkbox) is set to "Enabled"| |*Position*|0|units_pos|0 - Before value;<br>1 - Above value;<br>2 - *(default)* After value;<br>3 - Below value.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Units* (checkbox) is set to "Enabled"<br><br>This parameter is ignored if set to one of the following [time-related units](/manual/config/items/item#configuration): unixtime, uptime, s.| |*Color*|1|units_color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `""` (empty).| |***Value arc***|<|<|<| |*Arc size*|0|value_arc_size|Possible values range from 1-100.<br><br>Default: 20.| |***Needle***|<|<|<| |*Color*|1|needle_color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `""` (empty).<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if a dashboard widget field object for *Show* with the value "Value arc" is set, or *Show arc* is set to "Enabled"| |***Scale***|<|<|<| |*Show units*|0|scale_show_units|0 - Disabled;<br>1 - *(default)* Enabled.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Units* (checkbox) is set to "Enabled" and either a dashboard widget field object for *Show* with the value "Value arc" is set, or *Show arc* is set to "Enabled"| |*Size*|0|scale_size|Possible values range from 1-100.<br><br>Default: 15.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if a dashboard widget field object for *Show* with the value "Value arc" is set, or *Show arc* is set to "Enabled"| |*Decimal places*|0|scale_decimal_places|Possible values range from 1-10.<br><br>Default: 0.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if a dashboard widget field object for *Show* with the value "Value arc" is set, or *Show arc* is set to "Enabled"| |***Thresholds***|<|<|<| |*Color*|1|thresholds.0.color|Hexadecimal color code (e.g. `FF0000`).| |*Threshold*|1|thresholds.0.threshold|Any numeric value. [Suffixes](/manual/appendix/suffixes) (e.g. "1d", "2w", "4K", "8G") are supported.| |*Show labels*|0|th_show_labels|0 - *(default)* Disabled;<br>1 - Enabled.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Thresholds* are set and either a dashboard widget field object for *Show* with the value "Value arc" is set or *Show arc* is set to "Enabled"| |*Show arc*|0|th_show_arc|0 - *(default)* Disabled;<br>1 - Enabled.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Thresholds* are set| |*Arc size*|0|th_arc_size|Possible values range from 1-100.<br><br>Default: 5.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Show arc* is set to "Enabled"| #### Paplašinātā konfigurācija Tālāk norādītie paplašinātās konfigurācijas parametri tiek atbalstīti *Gauge* logrīkam. ::: noteclassic Skaitlis *Thresholds* īpašības nosaukumā (piemēram, thresholds.0.color) norāda sliekšņa vietu sarakstā, kas sakārtots augošā secībā. Tomēr, ja sliekšņi ir konfigurēti citā secībā, pēc logrīka konfigurācijas atjaunināšanas Zabbix lietotāja saskarnē vērtības tiks sakārtotas augošā secībā (piemēram, `"thresholds.0.threshold":"5"` → `"thresholds.0.threshold":"1"`; `"thresholds.1.threshold":"1"` → `"thresholds.1.threshold": "5"`). ::: |Parametrs|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Leņķis*|0|angle|Iespējamās vērtības: 180 *(noklusējums)* vai 270.| |***Apraksts***|<|<|<| |*Apraksts*|1|description|Jebkura virknes vērtība, ieskaitot makrosus.<br>Atbalstītie makrosi: {HOST.\*}, {ITEM.\*}, {INVENTORY.\*}, lietotāja makrosi.<br><br>Noklusējums: {ITEM.NAME}.| |*Izmērs*|0|desc_size|Iespējamās vērtības diapazonā no 1 līdz 100.<br><br>Noklusējums: 15.| |*Vertikālā pozīcija*|0|desc_v_pos|0 - Augšā;<br>1 - *(noklusējums)* Apakšā.| |*Treknraksts*|0|desc_bold|0 - *(noklusējums)* Atspējots;<br>1 - Iespējots.| |*Krāsa*|1|desc_color|Heksadecimāls krāsas kods (piemēram, `FF0000`).<br><br>Noklusējums: `""` (tukšs).| |***Vērtība***|<|<|<| |*Decimālvietas*|0|decimal_places|Iespējamās vērtības diapazonā no 1 līdz 10.<br><br>Noklusējums: 2.| |*Izmērs*|0|value_size|Iespējamās vērtības diapazonā no 1 līdz 100.<br><br>Noklusējums: 25.| |*Treknraksts*|0|value_bold|0 - *(noklusējums)* Atspējots;<br>1 - Iespējots.| |*Krāsa*|1|value_color|Heksadecimāls krāsas kods (piemēram, `FF0000`).<br><br>Noklusējums: `""` (tukšs).| |***Mērvienības***|<|<|<| |*Mērvienības* (izvēles rūtiņa)|0|units_show|0 - Atspējots;<br>1 - *(noklusējums)* Iespējots.| |*Mērvienības* (vērtība)|1|units|Jebkura virknes vērtība.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja *Mērvienības* (izvēles rūtiņa) ir iestatīta uz "Iespējots"| |*Izmērs*|0|units_size|Iespējamās vērtības diapazonā no 1 līdz 100.<br><br>Noklusējums: 25.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja *Mērvienības* (izvēles rūtiņa) ir iestatīta uz "Iespējots"| |*Treknraksts*|0|units_bold|0 - *(noklusējums)* Atspējots;<br>1 - Iespējots.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja *Mērvienības* (izvēles rūtiņa) ir iestatīta uz "Iespējots"| |*Pozīcija*|0|units_pos|0 - Pirms vērtības;<br>1 - Virs vērtības;<br>2 - *(noklusējums)* Pēc vērtības;<br>3 - Zem vērtības.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja *Mērvienības* (izvēles rūtiņa) ir iestatīta uz "Iespējots"<br><br>Šis parametrs tiek ignorēts, ja tas ir iestatīts uz kādu no šīm [ar laiku saistītajām mērvienībām](/manual/config/items/item#configuration): unixtime, uptime, s.| |*Krāsa*|1|units_color|Heksadecimāls krāsas kods (piemēram, `FF0000`).<br><br>Noklusējums: `""` (tukšs).| |***Vērtības loks***|<|<|<| |*Loka izmērs*|0|value_arc_size|Iespējamās vērtības diapazonā no 1 līdz 100.<br><br>Noklusējums: 20.| |***Rādītājs***|<|<|<| |*Krāsa*|1|needle_color|Heksadecimāls krāsas kods (piemēram, `FF0000`).<br><br>Noklusējums: `""` (tukšs).<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja ir iestatīts paneļa logrīka lauka objekts *Show* ar vērtību "Value arc" vai *Show arc* ir iestatīts uz "Iespējots"| |***Skala***|<|<|<| |*Rādīt mērvienības*|0|scale_show_units|0 - Atspējots;<br>1 - *(noklusējums)* Iespējots.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja *Mērvienības* (izvēles rūtiņa) ir iestatīta uz "Iespējots" un ir iestatīts paneļa logrīka lauka objekts *Show* ar vērtību "Value arc" vai *Show arc* ir iestatīts uz "Iespējots"| |*Izmērs*|0|scale_size|Iespējamās vērtības diapazonā no 1 līdz 100.<br><br>Noklusējums: 15.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja ir iestatīts paneļa logrīka lauka objekts *Show* ar vērtību "Value arc" vai *Show arc* ir iestatīts uz "Iespējots"| |*Decimālvietas*|0|scale_decimal_places|Iespējamās vērtības diapazonā no 1 līdz 10.<br><br>Noklusējums: 0.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja ir iestatīts paneļa logrīka lauka objekts *Show* ar vērtību "Value arc" vai *Show arc* ir iestatīts uz "Iespējots"| |***Sliekšņi***|<|<|<| |*Krāsa*|1|thresholds.0.color|Heksadecimāls krāsas kods (piemēram, `FF0000`).| |*Slieksnis*|1|thresholds.0.threshold|Jebkura skaitliska vērtība. Tiek atbalstīti [sufiksi](/manual/appendix/suffixes) (piemēram, "1d", "2w", "4K", "8G").| |*Rādīt etiķetes*|0|th_show_labels|0 - *(noklusējums)* Atspējots;<br>1 - Iespējots.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja *Sliekšņi* ir iestatīti un ir iestatīts paneļa logrīka lauka objekts *Show* ar vērtību "Value arc" vai *Show arc* ir iestatīts uz "Iespējots"| |*Rādīt loku*|0|th_show_arc|0 - *(noklusējums)* Atspējots;<br>1 - Iespējots.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja *Sliekšņi* ir iestatīti| |*Loka izmērs*|0|th_arc_size|Iespējamās vērtības diapazonā no 1 līdz 100.<br><br>Noklusējums: 5.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja *Show arc* ir iestatīts uz "Iespējots"| #### Advanced configuration The following advanced configuration parameters are supported for the *Honeycomb* widget. ::: noteclassic The number in the *Thresholds* property name (e.g. thresholds.0.color) references the threshold place in a list, sorted in ascending order. However, if thresholds are configured in a different order, the values will be sorted in ascending order after updating widget configuration in Zabbix frontend (e.g. `"thresholds.0.threshold":"5"` → `"thresholds.0.threshold":"1"`; `"thresholds.1.threshold":"1"` → `"thresholds.1.threshold": "5"`). ::: |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |***Primary label***|<|<|<| |*Type*|0|primary_label_type|0 - *(default)* Text;<br>1 - Value.| |*Text*|1|primary_label|Any string value, including macros.<br>Supported macros: {HOST.\*}, {ITEM.\*}, {INVENTORY.\*}, user macros.<br><br>Default: {HOST.NAME}<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Type* is set to "Text"| |*Decimal places*|0|primary_label_decimal_places|Possible values range from 0-6.<br><br>Default: 2.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Type* is set to "Value"| |*Size* (type)|0|primary_label_size_type|0 - *(default)* Auto;<br>1 - Custom.| |*Size*|0|primary_label_size|Possible values range from 1-100.<br><br>Default: 20.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Size* (type) is set to "Custom"| |*Bold*|0|primary_label_bold|0 - *(default)* Disabled;<br>1 - Enabled.| |*Color*|1|primary_label_color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: based on `theme` of [Settings object](/manual/api/reference/settings/object#settings) and [User object](/manual/api/reference/user/object#user):<br>`1F2C33` for "blue-theme" or "hc-light";<br>`EEEEEE` for "dark-theme" or "hc-dark".| |*Units* (checkbox)|0|primary_label_units_show|0 - Disabled;<br>1 - *(default)* Enabled.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Type* is set to "Value"| |*Units* (value)|1|primary_label_units|Any string value.<br><br>`""` (empty)<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Type* is set to "Value" and *Units* (checkbox) is set to "Enabled"| |*Position*|0|primary_label_units_pos|0 - Before value;<br>1 - *(default)* After value.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Type* is set to "Value" and *Units* (checkbox) is set to "Enabled"<br><br>This parameter is ignored if set to one of the following [time-related units](/manual/config/items/item#configuration): unixtime, uptime, s.| |***Secondary label***|<|<|<| |*Type*|0|secondary_label_type|0 - Text;<br>1 - *(default)* Value.| |*Text*|1|secondary_label|Any string value, including macros.<br>Supported macros: {HOST.\*}, {ITEM.\*}, {INVENTORY.\*}, user macros.<br><br>Default: {{ITEM.LASTVALUE}.fmtnum(2)}<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Type* is set to "Text"| |*Decimal places*|0|secondary_label_decimal_places|Possible values range from 0-6.<br><br>Default: 2.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Type* is set to "Value"| |*Size* (type)|0|secondary_label_size_type|0 - *(default)* Auto;<br>1 - Custom.| |*Size*|0|secondary_label_size|Possible values range from 1-100.<br><br>Default: 30.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Size* (type) is set to "Custom"| |*Bold*|0|secondary_label_bold|0 - Disabled;<br>1 - *(default)* Enabled.| |*Color*|1|secondary_label_color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: based on `theme` of [Settings object](/manual/api/reference/settings/object#settings) and [User object](/manual/api/reference/user/object#user):<br>`1F2C33` for "blue-theme" or "hc-light";<br>`EEEEEE` for "dark-theme" or "hc-dark".| |*Units* (checkbox)|0|secondary_label_units_show|0 - Disabled;<br>1 - *(default)* Enabled.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Type* is set to "Value"| |*Units* (value)|1|secondary_label_units|Any string value.<br><br>`""` (empty)<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Type* is set to "Value" and *Units* (checkbox) is set to "Enabled"| |*Position*|0|secondary_label_position|0 - Before value;<br>1 - *(default)* After value.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Type* is set to "Value" and *Units* (checkbox) is set to "Enabled"<br><br>This parameter is ignored if set to one of the following [time-related units](/manual/config/items/item#configuration): unixtime, uptime, s.| |***Background color***|<|<|<| |*Background color*|1|bg_color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: based on `theme` of [Settings object](/manual/api/reference/settings/object#settings) and [User object](/manual/api/reference/user/object#user):<br>`D9E7ED` for "blue-theme";<br>`3D5059` for "dark-theme";<br>`AAD7E9` for "hc-light";<br>`335463` for "hc-dark".| |***Thresholds***|<|<|<| |*Color interpolation*|0|interpolation|0 - Disabled;<br>1 - *(default)* Enabled.| |*Color*|1|thresholds.0.color|Hexadecimal color code (e.g. `FF0000`).| |*Threshold*|1|thresholds.0.threshold|Any numeric value. [Suffixes](/manual/appendix/suffixes) (e.g. "1d", "2w", "4K", "8G") are supported.| #### Papildu konfigurācija Tālāk norādītie papildu konfigurācijas parametri ir atbalstīti *Honeycomb* vienumam. ::: noteclassic Skaitlis *Thresholds* īpašuma nosaukumā (piem., thresholds.0.color) norāda sliekšņa vietu sarakstā, kas sakārtots augošā secībā. Tomēr, ja sliekšņi ir konfigurēti citā secībā, vērtības pēc vienuma konfigurācijas atjaunināšanas Zabbix lietotāja saskarnē tiks sakārtotas augošā secībā (piem., `"thresholds.0.threshold":"5"` → `"thresholds.0.threshold":"1"`; `"thresholds.1.threshold":"1"` → `"thresholds.1.threshold": "5"`). ::: |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |***Primārā etiķete***|<|<|<| |*Tips*|0|primary_label_type|0 - *(noklusējums)* Teksts;<br>1 - Vērtība.| |*Teksts*|1|primary_label|Jebkura virknes vērtība, tostarp makrosi.<br>Atbalstītie makrosi: {HOST.\*}, {ITEM.\*}, {INVENTORY.\*}, lietotāja makrosi.<br><br>Noklusējums: {HOST.NAME}<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja *Tips* ir iestatīts uz "Teksts"| |*Decimāldaļas*|0|primary_label_decimal_places|Iespējamās vērtības diapazonā no 0 līdz 6.<br><br>Noklusējums: 2.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja *Tips* ir iestatīts uz "Vērtība"| |*Izmērs* (tips)|0|primary_label_size_type|0 - *(noklusējums)* Automātiski;<br>1 - Pielāgots.| |*Izmērs*|0|primary_label_size|Iespējamās vērtības diapazonā no 1 līdz 100.<br><br>Noklusējums: 20.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja *Izmērs* (tips) ir iestatīts uz "Pielāgots"| |*Treknraksts*|0|primary_label_bold|0 - *(noklusējums)* Atspējots;<br>1 - Iespējots.| |*Krāsa*|1|primary_label_color|Heksadecimāls krāsas kods (piem., `FF0000`).<br><br>Noklusējums: atkarībā no [Settings object](/manual/api/reference/settings/object#settings) un [User object](/manual/api/reference/user/object#user) `theme`:<br>`1F2C33` "blue-theme" vai "hc-light";<br>`EEEEEE` "dark-theme" vai "hc-dark".| |*Vienības* (atzīme)|0|primary_label_units_show|0 - Atspējots;<br>1 - *(noklusējums)* Iespējots.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja *Tips* ir iestatīts uz "Vērtība"| |*Vienības* (vērtība)|1|primary_label_units|Jebkura virknes vērtība.<br><br>`""` (tukšs)<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja *Tips* ir iestatīts uz "Vērtība" un *Vienības* (atzīme) ir iestatīts uz "Iespējots"| |*Pozīcija*|0|primary_label_units_pos|0 - Pirms vērtības;<br>1 - *(noklusējums)* Pēc vērtības.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja *Tips* ir iestatīts uz "Vērtība" un *Vienības* (atzīme) ir iestatīts uz "Iespējots"<br><br>Šis parametrs tiek ignorēts, ja tas ir iestatīts uz kādu no šīm [ar laiku saistītajām vienībām](/manual/config/items/item#configuration): unixtime, uptime, s.| |***Sekundārā etiķete***|<|<|<| |*Tips*|0|secondary_label_type|0 - Teksts;<br>1 - *(noklusējums)* Vērtība.| |*Teksts*|1|secondary_label|Jebkura virknes vērtība, tostarp makrosi.<br>Atbalstītie makrosi: {HOST.\*}, {ITEM.\*}, {INVENTORY.\*}, lietotāja makrosi.<br><br>Noklusējums: {{ITEM.LASTVALUE}.fmtnum(2)}<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja *Tips* ir iestatīts uz "Teksts"| |*Decimāldaļas*|0|secondary_label_decimal_places|Iespējamās vērtības diapazonā no 0 līdz 6.<br><br>Noklusējums: 2.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja *Tips* ir iestatīts uz "Vērtība"| |*Izmērs* (tips)|0|secondary_label_size_type|0 - *(noklusējums)* Automātiski;<br>1 - Pielāgots.| |*Izmērs*|0|secondary_label_size|Iespējamās vērtības diapazonā no 1 līdz 100.<br><br>Noklusējums: 30.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja *Izmērs* (tips) ir iestatīts uz "Pielāgots"| |*Treknraksts*|0|secondary_label_bold|0 - Atspējots;<br>1 - *(noklusējums)* Iespējots.| |*Krāsa*|1|secondary_label_color|Heksadecimāls krāsas kods (piem., `FF0000`).<br><br>Noklusējums: atkarībā no [Settings object](/manual/api/reference/settings/object#settings) un [User object](/manual/api/reference/user/object#user) `theme`:<br>`1F2C33` "blue-theme" vai "hc-light";<br>`EEEEEE` "dark-theme" vai "hc-dark".| |*Vienības* (atzīme)|0|secondary_label_units_show|0 - Atspējots;<br>1 - *(noklusējums)* Iespējots.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja *Tips* ir iestatīts uz "Vērtība"| |*Vienības* (vērtība)|1|secondary_label_units|Jebkura virknes vērtība.<br><br>`""` (tukšs)<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja *Tips* ir iestatīts uz "Vērtība" un *Vienības* (atzīme) ir iestatīts uz "Iespējots"| |*Pozīcija*|0|secondary_label_position|0 - Pirms vērtības;<br>1 - *(noklusējums)* Pēc vērtības.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja *Tips* ir iestatīts uz "Vērtība" un *Vienības* (atzīme) ir iestatīts uz "Iespējots"<br><br>Šis parametrs tiek ignorēts, ja tas ir iestatīts uz kādu no šīm [ar laiku saistītajām vienībām](/manual/config/items/item#configuration): unixtime, uptime, s.| |***Fona krāsa***|<|<|<| |*Fona krāsa*|1|bg_color|Heksadecimāls krāsas kods (piem., `FF0000`).<br><br>Noklusējums: atkarībā no [Settings object](/manual/api/reference/settings/object#settings) un [User object](/manual/api/reference/user/object#user) `theme`:<br>`D9E7ED` "blue-theme";<br>`3D5059` "dark-theme";<br>`AAD7E9` "hc-light";<br>`335463` "hc-dark".| |***Sliekšņi***|<|<|<| |*Krāsu interpolācija*|0|interpolation|0 - Atspējots;<br>1 - *(noklusējums)* Iespējots.| |*Krāsa*|1|thresholds.0.color|Heksadecimāls krāsas kods (piem., `FF0000`).| |*Slieksnis*|1|thresholds.0.threshold|Jebkura skaitliska vērtība. Tiek atbalstīti [piedēkļi](/manual/appendix/suffixes) (piem., "1d", "2w", "4K", "8G").| #### Advanced configuration The following advanced configuration parameters are supported for the *Item history* widget. |Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-|--------|--|--------|-------------------------------| |*New values*|<|0|sortorder|0 - *(default)* Top;<br>1 - Bottom.| |*Show timestamp*|<|0|show_timestamp|0 - *(default)* Disabled;<br>1 - Enabled.| |*Show column header*|<|0|show_column_header|0 - Off;<br>1 - Horizontal;<br>2 - *(default)* Vertical.| |*Time period*|<|1|time_period.\_reference|`DASHBOARD._timeperiod` - set the [*Time period* selector](/manual/web_interface/time_period_selector) as the data source;<br>`ABCDE._timeperiod` - set a [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (with its *Reference* parameter set to "`ABCDE`") as the data source.<br><br>Default: `DASHBOARD._timeperiod`<br><br>Alternatively, you can set the time period only in the *From* and *To* parameters.| |<|*From*|1|time_period.from|Valid time string in absolute (`YYYY-MM-DD hh:mm:ss`) or [relative](/manual/web_interface/time_period_selector) time syntax (`now`, `now/d`, `now/w-1w`, etc.).<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Time period* is not set<br>- *required* if `time_period.to` is set| |^|*To*|1|time_period.to|Valid time string in absolute (`YYYY-MM-DD hh:mm:ss`) or [relative](/manual/web_interface/time_period_selector) time syntax (`now`, `now/d`, `now/w-1w`, etc.).<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Time period* is not set<br>- *required* if `time_period.from` is set| #### Papildu konfigurācija Tālāk norādītie papildu konfigurācijas parametri ir atbalstīti *Vienuma vēstures* sīkrīkam. |Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-|--------|--|--------|-------------------------------| |*Jaunās vērtības*|<|0|sortorder|0 - *(noklusējums)* Augšā;<br>1 - Apakšā.| |*Rādīt laikspiedolu*|<|0|show_timestamp|0 - *(noklusējums)* Atspējots;<br>1 - Iespējots.| |*Rādīt kolonnas galveni*|<|0|show_column_header|0 - Izslēgts;<br>1 - Horizontāls;<br>2 - *(noklusējums)* Vertikāls.| |*Laika periods*|<|1|time_period.\_reference|`DASHBOARD._timeperiod` - iestatīt [*Laika perioda* atlasītāju](/manual/web_interface/time_period_selector) kā datu avotu;<br>`ABCDE._timeperiod` - iestatīt [saderīgu sīkrīku](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (ar tā *Reference* parametru, kas iestatīts uz "`ABCDE`") kā datu avotu.<br><br>Noklusējums: `DASHBOARD._timeperiod`<br><br>Alternatīvi, laika periodu var iestatīt tikai parametros *No* un *Līdz*.| |<|*No*|1|time_period.from|Derīga laika virkne absolūtā (`YYYY-MM-DD hh:mm:ss`) vai [relatīvā](/manual/web_interface/time_period_selector) laika sintaksē (`now`, `now/d`, `now/w-1w` u. c.).<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja *Laika periods* nav iestatīts<br>- *obligāts*, ja ir iestatīts `time_period.to`| |^|*Līdz*|1|time_period.to|Derīga laika virkne absolūtā (`YYYY-MM-DD hh:mm:ss`) vai [relatīvā](/manual/web_interface/time_period_selector) laika sintaksē (`now`, `now/d`, `now/w-1w` u. c.).<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja *Laika periods* nav iestatīts<br>- *obligāts*, ja ir iestatīts `time_period.from`| #### Advanced configuration The following advanced configuration parameters are supported for the *Item value* widget. ::: noteclassic The number in the *Thresholds* property name (e.g. thresholds.0.color) references the threshold place in a list, sorted in ascending order. However, if thresholds are configured in a different order, the values will be sorted in ascending order after updating widget configuration in Zabbix frontend (e.g. `"thresholds.0.threshold":"5"` → `"thresholds.0.threshold":"1"`; `"thresholds.1.threshold":"1"` → `"thresholds.1.threshold": "5"`). ::: |Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-|--------|--|--------|-------------------------------| |*Background color*|<|1|bg_color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `""` (empty).| |*Thresholds*|<|<|<|<| |<|*Color*|1|thresholds.0.color|Hexadecimal color code (e.g. `FF0000`).| |^|*Threshold*|1|thresholds.0.threshold|Any string value.| |*Aggregation function*|<|0|aggregate_function|0 - *(default)* not used;<br>1 - min;<br>2 - max;<br>3 - avg;<br>4 - count;<br>5 - sum;<br>6 - first;<br>7 - last.| |*Time period*|<|1|time_period.\_reference|`DASHBOARD._timeperiod` - set the [*Time period* selector](/manual/web_interface/time_period_selector) as the data source;<br>`ABCDE._timeperiod` - set a [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (with its `reference` parameter equal to `ABCDE`) as the data source.<br><br>Default: `DASHBOARD._timeperiod`<br><br>Alternatively, you can set the time period only in the *From* and *To* parameters.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Aggregation function* is set to "min", "max", "avg", "count", "sum", "first", "last"| |<|*From*|1|time_period.from|Valid time string in absolute (`YYYY-MM-DD hh:mm:ss`) or [relative](/manual/web_interface/time_period_selector) time syntax (`now`, `now/d`, `now/w-1w`, etc.).<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Time period* is not set and *Aggregation function* is set to "min", "max", "avg", "count", "sum", "first", "last"<br>- *required* if `time_period.to` is set| |^|*To*|1|time_period.to|Valid time string in absolute (`YYYY-MM-DD hh:mm:ss`) or [relative](/manual/web_interface/time_period_selector) time syntax (`now`, `now/d`, `now/w-1w`, etc.).<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Time period* is not set and *Aggregation function* is set to "min", "max", "avg", "count", "sum", "first", "last"<br>- *required* if `time_period.from` is set| |*History data*|<|0|history|0 - *(default)* Auto;<br>1 - History;<br>2 - Trends.| #### Papildu konfigurācija Tālāk norādītie papildu konfigurācijas parametri ir atbalstīti *Vienuma vērtība* logrīkā. ::: noteclassic Skaitlis *Sliekšņi* īpašuma nosaukumā (piem., thresholds.0.color) norāda sliekšņa pozīciju sarakstā, kas sakārtots augošā secībā. Tomēr, ja sliekšņi ir konfigurēti citā secībā, vērtības pēc logrīka konfigurācijas atjaunināšanas Zabbix lietotāja saskarnē tiks sakārtotas augošā secībā (piem., `"thresholds.0.threshold":"5"` → `"thresholds.0.threshold":"1"`; `"thresholds.1.threshold":"1"` → `"thresholds.1.threshold": "5"`). ::: |Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-|--------|--|--------|-------------------------------| |*Fona krāsa*|<|1|bg_color|Hexadecimāls krāsas kods (piem., `FF0000`).<br><br>Noklusējums: `""` (tukšs).| |*Sliekšņi*|<|<|<|<| |<|*Krāsa*|1|thresholds.0.color|Hexadecimāls krāsas kods (piem., `FF0000`).| |^|*Slieksnis*|1|thresholds.0.threshold|Jebkura virknes vērtība.| |*Agregēšanas funkcija*|<|0|aggregate_function|0 - *(noklusējums)* netiek izmantots;<br>1 - min;<br>2 - max;<br>3 - avg;<br>4 - count;<br>5 - sum;<br>6 - first;<br>7 - last.| |*Laika periods*|<|1|time_period.\_reference|`DASHBOARD._timeperiod` - iestata [*Laika perioda* atlasītāju](/manual/web_interface/time_period_selector) kā datu avotu;<br>`ABCDE._timeperiod` - iestata [saderīgu logrīku](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (ar tā `reference` parametru, kas ir vienāds ar `ABCDE`) kā datu avotu.<br><br>Noklusējums: `DASHBOARD._timeperiod`<br><br>Alternatīvi laika periodu var iestatīt tikai parametros *No* un *Līdz*.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja *Agregēšanas funkcija* ir iestatīta uz "min", "max", "avg", "count", "sum", "first", "last"| |<|*No*|1|time_period.from|Derīga laika virkne absolūtā (`YYYY-MM-DD hh:mm:ss`) vai [relatīvā](/manual/web_interface/time_period_selector) laika sintaksē (`now`, `now/d`, `now/w-1w` u.c.).<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja *Laika periods* nav iestatīts un *Agregēšanas funkcija* ir iestatīta uz "min", "max", "avg", "count", "sum", "first", "last"<br>- *obligāts*, ja ir iestatīts `time_period.to`| |^|*Līdz*|1|time_period.to|Derīga laika virkne absolūtā (`YYYY-MM-DD hh:mm:ss`) vai [relatīvā](/manual/web_interface/time_period_selector) laika sintaksē (`now`, `now/d`, `now/w-1w` u.c.).<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja *Laika periods* nav iestatīts un *Agregēšanas funkcija* ir iestatīta uz "min", "max", "avg", "count", "sum", "first", "last"<br>- *obligāts*, ja ir iestatīts `time_period.from`| |*Vēstures dati*|<|0|history|0 - *(noklusējums)* Auto;<br>1 - History;<br>2 - Trends.| #### Advanced configuration The following advanced configuration parameters are supported if *Clock type* is set to "Digital". |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Background color*|1|bg_color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `""` (empty).| #### Papildu konfigurācija Tālāk norādītie papildu konfigurācijas parametri tiek atbalstīti, ja *Pulksteņa tips* ir iestatīts uz "Digitāls". |Parametrs|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Fona krāsa*|1|bg_color|Heksadecimālais krāsas kods (piemēram, `FF0000`).<br><br>Noklusējums: `""` (tukšs).| #### Advanced extensions #### Paplašinātie paplašinājumi #### Advanced host interface configuration The `vmware.vm.discovery[{$VMWARE.URL}]` item key, configured in the [*Create a low-level discovery rule*](#create-a-low-level-discovery-rule) section, returns network interfaces data in the ["net_if" field](/manual/vm_monitoring/discovery_fields): ```json "net_if": [ { "ifname": "5000", "ifdesc": "Network adapter 1", "ifmac": "00:11:22:33:44:55", "ifconnected": true, "iftype": "VirtualVmxnet3", "ifbackingdevice": "VLAN(myLab)", "ifdvswitch_uuid": "", "ifdvswitch_portgroup": "", "ifdvswitch_port": "", "ifip": [ "127.0.0.1", "::1" ] }, { "ifname": "5001", "ifdesc": "Network adapter 2", "ifmac": "00:11:22:33:44:55", "ifconnected": false, "iftype": "VirtualVmxnet3", "ifbackingdevice": "VLAN(myLab2)", "ifdvswitch_uuid": "", "ifdvswitch_portgroup": "", "ifdvswitch_port": "", "ifip": [] } ] ``` This data can be used to configure a custom host interface. 1\. When [creating a low-level discovery rule](#create-a-low-level-discovery-rule), additionally configure a [low-level discovery macro](/manual/config/macros/lld_macros). In the *LLD macros* tab, create a custom LLD macro with a [JSONPath](/manual/config/items/preprocessing/jsonpath_functionality) value. For example: - {#MYLAB.NET.IF} - `$.net_if[?(@.ifbackingdevice=="VLAN(myLab)")].ifip[0].first()` {width="600"} 2\. When [creating a host prototype](#create-a-host-prototype), add a custom host interface and enter the LLD macro in the *DNS name* or *IP address* field. {width="600"} #### Paplašināta hosta saskarnes konfigurācija `vmware.vm.discovery[{$VMWARE.URL}]` vienuma atslēga, kas konfigurēta sadaļā [*Izveidot zema līmeņa atklāšanas kārtulu*](#create-a-low-level-discovery-rule), atgriež tīkla saskarņu datus laukā ["net_if"](/manual/vm_monitoring/discovery_fields): ```json "net_if": [ { "ifname": "5000", "ifdesc": "Network adapter 1", "ifmac": "00:11:22:33:44:55", "ifconnected": true, "iftype": "VirtualVmxnet3", "ifbackingdevice": "VLAN(myLab)", "ifdvswitch_uuid": "", "ifdvswitch_portgroup": "", "ifdvswitch_port": "", "ifip": [ "127.0.0.1", "::1" ] }, { "ifname": "5001", "ifdesc": "Network adapter 2", "ifmac": "00:11:22:33:44:55", "ifconnected": false, "iftype": "VirtualVmxnet3", "ifbackingdevice": "VLAN(myLab2)", "ifdvswitch_uuid": "", "ifdvswitch_portgroup": "", "ifdvswitch_port": "", "ifip": [] } ] ``` Šos datus var izmantot pielāgotas hosta saskarnes konfigurēšanai. 1\. [Veidojot zema līmeņa atklāšanas kārtulu](#create-a-low-level-discovery-rule), papildus konfigurējiet [zema līmeņa atklāšanas makrosu](/manual/config/macros/lld_macros). Cilnē *LLD macros* izveidojiet pielāgotu LLD makrosu ar [JSONPath](/manual/config/items/preprocessing/jsonpath_functionality) vērtību. Piemēram: - {#MYLAB.NET.IF} - `$.net_if[?(@.ifbackingdevice=="VLAN(myLab)")].ifip[0].first()` {width="600"} 2\. [Veidojot hosta prototipu](#create-a-host-prototype), pievienojiet pielāgotu hosta saskarni un ievadiet LLD makrosu laukā *DNS name* vai *IP address*. {width="600"} #### Advanced root-cause handling for unsupported item state Error handling in case of a failure to retrieve an item value (and thus it becoming unsupported) previously lacked the ability to distinguish the reason or runtime stage where the process failed. All errors had to be handled using one and the same option for error handling - either to discard the value, set a specified value or set a specified error message. It is now possible to match the error message to a regular expression. If the error matches (or does not match) it is possible to specify how the error case should be processed. For example, a specific error message can be "mapped" to a more general case to be matched for and handled by a further preprocessing step, or some intermittent (e.g., network connectivity) issue can be handled differently to a definite failure to acquire the item value. Multiple *Check for not supported value* preprocessing steps can now be added. Note that there can be only one "any error" matching step at the end of the pipeline probing for unsupported state of the item. If present, it is activated if none of the specific checks (mis)matched the according pattern, or a (modified) error message was carried over - i.e., no "Discard value" or "Set value to" override came into effect. {width="600"} See also: [Check for not supported value](/manual/config/items/preprocessing#checkunsupported) #### Paplašināta pamatcēloņa apstrāde neatbalstītam vienuma stāvoklim Kļūdu apstrādei gadījumā, ja neizdodas izgūt vienuma vērtību (un tādējādi tas kļūst neatbalstīts), iepriekš nebija iespējams atšķirt iemeslu vai izpildes posmu, kurā process neizdevās. Visas kļūdas bija jāapstrādā, izmantojot vienu un to pašu kļūdu apstrādes opciju - vai nu atmest vērtību, iestatīt norādītu vērtību vai iestatīt norādītu kļūdas ziņojumu. Tagad ir iespējams salīdzināt kļūdas ziņojumu ar regulāro izteiksmi. Ja kļūda atbilst (vai neatbilst), ir iespējams norādīt, kā kļūdas gadījums jāapstrādā. Piemēram, konkrētu kļūdas ziņojumu var "kartēt" uz vispārīgāku gadījumu, kas tālāk jāatbilst un jāapstrādā ar nākamo priekšapstrādes soli, vai arī kādu pārejošu (piem., tīkla savienojamības) problēmu var apstrādāt citādi nekā noteiktu vienuma vērtības iegūšanas kļūmi. Tagad var pievienot vairākus priekšapstrādes soļus *Check for not supported value*. Ņemiet vērā, ka cauruļvada beigās, kas pārbauda vienuma neatbalstīto stāvokli, var būt tikai viens "any error" atbilstības solis. Ja tas ir pieejams, tas tiek aktivizēts, ja neviena no konkrētajām pārbaudēm neatbilst (vai neatbilst nepareizi) attiecīgajam paraugam, vai arī ir pārnests (modificēts) kļūdas ziņojums - t.i., nav stājusies spēkā neviena "Discard value" vai "Set value to" pārrakstīšana. {width="600"} Skatiet arī: [Check for not supported value](/manual/config/items/preprocessing#checkunsupported) #### Advanced settings Additional SAML parameters can be configured in the Zabbix frontend configuration file (*zabbix.conf.php*): - $SSO\['SP\_KEY'\] = '<path to the SP private key file>'; - $SSO\['SP\_CERT'\] = '<path to the SP cert file>'; - $SSO\['IDP\_CERT'\] = '<path to the IDP cert file>'; - $SSO\['SETTINGS'\] ::: noteclassic The `$SSO['SETTINGS']` array must follow the same structure expected by the *SAML PHP Toolkit* library ([supplied](/manual/installation/requirements#frontend) with Zabbix). For a full description of available configuration options, refer to the official [library documentation](https://github.com/SAML-Toolkits/php-saml?tab=readme-ov-file#how-it-works). ::: Only the following options can be set as part of $SSO\['SETTINGS'\]: - *strict* - *baseurl* - *compress* - *contactPerson* - *organization* - *sp* (only options specified in this list) - *attributeConsumingService* - *x509certNew* - *idp* (only options specified in this list) - *singleLogoutService* (only one option) - *responseUrl* - *certFingerprint* - *certFingerprintAlgorithm* - *x509certMulti* - *security* (only options specified in this list) - *signMetadata* - *wantNameId* - *requestedAuthnContext* - *requestedAuthnContextComparison* - *wantXMLValidation* - *relaxDestinationValidation* - *destinationStrictlyMatches* - *rejectUnsolicitedResponsesWithInResponseTo* - *signatureAlgorithm* - *digestAlgorithm* - *lowercaseUrlencoding* All other options will be taken from the database and cannot be overridden. The *debug* option will be ignored. In addition, if Zabbix UI is behind a proxy or a load balancer, the custom *use\_proxy\_headers* option can be used: - *false* (default) - ignore the option; - *true* - use X-Forwarded-\* HTTP headers for building the base URL. If using a load balancer to connect to Zabbix instance, where the load balancer uses TLS/SSL and Zabbix does not, you must indicate 'baseurl', 'strict' and 'use_proxy_headers' parameters as follows: ```php $SSO['SETTINGS'] = [ 'strict' => false, 'baseurl' => 'https://zabbix.example.com/zabbix/', 'use_proxy_headers' => true ]; ``` **Configuration example:** ```php $SSO['SETTINGS'] = [ 'security' => [ 'signatureAlgorithm' => 'http://www.w3.org/2001/04/xmldsig-more#rsa-sha384' 'digestAlgorithm' => 'http://www.w3.org/2001/04/xmldsig-more#sha384', // ... ], // ... ]; ``` #### Papildu iestatījumi Papildu SAML parametrus var konfigurēt Zabbix lietotāja saskarnes konfigurācijas failā (*zabbix.conf.php*): - $SSO\['SP\_KEY'\] = '<ceļš uz SP privātās atslēgas failu>'; - $SSO\['SP\_CERT'\] = '<ceļš uz SP sertifikāta failu>'; - $SSO\['IDP\_CERT'\] = '<ceļš uz IDP sertifikāta failu>'; - $SSO\['SETTINGS'\] ::: noteclassic Masīvam `$SSO['SETTINGS']` jāatbilst tai pašai struktūrai, ko sagaida *SAML PHP Toolkit* bibliotēka ([iekļauta](/manual/installation/requirements#frontend) Zabbix komplektā). Pilnu pieejamo konfigurācijas opciju aprakstu skatiet oficiālajā [bibliotēkas dokumentācijā](https://github.com/SAML-Toolkits/php-saml?tab=readme-ov-file#how-it-works). ::: Tikai tālāk norādītās opcijas var iestatīt kā daļu no $SSO\['SETTINGS'\]: - *strict* - *baseurl* - *compress* - *contactPerson* - *organization* - *sp* (tikai šajā sarakstā norādītās opcijas) - *attributeConsumingService* - *x509certNew* - *idp* (tikai šajā sarakstā norādītās opcijas) - *singleLogoutService* (tikai viena opcija) - *responseUrl* - *certFingerprint* - *certFingerprintAlgorithm* - *x509certMulti* - *security* (tikai šajā sarakstā norādītās opcijas) - *signMetadata* - *wantNameId* - *requestedAuthnContext* - *requestedAuthnContextComparison* - *wantXMLValidation* - *relaxDestinationValidation* - *destinationStrictlyMatches* - *rejectUnsolicitedResponsesWithInResponseTo* - *signatureAlgorithm* - *digestAlgorithm* - *lowercaseUrlencoding* Visas pārējās opcijas tiks ņemtas no datubāzes, un tās nevar pārrakstīt. Opcija *debug* tiks ignorēta. Papildus tam, ja Zabbix UI atrodas aiz starpniekservera vai slodzes balansētāja, var izmantot pielāgoto opciju *use\_proxy\_headers*: - *false* (noklusējums) - ignorēt opciju; - *true* - izmantot X-Forwarded-\* HTTP galvenes bāzes URL izveidei. Ja savienojumam ar Zabbix instanci tiek izmantots slodzes balansētājs, kur slodzes balansētājs izmanto TLS/SSL, bet Zabbix to neizmanto, jānorāda parametri 'baseurl', 'strict' un 'use_proxy_headers' šādi: ```php $SSO['SETTINGS'] = [ 'strict' => false, 'baseurl' => 'https://zabbix.example.com/zabbix/', 'use_proxy_headers' => true ]; ``` **Konfigurācijas piemērs:** ```php $SSO['SETTINGS'] = [ 'security' => [ 'signatureAlgorithm' => 'http://www.w3.org/2001/04/xmldsig-more#rsa-sha384' 'digestAlgorithm' => 'http://www.w3.org/2001/04/xmldsig-more#sha384', // ... ], // ... ]; ``` After receiving a list of active checks the agent marks obsolete persistent files for removal. A persistent file becomes obsolete if: 1. The corresponding log item is no longer monitored. 2. A log item is reconfigured with a different `persistent_dir` location than before. Removing is done with delay 24 hours because log files in NOTSUPPORTED state are not included in the list of active checks but they may become SUPPORTED later and their persistent files will be useful. If the agent is stopped before 24 hours expire, then the obsolete files will not be deleted as Zabbix agent is not getting info about their location from Zabbix server anymore. ::: notewarning Reconfiguring a log item's `persistent_dir` back to the old `persistent_dir` location while the agent is stopped, without deleting the old persistent file by user - will cause restoring the agent state from the old persistent file resulting in missed messages or false alerts. ::: Pēc aktīvo pārbaužu saraksta saņemšanas aģents atzīmē novecojušos pastāvīgos failus dzēšanai. Pastāvīgs fails kļūst novecojis, ja: 1. Attiecīgais žurnāla vienums vairs netiek uzraudzīts. 2. Žurnāla vienums tiek pārkonfigurēts ar citu `persistent_dir` atrašanās vietu nekā iepriekš. Dzēšana tiek veikta ar 24 stundu aizkavi, jo žurnālfaili NOTSUPPORTED stāvoklī nav iekļauti aktīvo pārbaužu sarakstā, taču vēlāk tie var kļūt SUPPORTED, un to pastāvīgie faili būs noderīgi. Ja aģents tiek apturēts pirms 24 stundu termiņa beigām, novecojušie faili netiks dzēsti, jo Zabbix aģents vairs nesaņem informāciju par to atrašanās vietu no Zabbix serveris. ::: notewarning Ja žurnāla vienuma `persistent_dir` tiek pārkonfigurēts atpakaļ uz veco `persistent_dir` atrašanās vietu, kamēr aģents ir apturēts, un lietotājs nav izdzēsis veco pastāvīgo failu, tas izraisīs aģenta stāvokļa atjaunošanu no vecā pastāvīgā faila, kā rezultātā tiks palaistas garām ziņas vai tiks ģenerēti kļūdaini brīdinājumi. ::: #### Agent 2 configuration **Buffer size** The default value of the [BufferSize](/manual/appendix/config/zabbix_agent2) configuration parameter for Zabbix agent 2 has been increased from 100 to 1000. **Empty values allowed** Empty values are now allowed in plugin-related configuration parameters on Zabbix agent 2. #### Aģents 2 konfigurācija **Bufera lielums** Zabbix aģents 2 konfigurācijas parametra [BufferSize](/manual/appendix/config/zabbix_agent2) noklusējuma vērtība ir palielināta no 100 līdz 1000. **Atļautas tukšas vērtības** Tagad Zabbix aģents 2 spraudņiem saistītajos konfigurācijas parametros ir atļautas tukšas vērtības. #### Agent 2 on Unix-like systems Zabbix agent 2 on Unix-like systems is run on the host being monitored. #### Aģents 2 Unix līdzīgās sistēmās Zabbix aģents 2 Unix līdzīgās sistēmās tiek palaists uz uzraudzītā hosta. #### Agent 2 on Windows systems Zabbix agent 2 runs as a standalone process; however, it can also be run as a Windows service. #### Aģents 2 Windows sistēmās Zabbix aģents 2 darbojas kā atsevišķs process; tomēr to var palaist arī kā Windows pakalpojumu. #### Agent 2 package support for RHEL 6 dropped Since Zabbix 7.0.5, Zabbix agent 2 packages are no longer available for [RHEL 6](https://repo.zabbix.com/zabbix/6.0/rhel/6/x86_64/) due to Go 1.22 (and newer) being incompatible with GCC 4.4.7 provided by RHEL 6, which results in compilation errors. Note, however, that [Zabbix agent packages](/manual/installation/install_from_packages/rhel) are still supported. #### Aģents 2 pakotņu atbalsts RHEL 6 ir pārtraukts Kopš Zabbix 7.0.5 Zabbix aģents 2 pakotnes vairs nav pieejamas [RHEL 6](https://repo.zabbix.com/zabbix/6.0/rhel/6/x86_64/) dēļ, jo Go 1.22 (un jaunākas versijas) nav saderīgs ar RHEL 6 nodrošināto GCC 4.4.7, kā rezultātā rodas kompilēšanas kļūdas. Tomēr ņemiet vērā, ka [Zabbix aģents pakotnes](/manual/installation/install_from_packages/rhel) joprojām tiek atbalstītas. ##### Agent 2 |Requirement|Mandatory status|Description| |--|-|-------| |*Go*|Yes|Required to build Zabbix agent 2 and its plugins from source.<br>Go 1.24.10 or later is supported. See [go.dev](https://go.dev/doc/install) for installation instructions.<br>Go libraries used by Zabbix agent 2 and its plugins are listed in the Zabbix Git repository (libraries marked as `indirect` in the repository are dependencies of other required libraries):<br>- [Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/go.mod?at=refs%2Fheads%2Frelease%2F7.0)<br>- [Plugin support](https://git.zabbix.com/projects/AP/repos/plugin-support/browse/go.mod?at=refs%2Fheads%2Frelease%2F7.0)<br>- [PostgreSQL](https://git.zabbix.com/projects/AP/repos/postgresql/browse/go.mod?at=refs%2Fheads%2Frelease%2F7.0)<br>- [MongoDB](https://git.zabbix.com/projects/AP/repos/mongodb/browse/go.mod?at=refs%2Fheads%2Frelease%2F7.0)<br>- [MSSQL](https://git.zabbix.com/projects/AP/repos/mssql/browse/go.mod?at=refs%2Fheads%2Frelease%2F7.0)<br>- [Ember+](https://git.zabbix.com/projects/AP/repos/ember-plus/browse/go.mod?at=refs%2Fheads%2Frelease%2F7.0)<br>- [Example plugin](https://git.zabbix.com/projects/AP/repos/example/browse/go.mod?at=refs%2Fheads%2Frelease%2F7.0)| |*libpcre/libpcre2*|One of|PCRE/PCRE2 library is required for [Perl Compatible Regular Expression](https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions) (PCRE) support.<br>The naming may differ depending on the GNU/Linux distribution, for example 'libpcre3' or 'libpcre1'. PCRE v8.x and PCRE2 v10.x are supported.<br>Required for log monitoring. Also required on Windows.| |*libopenssl*|No|Required when using encryption.<br>OpenSSL 1.0.1 or later is required on UNIX platforms.<br>The OpenSSL library must have PSK support enabled. LibreSSL is not supported.<br>On Microsoft Windows systems OpenSSL 1.1.1 or later is required.| ##### Aģents 2 |Requirement|Mandatory status|Description| |--|-|-------| |*Go*|Yes|Nepieciešams, lai no avota koda izveidotu Zabbix aģents 2 un tā spraudņus.<br>Tiek atbalstīts Go 1.24.10 vai jaunāks. Instalēšanas norādījumus skatiet [go.dev](https://go.dev/doc/install).<br>Go bibliotēkas, ko izmanto Zabbix aģents 2 un tā spraudņi, ir uzskaitītas Zabbix Git repozitorijā (bibliotēkas, kas repozitorijā atzīmētas kā `indirect`, ir citu nepieciešamo bibliotēku atkarības):<br>- [Zabbix aģents 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/go.mod?at=refs%2Fheads%2Frelease%2F7.0)<br>- [Spraudņu atbalsts](https://git.zabbix.com/projects/AP/repos/plugin-support/browse/go.mod?at=refs%2Fheads%2Frelease%2F7.0)<br>- [PostgreSQL](https://git.zabbix.com/projects/AP/repos/postgresql/browse/go.mod?at=refs%2Fheads%2Frelease%2F7.0)<br>- [MongoDB](https://git.zabbix.com/projects/AP/repos/mongodb/browse/go.mod?at=refs%2Fheads%2Frelease%2F7.0)<br>- [MSSQL](https://git.zabbix.com/projects/AP/repos/mssql/browse/go.mod?at=refs%2Fheads%2Frelease%2F7.0)<br>- [Ember+](https://git.zabbix.com/projects/AP/repos/ember-plus/browse/go.mod?at=refs%2Fheads%2Frelease%2F7.0)<br>- [Piemēra spraudnis](https://git.zabbix.com/projects/AP/repos/example/browse/go.mod?at=refs%2Fheads%2Frelease%2F7.0)| |*libpcre/libpcre2*|One of|PCRE/PCRE2 bibliotēka ir nepieciešama [Perl Compatible Regular Expression](https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions) (PCRE) atbalstam.<br>Nosaukums var atšķirties atkarībā no GNU/Linux distributīva, piemēram, 'libpcre3' vai 'libpcre1'. Tiek atbalstītas PCRE v8.x un PCRE2 v10.x.<br>Nepieciešams žurnālu uzraudzībai. Nepieciešams arī Windows vidē.| |*libopenssl*|No|Nepieciešams, izmantojot šifrēšanu.<br>UNIX platformās nepieciešams OpenSSL 1.0.1 vai jaunāks.<br>OpenSSL bibliotēkai jābūt iespējotam PSK atbalstam. LibreSSL netiek atbalstīts.<br>Microsoft Windows sistēmās nepieciešams OpenSSL 1.1.1 vai jaunāks.| #### Agent 2 runtime control output stream Zabbix agent 2 [runtime control](/manual/concepts/agent2#runtime-control) commands (`zabbix_agent2 -R <option>`) now write output to `stdout` (standard output) instead of `stderr` (standard error). Please update any scripts that rely on previous behavior. #### Aģents 2 izpildlaika vadības izvades plūsma Zabbix aģents 2 [izpildlaika vadības](/manual/concepts/agent2#runtime-control) komandas (`zabbix_agent2 -R <option>`) tagad raksta izvadi uz `stdout` (standarta izvade), nevis `stderr` (standarta kļūdu izvade). Lūdzu, atjauniniet visus skriptus, kas paļaujas uz iepriekšējo darbību. **Agent configuration** Add the next line to the agent configuration file: ```ini HostMetadata=Linux 21df83bf21bf0be663090bb8d4128558ab9b95fba66a6dbf834f8b91ae5e08ae ``` where "Linux" is a platform, and the rest of the string is the hard-to-guess secret text. Do not forget to restart the agent after making any changes to the configuration file. **Aģenta konfigurācija** Pievienojiet aģenta konfigurācijas failam šādu rindu: ```ini HostMetadata=Linux 21df83bf21bf0be663090bb8d4128558ab9b95fba66a6dbf834f8b91ae5e08ae ``` kur "Linux" ir platforma, bet pārējā virknes daļa ir grūti uzminams slepenais teksts. Neaizmirstiet restartēt aģentu pēc jebkādu izmaiņu veikšanas konfigurācijas failā. ##### Agent configuration HA cluster nodes (servers) must be listed in the configuration of Zabbix agent or Zabbix agent 2.  To enable passive checks, the node names must be listed in the Server [parameter](/manual/appendix/config/zabbix_agentd), separated by a **comma**. ``` Server=zabbix-node-01,zabbix-node-02 ``` To enable active checks, the node names must be listed in the ServerActive [parameter](/manual/appendix/config/zabbix_agentd). Note that for active checks the nodes must be separated by a comma from any other servers, while the nodes themselves must be separated by a **semicolon**, e.g.: ``` ServerActive=zabbix-node-01;zabbix-node-02 ``` ##### Aģenta konfigurācija HA klastera mezgli (serveri) ir jānorāda Zabbix aģenta vai Zabbix aģenta 2 konfigurācijā.  Lai iespējotu pasīvos pārbaudes, mezglu nosaukumi ir jānorāda Server [parametrā](/manual/appendix/config/zabbix_agentd), atdalot tos ar **komatu**. ``` Server=zabbix-node-01,zabbix-node-02 ``` Lai iespējotu aktīvos pārbaudes, mezglu nosaukumi ir jānorāda ServerActive [parametrā](/manual/appendix/config/zabbix_agentd). Ņemiet vērā, ka aktīvajām pārbaudēm mezgliem jābūt atdalītiem no citiem serveriem ar komatu, savukārt pašiem mezgliem jābūt atdalītiem ar **semikolu**, piemēram: ``` ServerActive=zabbix-node-01;zabbix-node-02 ``` **Agent configuration** Now you need to configure the agents. Add the next line to the agent configuration files: ```ini HostMetadataItem=system.uname ``` This way you make sure host metadata will contain "Linux" or "Windows" depending on the host an agent is running on. An example of host metadata in this case: ```default Linux: Linux server3 3.2.0-4-686-pae #1 SMP Debian 3.2.41-2 i686 GNU/Linux Windows: Windows WIN-0PXGGSTYNHO 6.0.6001 Windows Server 2008 Service Pack 1 Intel IA-32 ``` Do not forget to restart the agent after making any changes to the configuration file. **Aģenta konfigurācija** Tagad jums jākonfigurē aģenti. Pievienojiet nākamo rindu aģenta konfigurācijas failiem: ```ini HostMetadataItem=system.uname ``` Tādējādi jūs nodrošināsiet, ka hosta metadati saturēs "Linux" vai "Windows" atkarībā no hosta, uz kura darbojas aģents. Hosta metadatu piemērs šajā gadījumā: ```default Linux: Linux server3 3.2.0-4-686-pae #1 SMP Debian 3.2.41-2 i686 GNU/Linux Windows: Windows WIN-0PXGGSTYNHO 6.0.6001 Windows Server 2008 Service Pack 1 Intel IA-32 ``` Neaizmirstiet restartēt aģentu pēc jebkādu izmaiņu veikšanas konfigurācijas failā. **Agent configuration** Update the next line in the agent configuration file: ```ini HostMetadata=MySQL on Linux 21df83bf21bf0be663090bb8d4128558ab9b95fba66a6dbf834f8b91ae5e08ae ``` Do not forget to restart the agent after making any changes to the configuration file. **Aģenta konfigurācija** Atjauniniet nākamo rindu aģenta konfigurācijas failā: ```ini HostMetadata=MySQL on Linux 21df83bf21bf0be663090bb8d4128558ab9b95fba66a6dbf834f8b91ae5e08ae ``` Neaizmirstiet restartēt aģentu pēc jebkādu izmaiņu veikšanas konfigurācijas failā. ##### agent.hostmetadata {#agent.hostmetadata} <br> The agent host metadata.<br> Return value: *String*.<br> See [supported platforms](#supported-platforms). Returns the value of [HostMetadata](/manual/appendix/config/zabbix_agentd#hostmetadata) or [HostMetadataItem](/manual/appendix/config/zabbix_agentd#hostmetadataitem) parameters, or empty string if none are defined. ##### aģents.hostmetadata {#agent.hostmetadata} <br> Aģenta hosta metadati.<br> Atgrieztā vērtība: *String*.<br> Skatiet [atbalstītās platformas](#supported-platforms). Atgriež [HostMetadata](/manual/appendix/config/zabbix_agentd#hostmetadata) vai [HostMetadataItem](/manual/appendix/config/zabbix_agentd#hostmetadataitem) parametru vērtību, vai tukšu virkni, ja neviens no tiem nav definēts. ##### agent.hostname {#agent.hostname} <br> The agent host name.<br> Return value: *String*.<br> See [supported platforms](#supported-platforms). Returns: - As passive check - the name of the first host listed in the [Hostname](/manual/appendix/config/zabbix_agentd#hostname) parameter of the agent configuration file; - As active check - the name of the current hostname. ##### aģents.hostname {#agent.hostname} <br> Aģenta hosta nosaukums.<br> Atgrieztā vērtība: *String*.<br> Skatiet [atbalstītās platformas](#supported-platforms). Atgriež: - Kā pasīvajai pārbaudei - pirmā hosta nosaukumu, kas norādīts aģenta konfigurācijas faila [Hostname](/manual/appendix/config/zabbix_agentd#hostname) parametrā; - Kā aktīvajai pārbaudei - pašreizējā hosta nosaukumu. #### Agent on Unix-like systems Zabbix agent on Unix-like systems is run on the host being monitored. #### Aģents Unix līdzīgās sistēmās Zabbix aģents Unix līdzīgās sistēmās tiek palaists uz uzraudzītā hosta. #### Agent on Windows systems Zabbix agent on Windows runs as a Windows service. #### Aģents Windows sistēmās Zabbix aģents Windows sistēmās darbojas kā Windows pakalpojums. ##### Agent operation with persistent file On startup Zabbix agent knows nothing about persistent files. Only after receiving a list of active checks from Zabbix server \(proxy\) the agent sees that some log items should be backed by persistent files under specified directories. During agent operation the persistent files are opened for writing (with fopen(filename, "w")) and overwritten with the latest data. The chance of losing persistent file data if the overwriting and file system mirror split happen at the same time is very small, no special handling for it. Writing into persistent file is NOT followed by enforced synchronization to storage media \(`fsync()` is not called\). Overwriting with the latest data is done after successful reporting of matching log file record or metadata \(processed log size and modification time\) to Zabbix server. That may happen as often as every item check if log file keeps changing. No special actions during agent shutdown. ##### Aģenta darbība ar pastāvīgu failu Startējoties Zabbix aģents neko nezina par pastāvīgiem failiem. Tikai pēc aktīvo pārbaužu saraksta saņemšanas no Zabbix servera \(starpniekservera\) aģents redz, ka daži žurnāla vienumi ir jāatbalsta ar pastāvīgiem failiem norādītajos direktorijos. Aģenta darbības laikā pastāvīgie faili tiek atvērti rakstīšanai (ar `fopen(filename, "w")`) un pārrakstīti ar jaunākajiem datiem. Iespēja zaudēt pastāvīgā faila datus, ja pārrakstīšana un failu sistēmas spoguļošanas sadalīšanās notiek vienlaikus, ir ļoti maza, tāpēc īpaša apstrāde nav nepieciešama. Rakstīšanai pastāvīgajā failā NETIEK veikta piespiedu sinhronizācija ar datu nesēju (`fsync()` netiek izsaukts). Pārrakstīšana ar jaunākajiem datiem tiek veikta pēc veiksmīgas atbilstošā žurnālfaila ieraksta vai metadatu (apstrādātais žurnāla lielums un modificēšanas laiks) paziņošanas Zabbix serverim. Tas var notikt tik bieži kā katrā vienuma pārbaudē, ja žurnālfails turpina mainīties. Aģenta izslēgšanas laikā īpašas darbības netiek veiktas. ##### agent.ping {#agent.ping} <br> The agent availability check.<br> Return value: Nothing - unavailable; 1 - available.<br> See [supported platforms](#supported-platforms). Use the **nodata()** trigger function to check for host unavailability. ##### agent.ping {#agent.ping} <br> Aģenta pieejamības pārbaude.<br> Atgrieztā vērtība: nekas — nav pieejams; 1 — pieejams.<br> Skatiet [atbalstītās platformas](#supported-platforms). Izmantojiet **nodata()** trigera funkciju, lai pārbaudītu hosta nepieejamību. #### Agent process types Agent process types are as follows: - `active checks` - process for performing active checks; - `collector` - process for data collection; - `listener` - process for listening to passive checks. The agent log file can be used to observe these process types. Since Zabbix 7.0.22, the agent log file is created with read-write permissions for the file owner only. Additionally the file is readable by the owner group. All other permissions are denied. #### Aģenta procesu tipi Aģenta procesu tipi ir šādi: - `active checks` - process aktīvo pārbaužu veikšanai; - `collector` - datu vākšanas process; - `listener` - process pasīvo pārbaužu uzklausīšanai. Šos procesu tipus var novērot aģenta žurnālfailā. Sākot ar Zabbix 7.0.22, aģenta žurnālfails tiek izveidots ar lasīšanas un rakstīšanas atļaujām tikai faila īpašniekam. Papildus tam failu var lasīt īpašnieka grupa. Visas pārējās atļaujas ir liegtas. ##### Agent |Requirement|Mandatory status|Description| |--|-|-------| |*libpcre/libpcre2*|One of|PCRE/PCRE2 library is required for [Perl Compatible Regular Expression](https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions) (PCRE) support.<br>The naming may differ depending on the GNU/Linux distribution, for example 'libpcre3' or 'libpcre1'. PCRE v8.x and PCRE2 v10.x are supported.<br>Required for log monitoring. Also required on Windows.| |*libpthread*|Yes|Required for mutex and read-write lock support (could be part of libc). Not required on Windows.| |*libresolv*|^|Required for DNS resolution (could be part of libc). Not required on Windows.| |*libiconv*|^|Required for text encoding/format conversion to UTF-8 in log items, file content, file regex and regmatch items (could be part of libc). Not required on Windows.| |*libgnutls* or *libopenssl*|No|Required if using [encryption](/manual/encryption#compiling-zabbix-with-encryption-support).<br>Minimum versions: *libgnutls* - 3.1.18, *libopenssl* - 1.0.1<br>On Microsoft Windows OpenSSL 1.1.1 or later is required.| |*libldap*|^|Required if LDAP is used. Not supported on Windows.| |*libcurl*|^|Required for extended support of Zabbix agent [web.page.\*](/manual/config/items/itemtypes/zabbix_agent#web.page.get) items.<br>Without libcurl, basic functionality is available (e.g., web.page.get\[http://example.com\]). With libcurl, the agent supports additional features, such as HTTP URLs with credentials (e.g., http://user:password@example.com) and HTTPS URLs.<br>Version 7.19.1 or higher is required (7.28.0 or higher is recommended).<br>To use upgraded cURL features, restart Zabbix agent.| |*libmodbus*|^|Only required if Modbus monitoring is used.<br>Version 3.0 or higher.| ##### Aģents |Requirement|Mandatory status|Description| |--|-|-------| |*libpcre/libpcre2*|One of|PCRE/PCRE2 bibliotēka ir nepieciešama [Perl Compatible Regular Expression](https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions) (PCRE) atbalstam.<br>Nosaukums var atšķirties atkarībā no GNU/Linux distribūcijas, piemēram, 'libpcre3' vai 'libpcre1'. Tiek atbalstītas PCRE v8.x un PCRE2 v10.x.<br>Nepieciešama žurnālu uzraudzībai. Nepieciešama arī operētājsistēmā Windows.| |*libpthread*|Yes|Nepieciešama mutex un lasīšanas/rakstīšanas bloķēšanas atbalstam (var būt daļa no libc). Operētājsistēmā Windows nav nepieciešama.| |*libresolv*|^|Nepieciešama DNS atrisināšanai (var būt daļa no libc). Operētājsistēmā Windows nav nepieciešama.| |*libiconv*|^|Nepieciešama teksta kodējuma/formāta pārveidei uz UTF-8 žurnālu vienumos, faila saturā, faila regex un regmatch vienumos (var būt daļa no libc). Operētājsistēmā Windows nav nepieciešama.| |*libgnutls* or *libopenssl*|No|Nepieciešama, ja tiek izmantota [šifrēšana](/manual/encryption#compiling-zabbix-with-encryption-support).<br>Minimālās versijas: *libgnutls* - 3.1.18, *libopenssl* - 1.0.1<br>Microsoft Windows vidē ir nepieciešams OpenSSL 1.1.1 vai jaunāks.| |*libldap*|^|Nepieciešama, ja tiek izmantots LDAP. Operētājsistēmā Windows netiek atbalstīta.| |*libcurl*|^|Nepieciešama paplašinātam Zabbix aģents [web.page.\*](/manual/config/items/itemtypes/zabbix_agent#web.page.get) vienumu atbalstam.<br>Bez libcurl ir pieejama pamata funkcionalitāte (piem., web.page.get\[http://example.com\]). Ar libcurl aģents atbalsta papildu iespējas, piemēram, HTTP URL ar akreditācijas datiem (piem., http://user:password@example.com) un HTTPS URL.<br>Nepieciešama versija 7.19.1 vai jaunāka (ieteicama 7.28.0 vai jaunāka).<br>Lai izmantotu atjauninātās cURL iespējas, restartējiet Zabbix aģents.| |*libmodbus*|^|Nepieciešama tikai tad, ja tiek izmantota Modbus uzraudzība.<br>Versija 3.0 vai jaunāka.| #### Agent upgrade process ::: noteimportant Upgrading agents is not mandatory. You only need to upgrade agents if it is required to access the new functionality. ::: The upgrade procedure described in this section may be used for upgrading both the Zabbix agent and the Zabbix agent 2. #### Aģenta jaunināšanas process ::: noteimportant Aģentu jaunināšana nav obligāta. Aģenti ir jājaunina tikai tad, ja tas ir nepieciešams, lai piekļūtu jaunajai funkcionalitātei. ::: Šajā sadaļā aprakstīto jaunināšanas procedūru var izmantot, lai jauninātu gan Zabbix aģentu, gan Zabbix aģentu 2. ##### agent.variant {#agent.variant} <br> The variant of Zabbix agent (Zabbix agent or Zabbix agent 2).<br> Return value: 1 - Zabbix agent; 2 - Zabbix agent 2.<br> See [supported platforms](#supported-platforms). ##### agent.variant {#agent.variant} <br> Zabbix aģents variants (Zabbix aģents vai Zabbix aģents 2).<br> Atgrieztā vērtība: 1 - Zabbix aģents; 2 - Zabbix aģents 2.<br> Skatiet [atbalstītās platformas](#supported-platforms). ##### agent.version {#agent.version} <br> The version of Zabbix agent.<br> Return value: *String*.<br> See [supported platforms](#supported-platforms). Example of returned value: ```default 6.0.3 ``` ##### aģents.version {#agent.version} <br> Zabbix aģenta versija.<br> Atgrieztā vērtība: *String*.<br> Skatiet [atbalstītās platformas](#supported-platforms). Atgrieztās vērtības piemērs: ```default 6.0.3 ``` ##### Agent Zabbix agents are deployed on monitoring targets to actively monitor local resources and applications and report the gathered data to Zabbix server. Since Zabbix 4.4, there are two types of agents available: the [Zabbix agent](/manual/concepts/agent) (lightweight, supported on many platforms, written in C) and the [Zabbix agent 2](/manual/concepts/agent2) (extra-flexible, easily extendable with plugins, written in Go). ##### Aģents Zabbix aģenti tiek izvietoti uz uzraudzības mērķiem, lai aktīvi uzraudzītu lokālos resursus un lietojumprogrammas un nosūtītu savāktos datus uz Zabbix serveri. Kopš Zabbix 4.4 ir pieejami divu veidu aģenti: [Zabbix aģents](/manual/concepts/agent) (viegls, atbalstīts daudzās platformās, rakstīts C valodā) un [Zabbix aģents 2](/manual/concepts/agent2) (ļoti elastīgs, viegli paplašināms ar spraudņiem, rakstīts Go valodā). #### Aggregate calculations Several aggregate functions have been updated. Now: - Aggregate functions now also support non-numeric types for calculation. This may be useful, for example, with the [count](/manual/appendix/functions/aggregate#count) and [count_foreach](/manual/appendix/functions/aggregate/foreach#additional-parameters) functions. - The [count](/manual/appendix/functions/aggregate#count) and [count_foreach](/manual/appendix/functions/aggregate/foreach#additional-parameters) aggregate functions support optional parameters *operator* and *pattern*, which can be used to fine-tune item filtering and only count values that match given criteria. - All [foreach functions](/manual/appendix/functions/aggregate/foreach) no longer include unsupported items in the count. - The function **[last_foreach](/manual/appendix/functions/aggregate/foreach#time-period)**, previously configured to ignore the time period argument, accepts it as an optional parameter. #### Agregētie aprēķini Vairākas agregētās funkcijas ir atjauninātas. Tagad: - Agregētās funkcijas aprēķinos tagad atbalsta arī nenumeriskus tipus. Tas var būt noderīgi, piemēram, ar funkcijām [count](/manual/appendix/functions/aggregate#count) un [count_foreach](/manual/appendix/functions/aggregate/foreach#additional-parameters). - Agregētās funkcijas [count](/manual/appendix/functions/aggregate#count) un [count_foreach](/manual/appendix/functions/aggregate/foreach#additional-parameters) atbalsta izvēles parametrus *operator* un *pattern*, kurus var izmantot, lai precīzāk pielāgotu vienumu filtrēšanu un skaitītu tikai tās vērtības, kas atbilst norādītajiem kritērijiem. - Visas [foreach funkcijas](/manual/appendix/functions/aggregate/foreach) vairs neiekļauj neatbalstītos vienumus skaitā. - Funkcija **[last_foreach](/manual/appendix/functions/aggregate/foreach#time-period)**, kas iepriekš bija konfigurēta, lai ignorētu laika perioda argumentu, tagad to pieņem kā izvēles parametru. ##### Aggregation in graphs Aggregation allows displaying an aggregated value (minimum, maximum, average, etc.) over a specified time interval (5 minutes, an hour, a day, etc.) instead of all individual values. Within a data set, aggregation can be applied either to each item separately or to the entire data set. Some use cases for the aggregation function can be as follows: - The average request count to an Nginx server per day. - The lowest disk space among clusters per week. In the following example, the "max" aggregation function is applied to the item with an aggregation interval of five minutes:  The example demonstrates the maximum CPU load over five minutes (aggregated from one-minute average values), compared to the average CPU load over five minutes. {width="600"} When *Show aggregation function* is selected for the legend, items are displayed in parentheses, prefixed by the aggregation function in the legend and the tooltip. If *Data set label* is specified for a graph, the label is displayed in parentheses, prefixed by the aggregation function. ##### Agregēšana grafikos Agregēšana ļauj attēlot agregētu vērtību (minimumu, maksimumu, vidējo u. c.) noteiktā laika intervālā (5 minūtes, stunda, diena u. c.) visu atsevišķo vērtību vietā. Datu kopā agregēšanu var piemērot vai nu katram vienumam atsevišķi, vai visai datu kopai. Daži agregēšanas funkcijas lietošanas gadījumi var būt šādi: - Vidējais pieprasījumu skaits uz Nginx serveri dienā. - Mazākā diska vieta starp klasteriem nedēļā. Tālākajā piemērā vienumam ir lietota agregēšanas funkcija "max" ar piecu minūšu agregēšanas intervālu:  Piemērs demonstrē maksimālo CPU slodzi piecu minūšu laikā (agregētu no vienas minūtes vidējām vērtībām), salīdzinot ar vidējo CPU slodzi piecu minūšu laikā. {width="600"} Ja leģendai ir atlasīts *Rādīt agregēšanas funkciju*, vienumi tiek attēloti iekavās, leģendā un paskaidrojumā tiem priekšā norādot agregēšanas funkciju. Ja grafikam ir norādīta *Datu kopas etiķete*, etiķete tiek attēlota iekavās, tai priekšā norādot agregēšanas funkciju. #### AGPL-3.0 license Zabbix software is now is written and distributed under the AGPL-3.0 license (previously GPL v2.0 license). #### AGPL-3.0 licence Zabbix programmatūra tagad tiek rakstīta un izplatīta saskaņā ar AGPL-3.0 licenci (iepriekš GPL v2.0 licence). #### AIX See values supported for 'memtype' parameter on AIX in the table. |Supported value|Description|Source in procentry64 structure|Tries to be compatible with| |--|------|--|--| |vsize ^[1](proc_mem_notes#footnotes)^|Virtual memory size|pi\_size| | |pmem|Percentage of real memory|pi\_prm|ps -o pmem| |rss|Resident set size|pi\_trss + pi\_drss|ps -o rssize| |size|Size of process (code + data)|pi\_dvm|"ps gvw" SIZE column| |dsize|Data size|pi\_dsize|<| |tsize|Text (code) size|pi\_tsize|"ps gvw" TSIZ column| |sdsize|Data size from shared library|pi\_sdsize|<| |drss|Data resident set size|pi\_drss| | |trss|Text resident set size|pi\_trss| | #### AIX Skatiet AIX atbalstītās parametra `memtype` vērtības tabulā. |Atbalstītā vērtība|Apraksts|Avots struktūrā procentry64|Mēģina būt saderīgs ar| |--|------|--|--| |vsize ^[1](proc_mem_notes#footnotes)^|Virtuālās atmiņas izmērs|pi\_size| | |pmem|Reālās atmiņas procentuālā daļa|pi\_prm|ps -o pmem| |rss|Rezidentās kopas izmērs|pi\_trss + pi\_drss|ps -o rssize| |size|Procesa izmērs (kods + dati)|pi\_dvm|"ps gvw" SIZE kolonna| |dsize|Datu izmērs|pi\_dsize|<| |tsize|Teksta (koda) izmērs|pi\_tsize|"ps gvw" TSIZ kolonna| |sdsize|Datu izmērs no koplietojamās bibliotēkas|pi\_sdsize|<| |drss|Datu rezidentās kopas izmērs|pi\_drss| | |trss|Teksta rezidentās kopas izmērs|pi\_trss| | #### Alert customization #### Brīdinājumu pielāgošana #### Alerter process crash in RHEL 7 Instances of a Zabbix server alerter process crash have been encountered in RHEL 7. Please see [ZBX-10461](https://support.zabbix.com/browse/ZBX-10461) for details. #### Alerter procesa avārija RHEL 7 RHEL 7 vidē ir konstatēti Zabbix servera alerter procesa avārijas gadījumi. Lūdzu, skatiet [ZBX-10461](https://support.zabbix.com/browse/ZBX-10461), lai iegūtu sīkāku informāciju. # alert.get # alert.get ### Alert ::: noteclassic Alerts are created by Zabbix server and cannot be modified via the API. ::: The alert object contains information about whether certain action operations have been executed successfully. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |alertid|ID|ID of the alert.| |actionid|ID|ID of the action that generated the alert.| |alerttype|integer|Alert type.<br><br>Possible values:<br>0 - message;<br>1 - remote command.| |clock|timestamp|Time when the alert was generated.| |error|string|Error text if there are problems sending a message or running a command.| |esc\_step|integer|Action escalation step during which the alert was generated.| |eventid|ID|ID of the event that triggered the action.| |mediatypeid|ID|ID of the media type that was used to send the message.| |message|text|Message text.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `alerttype` is set to "message"| |retries|integer|Number of times Zabbix tried to send the message.| |sendto|string|Address, user name or other identifier of the recipient.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `alerttype` is set to "message"| |status|integer|Status indicating whether the action operation has been executed successfully.<br><br>Possible values if `alerttype` is set to "message":<br>0 - message not sent;<br>1 - message sent;<br>2 - failed after a number of retries;<br>3 - new alert is not yet processed by alert manager.<br><br>Possible values if `alerttype` is set to "remote command":<br>0 - command not run;<br>1 - command run;<br>2 - tried to run the command on Zabbix agent, but it was unavailable.| |subject|string|Message subject.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `alerttype` is set to "message"| |userid|ID|ID of the user that the message was sent to.| |p\_eventid|ID|ID of problem event, which generated the alert.| |acknowledgeid|ID|ID of acknowledgment, which generated the alert.| ### Brīdinājums ::: noteclassic Brīdinājumus izveido Zabbix serveris, un tos nevar modificēt, izmantojot API. ::: Brīdinājuma objekts satur informāciju par to, vai noteiktas darbības operācijas ir izpildītas veiksmīgi. Tam ir šādas īpašības. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |alertid|ID|Brīdinājuma ID.| |actionid|ID|Darbības ID, kas ģenerēja brīdinājumu.| |alerttype|integer|Brīdinājuma tips.<br><br>Iespējamās vērtības:<br>0 - ziņojums;<br>1 - attālināta komanda.| |clock|timestamp|Laiks, kad brīdinājums tika ģenerēts.| |error|string|Kļūdas teksts, ja rodas problēmas ar ziņojuma nosūtīšanu vai komandas izpildi.| |esc\_step|integer|Darbības eskalācijas solis, kura laikā tika ģenerēts brīdinājums.| |eventid|ID|Notikuma ID, kas izraisīja darbību.| |mediatypeid|ID|Medija tipa ID, kas tika izmantots ziņojuma nosūtīšanai.| |message|text|Ziņojuma teksts.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *atbalstīts*, ja `alerttype` ir iestatīts uz "message"| |retries|integer|Reižu skaits, cik Zabbix mēģināja nosūtīt ziņojumu.| |sendto|string|Saņēmēja adrese, lietotājvārds vai cits identifikators.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *atbalstīts*, ja `alerttype` ir iestatīts uz "message"| |status|integer|Statuss, kas norāda, vai darbības operācija ir izpildīta veiksmīgi.<br><br>Iespējamās vērtības, ja `alerttype` ir iestatīts uz "message":<br>0 - ziņojums nav nosūtīts;<br>1 - ziņojums nosūtīts;<br>2 - neizdevās pēc vairākiem atkārtotiem mēģinājumiem;<br>3 - jaunu brīdinājumu vēl nav apstrādājis brīdinājumu pārvaldnieks.<br><br>Iespējamās vērtības, ja `alerttype` ir iestatīts uz "remote command":<br>0 - komanda nav izpildīta;<br>1 - komanda izpildīta;<br>2 - tika mēģināts izpildīt komandu uz Zabbix aģents, bet tas nebija pieejams.| |subject|string|Ziņojuma temats.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *atbalstīts*, ja `alerttype` ir iestatīts uz "message"| |userid|ID|Lietotāja ID, kuram tika nosūtīts ziņojums.| |p\_eventid|ID|Problēmas notikuma ID, kas ģenerēja brīdinājumu.| |acknowledgeid|ID|Apstiprinājuma ID, kas ģenerēja brīdinājumu.| # Alert object The following objects are directly related to the `alert` API. # Brīdinājuma objekts Tālāk norādītie objekti ir tieši saistīti ar `alert` API. ##### Alert scripts An [alert script](/manual/config/notifications/media/script) is a Zabbix [media type](/manual/config/notifications/media) that provides an option to create an alternative way (script) to handle Zabbix alerts. Alert scripts are useful if you are not satisfied with the existing media types for sending alerts in Zabbix. ##### Brīdinājumu skripti [Brīdinājumu skripts](/manual/config/notifications/media/script) ir Zabbix [medija tips](/manual/config/notifications/media), kas nodrošina iespēju izveidot alternatīvu veidu (skriptu) Zabbix brīdinājumu apstrādei. Brīdinājumu skripti ir noderīgi, ja jūs neapmierina esošie mediju tipi brīdinājumu nosūtīšanai Zabbix. ##### AlertScriptsPath The location of [custom alert scripts](/manual/config/notifications/media/script) (depends on the `datadir` compile-time installation variable). Default: `/usr/local/share/zabbix/alertscripts` ##### AlertScriptsPath [pielāgoto brīdinājumu skriptu](/manual/config/notifications/media/script) atrašanās vieta (atkarīga no `datadir` kompilēšanas laikā iestatītā instalācijas mainīgā). Noklusējums: `/usr/local/share/zabbix/alertscripts` ## Alerts The Zabbix API allows you to manage the actions and alerts of your monitoring system. ## Brīdinājumi Zabbix API ļauj pārvaldīt jūsu uzraudzības sistēmas darbības un brīdinājumus. #### Alert The `Alert` object represents a web page alert, is returned by [`Browser`](#browser) object `getAlert()` method, and cannot be constructed directly. The `Alert` object contains the `text` property with the alert text (or `null` if there are no alerts). The following methods are supported with the `Alert` object. |Method|Description| |--|--------| |`accept()`|Accept the alert.| |`dismiss()`|Dismiss the alert.| #### Brīdinājums Objekts `Alert` attēlo tīmekļa lapas brīdinājumu, to atgriež objekta [`Browser`](#browser) metode `getAlert()`, un to nevar izveidot tieši. Objekts `Alert` satur rekvizītu `text` ar brīdinājuma tekstu (vai `null`, ja brīdinājumu nav). Ar objektu `Alert` tiek atbalstītas šādas metodes. |Method|Description| |--|--------| |`accept()`|Apstiprināt brīdinājumu.| |`dismiss()`|Noraidīt brīdinājumu.| # Alert This class is designed to work with alerts. Object references: - [Alert](/manual/api/reference/alert/object#alert) Available methods: - [alert.get](/manual/api/reference/alert/get) - retrieve alerts # Brīdinājums Šī klase ir paredzēta darbam ar brīdinājumiem. Objekta atsauces: - [Alert](/manual/api/reference/alert/object#alert) Pieejamās metodes: - [alert.get](/manual/api/reference/alert/get) - izgūt brīdinājumus #### alert [ZBX-25385](https://support.zabbix.com/browse/ZBX-25385) `alert.get`: *Admin* type users may now retrieve only the following [Media type object](/manual/api/reference/mediatype/object) properties with the `selectMediatypes` parameter: `mediatypeid`, `name`, `type`, `status`, `maxattempts`, `description`. #### alert [ZBX-25385](https://support.zabbix.com/browse/ZBX-25385) `alert.get`: *Admin* tipa lietotāji tagad var izgūt tikai šādas [Media type object](/manual/api/reference/mediatype/object) īpašības ar parametru `selectMediatypes`: `mediatypeid`, `name`, `type`, `status`, `maxattempts`, `description`. #### alert [ZBX-26023](https://support.zabbix.com/browse/ZBX-26023) `alert.get`: *Admin* and *User* type users may now retrieve "message" (0) type alert data about users in their user group. #### brīdinājums [ZBX-26023](https://support.zabbix.com/browse/ZBX-26023) `alert.get`: *Admin* un *User* tipa lietotāji tagad var izgūt "message" (0) tipa brīdinājuma datus par lietotājiem savā lietotāju grupā. #### alert [ZBX-26258](https://support.zabbix.com/browse/ZBX-26258) `alert.get`: Parameter `selectUsers` now returns data based on the restrictions added to `user.get` method.<br> [ZBX-26258](https://support.zabbix.com/browse/ZBX-26258) `alert.get`: *Admin* and *User* type users may now retrieve "message" (0) type alert data only about their own user. #### brīdinājums [ZBX-26258](https://support.zabbix.com/browse/ZBX-26258) `alert.get`: parametrs `selectUsers` tagad atgriež datus, pamatojoties uz ierobežojumiem, kas pievienoti `user.get` metodei.<br> [ZBX-26258](https://support.zabbix.com/browse/ZBX-26258) `alert.get`: *Admin* un *User* tipa lietotāji tagad var izgūt tikai "message" (0) tipa brīdinājumu datus par savu lietotāju. #### alert [ZBXNEXT-6974](https://support.zabbix.com/browse/ZBXNEXT-6974) `alert.get`: Added strict validation of the method parameters. #### alert [ZBXNEXT-6974](https://support.zabbix.com/browse/ZBXNEXT-6974) `alert.get`: Pievienota stingra metodes parametru validācija. #### alert [ZBXNEXT-9404](https://support.zabbix.com/browse/ZBXNEXT-9404) `alert.get`: *User* type users may now retrieve the following [Media type object](/manual/api/reference/mediatype/object) properties with the `selectMediatypes` parameter: `mediatypeid`, `name`, `type`, `status`, `maxattempts`, `description`. #### brīdinājums [ZBXNEXT-9404](https://support.zabbix.com/browse/ZBXNEXT-9404) `alert.get`: *User* tipa lietotāji tagad var izgūt šādas [Media type object](/manual/api/reference/mediatype/object) īpašības, izmantojot `selectMediatypes` parametru: `mediatypeid`, `name`, `type`, `status`, `maxattempts`, `description`. ##### Alias Sets an alias for an item key. It can be used to substitute a long and complex item key with a shorter and simpler one.<br> Multiple `Alias` parameters may be present. Multiple parameters with the same `Alias` key are not allowed.<br> Different `Alias` keys may reference the same item key.<br> Aliases can be used in `HostMetadataItem` but not in `HostnameItem` or `PerfCounter` parameter. Example 1: Retrieving the paging file usage in percentage from the server. ```default Alias=pg_usage:perf_counter[\Paging File(_Total)\% Usage] ``` Now the shorthand key `pg_usage` may be used to retrieve data. Example 2: Getting the CPU load with default and custom parameters. ```default Alias=cpu.load:system.cpu.load Alias=cpu.load[*]:system.cpu.load[*] ``` This allows use `cpu.load` key to get the CPU load with default parameters as well as use `cpu.load[percpu,avg15]` to get specific data about the CPU load. Example 3: Running multiple [low-level discovery](/manual/discovery/low_level_discovery) rules processing the same discovery items. ```default Alias=vfs.fs.discovery[*]:vfs.fs.discovery ``` Now it is possible to set up several discovery rules using `vfs.fs.discovery` with different parameters for each rule, e.g., `vfs.fs.discovery[foo]`, `vfs.fs.discovery[bar]`, etc. ##### Alias Iestata vienuma atslēgas aizstājvārdu. To var izmantot, lai aizstātu garu un sarežģītu vienuma atslēgu ar īsāku un vienkāršāku.<br> Var būt norādīti vairāki `Alias` parametri. Nav atļauti vairāki parametri ar vienu un to pašu `Alias` atslēgu.<br> Dažādas `Alias` atslēgas var atsaukties uz vienu un to pašu vienuma atslēgu.<br> Aliasus var izmantot `HostMetadataItem`, bet ne `HostnameItem` vai `PerfCounter` parametrā. Piemērs 1: Lapošanas faila lietojuma procentos izgūšana no servera. ```default Alias=pg_usage:perf_counter[\Paging File(_Total)\% Usage] ``` Tagad saīsināto atslēgu `pg_usage` var izmantot datu izgūšanai. Piemērs 2: CPU noslodzes iegūšana ar noklusējuma un pielāgotiem parametriem. ```default Alias=cpu.load:system.cpu.load Alias=cpu.load[*]:system.cpu.load[*] ``` Tas ļauj izmantot `cpu.load` atslēgu CPU noslodzes iegūšanai ar noklusējuma parametriem, kā arī `cpu.load[percpu,avg15]` atslēgu, lai iegūtu konkrētus datus par CPU noslodzi. Piemērs 3: Vairāku [zemā līmeņa atklāšanas](/manual/discovery/low_level_discovery) noteikumu izpilde, apstrādājot tos pašus atklāšanas vienumus. ```default Alias=vfs.fs.discovery[*]:vfs.fs.discovery ``` Tagad ir iespējams konfigurēt vairākus atklāšanas noteikumus, izmantojot `vfs.fs.discovery` ar atšķirīgiem parametriem katram noteikumam, piemēram, `vfs.fs.discovery[foo]`, `vfs.fs.discovery[bar]` utt. ##### Alias Sets an alias for an item key. It can be used to substitute a long and complex item key with a shorter and simpler one.<br> Multiple `Alias` parameters may be present. Multiple parameters with the same `Alias` key are not allowed.<br> Different `Alias` keys may reference the same item key.<br> Aliases can be used in `HostMetadataItem` but not in `HostnameItem` parameter. Example 1: Retrieving the ID of user `zabbix`. ```default Alias=zabbix.userid:vfs.file.regexp[/etc/passwd,"^zabbix:.:([0-9]+)",,,,\1] ``` Now the `zabbix.userid` shorthand key may be used to retrieve data. Example 2: Getting CPU utilization with default and custom parameters. ```default Alias=cpu.util:system.cpu.util Alias=cpu.util[*]:system.cpu.util[*] ``` This allows use the `cpu.util` key to get CPU utilization percentage with default parameters as well as use `cpu.util[all, idle, avg15]` to get specific data about CPU utilization. Example 3: Running multiple [low-level discovery](/manual/discovery/low_level_discovery) rules processing the same discovery items. ```default Alias=vfs.fs.discovery[*]:vfs.fs.discovery ``` Now it is possible to set up several discovery rules using `vfs.fs.discovery` with different parameters for each rule, e.g., `vfs.fs.discovery[foo]`, `vfs.fs.discovery[bar]`, etc. ##### Alias Iestata vienuma atslēgas aizstājvārdu. To var izmantot, lai aizstātu garu un sarežģītu vienuma atslēgu ar īsāku un vienkāršāku.<br> Var būt norādīti vairāki `Alias` parametri. Nav atļauti vairāki parametri ar vienu un to pašu `Alias` atslēgu.<br> Dažādas `Alias` atslēgas var atsaukties uz vienu un to pašu vienuma atslēgu.<br> Aizstājvārdus var izmantot `HostMetadataItem`, bet ne `HostnameItem` parametrā. Piemērs 1: lietotāja `zabbix` ID iegūšana. ```default Alias=zabbix.userid:vfs.file.regexp[/etc/passwd,"^zabbix:.:([0-9]+)",,,,\1] ``` Tagad datu iegūšanai var izmantot saīsināto atslēgu `zabbix.userid`. Piemērs 2: CPU noslodzes iegūšana ar noklusējuma un pielāgotiem parametriem. ```default Alias=cpu.util:system.cpu.util Alias=cpu.util[*]:system.cpu.util[*] ``` Tas ļauj izmantot atslēgu `cpu.util`, lai iegūtu CPU noslodzes procentuālo vērtību ar noklusējuma parametriem, kā arī izmantot `cpu.util[all, idle, avg15]`, lai iegūtu konkrētus datus par CPU noslodzi. Piemērs 3: vairāku [zemlīmeņa atklāšanas](/manual/discovery/low_level_discovery) noteikumu izpilde, apstrādājot tos pašus atklāšanas vienumus. ```default Alias=vfs.fs.discovery[*]:vfs.fs.discovery ``` Tagad ir iespējams iestatīt vairākus atklāšanas noteikumus, izmantojot `vfs.fs.discovery` ar atšķirīgiem parametriem katram noteikumam, piemēram, `vfs.fs.discovery[foo]`, `vfs.fs.discovery[bar]` utt. ##### Alias Sets an alias for an item key. It can be used to substitute a long and complex item key with a shorter and simpler one.<br> Multiple `Alias` parameters may be present. Multiple parameters with the same `Alias` key are not allowed.<br> Different `Alias` keys may reference the same item key.<br> Aliases can be used in `HostMetadataItem` but not in `HostnameItem` parameter. Example 1: Retrieving the ID of user `zabbix`. ```default Alias=zabbix.userid:vfs.file.regexp[/etc/passwd,"^zabbix:.:([0-9]+)",,,,\1] ``` Now the `zabbix.userid` shorthand key may be used to retrieve data. Example 2: Getting CPU utilization with default and custom parameters. ```default Alias=cpu.util:system.cpu.util Alias=cpu.util[*]:system.cpu.util[*] ``` This allows use the `cpu.util` key to get CPU utilization percentage with default parameters as well as use `cpu.util[all, idle, avg15]` to get specific data about CPU utilization. Example 3: Running multiple [low-level discovery](/manual/discovery/low_level_discovery) rules processing the same discovery items. ```default Alias=vfs.fs.discovery[*]:vfs.fs.discovery ``` Now it is possible to set up several discovery rules using `vfs.fs.discovery` with different parameters for each rule, e.g., `vfs.fs.discovery[foo]`, `vfs.fs.discovery[bar]`, etc. ##### Alias Iestata vienuma atslēgas aizstājvārdu. To var izmantot, lai aizstātu garu un sarežģītu vienuma atslēgu ar īsāku un vienkāršāku.<br> Var būt norādīti vairāki `Alias` parametri. Nav atļauti vairāki parametri ar vienu un to pašu `Alias` atslēgu.<br> Dažādas `Alias` atslēgas var atsaukties uz vienu un to pašu vienuma atslēgu.<br> Aizstājvārdus var izmantot `HostMetadataItem`, bet ne `HostnameItem` parametrā. Piemērs 1: lietotāja `zabbix` ID iegūšana. ```default Alias=zabbix.userid:vfs.file.regexp[/etc/passwd,"^zabbix:.:([0-9]+)",,,,\1] ``` Tagad saīsināto atslēgu `zabbix.userid` var izmantot datu iegūšanai. Piemērs 2: CPU noslodzes iegūšana ar noklusējuma un pielāgotiem parametriem. ```default Alias=cpu.util:system.cpu.util Alias=cpu.util[*]:system.cpu.util[*] ``` Tas ļauj izmantot atslēgu `cpu.util`, lai iegūtu CPU noslodzes procentu ar noklusējuma parametriem, kā arī izmantot `cpu.util[all, idle, avg15]`, lai iegūtu konkrētus CPU noslodzes datus. Piemērs 3: vairāku [zemlīmeņa atklāšanas](/manual/discovery/low_level_discovery) noteikumu izpilde, kas apstrādā tos pašus atklāšanas vienumus. ```default Alias=vfs.fs.discovery[*]:vfs.fs.discovery ``` Tagad ir iespējams konfigurēt vairākus atklāšanas noteikumus, izmantojot `vfs.fs.discovery` ar atšķirīgiem parametriem katram noteikumam, piemēram, `vfs.fs.discovery[foo]`, `vfs.fs.discovery[bar]` utt. ##### Alias Sets an alias for an item key. It can be used to substitute a long and complex item key with a shorter and simpler one.<br> Multiple `Alias` parameters may be present. Multiple parameters with the same `Alias` key are not allowed.<br> Different `Alias` keys may reference the same item key.<br> Aliases can be used in `HostMetadataItem` but not in the `HostnameItem` parameter. Example 1: Retrieving the paging file usage in percentage from the server. ```default Alias=pg_usage:perf_counter[\Paging File(_Total)\% Usage] ``` Now the shorthand key `pg_usage` may be used to retrieve data. Example 2: Getting the CPU load with default and custom parameters. ```default Alias=cpu.load:system.cpu.load Alias=cpu.load[*]:system.cpu.load[*] ``` This allows use `cpu.load` key to get the CPU load with default parameters as well as use `cpu.load[percpu,avg15]` to get specific data about the CPU load. Example 3: Running multiple [low-level discovery](/manual/discovery/low_level_discovery) rules processing the same discovery items. ```default Alias=vfs.fs.discovery[*]:vfs.fs.discovery ``` Now it is possible to set up several discovery rules using `vfs.fs.discovery` with different parameters for each rule, e.g., `vfs.fs.discovery[foo]`, `vfs.fs.discovery[bar]`, etc. ##### Alias Iestata vienuma atslēgas aizstājvārdu. To var izmantot, lai aizstātu garu un sarežģītu vienuma atslēgu ar īsāku un vienkāršāku.<br> Var būt norādīti vairāki `Alias` parametri. Nav atļauti vairāki parametri ar vienu un to pašu `Alias` atslēgu.<br> Dažādas `Alias` atslēgas var atsaukties uz vienu un to pašu vienuma atslēgu.<br> Aizstājvārdus var izmantot `HostMetadataItem`, bet ne `HostnameItem` parametrā. Piemērs 1: Lappošanas faila lietojuma procentos iegūšana no serveris. ```default Alias=pg_usage:perf_counter[\Paging File(_Total)\% Usage] ``` Tagad saīsināto atslēgu `pg_usage` var izmantot datu iegūšanai. Piemērs 2: CPU noslodzes iegūšana ar noklusējuma un pielāgotiem parametriem. ```default Alias=cpu.load:system.cpu.load Alias=cpu.load[*]:system.cpu.load[*] ``` Tas ļauj izmantot `cpu.load` atslēgu CPU noslodzes iegūšanai ar noklusējuma parametriem, kā arī `cpu.load[percpu,avg15]`, lai iegūtu konkrētus datus par CPU noslodzi. Piemērs 3: Vairāku [zemlīmeņa atklāšanas](/manual/discovery/low_level_discovery) noteikumu izpilde, apstrādājot tos pašus atklāšanas vienumus. ```default Alias=vfs.fs.discovery[*]:vfs.fs.discovery ``` Tagad ir iespējams konfigurēt vairākus atklāšanas noteikumus, izmantojot `vfs.fs.discovery` ar atšķirīgiem parametriem katram noteikumam, piemēram, `vfs.fs.discovery[foo]`, `vfs.fs.discovery[bar]` utt. ##### Aligning time zones for proxies and agent Note that Zabbix proxies and agent use their local time zones when processing scheduling intervals. For this reason, when scheduling intervals are applied to items monitored by Zabbix proxy or agent active items, it is recommended to set the time zone of the respective proxies or agent the same as Zabbix server, otherwise the [queue](/manual/config/items/queue) may report item delays incorrectly. The time zone for Zabbix proxy or agent can be set using the environment variable `TZ` in the `systemd` unit file: ```default [Service] ... Environment="TZ=Europe/Amsterdam" ``` ##### Laika joslu saskaņošana starpniekserveriem un aģentam Ņemiet vērā, ka Zabbix starpniekserveri un aģents, apstrādājot plānošanas intervālus, izmanto savas lokālās laika joslas. Tādēļ, ja plānošanas intervāli tiek piemēroti vienumiem, kurus uzrauga Zabbix starpniekserveris, vai aģenta aktīvajiem vienumiem, ieteicams attiecīgajiem starpniekserveriem vai aģentam iestatīt tādu pašu laika joslu kā Zabbix serverim, pretējā gadījumā [rinda](/manual/config/items/queue) var nepareizi ziņot par vienumu aizturēm. Zabbix starpniekservera vai aģenta laika joslu var iestatīt, izmantojot vides mainīgo `TZ` `systemd` vienības failā: ```default [Service] ... Environment="TZ=Europe/Amsterdam" ``` All of these parameters can be changed in *Administration* > [*Housekeeping*](/manual/web_interface/frontend_sections/administration/housekeeping) after the installation. ::: notetip You may want to run the timescaledb-tune tool provided by TimescaleDB to optimize PostgreSQL configuration parameters in your `postgresql.conf`. ::: Visus šos parametrus pēc instalēšanas var mainīt sadaļā *Administrēšana* > [*Housekeeping*](/manual/web_interface/frontend_sections/administration/housekeeping). ::: notetip Iespējams, vēlēsieties palaist TimescaleDB nodrošināto rīku timescaledb-tune, lai optimizētu PostgreSQL konfigurācijas parametrus savā `postgresql.conf`. ::: #### Allow/deny rule order You can specify an unlimited number of `AllowKey` or `DenyKey` rules, though their order matters. - Rules are evaluated one by one, from top to bottom. - When an item key matches a rule, it is either allowed or denied, and rule evaluation stops. For example, when evaluating `vfs.file.contents[/etc/passwd]`, the rules are processed as follows: ```default AllowKey=vfs.file.contents[/tmp/app.log] # Item key pattern does not match, agent proceeds to the next rule. AllowKey=vfs.file.contents[/etc/passwd] # Item key pattern matches; agent allows the item check and stops rule evaluation. DenyKey=vfs.file.*[*] # Agent ignores the rule, as the evaluation has stopped. ``` The following rule order will deny the item check: ```default DenyKey=vfs.file.*[*] # Item key pattern matches; agent denies the item check and stops rule evaluation. AllowKey=vfs.file.contents[/etc/passwd] # Agent ignores the rule, as the evaluation has stopped. AllowKey=vfs.file.contents[/tmp/app.log] # Agent ignores the rule, as the evaluation has stopped. ``` #### Atļaut/aizliegt noteikumu secība Varat norādīt neierobežotu skaitu `AllowKey` vai `DenyKey` noteikumu, taču to secībai ir nozīme. - Noteikumi tiek izvērtēti pa vienam, no augšas uz leju. - Kad vienuma atslēga atbilst noteikumam, tā tiek vai nu atļauta, vai aizliegta, un noteikumu izvērtēšana tiek pārtraukta. Piemēram, izvērtējot `vfs.file.contents[/etc/passwd]`, noteikumi tiek apstrādāti šādi: ```default AllowKey=vfs.file.contents[/tmp/app.log] # Vienuma atslēgas raksts neatbilst, aģents pāriet pie nākamā noteikuma. AllowKey=vfs.file.contents[/etc/passwd] # Vienuma atslēgas raksts atbilst; aģents atļauj vienuma pārbaudi un pārtrauc noteikumu izvērtēšanu. DenyKey=vfs.file.*[*] # Aģents ignorē noteikumu, jo izvērtēšana ir pārtraukta. ``` Šāda noteikumu secība aizliegs vienuma pārbaudi: ```default DenyKey=vfs.file.*[*] # Vienuma atslēgas raksts atbilst; aģents aizliedz vienuma pārbaudi un pārtrauc noteikumu izvērtēšanu. AllowKey=vfs.file.contents[/etc/passwd] # Aģents ignorē noteikumu, jo izvērtēšana ir pārtraukta. AllowKey=vfs.file.contents[/tmp/app.log] # Aģents ignorē noteikumu, jo izvērtēšana ir pārtraukta. ``` ##### AllowedIP A list of comma delimited IP addresses, optionally in CIDR notation, or DNS names of Zabbix servers and Zabbix proxies. Incoming connections will be accepted only from the hosts listed here.<br>If IPv6 support is enabled then `127.0.0.1`, `::127.0.0.1`, `::ffff:127.0.0.1` are treated equally and `::/0` will allow any IPv4 or IPv6 address. `0.0.0.0/0` can be used to allow any IPv4 address. Example: 127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com Mandatory: yes ##### AllowedIP Ar komatiem atdalīts Zabbix serveru un Zabbix starpniekserveru IP adrešu saraksts, pēc izvēles CIDR pierakstā, vai DNS nosaukumi. Ienākošie savienojumi tiks pieņemti tikai no šeit norādītajiem hostiem.<br>Ja IPv6 atbalsts ir iespējots, tad `127.0.0.1`, `::127.0.0.1`, `::ffff:127.0.0.1` tiek uzskatītas par vienādām, un `::/0` atļaus jebkuru IPv4 vai IPv6 adresi. `0.0.0.0/0` var izmantot, lai atļautu jebkuru IPv4 adresi. Piemērs: 127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com Obligāts: jā ##### Allowing scripts Allow Zabbix agent to execute scripts on hosts via all available methods: - [Global scripts](/manual/web_interface/frontend_sections/alerts/scripts) that can be executed in the frontend or via API (this method always uses the `system.run[myscript.sh]` key) - Remote commands from [action operations](/manual/config/notifications/action/operation#operation-details) (this method always uses the `system.run[myscript.sh,nowait]` key) - [`system.run`](/manual/config/items/itemtypes/zabbix_agent#system.run) Zabbix agent items with the script, for example: - `system.run[myscript.sh]` - `system.run[myscript.sh,wait]` - `system.run[myscript.sh,nowait]` ```default AllowKey=system.run[myscript.sh,*] ``` To control the `wait`/`nowait` parameter, you must set a different rule. For example, you can allow only `system.run[myscript.sh,wait]` items, thus excluding other methods: ```default AllowKey=system.run[myscript.sh,wait] ``` ##### Skriptu atļaušana Atļaujiet Zabbix aģentam izpildīt skriptus hostos, izmantojot visas pieejamās metodes: - [Globālie skripti](/manual/web_interface/frontend_sections/alerts/scripts), kurus var izpildīt lietotāja saskarnē vai izmantojot API (šī metode vienmēr izmanto `system.run[myscript.sh]` atslēgu) - Attālinātās komandas no [darbību operācijām](/manual/config/notifications/action/operation#operation-details) (šī metode vienmēr izmanto `system.run[myscript.sh,nowait]` atslēgu) - [`system.run`](/manual/config/items/itemtypes/zabbix_agent#system.run) Zabbix aģenta vienumi ar skriptu, piemēram: - `system.run[myscript.sh]` - `system.run[myscript.sh,wait]` - `system.run[myscript.sh,nowait]` ```default AllowKey=system.run[myscript.sh,*] ``` Lai kontrolētu `wait`/`nowait` parametru, jāiestata cits noteikums. Piemēram, varat atļaut tikai `system.run[myscript.sh,wait]` vienumus, tādējādi izslēdzot citas metodes: ```default AllowKey=system.run[myscript.sh,wait] ``` ##### Allowing specific checks and commands Allow only two [`vfs.file`](/manual/config/items/itemtypes/zabbix_agent#vfs.file.cksum) item checks and two [`system.run`](/manual/config/items/itemtypes/zabbix_agent#system.run) commands: ```default AllowKey=vfs.file.contents[/tmp/app.log] AllowKey=vfs.file.size[/tmp/app.log] AllowKey=system.run[/usr/bin/uptime] AllowKey=system.run[/usr/bin/df -h /] DenyKey=vfs.file.*[*] ``` ::: noteclassic Setting `DenyKey=system.run[*]` is unnecessary, because all other `system.run` commands are denied by default. ::: ##### Atļaut konkrētas pārbaudes un komandas Atļaut tikai divas [`vfs.file`](/manual/config/items/itemtypes/zabbix_agent#vfs.file.cksum) vienumu pārbaudes un divas [`system.run`](/manual/config/items/itemtypes/zabbix_agent#system.run) komandas: ```default AllowKey=vfs.file.contents[/tmp/app.log] AllowKey=vfs.file.size[/tmp/app.log] AllowKey=system.run[/usr/bin/uptime] AllowKey=system.run[/usr/bin/df -h /] DenyKey=vfs.file.*[*] ``` ::: noteclassic Iestatīt `DenyKey=system.run[*]` nav nepieciešams, jo visas pārējās `system.run` komandas pēc noklusējuma ir aizliegtas. ::: ##### AllowKey Allow the execution of those item keys that match a pattern. The key pattern is a wildcard expression that supports the `*` character to match any number of any characters.<br>Multiple key matching rules may be defined in combination with `DenyKey`. The parameters are processed one by one according to their appearance order. See also: [Restricting agent checks](/manual/config/items/restrict_checks). ##### AllowKey Atļauj izpildīt tos vienumu atslēgu nosaukumus, kas atbilst paraugam. Atslēgas paraugs ir aizstājējzīmju izteiksme, kas atbalsta `*` rakstzīmi, lai atbilstu jebkuram jebkādu rakstzīmju skaitam.<br>Vairākus atslēgu atbilstības noteikumus var definēt kopā ar `DenyKey`. Parametri tiek apstrādāti pa vienam atbilstoši to parādīšanās secībai. Skatiet arī: [Aģenta pārbaužu ierobežošana](/manual/config/items/restrict_checks). ##### AllowKey Allow the execution of those item keys that match a pattern. The key pattern is a wildcard expression that supports the `*` character to match any number of any characters.<br>Multiple key matching rules may be defined in combination with `DenyKey`. The parameters are processed one by one according to their appearance order. See also: [Restricting agent checks](/manual/config/items/restrict_checks). ##### AllowKey Atļauj izpildīt tos vienumu atslēgu nosaukumus, kas atbilst paraugam. Atslēgas paraugs ir aizstājējzīmju izteiksme, kas atbalsta `*` rakstzīmi, lai atbilstu jebkuram simbolu skaitam.<br>Vairāki vienumu atslēgu atbilstības noteikumi var tikt definēti kopā ar `DenyKey`. Parametri tiek apstrādāti pa vienam atbilstoši to parādīšanās secībai. Skatiet arī: [Aģenta pārbaužu ierobežošana](/manual/config/items/restrict_checks). ##### AllowKey Allow the execution of those item keys that match a pattern. The key pattern is a wildcard expression that supports the `*` character to match any number of any characters.<br>Multiple key matching rules may be defined in combination with `DenyKey`. The parameters are processed one by one according to their appearance order. See also: [Restricting agent checks](/manual/config/items/restrict_checks). ##### AllowKey Atļauj izpildīt tos vienumu atslēgu nosaukumus, kas atbilst paraugam. Atslēgas paraugs ir aizstājējzīmju izteiksme, kas atbalsta `*` rakstzīmi, lai atbilstu jebkuram simbolu skaitam.<br>Vairāki atslēgu atbilstības noteikumi var tikt definēti kopā ar `DenyKey`. Parametri tiek apstrādāti pa vienam atbilstoši to parādīšanās secībai. Skatiet arī: [Aģenta pārbaužu ierobežošana](/manual/config/items/restrict_checks). ##### AllowKey Allow the execution of those item keys that match a pattern. The key pattern is a wildcard expression that supports the `*` character to match any number of any characters.<br>Multiple key matching rules may be defined in combination with `DenyKey`. The parameters are processed one by one according to their appearance order. See also: [Restricting agent checks](/manual/config/items/restrict_checks). ##### AllowKey Atļauj izpildīt tos vienumu atslēgu nosaukumus, kas atbilst paraugam. Atslēgas paraugs ir aizstājējzīmju izteiksme, kas atbalsta `*` rakstzīmi, lai atbilstu jebkuram rakstzīmju skaitam.<br>Vairākus atslēgu atbilstības noteikumus var definēt kopā ar `DenyKey`. Parametri tiek apstrādāti pa vienam atbilstoši to parādīšanās secībai. Skatiet arī: [Aģenta pārbaužu ierobežošana](/manual/config/items/restrict_checks). ##### AllowRoot Allow the agent to run as 'root'. If disabled and the agent is started by 'root', the agent will try to switch to user 'zabbix' instead. Has no effect if started under a regular user. Default: `0`<br> Values: 0 - do not allow; 1 - allow ##### AllowRoot Atļauj aģentam darboties kā 'root'. Ja šī opcija ir atspējota un aģents tiek palaists ar 'root', aģents mēģinās pārslēgties uz lietotāju 'zabbix'. Nav ietekmes, ja tas tiek palaists parasta lietotāja ietvaros. Noklusējums: `0`<br> Vērtības: 0 - neatļaut; 1 - atļaut ##### AllowRoot Allow the proxy to run as 'root'. If disabled and the proxy is started by 'root', the proxy will try to switch to the 'zabbix' user instead. Has no effect if started under a regular user. Default: `0`<br> Values: 0 - do not allow; 1 - allow ##### AllowRoot Atļaut starpniekserverim darboties kā 'root'. Ja šī opcija ir atspējota un starpniekserveris tiek palaists ar 'root', starpniekserveris mēģinās pārslēgties uz 'zabbix' lietotāju. Nav ietekmes, ja tas tiek palaists parasta lietotāja ietvaros. Noklusējums: `0`<br> Vērtības: 0 - neatļaut; 1 - atļaut ##### AllowRoot Allow the server to run as 'root'. If disabled and the server is started by 'root', the server will try to switch to the 'zabbix' user instead. Has no effect if started under a regular user. Default: `0`<br> Values: 0 - do not allow; 1 - allow ##### AllowRoot Atļauj serverim darboties kā 'root'. Ja šī opcija ir atspējota un serveris tiek palaists ar 'root', serveris mēģinās pārslēgties uz 'zabbix' lietotāju. Nav ietekmes, ja tas tiek palaists parasta lietotāja ietvaros. Noklusējums: `0`<br> Vērtības: 0 - neatļaut; 1 - atļaut ##### AllowSoftwareUpdateCheck Allow Zabbix UI to receive information about software updates from zabbix.com. Default: `1`<br> Values: 0 - do not allow; 1 - allow ##### AllowSoftwareUpdateCheck Atļaut Zabbix lietotāja saskarnei saņemt informāciju par programmatūras atjauninājumiem no zabbix.com. Noklusējums: `1`<br> Vērtības: 0 - neatļaut; 1 - atļaut ##### AllowUnsupportedDBVersions Allow the proxy to work with unsupported database versions. Default: `0`<br> Values: 0 - do not allow; 1 - allow ##### AllowUnsupportedDBVersions Ļauj starpniekserverim darboties ar neatbalstītām datubāzes versijām. Noklusējums: `0`<br> Vērtības: 0 - neatļaut; 1 - atļaut ##### AllowUnsupportedDBVersions Allow the server to work with unsupported database versions. Default: `0`<br> Values: 0 - do not allow; 1 - allow ##### AllowUnsupportedDBVersions Atļaut serverim strādāt ar neatbalstītām datubāzes versijām. Noklusējums: `0`<br> Vērtības: 0 - neatļaut; 1 - atļaut ##### Altering primary key with downtime {#altering-primary-key-with-downtime-1} 1\. Drop the current `auditlog` table primary key and add the new primary key. ```sql ALTER TABLE auditlog DROP PRIMARY KEY, ADD PRIMARY KEY (auditid, clock); ``` 2\. Rebuild indexes (optional but highly recommended, see [Important notes on rebuilding indexes](#important-notes-on-rebuilding-indexes-1)). ```sql OPTIMIZE TABLE auditlog; ``` ##### Primārās atslēgas maiņa ar dīkstāvi {#altering-primary-key-with-downtime-1} 1\. Noņemiet pašreizējo `auditlog` tabulas primāro atslēgu un pievienojiet jauno primāro atslēgu. ```sql ALTER TABLE auditlog DROP PRIMARY KEY, ADD PRIMARY KEY (auditid, clock); ``` 2\. Pārbūvējiet indeksus (pēc izvēles, bet ļoti ieteicams; skatiet [Svarīgas piezīmes par indeksu pārbūvi](#important-notes-on-rebuilding-indexes-1)). ```sql OPTIMIZE TABLE auditlog; ``` ##### Altering primary key with downtime {#altering-primary-key-with-downtime-2} 1\. Drop the current `auditlog` table primary key and add the new primary key. ```sql ALTER TABLE auditlog DROP CONSTRAINT auditlog_pkey; ALTER TABLE auditlog ADD PRIMARY KEY (auditid,clock); ``` 2\. Rebuild indexes (optional but highly recommended, see [Important notes on rebuilding indexes](#important-notes-on-rebuilding-indexes-2)). ```sql REINDEX TABLE CONCURRENTLY auditlog; ``` ##### Primārās atslēgas maiņa ar dīkstāvi {#altering-primary-key-with-downtime-2} 1\. Noņemiet pašreizējo `auditlog` tabulas primāro atslēgu un pievienojiet jauno primāro atslēgu. ```sql ALTER TABLE auditlog DROP CONSTRAINT auditlog_pkey; ALTER TABLE auditlog ADD PRIMARY KEY (auditid,clock); ``` 2\. Pārbūvējiet indeksus (pēc izvēles, bet ļoti ieteicams; skatiet [Svarīgas piezīmes par indeksu pārbūvi](#important-notes-on-rebuilding-indexes-2)). ```sql REINDEX TABLE CONCURRENTLY auditlog; ``` ##### Altering primary key with downtime {#altering-primary-key-with-downtime-3} 1\. Retrieve the constraint name. ```sql SELECT CONSTRAINT_NAME FROM all_constraints WHERE TABLE_NAME = 'AUDITLOG' AND CONSTRAINT_TYPE = 'P'; ``` 2\. Drop the current `auditlog` table primary key and add the new primary key. ```sql ALTER TABLE auditlog DROP CONSTRAINT <constraint_name>; ALTER TABLE auditlog ADD CONSTRAINT auditlog_pk PRIMARY KEY (auditid, clock); ``` 3\. Rebuild indexes (optional but highly recommended, see [Important notes on rebuilding indexes](#important-notes-on-rebuilding-indexes-3)). 3.1\. Get index names. ```sql SELECT index_name FROM user_indexes WHERE table_name='AUDITLOG'; ``` 3.2\. Rebuild each index. ```sql ALTER INDEX auditlog_pk REBUILD PARALLEL; ALTER INDEX auditlog_1 REBUILD PARALLEL; ALTER INDEX auditlog_2 REBUILD PARALLEL; ALTER INDEX auditlog_3 REBUILD PARALLEL; ``` ##### Primārās atslēgas maiņa ar dīkstāvi {#altering-primary-key-with-downtime-3} 1\. Iegūstiet ierobežojuma nosaukumu. ```sql SELECT CONSTRAINT_NAME FROM all_constraints WHERE TABLE_NAME = 'AUDITLOG' AND CONSTRAINT_TYPE = 'P'; ``` 2\. Noņemiet pašreizējo `auditlog` tabulas primāro atslēgu un pievienojiet jauno primāro atslēgu. ```sql ALTER TABLE auditlog DROP CONSTRAINT <constraint_name>; ALTER TABLE auditlog ADD CONSTRAINT auditlog_pk PRIMARY KEY (auditid, clock); ``` 3\. Pārbūvējiet indeksus (pēc izvēles, bet ļoti ieteicams; skatiet [Svarīgas piezīmes par indeksu pārbūvi](#important-notes-on-rebuilding-indexes-3)). 3.1\. Iegūstiet indeksu nosaukumus. ```sql SELECT index_name FROM user_indexes WHERE table_name='AUDITLOG'; ``` 3.2\. Pārbūvējiet katru indeksu. ```sql ALTER INDEX auditlog_pk REBUILD PARALLEL; ALTER INDEX auditlog_1 REBUILD PARALLEL; ALTER INDEX auditlog_2 REBUILD PARALLEL; ALTER INDEX auditlog_3 REBUILD PARALLEL; ``` ##### Altering primary key without downtime {#altering-primary-key-without-downtime-1} Manual method of altering the primary key is described here. Alternatively, you can use the [pt-online-schema-change](https://docs.percona.com/percona-toolkit/pt-online-schema-change.html) toolkit from Percona. This toolkit performs the following actions automatically, while also minimizing the space used for altering the `auditlog` table. 1\. Create a new table with the new primary key and create indexes. ```sql CREATE TABLE `auditlog_new` ( `auditid` varchar(25) NOT NULL, `userid` bigint unsigned NULL, `username` varchar(100) DEFAULT '' NOT NULL, `clock` integer DEFAULT '0' NOT NULL, `ip` varchar(39) DEFAULT '' NOT NULL, `action` integer DEFAULT '0' NOT NULL, `resourcetype` integer DEFAULT '0' NOT NULL, `resourceid` bigint unsigned NULL, `resource_cuid` varchar(25) NULL, `resourcename` varchar(255) DEFAULT '' NOT NULL, `recordsetid` varchar(25) NOT NULL, `details` longtext NOT NULL, PRIMARY KEY (auditid,clock) ) ENGINE=InnoDB; CREATE INDEX `auditlog_1` ON `auditlog_new` (`userid`,`clock`); CREATE INDEX `auditlog_2` ON `auditlog_new` (`clock`); CREATE INDEX `auditlog_3` ON `auditlog_new` (`resourcetype`,`resourceid`); ``` 2\. Swap tables. ```sql RENAME TABLE auditlog TO auditlog_old, auditlog_new TO auditlog; ``` 3\. Copy data from the old table to the new table. ```sql INSERT INTO auditlog SELECT * FROM auditlog_old; ``` This can be done in chunks (multiple `INSERT INTO` statements with `WHERE clock` clauses as needed) to avoid excessive resource usage. 4\. Drop the old table. ```sql DROP TABLE auditlog_old; ``` ##### Primārās atslēgas maiņa bez dīkstāves {#altering-primary-key-without-downtime-1} Šeit ir aprakstīta primārās atslēgas manuāla maiņas metode. Alternatīvi varat izmantot Percona rīkkopu [pt-online-schema-change](https://docs.percona.com/percona-toolkit/pt-online-schema-change.html). Šī rīkkopa automātiski veic tālāk norādītās darbības, vienlaikus samazinot vietu, kas nepieciešama `auditlog` tabulas maiņai. 1\. Izveidojiet jaunu tabulu ar jauno primāro atslēgu un izveidojiet indeksus. ```sql CREATE TABLE `auditlog_new` ( `auditid` varchar(25) NOT NULL, `userid` bigint unsigned NULL, `username` varchar(100) DEFAULT '' NOT NULL, `clock` integer DEFAULT '0' NOT NULL, `ip` varchar(39) DEFAULT '' NOT NULL, `action` integer DEFAULT '0' NOT NULL, `resourcetype` integer DEFAULT '0' NOT NULL, `resourceid` bigint unsigned NULL, `resource_cuid` varchar(25) NULL, `resourcename` varchar(255) DEFAULT '' NOT NULL, `recordsetid` varchar(25) NOT NULL, `details` longtext NOT NULL, PRIMARY KEY (auditid,clock) ) ENGINE=InnoDB; CREATE INDEX `auditlog_1` ON `auditlog_new` (`userid`,`clock`); CREATE INDEX `auditlog_2` ON `auditlog_new` (`clock`); CREATE INDEX `auditlog_3` ON `auditlog_new` (`resourcetype`,`resourceid`); ``` 2\. Apmainiet tabulas. ```sql RENAME TABLE auditlog TO auditlog_old, auditlog_new TO auditlog; ``` 3\. Kopējiet datus no vecās tabulas uz jauno tabulu. ```sql INSERT INTO auditlog SELECT * FROM auditlog_old; ``` To var veikt pa daļām (vairāki `INSERT INTO` priekšraksti ar `WHERE clock` nosacījumiem pēc vajadzības), lai izvairītos no pārmērīga resursu patēriņa. 4\. Dzēsiet veco tabulu. ```sql DROP TABLE auditlog_old; ``` ##### Altering primary key without downtime {#altering-primary-key-without-downtime-2} Manual method of altering the primary key is described here. Alternatively, the `pg_repack` extension can be considered for creating a new table, copying data, and swapping tables. 1\. Create a new table with the new primary key and create indexes. ```sql CREATE TABLE auditlog_new ( auditid varchar(25) NOT NULL, userid bigint NULL, username varchar(100) DEFAULT '' NOT NULL, clock integer DEFAULT '0' NOT NULL, ip varchar(39) DEFAULT '' NOT NULL, action integer DEFAULT '0' NOT NULL, resourcetype integer DEFAULT '0' NOT NULL, resourceid bigint NULL, resource_cuid varchar(25) NULL, resourcename varchar(255) DEFAULT '' NOT NULL, recordsetid varchar(25) NOT NULL, details text DEFAULT '' NOT NULL, PRIMARY KEY (auditid,clock) ); CREATE INDEX auditlog_new_1 ON auditlog_new (userid,clock); CREATE INDEX auditlog_new_2 ON auditlog_new (clock); CREATE INDEX auditlog_new_3 ON auditlog_new (resourcetype,resourceid); ``` 2\. Swap tables. ```sql ALTER TABLE auditlog RENAME TO auditlog_old; ALTER TABLE auditlog_new RENAME TO auditlog; ``` 3\. Copy data from the old table to the new table. ```sql INSERT INTO auditlog SELECT * FROM auditlog_old; ``` This can be done in chunks (multiple `INSERT INTO` statements with `WHERE clock` clauses as needed) to avoid excessive resource usage. 4\. Drop the old table. ```sql DROP TABLE auditlog_old; ``` ##### Primārās atslēgas maiņa bez dīkstāves {#altering-primary-key-without-downtime-2} Šeit ir aprakstīta primārās atslēgas maiņas manuālā metode. Alternatīvi var apsvērt `pg_repack` paplašinājumu jaunas tabulas izveidei, datu kopēšanai un tabulu apmaiņai. 1\. Izveidojiet jaunu tabulu ar jauno primāro atslēgu un izveidojiet indeksus. ```sql CREATE TABLE auditlog_new ( auditid varchar(25) NOT NULL, userid bigint NULL, username varchar(100) DEFAULT '' NOT NULL, clock integer DEFAULT '0' NOT NULL, ip varchar(39) DEFAULT '' NOT NULL, action integer DEFAULT '0' NOT NULL, resourcetype integer DEFAULT '0' NOT NULL, resourceid bigint NULL, resource_cuid varchar(25) NULL, resourcename varchar(255) DEFAULT '' NOT NULL, recordsetid varchar(25) NOT NULL, details text DEFAULT '' NOT NULL, PRIMARY KEY (auditid,clock) ); CREATE INDEX auditlog_new_1 ON auditlog_new (userid,clock); CREATE INDEX auditlog_new_2 ON auditlog_new (clock); CREATE INDEX auditlog_new_3 ON auditlog_new (resourcetype,resourceid); ``` 2\. Apmainiet tabulas. ```sql ALTER TABLE auditlog RENAME TO auditlog_old; ALTER TABLE auditlog_new RENAME TO auditlog; ``` 3\. Nokopējiet datus no vecās tabulas uz jauno tabulu. ```sql INSERT INTO auditlog SELECT * FROM auditlog_old; ``` To var veikt pa daļām (vairāki `INSERT INTO` priekšraksti ar `WHERE clock` nosacījumiem pēc vajadzības), lai izvairītos no pārmērīga resursu patēriņa. 4\. Dzēsiet veco tabulu. ```sql DROP TABLE auditlog_old; ``` ##### Altering primary key without downtime {#altering-primary-key-without-downtime-3} 1\. Create a new table with the new primary key and create indexes. ```sql CREATE TABLE auditlog_new ( auditid nvarchar2(25) , userid number(20) NULL, username nvarchar2(100) DEFAULT '' , clock number(10) DEFAULT '0' NOT NULL, ip nvarchar2(39) DEFAULT '' , action number(10) DEFAULT '0' NOT NULL, resourcetype number(10) DEFAULT '0' NOT NULL, resourceid number(20) NULL, resource_cuid nvarchar2(25) , resourcename nvarchar2(255) DEFAULT '' , recordsetid nvarchar2(25) , details nclob DEFAULT '' , PRIMARY KEY (auditid,clock) ); CREATE INDEX auditlog_new_1 ON auditlog_new (userid,clock); CREATE INDEX auditlog_new_2 ON auditlog_new (clock); CREATE INDEX auditlog_new_3 ON auditlog_new (resourcetype,resourceid); ``` 2\. Swap tables. ```sql ALTER TABLE auditlog RENAME TO auditlog_old; ALTER TABLE auditlog_new RENAME TO auditlog; ``` 3\. Copy data from the old table to the new table. ```sql INSERT INTO auditlog SELECT * FROM auditlog_old; ``` This can be done in chunks (multiple `INSERT INTO` statements with `WHERE clock` clauses as needed) to avoid excessive resource usage. 4\. Drop the old table. ```sql DROP TABLE auditlog_old; ``` ##### Primārās atslēgas maiņa bez dīkstāves {#altering-primary-key-without-downtime-3} 1\. Izveidojiet jaunu tabulu ar jauno primāro atslēgu un izveidojiet indeksus. ```sql CREATE TABLE auditlog_new ( auditid nvarchar2(25) , userid number(20) NULL, username nvarchar2(100) DEFAULT '' , clock number(10) DEFAULT '0' NOT NULL, ip nvarchar2(39) DEFAULT '' , action number(10) DEFAULT '0' NOT NULL, resourcetype number(10) DEFAULT '0' NOT NULL, resourceid number(20) NULL, resource_cuid nvarchar2(25) , resourcename nvarchar2(255) DEFAULT '' , recordsetid nvarchar2(25) , details nclob DEFAULT '' , PRIMARY KEY (auditid,clock) ); CREATE INDEX auditlog_new_1 ON auditlog_new (userid,clock); CREATE INDEX auditlog_new_2 ON auditlog_new (clock); CREATE INDEX auditlog_new_3 ON auditlog_new (resourcetype,resourceid); ``` 2\. Apmainiet tabulas. ```sql ALTER TABLE auditlog RENAME TO auditlog_old; ALTER TABLE auditlog_new RENAME TO auditlog; ``` 3\. Kopējiet datus no vecās tabulas uz jauno tabulu. ```sql INSERT INTO auditlog SELECT * FROM auditlog_old; ``` To var veikt pa daļām (vairāki `INSERT INTO` priekšraksti ar `WHERE clock` nosacījumiem pēc vajadzības), lai izvairītos no pārmērīga resursu patēriņa. 4\. Dzēsiet veco tabulu. ```sql DROP TABLE auditlog_old; ``` An example repository has been created that may be used as a starting point for creating a custom loadable plugin with Zabbix agent 2. For more information, see: - [Example plugin for Zabbix agent 2](https://git.zabbix.com/projects/AP/repos/example/browse) - [Developer center](/devel/plugins) Ir izveidots piemēra repozitorijs, ko var izmantot kā sākumpunktu pielāgota ielādējama spraudņa izveidei ar Zabbix aģents 2. Papildu informāciju skatiet: - [Piemēra spraudnis Zabbix aģents 2](https://git.zabbix.com/projects/AP/repos/example/browse) - [Izstrādātāju centrs](/devel/plugins) ##### Another example with an inline regex modifier Use of the following regular expression including multiple inline modifiers to match the characters after a specific line: ```default (?<=match (?i)everything(?-i) after this line\n)(?sx).*# we add s modifier to allow . match newline characters ```  Chosen Expression type: "Result is TRUE". Characters after a specific line are matched. ::: noteimportant **g** modifier can't be specified in line. The list of available modifiers can be found in [pcresyntax man page](https://www.pcre.org/original/doc/html/pcresyntax.html#SEC16). For more information about PCRE syntax please refer to [PCRE HTML documentation](https://www.pcre.org/original/doc/html/pcrepattern.html). ::: ##### Vēl viens piemērs ar iekļautu regulārās izteiksmes modifikatoru Tālāk norādītās regulārās izteiksmes izmantošana, iekļaujot vairākus iekļautos modifikatorus, lai atrastu rakstzīmes aiz noteiktas rindas: ```default (?<=match (?i)everything(?-i) after this line\n)(?sx).*# we add s modifier to allow . match newline characters ```  Izvēlētais izteiksmes tips: "Result is TRUE". Rakstzīmes aiz noteiktas rindas tiek atrastas. ::: noteimportant **g** modifikatoru nevar norādīt rindā. Pieejamo modifikatoru sarakstu var atrast [pcresyntax man page](https://www.pcre.org/original/doc/html/pcresyntax.html#SEC16). Plašāku informāciju par PCRE sintaksi skatiet [PCRE HTML documentation](https://www.pcre.org/original/doc/html/pcrepattern.html). ::: #### API changes See the list of [API changes](/manual/api/changes) in Zabbix 7.0.0. #### API izmaiņas Skatiet [API izmaiņu](/manual/api/changes) sarakstu Zabbix 7.0.0. ### API information Retrieve the version of the Zabbix API so that your application could use version-specific features. [API info API](/manual/api/reference/apiinfo) ### API informācija Iegūstiet Zabbix API versiju, lai jūsu lietojumprogramma varētu izmantot konkrētajai versijai raksturīgās iespējas. [API info API](/manual/api/reference/apiinfo) # API info This class is designed to retrieve meta information about the API. Available methods: - [apiinfo.version](/manual/api/reference/apiinfo/version) - retrieve the version of Zabbix API # API informācija Šī klase ir paredzēta API metainformācijas iegūšanai. Pieejamās metodes: - [apiinfo.version](/manual/api/reference/apiinfo/version) - iegūt Zabbix API versiju # apiinfo.version # apiinfo.version #### API requests After you've logged in, you can make any API requests by calling methods described in the Zabbix API [method reference](/manual/api/reference). API methods are called using the following format: ```python api_instance.zabbix_object.method(parameters) ``` ::: noteclassic Some Zabbix API method or object names use words that are reserved keywords in Python (e.g., `import`). To avoid Python errors, add an underscore to the method or object name when using it in Python (e.g., `api.configuration.import_`). ::: For example, to see a list of hosts with [`host.get`](/manual/api/reference/host/get): ```python # 1. Import ZabbixAPI from zabbix_utils: from zabbix_utils import ZabbixAPI # 2. Create the ZabbixAPI instance and log in: api = ZabbixAPI(url="127.0.0.1/zabbix") api.login(user="Admin", password="zabbix") # 3. Retrieve hosts matching a filter: hosts = api.host.get( filter={ "host": [ "Zabbix server", "Linux server" ] } ) # 4. Iterate over returned hosts and print each host's details: for host in hosts: print(host) # 5. Log out from the API to close the session: api.logout() ``` #### API pieprasījumi Pēc pieteikšanās jūs varat veikt jebkurus API pieprasījumus, izsaucot metodes, kas aprakstītas Zabbix API [metožu atsaucē](/manual/api/reference). API metodes tiek izsauktas, izmantojot šādu formātu: ```python api_instance.zabbix_object.method(parameters) ``` ::: noteclassic Dažu Zabbix API metožu vai objektu nosaukumos tiek izmantoti vārdi, kas Python ir rezervēti atslēgvārdi (piemēram, `import`). Lai izvairītos no Python kļūdām, pievienojiet pasvītrojuma zīmi metodes vai objekta nosaukumam, kad to izmantojat Python (piemēram, `api.configuration.import_`). ::: Piemēram, lai skatītu hostu sarakstu ar [`host.get`](/manual/api/reference/host/get): ```python # 1. Importējiet ZabbixAPI no zabbix_utils: from zabbix_utils import ZabbixAPI # 2. Izveidojiet ZabbixAPI instanci un piesakieties: api = ZabbixAPI(url="127.0.0.1/zabbix") api.login(user="Admin", password="zabbix") # 3. Iegūstiet filtram atbilstošos hostus: hosts = api.host.get( filter={ "host": [ "Zabbix server", "Linux server" ] } ) # 4. Iterējiet cauri atgrieztajiem hostiem un izdrukājiet katra hosta informāciju: for host in hosts: print(host) # 5. Izrakstieties no API, lai aizvērtu sesiju: api.logout() ``` #### API Tokens Manage authorization tokens. [Token API](/manual/api/reference/token) #### API tokeni Pārvaldiet autorizācijas tokenus. [Token API](/manual/api/reference/token) #### API tokens The *API tokens* section allows you to view tokens assigned to the user, edit token details and [create new tokens](/manual/web_interface/frontend_sections/users/api_tokens). This section is available to a user only if the *Manage API tokens* action is allowed in the [user role](/manual/web_interface/frontend_sections/users/user_roles) settings. {width="600"} You can filter API tokens by name, expiry date, or status (*Enabled/Disabled*). Click on the token status in the list to quickly enable/disable a token. You can also enable/disable multiple tokens at once by selecting them in the list and then clicking on the *Enable/Disable* buttons below the list. ::: noteimportant Users cannot view the *Auth token* value of the tokens assigned to them in Zabbix. The *Auth token* value is displayed only once - immediately after creating a token. If the token has been lost, it has to be regenerated. ::: #### API tokeni Sadaļa *API tokeni* ļauj skatīt lietotājam piešķirtos tokenus, rediģēt tokenu informāciju un [izveidot jaunus tokenus](/manual/web_interface/frontend_sections/users/api_tokens). Šī sadaļa lietotājam ir pieejama tikai tad, ja [lietotāja lomas](/manual/web_interface/frontend_sections/users/user_roles) iestatījumos ir atļauta darbība *Pārvaldīt API tokenus*. {width="600"} API tokenus var filtrēt pēc nosaukuma, derīguma termiņa vai statusa (*Iespējots/Atspējots*). Noklikšķiniet uz tokena statusa sarakstā, lai ātri iespējotu/atspējotu tokenu. Varat arī vienlaikus iespējot/atspējot vairākus tokenus, atlasot tos sarakstā un pēc tam noklikšķinot uz pogām *Iespējot/Atspējot* zem saraksta. ::: noteimportant Lietotāji nevar skatīt Zabbix tiem piešķirto tokenu *Auth token* vērtību. *Auth token* vērtība tiek parādīta tikai vienu reizi - uzreiz pēc tokena izveides. Ja tokens ir pazaudēts, tas ir jāģenerē atkārtoti. ::: ### API versions To simplify API versioning, since Zabbix 2.0.4, the version of the API matches the version of Zabbix itself. You can use the [`apiinfo.version`](/manual/api/reference/apiinfo/version) method to find out the version of the API you are working with. This can be useful for adjusting your application to use version-specific features. Zabbix guarantees feature backward compatibility inside a major version. When making backward incompatible changes between major releases, Zabbix usually leaves the old features as deprecated in the next release, and only removes them in the release after that. Occasionally, Zabbix may remove features between major releases without providing any backward compatibility. It is important that you never rely on any deprecated features and migrate to newer alternatives as soon as possible. ::: notetip You can follow all the changes made to the API in the [API changelog](/manual/api/changes). ::: ### API versijas Lai vienkāršotu API versiju pārvaldību, kopš Zabbix 2.0.4 API versija sakrīt ar paša Zabbix versiju. Varat izmantot metodi [`apiinfo.version`](/manual/api/reference/apiinfo/version), lai uzzinātu, ar kuru API versiju strādājat. Tas var būt noderīgi, pielāgojot savu lietojumprogrammu konkrētai versijai raksturīgu funkciju izmantošanai. Zabbix garantē funkciju atpakaļsaderību vienas galvenās versijas ietvaros. Veicot atpakaļnesaderīgas izmaiņas starp galvenajiem laidieniem, Zabbix parasti atstāj vecās funkcijas kā novecojušas nākamajā laidienā un noņem tās tikai laidienā pēc tam. Atsevišķos gadījumos Zabbix var noņemt funkcijas starp galvenajiem laidieniem, nenodrošinot nekādu atpakaļsaderību. Ir svarīgi nekad nepaļauties uz novecojušām funkcijām un pēc iespējas ātrāk pāriet uz jaunākām alternatīvām. ::: notetip Visas API veiktās izmaiņas varat sekot līdzi [API izmaiņu žurnālā](/manual/api/changes). ::: #### API [ZBX-22952](https://support.zabbix.com/browse/ZBX-22952) Added support for accepting headers in a case-insensitive way (e.g., `authorization`, `Authorization`, and `AUTHORIZATION` are treated the same). #### API [ZBX-22952](https://support.zabbix.com/browse/ZBX-22952) Pievienots atbalsts galveņu pieņemšanai, neņemot vērā burtu reģistru (piemēram, `authorization`, `Authorization` un `AUTHORIZATION` tiek apstrādāti vienādi). #### API [ZBX-25732](https://support.zabbix.com/browse/ZBX-25732) Added support for `Authorization` HTTP request header and `OPTIONS` HTTP request method in cross-origin requests ([CORS](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS)). #### API [ZBX-25732](https://support.zabbix.com/browse/ZBX-25732) Pievienots atbalsts `Authorization` HTTP pieprasījuma galvenei un `OPTIONS` HTTP pieprasījuma metodei starpdomēnu pieprasījumos ([CORS](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS)). # Appendix 1. Reference commentary # 1. pielikums. Atsauces komentāri # Appendix 2. Changes from 6.4 to 7.0 # Pielikums 2. Izmaiņas no 6.4 uz 7.0 # Appendix 3. Changes in 7.0 # 3. pielikums. Izmaiņas 7.0 versijā #### Architecture Zabbix consists of several major software components. Their responsibilities are outlined below. #### Arhitektūra Zabbix sastāv no vairākiem galvenajiem programmatūras komponentiem. To pienākumi ir izklāstīti tālāk. #### A real life scenario In this example, we would like to set up network discovery for the local network having an IP range of 192.168.1.1-192.168.1.254. In our scenario we want to: - discover those hosts that have Zabbix agent running - run discovery every 10 minutes - add a host to monitoring if the host uptime is more than 1 hour - remove hosts if the host downtime is more than 24 hours - add Linux hosts to the "Linux servers" group - add Windows hosts to the "Windows servers" group - use the template *Linux* for Linux hosts - use the template *Windows* for Windows hosts #### Reālas dzīves scenārijs Šajā piemērā mēs vēlamies iestatīt tīkla atklāšanu lokālajam tīklam ar IP diapazonu 192.168.1.1-192.168.1.254. Mūsu scenārijā mēs vēlamies: - atklāt tos hostus, kuros darbojas Zabbix aģents - palaist atklāšanu ik pēc 10 minūtēm - pievienot hostu uzraudzībai, ja hosta darbības laiks pārsniedz 1 stundu - noņemt hostus, ja hosta dīkstāves laiks pārsniedz 24 stundas - pievienot Linux hostus grupai "Linux servers" - pievienot Windows hostus grupai "Windows servers" - izmantot veidni *Linux* Linux hostiem - izmantot veidni *Windows* Windows hostiem ##### ascii(value) {#ascii} The ASCII code of the leftmost character of the value.<br> Supported value types: *String*, *Text*, *Log*. Parameter: - **value** - the value to check For example, a value like 'Abc' will return '65' (ASCII code for 'A'). Example: ascii(last(/host/key)) ##### ascii(value) {#ascii} Vērtības kreisākās rakstzīmes ASCII kods.<br> Atbalstītie vērtību tipi: *String*, *Text*, *Log*. Parametrs: - **value** - pārbaudāmā vērtība Piemēram, tāda vērtība kā 'Abc' atgriezīs '65' ('A' ASCII kodu). Piemērs: ascii(last(/host/key)) ##### asin(value) {#asin} The arcsine of a value as an angle, expressed in radians. Parameter: - **value** - the value to check The value must be between -1 and 1. For example, the arcsine of a value '0.5' will be '-0.523598776'. Example: asin(last(/host/key)) ##### asin(value) {#asin} Vērtības arkussinuss kā leņķis, izteikts radiānos. Parametrs: - **value** - pārbaudāmā vērtība Vērtībai jābūt no -1 līdz 1. Piemēram, vērtības '0.5' arkussinuss būs '-0.523598776'. Piemērs: asin(last(/host/key)) ### assets/css *assets/css* is reserved and should only contain CSS style files. To be used by the widget, specify these files in the *[manifest.json](/devel/modules/file_structure/manifest)*. For example: ```json "assets": { "css": ["mywidget.css"] } ``` ### assets/css *assets/css* ir rezervēts un tajā drīkst atrasties tikai CSS stilu faili. Lai tos izmantotu logrīks, norādiet šos failus *[manifest.json](/devel/modules/file_structure/manifest)*. Piemēram: ```json "assets": { "css": ["mywidget.css"] } ``` ### assets CSS styles and JavaScript files to include. *Type*: Object *Supported object keys:* - **css** (array) - CSS files to include. The files must be located in the *assets/css*. - **js** (array) - JavaScript files to include. The files must be located in the *assets/js*. *Example*: ```json "assets": { "css": ["widget.css"], "js": ["class.widget.js"] } ``` ### assets Iekļaujamie CSS stili un JavaScript faili. *Tips*: Object *Atbalstītās objekta atslēgas:* - **css** (array) - Iekļaujamie CSS faili. Failiem jāatrodas mapē *assets/css*. - **js** (array) - Iekļaujamie JavaScript faili. Failiem jāatrodas mapē *assets/js*. *Piemērs*: ```json "assets": { "css": ["widget.css"], "js": ["class.widget.js"] } ``` ### assets/js *assets/js* directory is reserved and should only contain JavaScript files. To be used by the widget, specify these files in the *[manifest.json](/devel/modules/file_structure/manifest)*. For example: ```json "assets": { "js": ["class.widget.js"] } ``` ### assets/js Direktorija *assets/js* ir rezervēta, un tajā drīkst atrasties tikai JavaScript faili. Lai tos izmantotu logrīks, norādiet šos failus *[manifest.json](/devel/modules/file_structure/manifest)*. Piemēram: ```json "assets": { "js": ["class.widget.js"] } ``` # Assets The folder *assets* may contain any files and subfolders that do not belong to other directories. You can use it for: - JavaScript styles (must be inside *[assets/js](#assetsjs)*); - CSS styles (must be inside *[assets/css](#assetscss)*); - Images; - Fonts; - Anything else you need to include. # Resursi Mape *assets* var saturēt jebkādus failus un apakšmapes, kas nepieder citām direktorijām. To var izmantot šādam saturam: - JavaScript stiliem (jāatrodas mapē *[assets/js](#assetsjs)*); - CSS stiliem (jāatrodas mapē *[assets/css](#assetscss)*); - Attēliem; - Fontiem; - Jebkam citam, kas jums jāiekļauj. #### Assigning different hosts Replace the hosts currently assigned to maintenance with two different ones. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "maintenance.update", "params": { "maintenanceid": "3", "hosts": [ {"hostid": "10085"}, {"hostid": "10084"} ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "maintenanceids": [ "3" ] }, "id": 1 } ``` #### Dažādu hostu piešķiršana Aizstājiet hostus, kas pašlaik piešķirti uzturēšanai, ar diviem citiem. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "maintenance.update", "params": { "maintenanceid": "3", "hosts": [ {"hostid": "10085"}, {"hostid": "10084"} ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "maintenanceids": [ "3" ] }, "id": 1 } ``` #### Asynchronous DNS resolution The agent poller and SNMP poller can now be configured to use the *c-ares* library (version 1.16.0 or newer) instead of the *libevent* DNS resolver, providing potentially faster and more flexible DNS resolution. If you want to use c-ares library, configure Zabbix with the `--with-ares` option: ```bash --with-ares[=ARG] use c-ares library [default=no], --with-ares-include=DIR use c-ares include headers from given path. --with-ares-lib=DIR use c-ares libraries from given path. ``` Note that starting from c-ares 1.31.0, DNS caching is enabled by default. #### Asinhrona DNS atrisināšana Aģenta aptaujātāju un SNMP aptaujātāju tagad var konfigurēt tā, lai tie izmantotu *c-ares* bibliotēku (versija 1.16.0 vai jaunāka) *libevent* DNS atrisinātāja vietā, nodrošinot potenciāli ātrāku un elastīgāku DNS atrisināšanu. Ja vēlaties izmantot c-ares bibliotēku, konfigurējiet Zabbix ar `--with-ares` opciju: ```bash --with-ares[=ARG] use c-ares library [default=no], --with-ares-include=DIR use c-ares include headers from given path. --with-ares-lib=DIR use c-ares libraries from given path. ``` Ņemiet vērā, ka, sākot ar c-ares 1.31.0, DNS kešošana ir iespējota pēc noklusējuma. #### Asynchronous DNS resolution The agent poller and SNMP poller can now be configured to use the *c-ares* library (version 1.16.0 or newer) instead of the *libevent* DNS resolver. This allows for potentially faster and more flexible DNS resolution. To enable c-ares, Zabbix must be [configured](/manual/installation/install#4-configure-the-sources) with the `--with-ares` option. Note that starting from c-ares 1.31.0, DNS caching is enabled by default. #### Asinhrona DNS atrisināšana Aģenta aptaujātāju un SNMP aptaujātāju tagad var konfigurēt tā, lai tie izmantotu *c-ares* bibliotēku (versija 1.16.0 vai jaunāka) *libevent* DNS atrisinātāja vietā. Tas var nodrošināt ātrāku un elastīgāku DNS atrisināšanu. Lai iespējotu c-ares, Zabbix ir jākonfigurē [konfigurēts](/manual/installation/install#4-configure-the-sources) ar `--with-ares` opciju. Ņemiet vērā, ka, начиная ar c-ares 1.31.0, DNS kešošana ir iespējota pēc noklusējuma. ##### Asynchronous mode Asynchronous mode lets your Python script send values without waiting for a response from Zabbix server or proxy. This can make your script more efficient when it needs to send many values or when some values take a long time send. When using asynchronous mode, there are a few important differences compared to synchronous mode: - Import Python's `asyncio` module (you must first [install](/devel/python/install) the required dependencies). - Import `AsyncSender` instead of `Sender`. - Write your code inside an `async` function. - Use `await` when calling the `send_value()` method. For example, to send a single value using asynchronous mode: ```python # 1. Import asyncio for asynchronous mode, and AsyncSender from zabbix_utils: import asyncio from zabbix_utils import AsyncSender # 2. Define the main async function where all data sending operations (must await) will be executed: async def main(): sender = AsyncSender(server='127.0.0.1', port=10051) response = await sender.send_value('Linux server', 'service.status', 1) # 3. Print the response returned by Zabbix server or proxy: print(response) # 4. Run the async main() function using asyncio's event loop: asyncio.run(main()) ``` ##### Asinhronais režīms Asinhronais režīms ļauj jūsu Python skriptam sūtīt vērtības, negaidot atbildi no Zabbix serveris vai starpniekserveris. Tas var padarīt jūsu skriptu efektīvāku, ja tam nepieciešams nosūtīt daudzas vērtības vai ja dažu vērtību nosūtīšana aizņem ilgu laiku. Izmantojot asinhrono režīmu, salīdzinājumā ar sinhrono režīmu ir dažas būtiskas atšķirības: - Importējiet Python `asyncio` moduli (vispirms jā[instalē](/devel/python/install) nepieciešamās atkarības). - Importējiet `AsyncSender` `Sender` vietā. - Rakstiet kodu `async` funkcijā. - Izmantojiet `await`, izsaucot `send_value()` metodi. Piemēram, lai, izmantojot asinhrono režīmu, nosūtītu vienu vērtību: ```python # 1. Import asyncio for asynchronous mode, and AsyncSender from zabbix_utils: import asyncio from zabbix_utils import AsyncSender # 2. Define the main async function where all data sending operations (must await) will be executed: async def main(): sender = AsyncSender(server='127.0.0.1', port=10051) response = await sender.send_value('Linux server', 'service.status', 1) # 3. Print the response returned by Zabbix server or proxy: print(response) # 4. Run the async main() function using asyncio's event loop: asyncio.run(main()) ``` ##### Asynchronous mode Asynchronous mode lets your script collect values without waiting for each one to arrive. This can make your script more efficient when it needs to collect many values or when some values take a long time to be collected. When using asynchronous mode, there are important differences compared to synchronous mode: - Import Python's `asyncio` module (you must first [install](/devel/python/install) the required dependencies). - Import `AsyncGetter` instead of `Getter`. - Write your code inside an `async` function. - Use `await` when calling the `get()` method. For example, to collect a single value using asynchronous mode: ```python # 1. Import asyncio for asynchronous mode, and AsyncGetter from zabbix_utils: import asyncio from zabbix_utils import AsyncGetter # 2. Define the main async function where all data requests will be executed: async def main(): agent = AsyncGetter(host='192.0.2.1', port=10050) # 3. Fetch the system.uname value from Zabbix agent (must await): response = await agent.get('system.uname') # 4. Print the value returned by Zabbix agent: print(response.value) # 5. Run the async main() function using asyncio's event loop: asyncio.run(main()) ``` ##### Asinhronais režīms Asinhronais režīms ļauj jūsu skriptam savākt vērtības, negaidot, līdz katra no tām tiek saņemta. Tas var padarīt jūsu skriptu efektīvāku, ja tam jāapkopo daudzas vērtības vai ja dažu vērtību savākšana aizņem ilgu laiku. Izmantojot asinhrono režīmu, pastāv svarīgas atšķirības salīdzinājumā ar sinhrono režīmu: - Importējiet Python `asyncio` moduli (vispirms jums jā[instalē](/devel/python/install) nepieciešamās atkarības). - Importējiet `AsyncGetter` nevis `Getter`. - Rakstiet savu kodu `async` funkcijā. - Izmantojiet `await`, izsaucot `get()` metodi. Piemēram, lai savāktu vienu vērtību, izmantojot asinhrono režīmu: ```python # 1. Import asyncio asinhronajam režīmam un AsyncGetter no zabbix_utils: import asyncio from zabbix_utils import AsyncGetter # 2. Definējiet galveno async funkciju, kurā tiks izpildīti visi datu pieprasījumi: async def main(): aģents = AsyncGetter(host='192.0.2.1', port=10050) # 3. Iegūstiet system.uname vērtību no Zabbix aģents (jāizmanto await): response = await aģents.get('system.uname') # 4. Izdrukājiet Zabbix aģents atgriezto vērtību: print(response.value) # 5. Palaidiet async main() funkciju, izmantojot asyncio notikumu ciklu: asyncio.run(main()) ``` ##### Asynchronous mode Asynchronous mode lets your script send API requests without waiting for each one to finish. This can make your script more efficient when it needs to perform many API requests or when some requests take a long time. When using asynchronous mode, there are important differences compared to synchronous mode: - Import Python's `asyncio` module (you must first [install](/devel/python/install) the required dependencies). - Import `AsyncZabbixAPI` instead of `ZabbixAPI`. - Write your code inside an `async` function. - Use `await` when calling API methods, including `login()` and `logout()`. ::: noteimportant When creating an `AsyncZabbixAPI` instance, you cannot log in [during initialization](#during-initialization). ::: For example, to see a list of hosts with [`host.get`](/manual/api/reference/host/get) in asynchronous mode: ```python # 1. Import asyncio for asynchronous mode, and AsyncZabbixAPI from zabbix_utils: import asyncio from zabbix_utils import AsyncZabbixAPI # 2. Define the main async function where all API operations will run: async def main(): # 3. Create an AsyncZabbixAPI instance and log in (must await): api = AsyncZabbixAPI(url="127.0.0.1") await api.login(user="User", password="zabbix") # 4. Retrieve hosts matching a filter (must await): hosts = await api.host.get( filter={ "host": [ "Zabbix server", "Linux server" ] } ) # 5. Iterate over returned hosts and print each host's details: for host in hosts: print(host) # 6. Log out from the API to close the session (must await): await api.logout() # 7. Run the async main() function using asyncio's event loop: asyncio.run(main()) ``` ##### Asinhronais režīms Asinhronais režīms ļauj jūsu skriptam sūtīt API pieprasījumus, negaidot, līdz katrs no tiem tiks pabeigts. Tas var padarīt jūsu skriptu efektīvāku, ja tam jāizpilda daudzi API pieprasījumi vai ja dažu pieprasījumu izpilde aizņem ilgu laiku. Izmantojot asinhrono režīmu, salīdzinājumā ar sinhrono režīmu ir vairākas būtiskas atšķirības: - Importējiet Python `asyncio` moduli (vispirms jā[instalē](/devel/python/install) nepieciešamās atkarības). - Importējiet `AsyncZabbixAPI` `ZabbixAPI` vietā. - Rakstiet savu kodu `async` funkcijā. - Izmantojiet `await`, izsaucot API metodes, tostarp `login()` un `logout()`. ::: noteimportant Veidojot `AsyncZabbixAPI` instanci, jūs nevarat pieteikties [inicializācijas laikā](#during-initialization). ::: Piemēram, lai asinhronajā režīmā skatītu hostu sarakstu ar [`host.get`](/manual/api/reference/host/get): ```python # 1. Import asyncio for asynchronous mode, and AsyncZabbixAPI from zabbix_utils: import asyncio from zabbix_utils import AsyncZabbixAPI # 2. Define the main async function where all API operations will run: async def main(): # 3. Create an AsyncZabbixAPI instance and log in (must await): api = AsyncZabbixAPI(url="127.0.0.1") await api.login(user="User", password="zabbix") # 4. Retrieve hosts matching a filter (must await): hosts = await api.host.get( filter={ "host": [ "Zabbix server", "Linux server" ] } ) # 5. Iterate over returned hosts and print each host's details: for host in hosts: print(host) # 6. Log out from the API to close the session (must await): await api.logout() # 7. Run the async main() function using asyncio's event loop: asyncio.run(main()) ``` #### Asynchronous pollers After the upgrade all agent, HTTP agent and `walk[OID]` SNMP checks will be moved to [asynchronous pollers](/manual/introduction/whatsnew700#asynchronous-pollers). Newly added `get[OID]` items use asynchronous pollers by default. #### Asinhronie aptaujātāji Pēc jaunināšanas visi aģents, HTTP aģents un `walk[OID]` SNMP pārbaudes tiks pārvietotas uz [asinhronajiem aptaujātājiem](/manual/introduction/whatsnew700#asynchronous-pollers). Jaunpievienotie `get[OID]` vienumi pēc noklusējuma izmanto asinhronos aptaujātājus. #### Asynchronous pollers New poller processes have been added capable of executing multiple checks at the same time: - `agent poller` - `http agent poller` - `snmp poller` (for `walk[OID]` and `get[OID]` items) These pollers are asynchronous - they are capable of starting new checks without the need to wait for a response, with concurrency that is configurable up to 1000 concurrent checks. Asynchronous pollers have been developed because, in comparison, the synchronous poller processes can execute only one check at the same time and most of their time is spent on waiting for the response. Thus the efficiency could be increased by starting new parallel checks while waiting for network response, and the new pollers do that. You can start asynchronous agent pollers by modifying the value of [StartAgentPollers](/manual/appendix/config/zabbix_server#startagentpollers) - a new server/proxy parameter. HTTP agent pollers can be started by modifying [StartHTTPAgentPollers](/manual/appendix/config/zabbix_server#starthttpagentpollers) respectively. SNMP pollers can be started by modifying [StartSNMPPollers](/manual/appendix/config/zabbix_server#startsnmppollers) respectively. The maximum concurrency for asynchronous pollers (agent, HTTP agent and SNMP) is defined by [MaxConcurrentChecksPerPoller](/manual/appendix/config/zabbix_server#maxconcurrentchecksperpoller). Note that after the upgrade all agent, HTTP agent and SNMP `walk[OID]` checks will be moved to asynchronous pollers. As part of the development, the persistent connections cURL feature has been added to HTTP agent checks. #### Asinhronie aptaujātāji Ir pievienoti jauni aptaujātāju procesi, kas spēj vienlaikus izpildīt vairākas pārbaudes: - `agent poller` - `http agent poller` - `snmp poller` (vienumiem `walk[OID]` un `get[OID]`) Šie aptaujātāji ir asinhroni - tie spēj sākt jaunas pārbaudes, negaidot atbildi, un to paralēlisms ir konfigurējams līdz pat 1000 vienlaicīgām pārbaudēm. Asinhronie aptaujātāji ir izstrādāti tāpēc, ka sinhronie aptaujātāju procesi vienlaikus var izpildīt tikai vienu pārbaudi, un lielāko daļu laika tie pavada, gaidot atbildi. Tāpēc efektivitāti var palielināt, kamēr tiek gaidīta tīkla atbilde, sākot jaunas paralēlas pārbaudes, un jaunie aptaujātāji to arī dara. Asinhronos aģenta aptaujātājus var palaist, modificējot [StartAgentPollers](/manual/appendix/config/zabbix_server#startagentpollers) vērtību - jaunu servera/starpniekservera parametru. HTTP aģenta aptaujātājus attiecīgi var palaist, modificējot [StartHTTPAgentPollers](/manual/appendix/config/zabbix_server#starthttpagentpollers). SNMP aptaujātājus attiecīgi var palaist, modificējot [StartSNMPPollers](/manual/appendix/config/zabbix_server#startsnmppollers). Maksimālais paralēlisms asinhronajiem aptaujātājiem (aģents, HTTP aģents un SNMP) ir definēts ar [MaxConcurrentChecksPerPoller](/manual/appendix/config/zabbix_server#maxconcurrentchecksperpoller). Ņemiet vērā, ka pēc jaunināšanas visas aģenta, HTTP aģenta un SNMP `walk[OID]` pārbaudes tiks pārvietotas uz asinhronajiem aptaujātājiem. Izstrādes ietvaros HTTP aģenta pārbaudēm ir pievienota cURL pastāvīgo savienojumu funkcionalitāte. #### Asynchronous poller state calculation Asynchronous pollers are now considered busy if they have reached the limit set by the MaxConcurrentChecksPerPoller [server](/manual/appendix/config/zabbix_server#maxconcurrentchecksperpoller)/[proxy](/manual/appendix/config/zabbix_proxy#maxconcurrentchecksperpoller) configuration parameter. Utilization of poller processes can be monitored with the [zabbix[process,,,]](/manual/config/items/itemtypes/internal#process) internal item. #### Asinhronā aptaujātāja stāvokļa aprēķins Asinhronie aptaujātāji tagad tiek uzskatīti par aizņemtiem, ja tie ir sasnieguši konfigurācijas parametru MaxConcurrentChecksPerPoller [serveris](/manual/appendix/config/zabbix_server#maxconcurrentchecksperpoller)/[starpniekserveris](/manual/appendix/config/zabbix_proxy#maxconcurrentchecksperpoller) iestatīto limitu. Aptaujātāja procesu noslodzi var uzraudzīt ar iekšējo vienumu [zabbix[process,,,]](/manual/config/items/itemtypes/internal#process). #### Asynchronous poller state calculation Asynchronous pollers are now considered busy if they have reached the limit set by the MaxConcurrentChecksPerPoller [server](/manual/appendix/config/zabbix_server#maxconcurrentchecksperpoller)/[proxy](/manual/appendix/config/zabbix_proxy#maxconcurrentchecksperpoller) configuration parameter. Utilization of poller processes can be monitored with the [zabbix[process,,,]](/manual/config/items/itemtypes/internal#process) internal item. #### Asinhronā aptaujātāja stāvokļa aprēķins Asinhronie aptaujātāji tagad tiek uzskatīti par aizņemtiem, ja tie ir sasnieguši robežu, kas iestatīta ar MaxConcurrentChecksPerPoller [serveris](/manual/appendix/config/zabbix_server#maxconcurrentchecksperpoller)/[starpniekserveris](/manual/appendix/config/zabbix_proxy#maxconcurrentchecksperpoller) konfigurācijas parametru. Aptaujātāja procesu noslodzi var uzraudzīt ar iekšējo vienumu [zabbix[process,,,]](/manual/config/items/itemtypes/internal#process). #### Asynchronous single-OID SNMP requests A new [`get[OID]`](/manual/config/items/itemtypes/snmp#step-3) SNMP item has been added allowing to query for a single OID value asynchronously. #### Asinhroni SNMP pieprasījumi vienam OID Ir pievienots jauns SNMP vienums [`get[OID]`](/manual/config/items/itemtypes/snmp#step-3), kas ļauj asinhroni vaicāt vienu OID vērtību. ##### atan2(value,abscissa) {#atan2} The arctangent of the ordinate (value) and abscissa coordinates specified as an angle, expressed in radians. Parameters: - **value** - the value to check; - **abscissa** - the abscissa value. For example, the arctangent of the ordinate and abscissa coordinates of a value '1' will be '2.21429744'. Example: atan2(last(/host/key),2) ##### atan2(value,abscissa) {#atan2} Ordinātas (value) un abscisas koordinātu arkustangens, kas norādīts kā leņķis radiānos. Parametri: - **value** - pārbaudāmā vērtība; - **abscissa** - abscisas vērtība. Piemēram, ordinātas un abscisas koordinātu arkustangens vērtībai '1' būs '2.21429744'. Piemērs: atan2(last(/host/key),2) ##### atan(value) {#atan} The arctangent of a value as an angle, expressed in radians. Parameter: - **value** - the value to check For example, the arctangent of a value '1' will be '0.785398163'. Example: atan(last(/host/key)) ##### atan(value) {#atan} Vērtības arkustangenss kā leņķis, izteikts radiānos. Parametrs: - **value** - pārbaudāmā vērtība Piemēram, vērtības '1' arkustangenss būs '0.785398163'. Piemērs: atan(last(/host/key)) #### Attempting to use Zabbix sender compiled with TLS support to send data to Zabbix server/proxy compiled without TLS #### Mēģinājums izmantot Zabbix sender, kas kompilēts ar TLS atbalstu, lai nosūtītu datus uz Zabbix serveri/starpniekserveri, kas kompilēts bez TLS ##### Attributes returning composite data It becomes more complicated when your attribute returns composite data. For example: your attribute name is "apple" and it returns a hash representing its parameters, like "weight", "color" etc. Your key may look like this: jmx[com.example:Type=Hello,apple.weight] This is how an attribute name and a hash key are separated, by using a dot symbol. Same way, if an attribute returns nested composite data the parts are separated by a dot: jmx[com.example:Type=Hello,fruits.apple.weight] ##### Atribūti, kas atgriež saliktus datus Tas kļūst sarežģītāk, ja jūsu atribūts atgriež saliktus datus. Piemēram: jūsu atribūta nosaukums ir "apple", un tas atgriež jaucējtabulu, kas attēlo tā parametrus, piemēram, "weight", "color" utt. Jūsu atslēga var izskatīties šādi: jmx[com.example:Type=Hello,apple.weight] Šādi atribūta nosaukums un jaucējtabulas atslēga tiek atdalīti, izmantojot punkta simbolu. Tādā pašā veidā, ja atribūts atgriež ligzdotus saliktus datus, daļas tiek atdalītas ar punktu: jmx[com.example:Type=Hello,fruits.apple.weight] ##### Attributes returning tabular data Tabular data attributes consist of one or multiple composite attributes. If such an attribute is specified in the attribute name parameter then this item value will return the complete structure of the attribute in JSON format. The individual element values inside the tabular data attribute can be retrieved using preprocessing. Tabular data attribute example: jmx[com.example:type=Hello,foodinfo] Item value: ``` {.javascript} [ { "a": "apple", "b": "banana", "c": "cherry" }, { "a": "potato", "b": "lettuce", "c": "onion" } ] ``` ##### Atribūti, kas atgriež tabulārus datus Tabulāru datu atribūti sastāv no viena vai vairākiem saliktiem atribūtiem. Ja šāds atribūts ir norādīts atribūta nosaukuma parametrā, tad šī vienuma vērtība atgriezīs pilnu atribūta struktūru JSON formātā. Atsevišķu elementu vērtības tabulāro datu atribūtā var iegūt, izmantojot priekšapstrādi. Tabulāru datu atribūta piemērs: jmx[com.example:type=Hello,foodinfo] Vienuma vērtība: ``` {.javascript} [ { "a": "apple", "b": "banana", "c": "cherry" }, { "a": "potato", "b": "lettuce", "c": "onion" } ] ``` # Audit log # Audita žurnāls #### Auditlog converted to hypertable on TimescaleDB The `auditlog` table has been converted to hypertable on TimescaleDB in new installations to benefit from automatic partitioning on time (7 days by default) and better performance. To successfully upgrade existing installations, see [Upgrading TimescaleDB schema](/manual/appendix/install/timescaledb#upgrading-timescaledb-schema). See also: [Supported TimescaleDB versions](/manual/installation/requirements#thirdparty-external-surrounding-software) #### Auditlog pārveidota par hypertable TimescaleDB Tabula `auditlog` jaunās instalācijās ir pārveidota par hypertable TimescaleDB, lai izmantotu automātisku sadalīšanu pa laiku (pēc noklusējuma 7 dienas) un labāku veiktspēju. Lai veiksmīgi jauninātu esošās instalācijas, skatiet [TimescaleDB shēmas jaunināšana](/manual/appendix/install/timescaledb#upgrading-timescaledb-schema). Skatiet arī: [Atbalstītās TimescaleDB versijas](/manual/installation/requirements#thirdparty-external-surrounding-software) #### Auditlog converted to hypertable on TimescaleDB The `auditlog` table has been converted to hypertable on TimescaleDB in new installations to benefit from automatic partitioning on time (7 days by default) and better performance. To successfully upgrade existing installations, see [Upgrading TimescaleDB schema](/manual/appendix/install/timescaledb#upgrading-timescaledb-schema). See also: [Supported TimescaleDB versions](/manual/installation/requirements#thirdparty-external-surrounding-software) #### Auditlog pārveidota par hypertable TimescaleDB `auditlog` tabula jaunās instalācijās ir pārveidota par hypertable TimescaleDB, lai izmantotu automātisku sadalīšanu pa laiku (pēc noklusējuma 7 dienas) un labāku veiktspēju. Lai veiksmīgi jauninātu esošās instalācijas, skatiet [TimescaleDB shēmas jaunināšana](/manual/appendix/install/timescaledb#upgrading-timescaledb-schema). Skatiet arī: [Atbalstītās TimescaleDB versijas](/manual/installation/requirements#thirdparty-external-surrounding-software) # auditlog.get # auditlog.get #### Audit log In *Administration* → [*Audit log*](/manual/web_interface/frontend_sections/administration/audit_log), you can now enable/disable audit logging of low-level discovery, network discovery and autoregistration activities performed by the server (System user). The default period of storing audit log records before those are deleted by the housekeeper has been changed from 365 days to 31 days. #### Audita žurnāls Sadaļā *Administration* → [*Audit log*](/manual/web_interface/frontend_sections/administration/audit_log) tagad varat iespējot/atspējot audita reģistrēšanu zema līmeņa atklāšanas, tīkla atklāšanas un automātiskās reģistrācijas darbībām, ko veic serveris (System user). Noklusējuma audita žurnāla ierakstu glabāšanas periods pirms to dzēšanas ar housekeeper ir mainīts no 365 dienām uz 31 dienu. # Audit log object The following objects are directly related to the `auditlog` API. # Audita žurnāla objekts Tālāk norādītie objekti ir tieši saistīti ar `auditlog` API. ### Audit log The audit log object contains information about user actions. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |auditid|ID|ID of audit log entry. Generated using CUID algorithm.| |userid|ID|Audit log entry author userid.| |username|string|Audit log entry author username.| |clock|timestamp|Audit log entry creation timestamp.| |ip|string|Audit log entry author IP address.| |action|integer|Audit log entry action.<br><br>Possible values:<br>0 - Add;<br>1 - Update;<br>2 - Delete;<br>4 - Logout;<br>7 - Execute;<br>8 - Login;<br>9 - Failed login;<br>10 - History clear;<br>11 - Config refresh;<br>12 - Push.| |resourcetype|integer|Audit log entry resource type.<br><br>Possible values:<br>0 - User;<br>3 - Media type;<br>4 - Host;<br>5 - Action;<br>6 - Graph;<br>11 - User group;<br>13 - Trigger;<br>14 - Host group;<br>15 - Item;<br>16 - Image;<br>17 - Value map;<br>18 - Service;<br>19 - Map;<br>22 - Web scenario;<br>23 - Discovery rule;<br>25 - Script;<br>26 - Proxy;<br>27 - Maintenance;<br>28 - Regular expression;<br>29 - Macro;<br>30 - Template;<br>31 - Trigger prototype;<br>32 - Icon mapping;<br>33 - Dashboard;<br>34 - Event correlation;<br>35 - Graph prototype;<br>36 - Item prototype;<br>37 - Host prototype;<br>38 - Autoregistration;<br>39 - Module;<br>40 - Settings;<br>41 - Housekeeping;<br>42 - Authentication;<br>43 - Template dashboard;<br>44 - User role;<br>45 - API token;<br>46 - Scheduled report;<br>47 - High availability node;<br>48 - SLA;<br>49 - User directory;<br>50 - Template group;<br>51 - Connector;<br>52 - LLD rule;<br>53 - History.| |resourceid|ID|Audit log entry resource identifier.| |resource_cuid|ID|Audit log entry resource unique identifier generated using the CUID algorithm.| |resourcename|string|Audit log entry resource human readable name.| |recordsetid|ID|Audit log entry recordset ID. The audit log records created during the same operation will have the same recordset ID. Generated using CUID algorithm.| |details|text|Audit log entry details. The details are stored as a JSON object, where each property name is a path to the property or nested object in which the change occurred, and where each value contains the data (in array format) about the change in this property or nested object.<br><br>Possible value formats:<br>\["add"\] - Nested object has been added;<br>\["add", "<value>"\] - The property of the added object equals <value>;<br>\["update"\] - Nested object has been updated;<br>\["update", "<new value>", "<old value>"\] - The property of the updated object was changed from <old value> to <new value>;<br>\["delete"\] - Nested object has been deleted.| ### Audita žurnāls Audita žurnāla objekts satur informāciju par lietotāju darbībām. Tam ir šādas īpašības. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |auditid|ID|Audita žurnāla ieraksta ID. Ģenerēts, izmantojot CUID algoritmu.| |userid|ID|Audita žurnāla ieraksta autora userid.| |username|string|Audita žurnāla ieraksta autora username.| |clock|timestamp|Audita žurnāla ieraksta izveides laikspiedols.| |ip|string|Audita žurnāla ieraksta autora IP adrese.| |action|integer|Audita žurnāla ieraksta darbība.<br><br>Iespējamās vērtības:<br>0 - Add;<br>1 - Update;<br>2 - Delete;<br>4 - Logout;<br>7 - Execute;<br>8 - Login;<br>9 - Failed login;<br>10 - History clear;<br>11 - Config refresh;<br>12 - Push.| |resourcetype|integer|Audita žurnāla ieraksta resursa tips.<br><br>Iespējamās vērtības:<br>0 - User;<br>3 - Media type;<br>4 - Host;<br>5 - Action;<br>6 - Graph;<br>11 - User group;<br>13 - Trigger;<br>14 - Host group;<br>15 - Item;<br>16 - Image;<br>17 - Value map;<br>18 - Service;<br>19 - Map;<br>22 - Web scenario;<br>23 - Discovery rule;<br>25 - Script;<br>26 - Proxy;<br>27 - Maintenance;<br>28 - Regular expression;<br>29 - Macro;<br>30 - Template;<br>31 - Trigger prototype;<br>32 - Icon mapping;<br>33 - Dashboard;<br>34 - Event correlation;<br>35 - Graph prototype;<br>36 - Item prototype;<br>37 - Host prototype;<br>38 - Autoregistration;<br>39 - Module;<br>40 - Settings;<br>41 - Housekeeping;<br>42 - Authentication;<br>43 - Template dashboard;<br>44 - User role;<br>45 - API token;<br>46 - Scheduled report;<br>47 - High availability node;<br>48 - SLA;<br>49 - User directory;<br>50 - Template group;<br>51 - Connector;<br>52 - LLD rule;<br>53 - History.| |resourceid|ID|Audita žurnāla ieraksta resursa identifikators.| |resource_cuid|ID|Audita žurnāla ieraksta resursa unikālais identifikators, kas ģenerēts, izmantojot CUID algoritmu.| |resourcename|string|Audita žurnāla ieraksta resursa cilvēklasāmais nosaukums.| |recordsetid|ID|Audita žurnāla ieraksta recordset ID. Audita žurnāla ierakstiem, kas izveidoti vienas un tās pašas darbības laikā, būs vienāds recordset ID. Ģenerēts, izmantojot CUID algoritmu.| |details|text|Audita žurnāla ieraksta detaļas. Detaļas tiek glabātas kā JSON objekts, kur katra īpašības nosaukums ir ceļš uz īpašību vai ligzdotu objektu, kurā notika izmaiņas, un katra vērtība satur datus (masīva formātā) par izmaiņām šajā īpašībā vai ligzdotajā objektā.<br><br>Iespējamie vērtību formāti:<br>\["add"\] - Ligzdots objekts ir pievienots;<br>\["add", "<value>"\] - Pievienotā objekta īpašība ir vienāda ar <value>;<br>\["update"\] - Ligzdots objekts ir atjaunināts;<br>\["update", "<new value>", "<old value>"\] - Atjauninātā objekta īpašība ir mainīta no <old value> uz <new value>;<br>\["delete"\] - Ligzdots objekts ir dzēsts.| # Audit log This class is designed to work with audit log. Object references: - [Audit log](/manual/api/reference/auditlog/object#audit-log) Available methods: - [auditlog.get](/manual/api/reference/auditlog/get) - retrieve audit log records # Audita žurnāls Šī klase ir paredzēta darbam ar audita žurnālu. Objektu atsauces: - [Audita žurnāls](/manual/api/reference/auditlog/object#audit-log) Pieejamās metodes: - [auditlog.get](/manual/api/reference/auditlog/get) - izgūt audita žurnāla ierakstus #### Audit log Track configuration changes each user has done. [Audit log API](/manual/api/reference/auditlog) #### Audita žurnāls Sekojiet līdzi konfigurācijas izmaiņām, ko veicis katrs lietotājs. [Audita žurnāla API](/manual/api/reference/auditlog) #### auditlog [ZBXNEXT-8541](https://support.zabbix.com/browse/ZBXNEXT-8541) Added new [audit log](/manual/api/reference/auditlog/object#audit-log) entry action (12 - Push) and resource type (53 - History). #### auditlog [ZBXNEXT-8541](https://support.zabbix.com/browse/ZBXNEXT-8541) Pievienota jauna [audit log](/manual/api/reference/auditlog/object#audit-log) ieraksta darbība (12 - Push) un resursa tips (53 - History). #### Authenticating a user Authenticate a user. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "user.login", "params": { "username": "Admin", "password": "zabbix" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": "0424bd59b807674191e7d77572075f33", "id": 1 } ``` #### Lietotāja autentificēšana Autentificējiet lietotāju. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "user.login", "params": { "username": "Admin", "password": "zabbix" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": "0424bd59b807674191e7d77572075f33", "id": 1 } ``` #### Authentication Change authentication configuration options. [Authentication API](/manual/api/reference/authentication) #### Autentifikācija Mainīt autentifikācijas konfigurācijas opcijas. [Autentifikācijas API](/manual/api/reference/authentication) # authentication.get # authentication.get # Authentication object The following objects are directly related to the `authentication` API. # Autentifikācijas objekts Tālāk norādītie objekti ir tieši saistīti ar `authentication` API. #### Authentication request signing It is possible to configure Entra ID to [validate the signature](https://learn.microsoft.com/en-us/entra/identity/enterprise-apps/howto-enforce-signed-saml-authentication) of signed authentication requests. To make this work, create public/private keys: ```bash openssl req -x509 -newkey rsa:4096 -keyout /usr/share/zabbix/conf/certs/request-sign.key -out /usr/share/zabbix/conf/certs/request-sign.pem -sha256 -days 1825 -nodes ``` Assign permissions: ```bash chown apache /usr/share/zabbix/conf/certs/request-sign.key chmod 400 /usr/share/zabbix/conf/certs/request-sign.key ``` Update Zabbix frontend configuration by adding: ```php $SSO['SP_KEY'] = 'conf/certs/request-sign.key'; $SSO['SP_CERT'] = 'conf/certs/request-sign.crt'; ``` #### Autentifikācijas pieprasījuma parakstīšana Ir iespējams konfigurēt Entra ID, lai [validētu parakstu](https://learn.microsoft.com/en-us/entra/identity/enterprise-apps/howto-enforce-signed-saml-authentication) parakstītiem autentifikācijas pieprasījumiem. Lai tas darbotos, izveidojiet publisko/privāto atslēgu pāri: ```bash openssl req -x509 -newkey rsa:4096 -keyout /usr/share/zabbix/conf/certs/request-sign.key -out /usr/share/zabbix/conf/certs/request-sign.pem -sha256 -days 1825 -nodes ``` Piešķiriet atļaujas: ```bash chown apache /usr/share/zabbix/conf/certs/request-sign.key chmod 400 /usr/share/zabbix/conf/certs/request-sign.key ``` Atjauniniet Zabbix lietotāja saskarne konfigurāciju, pievienojot: ```php $SSO['SP_KEY'] = 'conf/certs/request-sign.key'; $SSO['SP_CERT'] = 'conf/certs/request-sign.crt'; ``` ### Authentication The authentication object has the following properties. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |authentication\_type|integer|Default authentication.<br><br>Possible values:<br>0 - *(default)* Internal;<br>1 - LDAP.| |http\_auth\_enabled|integer|HTTP authentication.<br><br>Possible values:<br>0 - *(default)* Disabled;<br>1 - Enabled.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `$ALLOW_HTTP_AUTH` is enabled in the [frontend configuration file](/manual/installation/frontend#install) (*zabbix.conf.php*).| |http\_login\_form|integer|Default login form.<br><br>Possible values:<br>0 - *(default)* Zabbix login form;<br>1 - HTTP login form.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `$ALLOW_HTTP_AUTH` is enabled in the [frontend configuration file](/manual/installation/frontend#install) (*zabbix.conf.php*).| |http\_strip\_domains|string|Domain name to remove.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `$ALLOW_HTTP_AUTH` is enabled in the [frontend configuration file](/manual/installation/frontend#install) (*zabbix.conf.php*).| |http\_case\_sensitive|integer|HTTP case-sensitive login.<br><br>Possible values:<br>0 - Off;<br>1 - *(default)* On.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `$ALLOW_HTTP_AUTH` is enabled in the [frontend configuration file](/manual/installation/frontend#install) (*zabbix.conf.php*).| |ldap\_auth\_enabled|integer|LDAP authentication.<br><br>Possible values:<br>0 - *(default)* Disabled;<br>1 - Enabled.| |ldap\_case\_sensitive|integer|LDAP case-sensitive login.<br><br>Possible values:<br>0 - Off;<br>1 - *(default)* On.| |ldap\_userdirectoryid|ID|ID of the default user directory for LDAP authentication.<br>Used for user groups with `gui_access` set to LDAP or System default.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `ldap_auth_enabled` is set to "Enabled"| |saml\_auth\_enabled|integer|SAML authentication.<br><br>Possible values:<br>0 - *(default)* Disabled;<br>1 - Enabled.| |saml\_case\_sensitive|integer|SAML case-sensitive login.<br><br>Possible values:<br>0 - Off;<br>1 - *(default)* On.| |passwd\_min\_length|integer|Password minimal length requirement.<br><br>Possible values range from 1 to 70.<br><br>Default: 8.| |passwd\_check\_rules|integer|Password checking rules.<br><br>Possible bitmap values:<br>0 - Check password length;<br>1 - Check if password uses uppercase and lowercase Latin letters;<br>2 - Check if password uses digits;<br>4 - Check if password uses special characters;<br>8 - *(default)* Check if password is not in the list of commonly used passwords and does not contain derivations of word "Zabbix" or user's name, last name, or username.<br><br>This is a bitmask field; any sum of possible bitmap values is acceptable (for example, 15 for checking all rules).| |ldap\_jit\_status|integer|Status of LDAP provisioning.<br><br>Possible values:<br>0 - Disabled for configured LDAP IdPs;<br>1 - Enabled for configured LDAP IdPs.| |saml\_jit\_status|integer|Status of SAML provisioning.<br><br>Possible values:<br>0 - Disabled for configured SAML IdPs;<br>1 - Enabled for configured SAML IdPs.| |jit\_provision\_interval|string|Time interval between JIT provision requests for logged-in user.<br>Accepts seconds and time unit with suffix with month and year support (3600s,60m,1h,1d,1M,1y). Minimum value: 1h.<br><br>Default: 1h.<br><br>Available only for LDAP provisioning.| |disabled\_usrgrpid|ID|ID of the user group to assign the deprovisioned user to.<br>The user group must be disabled and cannot be enabled or deleted when configured.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `ldap_jit_status` is set to "Enabled for configured LDAP IdPs", or `saml_jit_status` is set to "Enabled for configured SAML IdPs"| |mfa\_status|integer|[Multi-factor authentication](/manual/web_interface/frontend_sections/users/authentication/mfa).<br><br>Possible values:<br>0 - Disabled (for all configured MFA methods);<br>1 - Enabled (for all configured MFA methods).| |mfaid|ID|Default [MFA method](/manual/api/reference/mfa/object) for [user groups](/manual/api/reference/usergroup/object#user-group) with MFA enabled.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `mfa_status` is set to "Enabled"| ### Autentifikācija Autentifikācijas objektam ir šādas īpašības. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |authentication\_type|integer|Noklusējuma autentifikācija.<br><br>Iespējamās vērtības:<br>0 - *(noklusējums)* Iekšējā;<br>1 - LDAP.| |http\_auth\_enabled|integer|HTTP autentifikācija.<br><br>Iespējamās vērtības:<br>0 - *(noklusējums)* Atspējota;<br>1 - Iespējota.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *atbalstīta*, ja [lietotāja saskarnes konfigurācijas failā](/manual/installation/frontend#install) (*zabbix.conf.php*) ir iespējots `$ALLOW_HTTP_AUTH`.| |http\_login\_form|integer|Noklusējuma pieteikšanās forma.<br><br>Iespējamās vērtības:<br>0 - *(noklusējums)* Zabbix pieteikšanās forma;<br>1 - HTTP pieteikšanās forma.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *atbalstīta*, ja [lietotāja saskarnes konfigurācijas failā](/manual/installation/frontend#install) (*zabbix.conf.php*) ir iespējots `$ALLOW_HTTP_AUTH`.| |http\_strip\_domains|string|Noņemamais domēna nosaukums.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *atbalstīta*, ja [lietotāja saskarnes konfigurācijas failā](/manual/installation/frontend#install) (*zabbix.conf.php*) ir iespējots `$ALLOW_HTTP_AUTH`.| |http\_case\_sensitive|integer|Reģistrjutīga HTTP pieteikšanās.<br><br>Iespējamās vērtības:<br>0 - Izslēgta;<br>1 - *(noklusējums)* Ieslēgta.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *atbalstīta*, ja [lietotāja saskarnes konfigurācijas failā](/manual/installation/frontend#install) (*zabbix.conf.php*) ir iespējots `$ALLOW_HTTP_AUTH`.| |ldap\_auth\_enabled|integer|LDAP autentifikācija.<br><br>Iespējamās vērtības:<br>0 - *(noklusējums)* Atspējota;<br>1 - Iespējota.| |ldap\_case\_sensitive|integer|Reģistrjutīga LDAP pieteikšanās.<br><br>Iespējamās vērtības:<br>0 - Izslēgta;<br>1 - *(noklusējums)* Ieslēgta.| |ldap\_userdirectoryid|ID|LDAP autentifikācijas noklusējuma lietotāju direktorija ID.<br>Izmanto lietotāju grupām, kurām `gui_access` ir iestatīts uz LDAP vai Sistēmas noklusējums.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāta*, ja `ldap_auth_enabled` ir iestatīts uz "Iespējota"| |saml\_auth\_enabled|integer|SAML autentifikācija.<br><br>Iespējamās vērtības:<br>0 - *(noklusējums)* Atspējota;<br>1 - Iespējota.| |saml\_case\_sensitive|integer|Reģistrjutīga SAML pieteikšanās.<br><br>Iespējamās vērtības:<br>0 - Izslēgta;<br>1 - *(noklusējums)* Ieslēgta.| |passwd\_min\_length|integer|Minimālā paroles garuma prasība.<br><br>Iespējamās vērtības ir diapazonā no 1 līdz 70.<br><br>Noklusējums: 8.| |passwd\_check\_rules|integer|Paroles pārbaudes noteikumi.<br><br>Iespējamās bitkartes vērtības:<br>0 - Pārbaudīt paroles garumu;<br>1 - Pārbaudīt, vai parole satur lielos un mazos latīņu burtus;<br>2 - Pārbaudīt, vai parole satur ciparus;<br>4 - Pārbaudīt, vai parole satur speciālās rakstzīmes;<br>8 - *(noklusējums)* Pārbaudīt, vai parole nav bieži lietotu paroļu sarakstā un nesatur vārda "Zabbix" atvasinājumus vai lietotāja vārdu, uzvārdu vai lietotājvārdu.<br><br>Šis ir bitmaskas lauks; ir pieļaujama jebkura iespējamo bitkartes vērtību summa (piemēram, 15 visu noteikumu pārbaudei).| |ldap\_jit\_status|integer|LDAP nodrošināšanas statuss.<br><br>Iespējamās vērtības:<br>0 - Atspējota konfigurētajiem LDAP IdP;<br>1 - Iespējota konfigurētajiem LDAP IdP.| |saml\_jit\_status|integer|SAML nodrošināšanas statuss.<br><br>Iespējamās vērtības:<br>0 - Atspējota konfigurētajiem SAML IdP;<br>1 - Iespējota konfigurētajiem SAML IdP.| |jit\_provision\_interval|string|Laika intervāls starp JIT nodrošināšanas pieprasījumiem pieteikušamies lietotājam.<br>Pieņem sekundes un laika vienību ar sufiksu, atbalstot mēnešus un gadus (3600s,60m,1h,1d,1M,1y). Minimālā vērtība: 1h.<br><br>Noklusējums: 1h.<br><br>Pieejams tikai LDAP nodrošināšanai.| |disabled\_usrgrpid|ID|Tās lietotāju grupas ID, kurai piešķirt atnodrošināto lietotāju.<br>Lietotāju grupai jābūt atspējotai, un to nevar iespējot vai dzēst, kamēr tā ir konfigurēta.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāta*, ja `ldap_jit_status` ir iestatīts uz "Iespējota konfigurētajiem LDAP IdP" vai `saml_jit_status` ir iestatīts uz "Iespējota konfigurētajiem SAML IdP"| |mfa\_status|integer|[Daudzfaktoru autentifikācija](/manual/web_interface/frontend_sections/users/authentication/mfa).<br><br>Iespējamās vērtības:<br>0 - Atspējota (visām konfigurētajām MFA metodēm);<br>1 - Iespējota (visām konfigurētajām MFA metodēm).| |mfaid|ID|Noklusējuma [MFA metode](/manual/api/reference/mfa/object) [lietotāju grupām](/manual/api/reference/usergroup/object#user-group), kurām MFA ir iespējota.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāta*, ja `mfa_status` ir iestatīts uz "Iespējota"| # Authentication This class is designed to work with authentication settings. Object references: - [Authentication](/manual/api/reference/authentication/object#authentication) Available methods: - [authentication.get](/manual/api/reference/authentication/get) - retrieve authentication settings - [authentication.update](/manual/api/reference/authentication/update) - update authentication settings # Autentifikācija Šī klase ir paredzēta darbam ar autentifikācijas iestatījumiem. Objektu atsauces: - [Authentication](/manual/api/reference/authentication/object#authentication) Pieejamās metodes: - [authentication.get](/manual/api/reference/authentication/get) - izgūt autentifikācijas iestatījumus - [authentication.update](/manual/api/reference/authentication/update) - atjaunināt autentifikācijas iestatījumus ### Authentication To access any data in Zabbix, you need to either: - Use an existing API token created in the Zabbix frontend, *Users* > [*API tokens*](/manual/web_interface/frontend_sections/users/api_tokens) section, or created using the [Token API](/manual/api/reference/token). - Use an authentication token obtained with the [`user.login`](/manual/api/reference/user/login) method. For example, if you wanted to obtain a new authentication token by logging in as a standard *Admin* user, then a JSON request would look like this: ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Content-Type: application/json-rpc' \ --data '{"jsonrpc":"2.0","method":"user.login","params":{"username":"Admin","password":"zabbix"},"id":1}' ``` If you provided the credentials correctly, the response returned by the API should contain the user authentication token: ```json { "jsonrpc": "2.0", "result": "0424bd59b807674191e7d77572075f33", "id": 1 } ``` ### Autentifikācija Lai piekļūtu jebkuriem datiem Zabbix, jums ir jāizmanto viens no šiem veidiem: - Izmantojiet esošu API tokenu, kas izveidots Zabbix lietotāja saskarnē, sadaļā *Users* > [*API tokens*](/manual/web_interface/frontend_sections/users/api_tokens), vai izveidots, izmantojot [Token API](/manual/api/reference/token). - Izmantojiet autentifikācijas tokenu, kas iegūts ar [`user.login`](/manual/api/reference/user/login) metodi. Piemēram, ja jūs vēlētos iegūt jaunu autentifikācijas tokenu, piesakoties kā standarta *Admin* lietotājs, JSON pieprasījums izskatītos šādi: ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Content-Type: application/json-rpc' \ --data '{"jsonrpc":"2.0","method":"user.login","params":{"username":"Admin","password":"zabbix"},"id":1}' ``` Ja jūs norādījāt akreditācijas datus pareizi, API atgrieztajā atbildē jābūt lietotāja autentifikācijas tokenam: ```json { "jsonrpc": "2.0", "result": "0424bd59b807674191e7d77572075f33", "id": 1 } ``` # authentication.update # authentication.update #### authentication [ZBXNEXT-6876](https://support.zabbix.com/browse/ZBXNEXT-6876) Added new properties `mfa_status` and `mfaid`. #### autentifikācija [ZBXNEXT-6876](https://support.zabbix.com/browse/ZBXNEXT-6876) Pievienotas jaunas īpašības `mfa_status` un `mfaid`. #### authentication [ZBXNEXT-8880](https://support.zabbix.com/browse/ZBXNEXT-8880) Properties `http_auth_enabled`, `http_login_form`, `http_strip_domains`, `http_case_sensitive` will be available only if `$ALLOW_HTTP_AUTH` is enabled in the [frontend configuration file](/manual/installation/frontend#install) (*zabbix.conf.php*). #### autentifikācija [ZBXNEXT-8880](https://support.zabbix.com/browse/ZBXNEXT-8880) Rekvizīti `http_auth_enabled`, `http_login_form`, `http_strip_domains`, `http_case_sensitive` būs pieejami tikai tad, ja `$ALLOW_HTTP_AUTH` ir iespējots [lietotāja saskarnes konfigurācijas failā](/manual/installation/frontend#install) (*zabbix.conf.php*). #### Authorization header forwarding In some cases, Apache or NGINX may prevent the Authorization header in API requests from reaching Zabbix. This can cause authentication issues when using Zabbix API or single sign-on (SSO) services, such as SAML with Okta. To address this, update your web server's configuration. For **Apache**, if you are using it as a reverse proxy (non-CGI setup), add the following directive to `/etc/httpd/conf/httpd.conf` (on RHEL-based systems) or `/etc/apache2/apache2.conf` (on Debian/Ubuntu): ```ini SetEnvIfNoCase ^Authorization$ "(.+)" HTTP_AUTHORIZATION=$1 ``` If Apache directly executes scripts to handle requests (e.g., by using mod\_cgi), add the following directive instead: ```ini CGIPassAuth On ``` In contrast, **NGINX** handles the Authorization header automatically. However, if NGINX is acting as a reverse proxy, you may explicitly forward the Authorization header by adding the following directives to `/etc/nginx/nginx.conf` (for your Zabbix frontend location): ```ini ... location / { ... proxy_set_header Authorization $http_authorization; proxy_pass http://backend_server; ... } ``` After updating the configuration, restart you web server. For more details, see: - [ZBX-22952](https://support.zabbix.com/browse/ZBX-22952) - [Apache 2.4 + PHP-FPM and Authorization headers](https://stackoverflow.com/questions/17018586/apache-2-4-php-fpm-and-authorization-headers) - [SetEnvIfNoCase](https://httpd.apache.org/docs/2.4/mod/mod_setenvif.html#setenvifnocase) and [CGIPassAuth](https://httpd.apache.org/docs/2.4/mod/core.html#CGIPassAuth) directives - [NGINX Reverse Proxy](https://docs.nginx.com/nginx/admin-guide/web-server/reverse-proxy/) #### Authorization galvenes pārsūtīšana Dažos gadījumos Apache vai NGINX var neļaut Authorization galvenei API pieprasījumos sasniegt Zabbix. Tas var izraisīt autentifikācijas problēmas, izmantojot Zabbix API vai vienoto pierakstīšanos (SSO) pakalpojumus, piemēram, SAML ar Okta. Lai to novērstu, atjauniniet sava tīmekļa servera konfigurāciju. **Apache** gadījumā, ja to izmantojat kā reverso starpniekserveri (ne-CGI iestatījums), pievienojiet šādu direktīvu `/etc/httpd/conf/httpd.conf` (RHEL bāzētās sistēmās) vai `/etc/apache2/apache2.conf` (Debian/Ubuntu): ```ini SetEnvIfNoCase ^Authorization$ "(.+)" HTTP_AUTHORIZATION=$1 ``` Ja Apache pieprasījumu apstrādei tieši izpilda skriptus (piem., izmantojot mod\_cgi), tā vietā pievienojiet šādu direktīvu: ```ini CGIPassAuth On ``` Savukārt **NGINX** Authorization galveni apstrādā automātiski. Tomēr, ja NGINX darbojas kā reversais starpniekserveris, jūs varat skaidri pārsūtīt Authorization galveni, pievienojot šādas direktīvas `/etc/nginx/nginx.conf` (jūsu Zabbix lietotāja saskarnei paredzētajai atrašanās vietai): ```ini ... location / { ... proxy_set_header Authorization $http_authorization; proxy_pass http://backend_server; ... } ``` Pēc konfigurācijas atjaunināšanas restartējiet savu tīmekļa serveri. Papildinformāciju skatiet: - [ZBX-22952](https://support.zabbix.com/browse/ZBX-22952) - [Apache 2.4 + PHP-FPM and Authorization headers](https://stackoverflow.com/questions/17018586/apache-2-4-php-fpm-and-authorization-headers) - [SetEnvIfNoCase](https://httpd.apache.org/docs/2.4/mod/mod_setenvif.html#setenvifnocase) un [CGIPassAuth](https://httpd.apache.org/docs/2.4/mod/core.html#CGIPassAuth) direktīvas - [NGINX Reverse Proxy](https://docs.nginx.com/nginx/admin-guide/web-server/reverse-proxy/) #### Authorization methods #### Autorizācijas metodes ##### Authorization |Parameter|Description| |--|--------| |*Login attempts*|Number of unsuccessful login attempts before the possibility to log in gets blocked.| |*Login blocking interval*|Period of time for which logging in will be prohibited when *Login attempts* limit is exceeded. Allowed range: 30 - 3600 seconds. [Time suffixes](/manual/appendix/suffixes), e.g. 90s, 5m, 1h, are supported.| ##### Autorizācija |Parametrs|Apraksts| |--|--------| |*Pieteikšanās mēģinājumi*|Neveiksmīgu pieteikšanās mēģinājumu skaits, pēc kura tiek bloķēta iespēja pieteikties.| |*Pieteikšanās bloķēšanas intervāls*|Laika periods, kurā pieteikšanās būs aizliegta, ja tiek pārsniegts *Pieteikšanās mēģinājumi* limits. Atļautais diapazons: 30 - 3600 sekundes. Tiek atbalstīti [laika sufiksi](/manual/appendix/suffixes), piemēram, 90s, 5m, 1h.| ### author Module author. The author will be displayed in the Administration section. *Type*: String *Example*: ```json "author": "John Smith" ``` ### autors Moduļa autors. Autors tiks parādīts sadaļā Administrēšana. *Type*: String *Piemērs*: ```json "author": "John Smith" ``` ## AUTHOR Zabbix LLC ------------------------------------------------------------------------ [ ]{#index} ## AUTORS SIA Zabbix -------------------------------------------------- ---------------------- [ ]{#rādītājs} #### Automated Gmail/Office365 media types Gmail or Office365 users may benefit from easier media type configuration. The *Email provider* field in the mail media type configuration allows to select pre-configured options for Gmail and Office 365. When selecting the Gmail/Office365 related options, it is only required to supply the sender email address/password to create a working media type. {width="600"} As soon as the email address/password is supplied, Zabbix will be able to automatically fill all required settings for Gmail/Office365 media types with the actual/recommended values, i.e., *SMTP server*, *SMTP server port*, *SMTP helo*, and *Connection security*. Because of this automation, these fields are not even shown, however, it is possible to see the SMTP server and email details in the media type list (see the *Details* column). Note also that: - The password is not required for the relay options. - For Office365 relay, the domain name of the provided email address will be used to dynamically fill the SMTP server (i.e., replace "example.com" in `example-com.mail.protection.outlook.com` with the real value). #### Automatizēti Gmail/Office365 mediju tipi Gmail vai Office365 lietotāji var gūt labumu no vienkāršākas mediju tipa konfigurācijas. Lauks *Email provider* pasta mediju tipa konfigurācijā ļauj izvēlēties iepriekš konfigurētas Gmail un Office 365 opcijas. Izvēloties ar Gmail/Office365 saistītās opcijas, lai izveidotu darbojošos mediju tipu, ir jānorāda tikai sūtītāja e-pasta adrese/parole. {width="600"} Tiklīdz e-pasta adrese/parole ir norādīta, Zabbix varēs automātiski aizpildīt visus Gmail/Office365 mediju tipiem nepieciešamos iestatījumus ar faktiskajām/rekomendētajām vērtībām, t. i., *SMTP server*, *SMTP server port*, *SMTP helo* un *Connection security*. Šīs automatizācijas dēļ šie lauki pat netiek rādīti, tomēr mediju tipu sarakstā ir iespējams redzēt SMTP servera un e-pasta informāciju (skatiet kolonnu *Details*). Ņemiet vērā arī, ka: - Paroles nav nepieciešamas relay opcijām. - Office365 relay gadījumā norādītās e-pasta adreses domēna vārds tiks izmantots, lai dinamiski aizpildītu SMTP serveri (t. i., aizstātu "example.com" ar `example-com.mail.protection.outlook.com` reālo vērtību). #### Automatic broadcasting of first entity in widgets Widgets supporting entity selection (e.g., *Item navigator*) now automatically broadcast data for the first available entity, without the need to select the entity first. For details, see [Widget behavior](/manual/web_interface/frontend_sections/dashboards/widgets#widget-behavior). #### Pirmās entītijas automātiska pārraidīšana logrīkos Logrīki, kas atbalsta entītiju atlasi (piemēram, *Vienuma navigators*), tagad automātiski pārraida datus par pirmo pieejamo entītiju, bez nepieciešamības vispirms atlasīt entītiju. Sīkāku informāciju skatiet [Logrīka darbība](/manual/web_interface/frontend_sections/dashboards/widgets#widget-behavior). #### Automatic disabling of lost resources Resources that are no longer discovered by low-level discovery now can be disabled automatically. They can be disabled immediately, after a specified time period or never (see the new *Disable lost resources* parameter in the discovery rule [configuration](/manual/discovery/low_level_discovery#discovery-rule)). Lost resources (hosts, items, triggers) are marked by an icon in the info column. The tooltip text provides details on their status. Within the same development the *Keep lost resources period* parameter was renamed to *Delete lost resources* with options to delete immediately, after a specified time period or never.  #### Automātiska pazaudēto resursu atspējošana Resursi, kas vairs netiek atklāti ar zemā līmeņa atklāšanu, tagad var tikt atspējoti automātiski. Tos var atspējot nekavējoties, pēc norādīta laika perioda vai nekad (skatiet jauno parametru *Disable lost resources* atklāšanas noteikuma [konfigurācijā](/manual/discovery/low_level_discovery#discovery-rule)). Pazaudētie resursi (hosts, vienumi, trigeri) ir atzīmēti ar ikonu informācijas kolonnā. Paskaidrojuma teksts sniedz informāciju par to statusu. Tajā pašā izstrādes ietvarā parametrs *Keep lost resources period* tika pārdēvēts par *Delete lost resources* ar iespējām dzēst nekavējoties, pēc norādīta laika perioda vai nekad.  ##### Automatic mode Host inventory can also be populated automatically. For that to work, when configuring a host the inventory mode in the *Inventory* tab must be set to *Automatic*. Then you can [configure host items](/manual/config/items/item) to populate any host inventory field with their value, indicating the destination field with the respective attribute (called *Item will populate host inventory field*) in item configuration. Items that are especially useful for automated inventory data collection: - system.hw.chassis\[full|type|vendor|model|serial\] - default is \[full\], root permissions needed - system.hw.cpu\[all|cpunum,full|maxfreq|vendor|model|curfreq\] - default is \[all,full\] - system.hw.devices\[pci|usb\] - default is \[pci\] - system.hw.macaddr\[interface,short|full\] - default is \[all,full\], interface is regexp - system.sw.arch - system.sw.os\[name|short|full\] - default is \[name\] - system.sw.packages\[regexp,manager,short|full\] - default is \[all,all,full\] ##### Automātiskais režīms Hosta inventāru var arī aizpildīt automātiski. Lai tas darbotos, konfigurējot hostu, cilnē *Inventory* inventāra režīmam jābūt iestatītam uz *Automatic*. Pēc tam varat [konfigurēt hosta vienumus](/manual/config/items/item), lai aizpildītu jebkuru hosta inventāra lauku ar to vērtību, norādot mērķa lauku ar attiecīgo atribūtu (sauktu par *Item will populate host inventory field*) vienuma konfigurācijā. Vienumi, kas ir īpaši noderīgi automatizētai inventāra datu apkopošanai: - system.hw.chassis\[full|type|vendor|model|serial\] — noklusējums ir \[full\], nepieciešamas root tiesības - system.hw.cpu\[all|cpunum,full|maxfreq|vendor|model|curfreq\] — noklusējums ir \[all,full\] - system.hw.devices\[pci|usb\] — noklusējums ir \[pci\] - system.hw.macaddr\[interface,short|full\] — noklusējums ir \[all,full\], interface ir regulārā izteiksme - system.sw.arch - system.sw.os\[name|short|full\] — noklusējums ir \[name\] - system.sw.packages\[regexp,manager,short|full\] — noklusējums ir \[all,all,full\] #### Automatic reload of SNMPv3 credentials SNMP agent walk[] and get[] item checks now automatically reload updated SNMPv3 authentication and privacy settings when the corresponding SNMPv3 interface is modified. The manual cache reload command [-R snmp_cache_reload](/manual/concepts/server#runtime-control) remains available for troubleshooting and for devices that do not fully comply with SNMPv3 specifications. #### Automātiska SNMPv3 akreditācijas datu pārlāde SNMP aģenta walk[] un get[] vienumu pārbaudes tagad automātiski pārlādē atjauninātos SNMPv3 autentifikācijas un privātuma iestatījumus, kad tiek modificēta atbilstošā SNMPv3 saskarne. Manuālā kešatmiņas pārlādes komanda [-R snmp_cache_reload](/manual/concepts/server#runtime-control) joprojām ir pieejama problēmu novēršanai un ierīcēm, kas pilnībā neatbilst SNMPv3 specifikācijām. #### Autoregistration actions The following conditions can be used in actions based on active agent autoregistration: |Condition type|Supported operators|Description| |--|--|------| |*Host metadata*|contains<br>does not contain<br>matches<br>does not match|Specify host metadata or host metadata to exclude.<br>**contains** - host metadata contains the string.<br>**does not contain** - host metadata does not contain the string.<br>Host metadata can be specified in an [agent configuration file](/manual/appendix/config/zabbix_agentd).<br>**matches** - host metadata matches regular expression.<br>**does not match** - host metadata does not match regular expression.| |*Host name*|contains<br>does not contain<br>matches<br>does not match|Specify a host name or a host name to exclude.<br>**contains** - host name contains the string.<br>**does not contain** - host name does not contain the string.<br>**matches** - host name matches regular expression.<br>**does not match** - host name does not match regular expression.| |*Proxy*|equals<br>does not equal|Specify a proxy or a proxy to exclude.<br>**equals** - using this proxy.<br>**does not equal** - using any other proxy except this one.| #### Autoreģistrācijas darbības Tālāk norādītos nosacījumus var izmantot darbībās, kuru pamatā ir aktīvā aģenta autoreģistrācija: |Condition type|Supported operators|Description| |--|--|------| |*Host metadata*|contains<br>does not contain<br>matches<br>does not match|Norādiet host metadata vai host metadata, ko izslēgt.<br>**contains** - host metadata satur virkni.<br>**does not contain** - host metadata nesatur virkni.<br>Host metadata var norādīt [aģenta konfigurācijas failā](/manual/appendix/config/zabbix_agentd).<br>**matches** - host metadata atbilst regulārajai izteiksmei.<br>**does not match** - host metadata neatbilst regulārajai izteiksmei.| |*Host name*|contains<br>does not contain<br>matches<br>does not match|Norādiet host name vai host name, ko izslēgt.<br>**contains** - host name satur virkni.<br>**does not contain** - host name nesatur virkni.<br>**matches** - host name atbilst regulārajai izteiksmei.<br>**does not match** - host name neatbilst regulārajai izteiksmei.| |*Proxy*|equals<br>does not equal|Norādiet starpniekserveri vai starpniekserveri, ko izslēgt.<br>**equals** - izmanto šo starpniekserveri.<br>**does not equal** - izmanto jebkuru citu starpniekserveri, izņemot šo.| ##### Autoregistration by OS using HostMetadata Say you would like the hosts to be autoregistered by the Zabbix server. You have active Zabbix agents (see "Configuration" section above) on your network. There are Windows hosts and Linux hosts on your network and you have "Linux by Zabbix agent" and "Windows by Zabbix agent" templates available in your Zabbix frontend. So at host registration, you would like the appropriate Linux/Windows template to be applied to the host being registered. By default, only the hostname is sent to the server at autoregistration, which might not be enough. In order to make sure the proper template is applied to the host you should use host metadata. ##### Autoreģistrācija pēc OS, izmantojot HostMetadata Pieņemsim, ka vēlaties, lai hosti tiktu automātiski reģistrēti Zabbix serverī. Jūsu tīklā darbojas aktīvi Zabbix aģenti (skatiet iepriekš esošo sadaļu "Configuration"). Jūsu tīklā ir Windows hosti un Linux hosti, un Zabbix lietotāja saskarnē jums ir pieejamas veidnes "Linux by Zabbix agent" un "Windows by Zabbix agent". Tāpēc hosta reģistrācijas laikā vēlaties, lai reģistrējamajam hostam tiktu piemērota atbilstošā Linux/Windows veidne. Pēc noklusējuma automātiskās reģistrācijas laikā uz serveri tiek nosūtīts tikai hosta nosaukums, un ar to var nepietikt. Lai nodrošinātu, ka hostam tiek piemērota pareizā veidne, jums jāizmanto hosta metadati. # autoregistration.get # autoregistration.get #### Autoregistration In this section, you can configure the encryption level for active agent autoregistration.  Parameters marked with an asterisk are mandatory. Configuration parameters: |Parameter|Description| |--|--------| |*Encryption level*|Select one or both options for encryption level:<br>**No encryption** - unencrypted connections are allowed<br>**PSK** - TLS encrypted connections with a pre-shared key are allowed| |*PSK identity*|Enter the pre-shared key identity string.<br>This field is only available if 'PSK' is selected as *Encryption level*.<br>Do not put sensitive information in the PSK identity, it is transmitted unencrypted over the network to inform a receiver which PSK to use.| |*PSK*|Enter the pre-shared key (an even number of hexadecimal characters).<br>Maximum length: 512 hex-digits (256-byte PSK) if Zabbix uses GnuTLS or OpenSSL library, 64 hex-digits (32-byte PSK) if Zabbix uses mbed TLS (PolarSSL) library.<br>Example: 1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952<br>This field is only available if 'PSK' is selected as *Encryption level*.| See also: [Secure autoregistration](/manual/discovery/auto_registration#secure-autoregistration) #### Autoreģistrācija Šajā sadaļā varat konfigurēt šifrēšanas līmeni aktīvai aģenta autoreģistrācijai.  Ar zvaigznīti atzīmētie parametri ir obligāti. Konfigurācijas parametri: |Parameter|Description| |--|--------| |*Encryption level*|Atlasiet vienu vai abas šifrēšanas līmeņa opcijas:<br>**No encryption** - atļauti nešifrēti savienojumi<br>**PSK** - atļauti ar TLS šifrēti savienojumi ar iepriekš koplietotu atslēgu| |*PSK identity*|Ievadiet iepriekš koplietotās atslēgas identitātes virkni.<br>Šis lauks ir pieejams tikai tad, ja kā *Encryption level* ir atlasīts 'PSK'.<br>Neievadiet sensitīvu informāciju PSK identitātē, jo tā tiek pārsūtīta nešifrēti tīklā, lai saņēmējam norādītu, kuru PSK izmantot.| |*PSK*|Ievadiet iepriekš koplietoto atslēgu (pāra skaits heksadecimālo rakstzīmju).<br>Maksimālais garums: 512 heksadecimālās zīmes (256 baitu PSK), ja Zabbix izmanto GnuTLS vai OpenSSL bibliotēku, 64 heksadecimālās zīmes (32 baitu PSK), ja Zabbix izmanto mbed TLS (PolarSSL) bibliotēku.<br>Piemērs: 1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952<br>Šis lauks ir pieejams tikai tad, ja kā *Encryption level* ir atlasīts 'PSK'.| Skatiet arī: [Droša autoreģistrācija](/manual/discovery/auto_registration#secure-autoregistration) # Autoregistration object The following objects are directly related to the `autoregistration` API. # Autoreģistrācijas objekts Tālāk norādītie objekti ir tieši saistīti ar `autoregistration` API. ### Autoregistration The autoregistration object has the following properties. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |tls\_accept|integer|Type of allowed incoming connections for autoregistration.<br><br>Possible values:<br>1 - allow unencrypted connections;<br>2 - allow TLS with PSK;<br>3 - allow both unencrypted and TLS with PSK connections.| |tls\_psk\_identity|string|PSK identity; must be paired with only one PSK (across [autoregistration](/manual/api/reference/autoregistration/object), [hosts](/manual/api/reference/host/object), and [proxies](/manual/api/reference/proxy/object)).<br><br>Do not include sensitive information in the PSK identity, as it is sent unencrypted over the network to inform the receiver which PSK to use.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *write-only*| |tls\_psk|string|Pre-shared key (PSK); must be at least 32 hex digits.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *write-only*| ### Autoreģistrācija Autoreģistrācijas objektam ir šādas īpašības. |Īpašība|[Type](/manual/api/reference_commentary#data-types)|Apraksts| |--|--|------| |tls\_accept|integer|Atļauto ienākošo savienojumu veids autoreģistrācijai.<br><br>Iespējamās vērtības:<br>1 - atļaut nešifrētus savienojumus;<br>2 - atļaut TLS ar PSK;<br>3 - atļaut gan nešifrētus savienojumus, gan TLS ar PSK savienojumus.| |tls\_psk\_identity|string|PSK identitāte; tai jābūt sasaistītai tikai ar vienu PSK (starp [autoregistration](/manual/api/reference/autoregistration/object), [hosts](/manual/api/reference/host/object) un [proxies](/manual/api/reference/proxy/object)).<br><br>Neiekļaujiet sensitīvu informāciju PSK identitātē, jo tā tiek nosūtīta nešifrētā veidā pa tīklu, lai informētu saņēmēju, kuru PSK izmantot.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *tikai rakstāma*| |tls\_psk|string|Iepriekš koplietotā atslēga (PSK); tai jābūt vismaz 32 heksadecimālām zīmēm garai.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *tikai rakstāma*| # Autoregistration This class is designed to work with autoregistration. Object references: - [Autoregistration](/manual/api/reference/autoregistration/object#autoregistration) Available methods: - [autoregistration.get](/manual/api/reference/autoregistration/get) - retrieve autoregistration - [autoregistration.update](/manual/api/reference/autoregistration/update) - update autoregistration # Autoreģistrācija Šī klase ir paredzēta darbam ar autoreģistrāciju. Objektu atsauces: - [Autoreģistrācija](/manual/api/reference/autoregistration/object#autoregistration) Pieejamās metodes: - [autoregistration.get](/manual/api/reference/autoregistration/get) - izgūt autoreģistrāciju - [autoregistration.update](/manual/api/reference/autoregistration/update) - atjaunināt autoreģistrāciju # autoregistration.update # autoregistration.update ### Available Docker images Zabbix provides a Docker image for each Zabbix component, all published on [Docker Hub](https://hub.docker.com/u/zabbix). Each image is used to create a container running that component. |Zabbix component|Docker image| |--|--------| |Agent|[zabbix/zabbix-agent](https://hub.docker.com/r/zabbix/zabbix-agent/)| |Agent 2|[zabbix/zabbix-agent2](https://hub.docker.com/r/zabbix/zabbix-agent2)| |Server (MySQL)|[zabbix/zabbix-server-mysql](https://hub.docker.com/r/zabbix/zabbix-server-mysql/)| |Server (PostgreSQL)|[zabbix/zabbix-server-pgsql](https://hub.docker.com/r/zabbix/zabbix-server-pgsql/)| |Web interface (Apache + MySQL)|[zabbix/zabbix-web-apache-mysql](https://hub.docker.com/r/zabbix/zabbix-web-apache-mysql/)| |Web interface (Apache + PostgreSQL)|[zabbix/zabbix-web-apache-pgsql](https://hub.docker.com/r/zabbix/zabbix-web-apache-pgsql/)| |Web interface (Nginx + MySQL)|[zabbix/zabbix-web-nginx-mysql](https://hub.docker.com/r/zabbix/zabbix-web-nginx-mysql/)| |Web interface (Nginx + PostgreSQL)|[zabbix/zabbix-web-nginx-pgsql](https://hub.docker.com/r/zabbix/zabbix-web-nginx-pgsql/)| |Proxy (SQLite3)|[zabbix/zabbix-proxy-sqlite3](https://hub.docker.com/r/zabbix/zabbix-proxy-sqlite3/)| |Proxy (MySQL)|[zabbix/zabbix-proxy-mysql](https://hub.docker.com/r/zabbix/zabbix-proxy-mysql/)| |Java gateway|[zabbix/zabbix-java-gateway](https://hub.docker.com/r/zabbix/zabbix-java-gateway/)| |Web service|[zabbix/zabbix-web-service](https://hub.docker.com/r/zabbix/zabbix-web-service)| |SNMP traps|[zabbix/zabbix-snmptraps](https://hub.docker.com/r/zabbix/zabbix-snmptraps/)| ::: noteclassic To use [SNMP traps](/manual/config/items/itemtypes/snmptrap), the SNMP traps container must share a volume with the Zabbix server or proxy container (see [how to use this image](https://hub.docker.com/r/zabbix/zabbix-snmptraps#how-to-use-this-image) on Docker Hub and the [example](#deploy-zabbix-server-postgresql-with-snmp-traps) below). ::: All Zabbix component images on Docker Hub are based on the latest major versions of the [supported operating systems](#image-tags). These images are automatically rebuilt when the underlying OS images are updated. ### Pieejamie Docker attēli Zabbix nodrošina Docker attēlu katram Zabbix komponentam, un visi tie ir publicēti [Docker Hub](https://hub.docker.com/u/zabbix). Katrs attēls tiek izmantots, lai izveidotu konteineru, kurā darbojas attiecīgais komponents. |Zabbix komponents|Docker attēls| |--|--------| |Aģents|[zabbix/zabbix-agent](https://hub.docker.com/r/zabbix/zabbix-agent/)| |Aģents 2|[zabbix/zabbix-agent2](https://hub.docker.com/r/zabbix/zabbix-agent2)| |Serveris (MySQL)|[zabbix/zabbix-server-mysql](https://hub.docker.com/r/zabbix/zabbix-server-mysql/)| |Serveris (PostgreSQL)|[zabbix/zabbix-server-pgsql](https://hub.docker.com/r/zabbix/zabbix-server-pgsql/)| |Lietotāja saskarne (Apache + MySQL)|[zabbix/zabbix-web-apache-mysql](https://hub.docker.com/r/zabbix/zabbix-web-apache-mysql/)| |Lietotāja saskarne (Apache + PostgreSQL)|[zabbix/zabbix-web-apache-pgsql](https://hub.docker.com/r/zabbix/zabbix-web-apache-pgsql/)| |Lietotāja saskarne (Nginx + MySQL)|[zabbix/zabbix-web-nginx-mysql](https://hub.docker.com/r/zabbix/zabbix-web-nginx-mysql/)| |Lietotāja saskarne (Nginx + PostgreSQL)|[zabbix/zabbix-web-nginx-pgsql](https://hub.docker.com/r/zabbix/zabbix-web-nginx-pgsql/)| |Starpniekserveris (SQLite3)|[zabbix/zabbix-proxy-sqlite3](https://hub.docker.com/r/zabbix/zabbix-proxy-sqlite3/)| |Starpniekserveris (MySQL)|[zabbix/zabbix-proxy-mysql](https://hub.docker.com/r/zabbix/zabbix-proxy-mysql/)| |Java gateway|[zabbix/zabbix-java-gateway](https://hub.docker.com/r/zabbix/zabbix-java-gateway/)| |Web service|[zabbix/zabbix-web-service](https://hub.docker.com/r/zabbix/zabbix-web-service)| |SNMP traps|[zabbix/zabbix-snmptraps](https://hub.docker.com/r/zabbix/zabbix-snmptraps/)| ::: noteclassic Lai izmantotu [SNMP traps](/manual/config/items/itemtypes/snmptrap), SNMP traps konteineram ir jāizmanto kopīgs sējums ar Zabbix serveris vai starpniekserveris konteineru (skatiet [kā izmantot šo attēlu](https://hub.docker.com/r/zabbix/zabbix-snmptraps#how-to-use-this-image) Docker Hub un tālāk redzamo [piemēru](#deploy-zabbix-server-postgresql-with-snmp-traps)). ::: Visi Zabbix komponentu attēli Docker Hub ir balstīti uz jaunākajām galvenajām [atbalstīto operētājsistēmu](#image-tags) versijām. Šie attēli tiek automātiski pārbūvēti, kad tiek atjaunināti pamatā esošie OS attēli. ##### avg(/host/key,(sec|#num)<:time shift>) {#avg} The average value of an item within the defined evaluation period.<br> Supported value types: *Float*, *Integer*.<br> Supported [foreach functions](/manual/appendix/functions/aggregate/foreach): *avg_foreach*, *count_foreach*, *exists_foreach*, *last_foreach*, *max_foreach*, *min_foreach*, *sum_foreach*. Parameters: see [common parameters](#common-parameters). Time shift is useful when there is a need to compare the current average value with the average value some time ago. Examples: ```default avg(/host/key,1h) #the average value for the last hour until now avg(/host/key,1h:now-1d) #the average value for an hour from 25 hours ago to 24 hours ago from now avg(/host/key,#5) #the average value of the five latest values avg(/host/key,#5:now-1d) #the average value of the five latest values excluding the values received in the last 24 hours avg(/host/proc.num,5m)>300 #trigger if the average number of processes in the last 5 minutes has been above 300 ``` ##### avg(/host/key,(sec|#num)<:time shift>) {#avg} Vienuma vidējā vērtība noteiktajā novērtēšanas periodā.<br> Atbalstītie vērtību tipi: *Float*, *Integer*.<br> Atbalstītās [foreach funkcijas](/manual/appendix/functions/aggregate/foreach): *avg_foreach*, *count_foreach*, *exists_foreach*, *last_foreach*, *max_foreach*, *min_foreach*, *sum_foreach*. Parametri: skatiet [kopējos parametrus](#common-parameters). Laika nobīde ir noderīga, ja nepieciešams salīdzināt pašreizējo vidējo vērtību ar vidējo vērtību pirms kāda laika. Piemēri: ```default avg(/host/key,1h) #vidējā vērtība par pēdējo stundu līdz šim brīdim avg(/host/key,1h:now-1d) #vidējā vērtība par stundu no 25 stundām līdz 24 stundām pirms šī brīža avg(/host/key,#5) #pēdējo piecu vērtību vidējā vērtība avg(/host/key,#5:now-1d) #pēdējo piecu vērtību vidējā vērtība, izslēdzot vērtības, kas saņemtas pēdējo 24 stundu laikā avg(/host/proc.num,5m)>300 #trigeris, ja procesu vidējais skaits pēdējo 5 minūšu laikā ir bijis virs 300 ``` ##### avg(<value1>,<value2>,...) {#avg} The average value of the referenced item values. Parameter: - **valueX** - the value returned by another function that is working with item history. Example: avg(avg(/host/key,1h),avg(/host2/key2,1h)) ##### avg(<value1>,<value2>,...) {#avg} Atsauktā vienuma vērtību vidējā vērtība. Parametrs: - **valueX** - vērtība, ko atgriež cita funkcija, kas darbojas ar vienuma vēsturi. Piemērs: avg(avg(/host/key,1h),avg(/host2/key2,1h)) #### Axes The **Axes** tab allows to customize how axes are displayed:  | | | |--|--------| |*Left Y*|Mark this checkbox to make left Y-axis visible.<br>The checkbox may be disabled if unselected either in *Data set* or in *Overrides* tab.| |*Right Y*|Mark this checkbox to make right Y-axis visible.<br>The checkbox may be disabled if unselected either in *Data set* or in *Overrides* tab.| |*X-Axis*|Unmark this checkbox to hide X-axis (marked by default).| |*Min*|Set the minimum value of the corresponding axis.<br>Visible range minimum value of Y-axis is specified.| |*Max*|Set the maximum value of the corresponding axis.<br>Visible range maximum value of Y-axis is specified.| |*Units*|Choose the unit for the graph axis values from the dropdown.<br>If the *Auto* option is chosen, axis values are displayed using units of the first item of the corresponding axis.<br>*Static* option allows you to assign the corresponding axis' custom name. If the *Static* option is chosen and the *value* input field left blank the corresponding axis' name will only consist of a numeric value.| #### Asis Cilne **Asis** ļauj pielāgot, kā tiek attēlotas asis:  | | | |--|--------| |*Left Y*|Atzīmējiet šo izvēles rūtiņu, lai padarītu kreiso Y asi redzamu.<br>Izvēles rūtiņa var būt atspējota, ja tā nav atlasīta cilnē *Data set* vai *Overrides*.| |*Right Y*|Atzīmējiet šo izvēles rūtiņu, lai padarītu labo Y asi redzamu.<br>Izvēles rūtiņa var būt atspējota, ja tā nav atlasīta cilnē *Data set* vai *Overrides*.| |*X-Axis*|Noņemiet atzīmi šai izvēles rūtiņai, lai paslēptu X asi (pēc noklusējuma tā ir atzīmēta).| |*Min*|Iestatiet atbilstošās ass minimālo vērtību.<br>Tiek norādīta Y ass redzamā diapazona minimālā vērtība.| |*Max*|Iestatiet atbilstošās ass maksimālo vērtību.<br>Tiek norādīta Y ass redzamā diapazona maksimālā vērtība.| |*Units*|No nolaižamā saraksta izvēlieties grafika ass vērtību vienības.<br>Ja ir izvēlēta opcija *Auto*, ass vērtības tiek attēlotas, izmantojot atbilstošās ass pirmā vienuma vienības.<br>Opcija *Static* ļauj piešķirt atbilstošajai asij pielāgotu nosaukumu. Ja ir izvēlēta opcija *Static* un lauks *value* ir atstāts tukšs, atbilstošās ass nosaukums sastāvēs tikai no skaitliskas vērtības.| #### Axes The following parameters are supported for configuring *Axes*. |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Left Y*|0|lefty|0 - Disabled;<br>1 - *(default)* Enabled.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Y-axis* (in [*Data set*](#data-set) configuration) is set to "Left"| |*Right Y*|0|righty|0 - *(default)* Disabled;<br>1 - Enabled.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Y-axis* (in [*Data set*](#data-set) configuration) is set to "Right"| |*Min*|1|lefty_min|Any numeric value.<br><br>Default: `""` (empty).| |^|^|righty_min|^| |*Max*|1|lefty_max|Any numeric value.<br><br>Default: `""` (empty).| |^|^|righty_max|^| |*Units* (type)|0|lefty_units|0 - *(default)* Auto;<br>1 - Static.| |^|^|righty_units|^| |*Units* (value)|1|lefty_static_units|Any string value.<br><br>Default: `""` (empty).| |^|^|righty_static_units|^| |*X-Axis*|0|xaxis|0 - Disabled;<br>1 - *(default)* Enabled.| #### Asis Tālāk norādītie parametri tiek atbalstīti *Asis* konfigurēšanai. |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Left Y*|0|lefty|0 - Atspējots;<br>1 - *(noklusējums)* Iespējots.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja *Y-axis* (konfigurācijā [*Data set*](#data-set)) ir iestatīts uz "Left"| |*Right Y*|0|righty|0 - *(noklusējums)* Atspējots;<br>1 - Iespējots.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja *Y-axis* (konfigurācijā [*Data set*](#data-set)) ir iestatīts uz "Right"| |*Min*|1|lefty_min|Jebkura skaitliska vērtība.<br><br>Noklusējums: `""` (tukšs).| |^|^|righty_min|^| |*Max*|1|lefty_max|Jebkura skaitliska vērtība.<br><br>Noklusējums: `""` (tukšs).| |^|^|righty_max|^| |*Units* (type)|0|lefty_units|0 - *(noklusējums)* Automātiski;<br>1 - Statiskas.| |^|^|righty_units|^| |*Units* (value)|1|lefty_static_units|Jebkura teksta vērtība.<br><br>Noklusējums: `""` (tukšs).| |^|^|righty_static_units|^| |*X-Axis*|0|xaxis|0 - Atspējots;<br>1 - *(noklusējums)* Iespējots.| ## Backups tab The *Backups* tab lets you view, create, restore, and delete backups of your Zabbix node. You can restore your instance from any saved backup or create a new manual backup at any time. The tab also shows the date of the next scheduled backup. {width="600"} To create a backup: 1. Click *Create backup* button. 2. Enter an optional description in the popup window. 3. Click *Create* to confirm. ::: notewarning Additional backups are charged monthly based on storage usage. ::: ## Dublējumu cilne Cilne *Dublējumi* ļauj skatīt, izveidot, atjaunot un dzēst jūsu Zabbix mezgla dublējumus. Jūs varat atjaunot savu instanci no jebkura saglabāta dublējuma vai jebkurā laikā izveidot jaunu manuālu dublējumu. Cilnē tiek parādīts arī nākamā ieplānotā dublējuma datums. {width="600"} Lai izveidotu dublējumu: 1. Noklikšķiniet uz pogas *Izveidot dublējumu*. 2. Uznirstošajā logā ievadiet neobligātu aprakstu. 3. Noklikšķiniet uz *Izveidot*, lai apstiprinātu. ::: notewarning Par papildu dublējumiem tiek piemērota ikmēneša maksa atbilstoši izmantotajai krātuves vietai. ::: ## Backward incompatible changes ## Atpakaļ nesaderīgas izmaiņas ::: banner{.banner-cloud-top} # Zabbix Cloud Discover the available configuration options and access controls for organizations and nodes in Zabbix Cloud. ::: ::: banner{.banner-cloud-top} # Zabbix Cloud Atklājiet pieejamās konfigurācijas opcijas un piekļuves kontroles organizācijām un mezgliem Zabbix Cloud. ::: ::: banner{.banner-dev-center-top} # Developer center Start developing custom extensions for Zabbix with guidance on modules, widgets, and plugins. ::: ::: banner{.banner-dev-center-top} # Izstrādātāju centrs Sāciet izstrādāt pielāgotus Zabbix paplašinājumus, izmantojot norādes par moduļiem, logrīkiem un spraudņiem. ::: ::: banner{.banner-main-top} # Welcome to Zabbix Documentation Your go-to resource for working with Zabbix monitoring, from basic setups to advanced configurations. This manual covers everything needed to install, configure, and operate Zabbix. [What's new in Zabbix 7.0](/manual/introduction/whatsnew700){.button} ::: ::: banner{.banner-main-top} # Laipni lūdzam Zabbix dokumentācijā Jūsu galvenais resurss darbam ar Zabbix uzraudzību — no pamata iestatījumiem līdz papildu konfigurācijām. Šajā rokasgrāmatā ir aprakstīts viss, kas nepieciešams, lai instalētu, konfigurētu un lietotu Zabbix. [Kas jauns Zabbix 7.0](/manual/introduction/whatsnew700){.button} ::: ##### baselinedev(/host/key,data period:time shift,season unit,num seasons) {#baselinedev} Returns the number of deviations (by stddevpop algorithm) between the last data period and the same data periods in preceding seasons.<br> Parameters: - See [common parameters](#common-parameters)<br> - **data period** - the data gathering period within a season, defined as <N><time unit> where:<br>`N` - the number of time units<br>`time unit` - h (hour), d (day), w (week), M (month) or y (year), must be equal to or less than season<br> - **season unit** - the calendar unit that defines one season (h, d, w, M, y); cannot be smaller than data period<br> - **num seasons** - the number of seasons to evaluate Examples: ```default baselinedev(/host/key,1d:now/d,"M",6) #calculating the number of standard deviations (population) between the previous day and the same day in the previous 6 months. If the date doesn't exist in a previous month, the last day of the month will be used (Jul,31 will be analysed against Jan,31, Feb, 28,... June, 30) baselinedev(/host/key,1h:now/h,"d",10) #calculating the number of population standard deviations between the previous hour and the same hour-of-day across the 10 preceding days ``` ##### baselinedev(/host/key,data period:time shift,season unit,num seasons) {#baselinedev} Atgriež noviržu skaitu (pēc stddevpop algoritma) starp pēdējo datu periodu un tiem pašiem datu periodiem iepriekšējās sezonās.<br> Parametri: - Skatiet [kopīgos parametrus](#common-parameters)<br> - **data period** - datu apkopošanas periods sezonas ietvaros, definēts kā <N><time unit>, kur:<br>`N` - laika vienību skaits<br>`time unit` - h (stunda), d (diena), w (nedēļa), M (mēnesis) vai y (gads), jābūt vienādam ar sezonu vai mazākam par to<br> - **season unit** - kalendārā vienība, kas definē vienu sezonu (h, d, w, M, y); nevar būt mazāka par data period<br> - **num seasons** - novērtējamo sezonu skaits Piemēri: ```default baselinedev(/host/key,1d:now/d,"M",6) #aprēķina populācijas standartnoviržu skaitu starp iepriekšējo dienu un to pašu dienu iepriekšējos 6 mēnešos. Ja datums iepriekšējā mēnesī nepastāv, tiks izmantota mēneša pēdējā diena (31. jūlijs tiks analizēts attiecībā pret 31. janvāri, 28. februāri, ... 30. jūniju) baselinedev(/host/key,1h:now/h,"d",10) #aprēķina populācijas standartnoviržu skaitu starp iepriekšējo stundu un to pašu diennakts stundu 10 iepriekšējās dienās ``` ##### baselinewma(/host/key,data period:time shift,season unit,num seasons) {#baselinewma} Calculates the baseline by averaging data from the same timeframe in multiple equal time periods ('seasons') using the weighted moving average algorithm.<br> Parameters: - See [common parameters](#common-parameters)<br> - **data period** - the data gathering period within a season, defined as <N><time unit> where:<br>`N` - the number of time units<br>`time unit` - h (hour), d (day), w (week), M (month) or y (year), must be equal to or less than season<br>Time shift - the time period offset, defines the end of data gathering time frame in seasons (see examples)<br> - **season unit** - the calendar unit that defines one season (h, d, w, M, y); cannot be smaller than data period<br> - **num seasons** - the number of seasons to evaluate Examples: ```default baselinewma(/host/key,1h:now/h,"d",3) #calculating the baseline from the same hour-of-day across the last 3 full days ending yesterday. If "now" is Monday 13:30, the data for 12:00-12:59 on Friday, Saturday, and Sunday will be analyzed baselinewma(/host/key,2h:now/h,"d",3) #calculating the baseline from the same two-hour timeframe across the last 3 full days ending yesterday. If "now" is Monday 13:30, the data for 11:00-12:59 on Friday, Saturday, and Sunday will be analyzed baselinewma(/host/key,1d:now/d,"M",4) #calculating the baseline from the same day-of-month as 'yesterday' across the 4 months preceding the last full month. If the required date doesn't exist, the last day of month is taken. If today is September 1st, the data for July 31st, June 30th, May 31st, April 30th will be analyzed. ``` ##### baselinewma(/host/key,data period:time shift,season unit,num seasons) {#baselinewma} Aprēķina bāzlīniju, vidējojot datus no viena un tā paša laika intervāla vairākos vienādos laika periodos ("sezonās"), izmantojot svērto slīdošā vidējā algoritmu.<br> Parametri: - Skatiet [kopīgos parametrus](#common-parameters)<br> - **data period** - datu apkopošanas periods sezonas ietvaros, definēts kā <N><time unit>, kur:<br>`N` - laika vienību skaits<br>`time unit` - h (stunda), d (diena), w (nedēļa), M (mēnesis) vai y (gads), jābūt vienādam ar sezonu vai mazākam par to<br>Time shift - laika perioda nobīde, nosaka datu apkopošanas laika intervāla beigas sezonās (skatiet piemērus)<br> - **season unit** - kalendārā vienība, kas definē vienu sezonu (h, d, w, M, y); nevar būt mazāka par data period<br> - **num seasons** - novērtējamo sezonu skaits Piemēri: ```default baselinewma(/host/key,1h:now/h,"d",3) #bāzlīnijas aprēķināšana no tās pašas diennakts stundas pēdējās 3 pilnajās dienās, kas beidzas vakar. Ja "now" ir pirmdiena 13:30, tiks analizēti dati par 12:00-12:59 piektdienā, sestdienā un svētdienā baselinewma(/host/key,2h:now/h,"d",3) #bāzlīnijas aprēķināšana no tā paša divu stundu intervāla pēdējās 3 pilnajās dienās, kas beidzas vakar. Ja "now" ir pirmdiena 13:30, tiks analizēti dati par 11:00-12:59 piektdienā, sestdienā un svētdienā baselinewma(/host/key,1d:now/d,"M",4) #bāzlīnijas aprēķināšana no tās pašas mēneša dienas kā "vakar" 4 mēnešos pirms pēdējā pilnā mēneša. Ja nepieciešamais datums neeksistē, tiek izmantota mēneša pēdējā diena. Ja šodien ir 1. septembris, tiks analizēti dati par 31. jūliju, 30. jūniju, 31. maiju un 30. aprīli. ``` # Basic configuration These guides introduce basic elements of Zabbix configuration: - [Login and configuring user](/manual/quickstart/basic_config/login) - [New host](/manual/quickstart/basic_config/host) - [New item](/manual/quickstart/basic_config/item) - [New trigger](/manual/quickstart/basic_config/trigger) - [Receiving problem notification](/manual/quickstart/basic_config/notification) - [New template](/manual/quickstart/basic_config/template) # Pamata konfigurācija Šīs rokasgrāmatas iepazīstina ar Zabbix konfigurācijas pamatelementiem: - [Pieteikšanās un lietotāja konfigurēšana](/manual/quickstart/basic_config/login) - [Jauns hosts](/manual/quickstart/basic_config/host) - [Jauns vienums](/manual/quickstart/basic_config/item) - [Jauns trigeris](/manual/quickstart/basic_config/trigger) - [Problēmas paziņojuma saņemšana](/manual/quickstart/basic_config/notification) - [Jauna veidne](/manual/quickstart/basic_config/template) #### Batch migration of history tables * Prepare directories for Data Pump. Data Pump must have read and write permissions to these directories. Example: ```bash mkdir -pv /export/history chown -R oracle:oracle /export ``` * Create a directory object and grant read and write permissions to this object to the user used for Zabbix authentication ('zabbix' in the example below). Under *sysdba* role, run: ```sql create directory history as '/export/history'; grant read,write on directory history to zabbix; ``` * Export tables. Replace N with the desired thread count. ```bash expdp zabbix/password@oracle_host/service \ DIRECTORY=history \ TABLES=history_old,history_uint_old,history_str_old,history_log_old,history_text_old \ PARALLEL=N ``` * Import tables. Replace N with the desired thread count. ```bash impdp zabbix/password@oracle_host/service \ DIRECTORY=history \ TABLES=history_uint_old \ REMAP_TABLE=history_old:history,history_uint_old:history_uint,history_str_old:history_str,history_log_old:history_log,history_text_old:history_text \ data_options=SKIP_CONSTRAINT_ERRORS table_exists_action=APPEND PARALLEL=N CONTENT=data_only ``` * Follow [post-migration instructions](#postmigration) to drop the old tables. #### Vēstures tabulu pakešmigrācija * Sagatavojiet direktorijus Data Pump. Data Pump šiem direktorijiem ir jābūt lasīšanas un rakstīšanas tiesībām. Piemērs: ```bash mkdir -pv /export/history chown -R oracle:oracle /export ``` * Izveidojiet direktorijas objektu un piešķiriet šim objektam lasīšanas un rakstīšanas tiesības lietotājam, kas tiek izmantots Zabbix autentifikācijai (piemērā zemāk - 'zabbix'). Ar *sysdba* lomu izpildiet: ```sql create directory history as '/export/history'; grant read,write on directory history to zabbix; ``` * Eksportējiet tabulas. Aizstājiet N ar vēlamo pavedienu skaitu. ```bash expdp zabbix/password@oracle_host/service \ DIRECTORY=history \ TABLES=history_old,history_uint_old,history_str_old,history_log_old,history_text_old \ PARALLEL=N ``` * Importējiet tabulas. Aizstājiet N ar vēlamo pavedienu skaitu. ```bash impdp zabbix/password@oracle_host/service \ DIRECTORY=history \ TABLES=history_uint_old \ REMAP_TABLE=history_old:history,history_uint_old:history_uint,history_str_old:history_str,history_log_old:history_log,history_text_old:history_text \ data_options=SKIP_CONSTRAINT_ERRORS table_exists_action=APPEND PARALLEL=N CONTENT=data_only ``` * Lai dzēstu vecās tabulas, izpildiet [pēc migrācijas norādījumus](#postmigration). #### Behavior depending on availability The following table illustrates how each function behaves in cases of limited availability of host/item and history data. |Function|Disabled host|Unavailable host with data|Unavailable host without data|Disabled item|Unsupported item|Data retrieval error (SQL)| |--|--|--|--|--|--|--| |*avg_foreach*|ignore|return avg|ignore|ignore|ignore|ignore| |*bucket_rate_foreach*|ignore|return bucket rate|ignore|ignore|ignore|ignore| |*count_foreach*|ignore|return count|0|ignore|ignore|ignore| |*exists_foreach*|ignore|1|1|ignore|1|n/a| |*last_foreach*|ignore|return last|ignore|ignore|ignore|ignore| |*max_foreach*|ignore|return max|ignore|ignore|ignore|ignore| |*min_foreach*|ignore|return min|ignore|ignore|ignore|ignore| |*sum_foreach*|ignore|return sum|ignore|ignore|ignore|ignore| If the item is *ignored*, nothing is added to the aggregation. #### Darbība atkarībā no pieejamības Tālāk esošā tabula parāda, kā katra funkcija darbojas ierobežotas hosta/vienuma un vēstures datu pieejamības gadījumos. |Function|Disabled host|Unavailable host with data|Unavailable host without data|Disabled item|Unsupported item|Data retrieval error (SQL)| |--|--|--|--|--|--|--| |*avg_foreach*|ignorēt|atgriezt vidējo|ignorēt|ignorēt|ignorēt|ignorēt| |*bucket_rate_foreach*|ignorēt|atgriezt bucket rate|ignorēt|ignorēt|ignorēt|ignorēt| |*count_foreach*|ignorēt|atgriezt skaitu|0|ignorēt|ignorēt|ignorēt| |*exists_foreach*|ignorēt|1|1|ignorēt|1|n/a| |*last_foreach*|ignorēt|atgriezt pēdējo vērtību|ignorēt|ignorēt|ignorēt|ignorēt| |*max_foreach*|ignorēt|atgriezt maksimumu|ignorēt|ignorēt|ignorēt|ignorēt| |*min_foreach*|ignorēt|atgriezt minimumu|ignorēt|ignorēt|ignorēt|ignorēt| |*sum_foreach*|ignorēt|atgriezt summu|ignorēt|ignorēt|ignorēt|ignorēt| Ja vienums tiek *ignorēts*, agregācijai nekas netiek pievienots. #### Better usability for preprocessing step mass update The previous design of the item mass update form was not sufficiently clear if the preprocessing step update would add or replace preprocessing steps. In the new design *Replace* and *Remove all* radio buttons have been added, making it clear for users what to expect as the result of preprocessing step [mass update](/manual/config/items/itemupdate):  #### Labāka lietojamība priekšapstrādes soļa masveida atjaunināšanai Iepriekšējais vienumu masveida atjaunināšanas formas dizains nebija pietiekami skaidrs, vai priekšapstrādes soļa atjaunināšana pievienos vai aizstās priekšapstrādes soļus. Jaunajā dizainā ir pievienotas radio pogas *Replace* un *Remove all*, kas lietotājiem skaidri parāda, ko sagaidīt kā priekšapstrādes soļa [masveida atjaunināšanas](/manual/config/items/itemupdate) rezultātu:  ##### between(value,min,max) {#between} Check if the value belongs to the given range.<br> Supported value types: *Integer*, *Float*.<br> Returns: 1 - in range; 0 - otherwise. Parameters: - **value** - the value to check;<br> - **min** - the minimum value;<br> - **max** - the maximum value. Example: between(last(/host/key),1,10)=1 #trigger if the value is between 1 and 10 ##### between(value,min,max) {#between} Pārbauda, vai vērtība ietilpst norādītajā diapazonā.<br> Atbalstītie vērtību tipi: *Integer*, *Float*.<br> Atgriež: 1 - diapazonā; 0 - pretējā gadījumā. Parametri: - **value** - pārbaudāmā vērtība;<br> - **min** - minimālā vērtība;<br> - **max** - maksimālā vērtība. Piemērs: between(last(/host/key),1,10)=1 #trigeris, ja vērtība ir no 1 līdz 10 #### Binary data history converted to hypertable on TimescaleDB The `history_bin` table has been converted to hypertable on TimescaleDB to benefit from automatic partitioning on time (1 day by default) and better performance. To successfully upgrade existing installations, see [Upgrading TimescaleDB schema](/manual/appendix/install/timescaledb#upgrading-timescaledb-schema). See also: [Supported TimescaleDB versions](/manual/installation/requirements#thirdparty-external-surrounding-software) #### Bināro datu vēsture pārveidota par hypertable TimescaleDB Tabula `history_bin` ir pārveidota par hypertable programmā TimescaleDB, lai izmantotu automātisku sadalīšanu pa laiku (pēc noklusējuma 1 diena) un uzlabotu veiktspēju. Lai veiksmīgi atjauninātu esošās instalācijas, skatiet [TimescaleDB shēmas jaunināšana](/manual/appendix/install/timescaledb#upgrading-timescaledb-schema). Skatiet arī: [Atbalstītās TimescaleDB versijas](/manual/installation/requirements#thirdparty-external-surrounding-software) #### Binary data history converted to hypertable on TimescaleDB The `history_bin` table has been converted to hypertable on TimescaleDB to benefit from automatic partitioning on time (1 day by default) and better performance. To successfully upgrade existing installations, see [Upgrading TimescaleDB schema](/manual/appendix/install/timescaledb#upgrading-timescaledb-schema). See also: [Supported TimescaleDB versions](/manual/installation/requirements#thirdparty-external-surrounding-software) #### Bināro datu vēsture pārveidota par hypertable TimescaleDB Tabula `history_bin` ir pārveidota par hypertable TimescaleDB, lai izmantotu automātisku sadalīšanu pa laiku (pēc noklusējuma 1 diena) un labāku veiktspēju. Lai veiksmīgi jauninātu esošās instalācijas, skatiet [TimescaleDB shēmas jaunināšana](/manual/appendix/install/timescaledb#upgrading-timescaledb-schema). Skatiet arī: [Atbalstītās TimescaleDB versijas](/manual/installation/requirements#thirdparty-external-surrounding-software) ### Binary history The binary history object has the following properties. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |clock|timestamp|Time when that value was received.| |itemid|ID|ID of the related item.| |ns|integer|Nanoseconds when the value was received.| |value|text|Received value.| ### Binārā vēsture Binārās vēstures objektam ir šādas īpašības. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |clock|timestamp|Laiks, kad šī vērtība tika saņemta.| |itemid|ID|Saistītā vienuma ID.| |ns|integer|Nanosekundes, kad vērtība tika saņemta.| |value|text|Saņemtā vērtība.| #### Binary item selection for export Binary item selection is now supported when configuring a [connector](/manual/config/export/streaming#configuration). #### Binārā vienuma atlase eksportam Binārā vienuma atlase tagad tiek atbalstīta, konfigurējot [savienotāju](/manual/config/export/streaming#configuration). ##### bitand(value,mask) {#bitand} The value of "bitwise AND" of an item value and mask.<br> Supported value types: *Integer*. Parameters: - **value** - the value to check; - **mask** (mandatory) - a 64-bit unsigned integer (0 - 18446744073709551615). Although the comparison is done in a bitwise manner, all the values must be supplied and are returned in decimal. For example, checking for the 3rd bit is done by comparing to 4, not 100. Examples: bitand(last(/host/key),12)=8 or bitand(last(/host/key),12)=4 #3rd or 4th bit set, but not both at the same time bitand(last(/host/key),20)=16 #3rd bit not set and 5th bit set ##### bitand(value,mask) {#bitand} "Bitu UN" vērtība starp vienuma vērtību un masku.<br> Atbalstītie vērtību tipi: *Integer*. Parametri: - **value** - pārbaudāmā vērtība; - **mask** (obligāts) - 64 bitu neparakstīts vesels skaitlis (0 - 18446744073709551615). Lai gan salīdzināšana tiek veikta bitu līmenī, visas vērtības ir jānorāda un tiek atgrieztas decimālajā formātā. Piemēram, 3. bita pārbaude tiek veikta, salīdzinot ar 4, nevis 100. Piemēri: bitand(last(/host/key),12)=8 or bitand(last(/host/key),12)=4 #3. vai 4. bits ir iestatīts, bet ne abi vienlaikus bitand(last(/host/key),20)=16 #3. bits nav iestatīts un 5. bits ir iestatīts ##### bitlength(value) {#bitlength} The length of value in bits.<br> Supported value types: *String*, *Text*, *Log*, *Integer*. Parameter: - **value** - the value to check Example: bitlength(last(/host/key)) ##### bitlength(value) {#bitlength} Vērtības garums bitos.<br> Atbalstītie vērtību tipi: *String*, *Text*, *Log*, *Integer*. Parametrs: - **value** - pārbaudāmā vērtība Piemērs: bitlength(last(/host/key)) ##### bitlshift(value,bits to shift) {#bitlshift} The bitwise shift left of an item value.<br> Supported value types: *Integer*. Parameters: - **value** - the value to check; - **bits to shift** (mandatory) - the number of bits to shift. Although the comparison is done in a bitwise manner, all the values must be supplied and are returned in decimal. For example, checking for the 3rd bit is done by comparing to 4, not 100. ##### bitlshift(value,bits to shift) {#bitlshift} Vienuma vērtības bitu nobīde pa kreisi.<br> Atbalstītie vērtību tipi: *Integer*. Parametri: - **value** - pārbaudāmā vērtība; - **bits to shift** (obligāts) - nobīdāmo bitu skaits. Lai gan salīdzināšana tiek veikta bitu līmenī, visas vērtības ir jānorāda un tiek atgrieztas decimālajā formātā. Piemēram, 3. bita pārbaude tiek veikta, salīdzinot ar 4, nevis 100. ##### bitnot(value) {#bitnot} The value of "bitwise NOT" of an item value.<br> Supported value types: *Integer*. Parameter: - **value** - the value to check. Although the comparison is done in a bitwise manner, all the values must be supplied and are returned in decimal. For example, checking for the 3rd bit is done by comparing to 4, not 100. ##### bitnot(value) {#bitnot} Vienuma vērtības "bitu loģiskā NOT" vērtība.<br> Atbalstītie vērtību tipi: *Integer*. Parametrs: - **value** - pārbaudāmā vērtība. Lai gan salīdzināšana tiek veikta bitu līmenī, visas vērtības ir jānorāda un tiek atgrieztas decimālajā formātā. Piemēram, 3. bita pārbaude tiek veikta, salīdzinot ar 4, nevis 100. ##### bitor(value,mask) {#bitor} The value of "bitwise OR" of an item value and mask.<br> Supported value types: *Integer*. Parameters: - **value** - the value to check; - **mask** (mandatory) - a 64-bit unsigned integer (0 - 18446744073709551615). Although the comparison is done in a bitwise manner, all the values must be supplied and are returned in decimal. For example, checking for the 3rd bit is done by comparing to 4, not 100. ##### bitor(value,mask) {#bitor} Vienuma vērtības un maskas "bitu VAI" vērtība.<br> Atbalstītie vērtību tipi: *Integer*. Parametri: - **value** - pārbaudāmā vērtība; - **mask** (obligāts) - 64 bitu bezzīmes vesels skaitlis (0 - 18446744073709551615). Lai gan salīdzināšana tiek veikta bitu līmenī, visas vērtības ir jānorāda un tiek atgrieztas decimālajā formātā. Piemēram, 3. bita pārbaude tiek veikta, salīdzinot ar 4, nevis 100. ##### bitrshift(value,bits to shift) {#bitrshift} The bitwise shift right of an item value.<br> Supported value types: *Integer*. Parameters: - **value** - the value to check; - **bits to shift** (mandatory) - the number of bits to shift. Although the comparison is done in a bitwise manner, all the values must be supplied and are returned in decimal. For example, checking for the 3rd bit is done by comparing to 4, not 100. ##### bitrshift(value,bits to shift) {#bitrshift} Vienuma vērtības bitu nobīde pa labi.<br> Atbalstītie vērtību tipi: *Integer*. Parametri: - **value** - pārbaudāmā vērtība; - **bits to shift** (obligāts) - pārbīdāmo bitu skaits. Lai gan salīdzināšana tiek veikta bitu līmenī, visas vērtības ir jānorāda un tiek atgrieztas decimālajā formātā. Piemēram, 3. bita pārbaude tiek veikta, salīdzinot ar 4, nevis 100. ##### bitxor(value,mask) {#bitxor} The value of "bitwise exclusive OR" of an item value and mask.<br> Supported value types: *Integer*. Parameters: - **value** - the value to check; - **mask** (mandatory) - a 64-bit unsigned integer (0 - 18446744073709551615). Although the comparison is done in a bitwise manner, all the values must be supplied and are returned in decimal. For example, checking for the 3rd bit is done by comparing to 4, not 100. ##### bitxor(value,mask) {#bitxor} Vienuma vērtības un maskas "bitu izslēdzošais VAI" vērtība.<br> Atbalstītie vērtību tipi: *Integer*. Parametri: - **value** - pārbaudāmā vērtība; - **mask** (obligāts) - 64 bitu vesels skaitlis bez zīmes (0 - 18446744073709551615). Lai gan salīdzināšana tiek veikta bitu līmenī, visas vērtības ir jānorāda un tiek atgrieztas decimālajā formā. Piemēram, 3. bita pārbaude tiek veikta, salīdzinot ar 4, nevis 100. ##### Boolean to decimal {#boolean} Convert the value from boolean format to decimal. Comments: - The textual representation is translated into either 0 or 1. Thus, 'TRUE' is stored as 1 and 'FALSE' is stored as 0. All values are matched in a case-insensitive way. Currently recognized values are, for *TRUE* - true, t, yes, y, on, up, running, enabled, available, ok, master; for *FALSE* - false, f, no, n, off, down, unused, disabled, unavailable, err, slave. Additionally, any non-zero numeric value is considered to be TRUE and zero is considered to be FALSE.<br> - If you mark the *Custom on fail* checkbox, it is possible to specify custom error-handling options: either to discard the value, set a specified value, or set a specified error message. In case of a failed preprocessing step, the item will not become unsupported if the option to discard the value or set a specified value is selected. ##### Būla vērtības pārveidošana decimālskaitlī {#boolean} Pārveido vērtību no būla formāta uz decimālskaitli. Komentāri: - Tekstuālais attēlojums tiek pārveidots par 0 vai 1. Tādējādi 'TRUE' tiek saglabāts kā 1 un 'FALSE' tiek saglabāts kā 0. Visas vērtības tiek salīdzinātas, neņemot vērā burtu reģistru. Pašlaik atpazītās vērtības ir šādas: *TRUE* — true, t, yes, y, on, up, running, enabled, available, ok, master; *FALSE* — false, f, no, n, off, down, unused, disabled, unavailable, err, slave. Papildus tam jebkura skaitliska vērtība, kas nav nulle, tiek uzskatīta par TRUE, bet nulle tiek uzskatīta par FALSE.<br> - Ja atzīmējat izvēles rūtiņu *Custom on fail*, ir iespējams norādīt pielāgotas kļūdu apstrādes opcijas: vai nu atmest vērtību, iestatīt norādītu vērtību vai iestatīt norādītu kļūdas ziņojumu. Ja priekšapstrādes solis neizdodas, vienums nekļūs neatbalstīts, ja ir atlasīta opcija atmest vērtību vai iestatīt norādītu vērtību. ## Breaking changes ## Būtiskas izmaiņas ## Breaking changes ## Būtiskas izmaiņas ## Breaking changes ## Būtiskas izmaiņas ## Breaking changes ## Būtiskas izmaiņas ## Breaking changes ## Būtiskas izmaiņas ## Breaking changes ## Būtiskas izmaiņas ## Breaking changes ## Būtiskas izmaiņas ## Breaking changes ## Būtiskas izmaiņas ## Breaking changes ## Būtiskas izmaiņas #### Broken LLD rule overrides in 7.0.7 In version 7.0.7, Zabbix server crashes upon processing low-level discovery rule [overrides](/manual/discovery/low_level_discovery#override). As a workaround, disable LLD rules containing overrides. The issue has been fixed in Zabbix 7.0.8rc2. #### Bojāti LLD noteikumu pārraksti versijā 7.0.7 Versijā 7.0.7 Zabbix serveris avarē, apstrādājot zema līmeņa atklāšanas noteikuma [pārrakstus](/manual/discovery/low_level_discovery#override). Kā pagaidu risinājumu atspējojiet LLD noteikumus, kuros ir pārraksti. Problēma ir novērsta Zabbix 7.0.8rc2. #### Browser items A new item type - [Browser item](/manual/config/items/itemtypes/browser) - has been added to Zabbix, enabling the monitoring of complex websites and web applications using a browser. Browser items allow the execution of user-defined JavaScript code to simulate browser-related actions such as clicking, entering text, navigating through web pages, etc. Additionally, this feature adds the following changes: - [Website by Browser](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/website_browser) template has been added to [templates out of the box](/manual/config/templates_out_of_the_box); - ITEM\_TYPE\_BROWSER (22) item type has been added to [template](/manual/xml_export_import/templates) or [host](/manual/xml_export_import/hosts) item, low-level discovery rule, and item prototype configuration export/import; - `StartBrowserPollers` and `WebDriverURL` Zabbix [server](/manual/appendix/config/zabbix_server#webdriverurl)/[proxy](/manual/appendix/config/zabbix_proxy#webdriverurl) configuration file parameters have been added; - Browser item timeout has been added to [proxy](/manual/distributed_monitoring/proxies#configuration) timeouts or [global](/manual/web_interface/frontend_sections/administration/general#timeouts) timeouts (if a proxy is not used); - `-w <webdriver url>` command-line parameter for enabling browser monitoring has been added to the [`zabbix_js` command-line utility](/manual/concepts/js). #### Pārlūkprogrammas vienumi Zabbix ir pievienots jauns vienuma tips - [Browser item](/manual/config/items/itemtypes/browser) -, kas ļauj uzraudzīt sarežģītas vietnes un tīmekļa lietotnes, izmantojot pārlūkprogrammu. Pārlūkprogrammas vienumi ļauj izpildīt lietotāja definētu JavaScript kodu, lai simulētu ar pārlūkprogrammu saistītas darbības, piemēram, klikšķināšanu, teksta ievadīšanu, pārvietošanos pa tīmekļa lapām utt. Turklāt šī funkcija pievieno šādas izmaiņas: - [Website by Browser](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/website_browser) veidne ir pievienota [standarta veidnēm](/manual/config/templates_out_of_the_box); - ITEM\_TYPE\_BROWSER (22) vienuma tips ir pievienots [veidnes](/manual/xml_export_import/templates) vai [hosta](/manual/xml_export_import/hosts) vienuma, zemā līmeņa atklāšanas noteikuma un vienuma prototipa konfigurācijas eksportam/importam; - Zabbix [serveris](/manual/appendix/config/zabbix_server#webdriverurl)/[starpniekserveris](/manual/appendix/config/zabbix_proxy#webdriverurl) konfigurācijas faila parametri `StartBrowserPollers` un `WebDriverURL` ir pievienoti; - Pārlūkprogrammas vienuma noildze ir pievienota [starpniekservera](/manual/distributed_monitoring/proxies#configuration) noildzēm vai [globālajām](/manual/web_interface/frontend_sections/administration/general#timeouts) noildzēm, ja starpniekserveris netiek izmantots; - `-w <webdriver url>` komandrindas parametrs pārlūkprogrammas uzraudzības iespējošanai ir pievienots [`zabbix_js` komandrindas utilītai](/manual/concepts/js). #### Browser monitoring A new item type - [Browser item](/manual/config/items/itemtypes/browser) - has been added to Zabbix, enabling the monitoring of complex websites and web applications using a browser. Browser items allow the execution of user-defined JavaScript code to simulate browser-related actions such as clicking, entering text, navigating through web pages, etc. This item collects data over HTTP/HTTPS and partially implements the W3C WebDriver standard with Selenium Server or a plain WebDriver (for example, ChromeDriver) as a testing endpoint. Note that the support of Browser items is currently experimental. Additionally, this feature adds the *Website by Browser* template and new elements to configuration export/import, Zabbix server/proxy configuration files, timeouts, and the `zabbix_js` command-line utility. For more information, see [Upgrade notes to 7.0.0](/manual/installation/upgrade_notes_700#browser-items). #### Pārlūkprogrammas monitorings Zabbix ir pievienots jauns vienuma tips - [Pārlūkprogrammas vienums](/manual/config/items/itemtypes/browser) -, kas ļauj monitorēt sarežģītas vietnes un tīmekļa lietotnes, izmantojot pārlūkprogrammu. Pārlūkprogrammas vienumi ļauj izpildīt lietotāja definētu JavaScript kodu, lai simulētu ar pārlūkprogrammu saistītas darbības, piemēram, klikšķināšanu, teksta ievadi, navigāciju pa tīmekļa lapām utt. Šis vienums apkopo datus, izmantojot HTTP/HTTPS, un daļēji ievieš W3C WebDriver standartu ar Selenium Server vai parastu WebDriver (piemēram, ChromeDriver) kā testēšanas galapunktu. Ņemiet vērā, ka Pārlūkprogrammas vienumu atbalsts pašlaik ir eksperimentāls. Turklāt šī funkcionalitāte pievieno veidni *Website by Browser* un jaunus elementus konfigurācijas eksportam/importam, Zabbix servera/starpniekservera konfigurācijas failiem, noildzēm un `zabbix_js` komandrindas utilītai. Plašāku informāciju skatiet [jaunināšanas piezīmēs uz 7.0.0](/manual/installation/upgrade_notes_700#browser-items). #### Browser The `Browser` object manages WebDriver sessions, initializing a session upon creation and terminating it upon destruction. A single script can support up to four `Browser` objects. To construct a `Browser` object, use the `new Browser(options)` syntax. The `options` (*JSON object*) parameter specifies browser options, usually the WebDriver options method result (for example, `Browser.chromeOptions()`). The following methods are supported with the `Browser` object. |Method|Description| |---|-------| |`navigate(url)`|Navigate to the specified URL.<br><br>Parameters:<br>`url` - (string) URL to navigate to.| |`getUrl()`|Return a string of the opened page URL.| |`getPageSource()`|Return a string of the opened page source.| |`findElement(strategy, selector)`|Return an [`Element`](#element) object with one element in the opened page (or return `null` if no elements match `strategy` and `selector`).<br><br>Parameters:<br>`strategy` - (string, css selector/link text/partial link text/tag name/xpath) [Location strategy](https://www.selenium.dev/documentation/webdriver/elements/locators/);<br>`selector` - (string) Element selector using the specified location strategy.| |`findElements(strategy, target)`|Return an array of [`Element`](#element) objects with multiple elements in the opened page (or return an empty array if no elements match location strategy and target).<br><br>Parameters:<br>`strategy` - (string, css selector/link text/partial link text/tag name/xpath) [Location strategy](https://www.selenium.dev/documentation/webdriver/elements/locators/);<br>`target` - (string) Element selector using the specified location strategy.| |`getCookies()`|Return an array of [`Cookie`](#cookie) objects.| |`addCookie(cookie)`|Set cookies.<br><br>Parameters:<br>`cookie` - ([`Cookie`](#cookie) object) Cookie to set.| |`getScreenshot()`|Return a Base64 encoded string representing an image of the browser's viewport.| |`setScreenSize(x,y)`|Set the browser's viewport size.<br><br>Parameters:<br>`x` - (string) Width in pixels;<br>`y` - (string) Height in pixels.| |`setScriptTimeout(timeout)`|Set script loading timeout.<br><br>Parameters:<br>`timeout` - (integer) Timeout value in milliseconds.| |`setSessionTimeout(timeout)`|Set session (page load) timeout.<br><br>Parameters:<br>`timeout` - (integer) Timeout value in milliseconds.| |`setElementWaitTimeout(timeout)`|Set element location strategy (implicit) timeout.<br><br>Parameters:<br>`timeout` - (integer) Timeout value in milliseconds.| |`collectPerfEntries(mark)`|Collect performance entries to retrieve with the `getResult()` method.<br><br>Parameters:<br>`mark` - (string, optional) Performance snapshot mark.| |`getRawPerfEntries()`|Return an array of performance entry objects.| |`getResult()`|Return a [`Result`](#result) object with browser session statistics (error information, performance snapshots, etc.).| |`getError()`|Return a `BrowserError` object with browser errors (or return `null` if there are no browser errors).| |`setError(message)`|Set a custom error message to be included in the [`Result`](#result) object.<br><br>Parameters:<br>`message` - (string) Error message.| |`discardError()`|Discard the error to be returned in the [`Result`](#result) object.| |`getAlert()`|Return an [`Alert`](#alert) object with browser alerts (or return `null` if there are no browser alerts).| |`chromeOptions()`|Return a `chromeOptions` object with predefined Chrome browser options.| |`firefoxOptions()`|Return a `firefoxOptions` object with predefined Firefox browser options.| |`safariOptions()`|Return a `safariOptions` object with predefined Safari browser options.| |`edgeOptions()`|Return an `edgeOptions` object with predefined Edge browser options.| |`switchFrame(target)`| Switch to the specified frame. Supported since version 7.0.4. <br><br>Parameters:<br>`target` - (browser element or integer, optional) Target frame. To select a frame by element, pass the element. To select a frame by index, pass the number. If left empty, will switch to the top-level browsing context. | All Browser methods can throw the following errors: - `BrowserError` - derived from the `Error` object that is thrown if the `Browser` constructor fails; contains an additional `browser` property with a `Browser` object that threw this `BrowserError`. - `WebdriverError` - derived from `BrowserError`; contains the same properties as the `BrowserError` object, which indicate if the error was generated in response to an error in the WebDriver response. #### Browser `Browser` objekts pārvalda WebDriver sesijas, inicializējot sesiju izveides brīdī un pārtraucot to iznīcināšanas brīdī. Viens skripts var atbalstīt līdz četriem `Browser` objektiem. Lai izveidotu `Browser` objektu, izmantojiet sintaksi `new Browser(options)`. Parametrs `options` (*JSON objekts*) norāda pārlūkprogrammas opcijas, parasti WebDriver opciju metodes rezultātu (piemēram, `Browser.chromeOptions()`). Ar `Browser` objektu ir pieejamas šādas metodes. |Method|Description| |---|-------| |`navigate(url)`|Pāriet uz norādīto URL.<br><br>Parameters:<br>`url` - (string) URL, uz kuru pāriet.| |`getUrl()`|Atgriež atvērtās lapas URL kā virkni.| |`getPageSource()`|Atgriež atvērtās lapas pirmkodu kā virkni.| |`findElement(strategy, selector)`|Atgriež [`Element`](#element) objektu ar vienu elementu atvērtajā lapā (vai atgriež `null`, ja neviens elements neatbilst `strategy` un `selector`).<br><br>Parameters:<br>`strategy` - (string, css selector/link text/partial link text/tag name/xpath) [Location strategy](https://www.selenium.dev/documentation/webdriver/elements/locators/);<br>`selector` - (string) Elementa atlasītājs, izmantojot norādīto atrašanās vietas stratēģiju.| |`findElements(strategy, target)`|Atgriež [`Element`](#element) objektu masīvu ar vairākiem elementiem atvērtajā lapā (vai atgriež tukšu masīvu, ja neviens elements neatbilst atrašanās vietas stratēģijai un mērķim).<br><br>Parameters:<br>`strategy` - (string, css selector/link text/partial link text/tag name/xpath) [Location strategy](https://www.selenium.dev/documentation/webdriver/elements/locators/);<br>`target` - (string) Elementa atlasītājs, izmantojot norādīto atrašanās vietas stratēģiju.| |`getCookies()`|Atgriež [`Cookie`](#cookie) objektu masīvu.| |`addCookie(cookie)`|Iestata sīkdatnes.<br><br>Parameters:<br>`cookie` - ([`Cookie`](#cookie) object) Iestatāmā sīkdatne.| |`getScreenshot()`|Atgriež Base64 kodētu virkni, kas attēlo pārlūkprogrammas skatpunkta attēlu.| |`setScreenSize(x,y)`|Iestata pārlūkprogrammas skatpunkta izmēru.<br><br>Parameters:<br>`x` - (string) Platums pikseļos;<br>`y` - (string) Augstums pikseļos.| |`setScriptTimeout(timeout)`|Iestata skripta ielādes noildzi.<br><br>Parameters:<br>`timeout` - (integer) Noildzes vērtība milisekundēs.| |`setSessionTimeout(timeout)`|Iestata sesijas (lapas ielādes) noildzi.<br><br>Parameters:<br>`timeout` - (integer) Noildzes vērtība milisekundēs.| |`setElementWaitTimeout(timeout)`|Iestata elementa atrašanas stratēģijas (netiešo) noildzi.<br><br>Parameters:<br>`timeout` - (integer) Noildzes vērtība milisekundēs.| |`collectPerfEntries(mark)`|Apkopo veiktspējas ierakstus, lai tos izgūtu ar metodi `getResult()`.<br><br>Parameters:<br>`mark` - (string, optional) Veiktspējas momentuzņēmuma atzīme.| |`getRawPerfEntries()`|Atgriež veiktspējas ierakstu objektu masīvu.| |`getResult()`|Atgriež [`Result`](#result) objektu ar pārlūkprogrammas sesijas statistiku (kļūdu informāciju, veiktspējas momentuzņēmumiem u. c.).| |`getError()`|Atgriež `BrowserError` objektu ar pārlūkprogrammas kļūdām (vai atgriež `null`, ja pārlūkprogrammas kļūdu nav).| |`setError(message)`|Iestata pielāgotu kļūdas ziņojumu, kas tiks iekļauts [`Result`](#result) objektā.<br><br>Parameters:<br>`message` - (string) Kļūdas ziņojums.| |`discardError()`|Atmet kļūdu, kas tiks atgriezta [`Result`](#result) objektā.| |`getAlert()`|Atgriež [`Alert`](#alert) objektu ar pārlūkprogrammas brīdinājumiem (vai atgriež `null`, ja pārlūkprogrammas brīdinājumu nav).| |`chromeOptions()`|Atgriež `chromeOptions` objektu ar iepriekš definētām Chrome pārlūkprogrammas opcijām.| |`firefoxOptions()`|Atgriež `firefoxOptions` objektu ar iepriekš definētām Firefox pārlūkprogrammas opcijām.| |`safariOptions()`|Atgriež `safariOptions` objektu ar iepriekš definētām Safari pārlūkprogrammas opcijām.| |`edgeOptions()`|Atgriež `edgeOptions` objektu ar iepriekš definētām Edge pārlūkprogrammas opcijām.| |`switchFrame(target)`| Pārslēdzas uz norādīto rāmi. Atbalstīts kopš versijas 7.0.4. <br><br>Parameters:<br>`target` - (browser element or integer, optional) Mērķa rāmis. Lai atlasītu rāmi pēc elementa, nododiet elementu. Lai atlasītu rāmi pēc indeksa, nododiet skaitli. Ja atstāts tukšs, tiks pārslēgts uz augšējā līmeņa pārlūkošanas kontekstu. | Visas Browser metodes var izraisīt šādas kļūdas: - `BrowserError` - atvasināta no `Error` objekta, kas tiek izraisīta, ja `Browser` konstruktors neizdodas; satur papildu `browser` īpašību ar `Browser` objektu, kas izraisīja šo `BrowserError`. - `WebdriverError` - atvasināta no `BrowserError`; satur tās pašas īpašības kā `BrowserError` objekts, kas norāda, vai kļūda tika ģenerēta, reaģējot uz kļūdu WebDriver atbildē. #### BSD-based OS The following process parameters are returned on FreeBSD, OpenBSD, and NetBSD for each mode: |mode=process |mode=thread |mode=summary | |---|---|---| |pid: PID |pid: PID |name: process name | |ppid: parent PID |ppid: parent PID |processes: number of processes | |jid: ID of jail (FreeBSD only) |jid: ID of jail (FreeBSD only) |vsize: virtual memory size | |jname: name of jail (FreeBSD only) |jname: name of jail (FreeBSD only) |pmem: percentage of real memory (FreeBSD only) | |name: process name |name: process name |rss: resident set size | |cmdline: command with arguments |user: user (real) the process runs under |size: size of process (code + data + stack) | |user: user (real) the process runs under |group: group (real) the process runs under |tsize: text (code) size | |group: group (real) the process runs under |uid: user ID |dsize: data size | |uid: user ID |gid: ID of the group the process runs under |ssize: stack size | |gid: ID of the group the process runs under |tid: thread ID |cputime_user: total CPU time spent in user mode (reported in seconds) | |vsize: virtual memory size |tname: thread name |cputime_system: total CPU time spent in system mode (reported in seconds) | |pmem: percentage of real memory (FreeBSD only) |cputime_user: total CPU time spent in user mode (reported in seconds) |ctx_switches: number of context switches | |rss: resident set size |cputime_system: total CPU time spent in system mode (reported in seconds) |threads: number of threads (not supported for NetBSD) | |size: size of process (code + data + stack) |state: thread state |stk: size of stack segment | |tsize: text (code) size |ctx_switches: number of context switches |page_faults: number of page faults | |dsize: data size |io_read_op: number of times the system had to perform input |fds: number of file descriptors (OpenBSD only) | |ssize: stack size |io_write_op: number of times the system had to perform output |swap: size of swap space used | |cputime_user: total CPU time spent in user mode (reported in seconds) | |io_read_op: number of times the system had to perform input | |cputime_system: total CPU time spent in system mode (reported in seconds) | |io_write_op: number of times the system had to perform output | |state: process state (disk sleep/running/sleeping/tracing stop/zombie/other) | | | |ctx_switches: number of context switches | | | |threads: number of threads (not supported for NetBSD) | | | |page_faults: number of page faults | | | |fds: number of file descriptors (OpenBSD only) | | | |swap: size of swap space used | | | |io_read_op: number of times the system had to perform input | | | |io_write_op: number of times the system had to perform output | | | #### BSD bāzēta OS Tālāk norādītie procesa parametri tiek atgriezti sistēmās FreeBSD, OpenBSD un NetBSD katram režīmam: |mode=process |mode=thread |mode=summary | |---|---|---| |pid: PID |pid: PID |name: procesa nosaukums | |ppid: vecākprocesa PID |ppid: vecākprocesa PID |processes: procesu skaits | |jid: cietuma ID (tikai FreeBSD) |jid: cietuma ID (tikai FreeBSD) |vsize: virtuālās atmiņas izmērs | |jname: cietuma nosaukums (tikai FreeBSD) |jname: cietuma nosaukums (tikai FreeBSD) |pmem: reālās atmiņas procentuālā daļa (tikai FreeBSD) | |name: procesa nosaukums |name: procesa nosaukums |rss: rezidentās atmiņas izmērs | |cmdline: komanda ar argumentiem |user: lietotājs (reālais), kura vārdā process darbojas |size: procesa izmērs (kods + dati + steks) | |user: lietotājs (reālais), kura vārdā process darbojas |group: grupa (reālā), kuras vārdā process darbojas |tsize: teksta (koda) izmērs | |group: grupa (reālā), kuras vārdā process darbojas |uid: lietotāja ID |dsize: datu izmērs | |uid: lietotāja ID |gid: grupas ID, kuras vārdā process darbojas |ssize: steka izmērs | |gid: grupas ID, kuras vārdā process darbojas |tid: pavediena ID |cputime_user: kopējais CPU laiks lietotāja režīmā (norādīts sekundēs) | |vsize: virtuālās atmiņas izmērs |tname: pavediena nosaukums |cputime_system: kopējais CPU laiks sistēmas režīmā (norādīts sekundēs) | |pmem: reālās atmiņas procentuālā daļa (tikai FreeBSD) |cputime_user: kopējais CPU laiks lietotāja režīmā (norādīts sekundēs) |ctx_switches: konteksta pārslēgšanu skaits | |rss: rezidentās atmiņas izmērs |cputime_system: kopējais CPU laiks sistēmas režīmā (norādīts sekundēs) |threads: pavedienu skaits (NetBSD netiek atbalstīts) | |size: procesa izmērs (kods + dati + steks) |state: pavediena stāvoklis |stk: steka segmenta izmērs | |tsize: teksta (koda) izmērs |ctx_switches: konteksta pārslēgšanu skaits |page_faults: lapu kļūdu skaits | |dsize: datu izmērs |io_read_op: reižu skaits, kad sistēmai bija jāveic ievade |fds: failu deskriptoru skaits (tikai OpenBSD) | |ssize: steka izmērs |io_write_op: reižu skaits, kad sistēmai bija jāveic izvade |swap: izmantotās maiņvietas izmērs | |cputime_user: kopējais CPU laiks lietotāja režīmā (norādīts sekundēs) | |io_read_op: reižu skaits, kad sistēmai bija jāveic ievade | |cputime_system: kopējais CPU laiks sistēmas režīmā (norādīts sekundēs) | |io_write_op: reižu skaits, kad sistēmai bija jāveic izvade | |state: procesa stāvoklis (gaidīšana uz disku/darbojas/guļ/izsekošanas apturēšana/zombijs/cits) | | | |ctx_switches: konteksta pārslēgšanu skaits | | | |threads: pavedienu skaits (NetBSD netiek atbalstīts) | | | |page_faults: lapu kļūdu skaits | | | |fds: failu deskriptoru skaits (tikai OpenBSD) | | | |swap: izmantotās maiņvietas izmērs | | | |io_read_op: reižu skaits, kad sistēmai bija jāveic ievade | | | |io_write_op: reižu skaits, kad sistēmai bija jāveic izvade | | | ##### btoa {#btoa} Encoding a macro value into Base64 encoding. Base64 encoding is a method for representing binary data as text, useful for storing and secure transmission of binary content over text-based protocols. Example: ```default {{ITEM.VALUE}.btoa()} - will Base64-encode a value like "zabbix" into "emFiYml4" ``` This function is supported since Zabbix 7.0.4. ##### btoa {#btoa} Makro vērtības kodēšana Base64 kodējumā. Base64 kodējums ir metode bināro datu attēlošanai kā tekstu, kas ir noderīga binārā satura glabāšanai un drošai pārsūtīšanai, izmantojot uz tekstu balstītus protokolus. Piemērs: ```default {{ITEM.VALUE}.btoa()} - kodēs tādu vērtību kā "zabbix" Base64 formātā "emFiYml4" ``` Šī funkcija tiek atbalstīta kopš Zabbix 7.0.4. ##### bucket_percentile(item filter,time period,percentage) {#bucket-percentile} Calculates the percentile from the buckets of a histogram.<br> Parameters: - **item filter** - see [item filter](/manual/appendix/functions/aggregate/foreach#item-filter-syntax);<br> - **time period** - see [time period](/manual/appendix/functions/aggregate/foreach#time-period);<br> - **percentage** - percentage (0-100). Comments: - Supported only in calculated items; - This function is an alias for `histogram_quantile(percentage/100, bucket_rate_foreach(item filter, time period, 1))`. Examples: ```default bucket_percentile(/*/http_request_duration_seconds_bucket[*],5m,95) #calculate the 95th percentile response time over 5 minutes bucket_percentile(/*/apiserver_request_duration_seconds_bucket[*],10m,99) #calculate the 99th percentile API latency ``` ##### bucket_percentile(item filter,time period,percentage) {#bucket-percentile} Aprēķina procentili no histogrammas spaiņiem.<br> Parametri: - **item filter** - skatiet [item filter](/manual/appendix/functions/aggregate/foreach#item-filter-syntax);<br> - **time period** - skatiet [time period](/manual/appendix/functions/aggregate/foreach#time-period);<br> - **percentage** - procentuālā vērtība (0-100). Piezīmes: - Atbalstīts tikai aprēķinātajos vienumos; - Šī funkcija ir aizstājvārds funkcijai `histogram_quantile(percentage/100, bucket_rate_foreach(item filter, time period, 1))`. Piemēri: ```default bucket_percentile(/*/http_request_duration_seconds_bucket[*],5m,95) #aprēķina 95. procentiles atbildes laiku 5 minūšu periodā bucket_percentile(/*/apiserver_request_duration_seconds_bucket[*],10m,99) #aprēķina 99. procentiles API latentumu ``` ##### BufferSend Do not keep data longer than N seconds in buffer. Default: `5`<br> Range: 1-3600 ##### BufferSend Neglabājiet datus buferī ilgāk par N sekundēm. Noklusējums: `5`<br> Diapazons: 1-3600 ##### BufferSend Do not keep data longer than N seconds in buffer. Default: `5`<br> Range: 1-3600 ##### BufferSend Neglabājiet datus buferī ilgāk par N sekundēm. Noklusējums: `5`<br> Diapazons: 1-3600 ##### BufferSend The time interval in seconds which determines how often values are sent from the buffer to Zabbix server.<br>Note that if the buffer is full, the data will be sent sooner. Default: `5`<br> Range: 1-3600 ##### BufferSend The time interval in seconds which determines how often values are sent from the buffer to Zabbix server.<br>Note, that if the buffer is full, the data will be sent sooner. Default: `5`<br> Range: 1-3600 ##### BufferSend The time interval in seconds which determines how often values are sent from the buffer to Zabbix server. Note that if the buffer is full, the data will be sent sooner. Default: `5`<br> Range: 1-3600 ##### BufferSend Laika intervāls sekundēs, kas nosaka, cik bieži vērtības tiek nosūtītas no bufera uz Zabbix serveris. Ņemiet vērā, ka, ja buferis ir pilns, dati tiks nosūtīti ātrāk. Noklusējums: `5`<br> Diapazons: 1-3600 ##### BufferSize Set the maximum number of values in the memory buffer.<br> The agent will send all collected data to the Zabbix server or proxy if the buffer is full.<br>This parameter should only be used if persistent buffer is disabled (`EnablePersistentBuffer=0`). Default: `1000`<br> Range: 2-65535 ##### BufferSize Iestata maksimālo vērtību skaitu atmiņas buferī.<br> Ja buferis ir pilns, aģents nosūtīs visus savāktos datus uz Zabbix serveri vai starpniekserveri.<br>Šis parametrs jāizmanto tikai tad, ja pastāvīgais buferis ir atspējots (`EnablePersistentBuffer=0`). Noklusējums: `1000`<br> Diapazons: 2-65535 ##### BufferSize The maximum number of values in the memory buffer. The agent will send all collected data to the Zabbix server or proxy if the buffer is full. Default: `100`<br> Range: 2-65535 ##### BufferSize Maksimālais vērtību skaits atmiņas buferī. Ja buferis ir pilns, aģents nosūtīs visus savāktos datus uz Zabbix serveri vai starpniekserveri. Noklusējums: `100`<br> Diapazons: 2-65535 ##### BufferSize The maximum number of values in the memory buffer. The agent will send all collected data to the Zabbix server or proxy if the buffer is full. Default: `100`<br> Range: 2-65535 ##### BufferSize Maksimālais vērtību skaits atmiņas buferī. Ja buferis ir pilns, aģents nosūtīs visus savāktos datus uz Zabbix serveri vai starpniekserveri. Noklusējums: `100`<br> Diapazons: 2-65535 ##### BufferSize The maximum number of values in the memory buffer. The agent will send all collected data to the Zabbix server or proxy if the buffer is full. This parameter should only be used if persistent buffer is disabled (`EnablePersistentBuffer=0`). Default: `1000`<br> Range: 2-65535 ##### BufferSize Maksimālais vērtību skaits atmiņas buferī. Aģents nosūtīs visus savāktos datus uz Zabbix serveri vai starpniekserveri, ja buferis būs pilns. Šis parametrs jāizmanto tikai tad, ja pastāvīgais buferis ir atspējots (`EnablePersistentBuffer=0`). Noklusējums: `1000`<br> Diapazons: 2-65535 #### Building agent binaries with shared libraries Install PCRE2 (replace *pcre2* with *pcre* in the commands below, if needed): brew install pcre2 When building with TLS, install OpenSSL and/or GnuTLS: brew install openssl brew install gnutls Download Zabbix source: git clone https://git.zabbix.com/scm/zbx/zabbix.git Build agent without TLS: cd zabbix ./bootstrap.sh ./configure --sysconfdir=/usr/local/etc/zabbix --enable-agent --enable-ipv6 make make install Build agent with OpenSSL: cd zabbix ./bootstrap.sh ./configure --sysconfdir=/usr/local/etc/zabbix --enable-agent --enable-ipv6 --with-openssl=/usr/local/opt/openssl make make install Build agent with GnuTLS: cd zabbix-source/ ./bootstrap.sh ./configure --sysconfdir=/usr/local/etc/zabbix --enable-agent --enable-ipv6 --with-gnutls=/usr/local/opt/gnutls make make install #### Aģenta bināro failu veidošana ar koplietojamām bibliotēkām Instalējiet PCRE2 (ja nepieciešams, tālāk norādītajās komandās aizstājiet *pcre2* ar *pcre*): brew install pcre2 Veidojot ar TLS, instalējiet OpenSSL un/vai GnuTLS: brew install openssl brew install gnutls Lejupielādējiet Zabbix pirmkodu: git clone https://git.zabbix.com/scm/zbx/zabbix.git Veidojiet aģentu bez TLS: cd zabbix ./bootstrap.sh ./configure --sysconfdir=/usr/local/etc/zabbix --enable-agent --enable-ipv6 make make install Veidojiet aģentu ar OpenSSL: cd zabbix ./bootstrap.sh ./configure --sysconfdir=/usr/local/etc/zabbix --enable-agent --enable-ipv6 --with-openssl=/usr/local/opt/openssl make make install Veidojiet aģentu ar GnuTLS: cd zabbix-source/ ./bootstrap.sh ./configure --sysconfdir=/usr/local/etc/zabbix --enable-agent --enable-ipv6 --with-gnutls=/usr/local/opt/gnutls make make install #### Building agent binaries with static libraries with GnuTLS GnuTLS depends on the Nettle crypto backend and GMP arithmetic library. Instead of using full GMP library, this guide will use mini-gmp which is included in Nettle. When building GnuTLS and Nettle, it's recommended to run `make check` after successful building. Even if building was successful, tests sometimes fail. If this is the case, problems should be researched and resolved before continuing. Let's assume that PCRE, Nettle and GnuTLS static libraries will be installed in `$HOME/static-libs`. We will use PCRE2 10.39, Nettle 3.4.1 and GnuTLS 3.6.5. PCRE_PREFIX="$HOME/static-libs/pcre2-10.39" NETTLE_PREFIX="$HOME/static-libs/nettle-3.4.1" GNUTLS_PREFIX="$HOME/static-libs/gnutls-3.6.5" Let's build static libraries in `static-libs-source`: mkdir static-libs-source cd static-libs-source Download and build Nettle: curl --remote-name https://ftp.gnu.org/gnu/nettle/nettle-3.4.1.tar.gz tar xf nettle-3.4.1.tar.gz cd nettle-3.4.1 ./configure --prefix="$NETTLE_PREFIX" --enable-static --disable-shared --disable-documentation --disable-assembler --enable-x86-aesni --enable-mini-gmp make make check make install cd .. Download and build GnuTLS: curl --remote-name https://www.gnupg.org/ftp/gcrypt/gnutls/v3.6/gnutls-3.6.5.tar.xz tar xf gnutls-3.6.5.tar.xz cd gnutls-3.6.5 PKG_CONFIG_PATH="$NETTLE_PREFIX/lib/pkgconfig" ./configure --prefix="$GNUTLS_PREFIX" --enable-static --disable-shared --disable-guile --disable-doc --disable-tools --disable-libdane --without-idn --without-p11-kit --without-tpm --with-included-libtasn1 --with-included-unistring --with-nettle-mini make make check make install cd .. Download Zabbix source and build agent: git clone https://git.zabbix.com/scm/zbx/zabbix.git cd zabbix ./bootstrap.sh CFLAGS="-Wno-unused-command-line-argument -framework Foundation -framework Security" \ > LIBS="-lgnutls -lhogweed -lnettle" \ > LDFLAGS="-L$GNUTLS_PREFIX/lib -L$NETTLE_PREFIX/lib" \ > ./configure --sysconfdir=/usr/local/etc/zabbix --enable-agent --enable-ipv6 --with-libpcre2="$PCRE_PREFIX" --with-gnutls="$GNUTLS_PREFIX" make make install #### Aģenta bināro failu veidošana ar statiskajām bibliotēkām, izmantojot GnuTLS GnuTLS ir atkarīgs no Nettle kriptogrāfijas aizmugures un GMP aritmētikas bibliotēkas. Pilnas GMP bibliotēkas vietā šajā ceļvedī tiks izmantots mini-gmp, kas ir iekļauts Nettle. Veidojot GnuTLS un Nettle, pēc veiksmīgas izveides ieteicams palaist `make check`. Pat ja izveide bija veiksmīga, testi dažkārt neizdodas. Ja tā notiek, problēmas ir jāizpēta un jānovērš, pirms turpināt. Pieņemsim, ka PCRE, Nettle un GnuTLS statiskās bibliotēkas tiks instalētas mapē `$HOME/static-libs`. Mēs izmantosim PCRE2 10.39, Nettle 3.4.1 un GnuTLS 3.6.5. PCRE_PREFIX="$HOME/static-libs/pcre2-10.39" NETTLE_PREFIX="$HOME/static-libs/nettle-3.4.1" GNUTLS_PREFIX="$HOME/static-libs/gnutls-3.6.5" Izveidosim statiskās bibliotēkas mapē `static-libs-source`: mkdir static-libs-source cd static-libs-source Lejupielādējiet un izveidojiet Nettle: curl --remote-name https://ftp.gnu.org/gnu/nettle/nettle-3.4.1.tar.gz tar xf nettle-3.4.1.tar.gz cd nettle-3.4.1 ./configure --prefix="$NETTLE_PREFIX" --enable-static --disable-shared --disable-documentation --disable-assembler --enable-x86-aesni --enable-mini-gmp make make check make install cd .. Lejupielādējiet un izveidojiet GnuTLS: curl --remote-name https://www.gnupg.org/ftp/gcrypt/gnutls/v3.6/gnutls-3.6.5.tar.xz tar xf gnutls-3.6.5.tar.xz cd gnutls-3.6.5 PKG_CONFIG_PATH="$NETTLE_PREFIX/lib/pkgconfig" ./configure --prefix="$GNUTLS_PREFIX" --enable-static --disable-shared --disable-guile --disable-doc --disable-tools --disable-libdane --without-idn --without-p11-kit --without-tpm --with-included-libtasn1 --with-included-unistring --with-nettle-mini make make check make install cd .. Lejupielādējiet Zabbix pirmkodu un izveidojiet aģentu: git clone https://git.zabbix.com/scm/zbx/zabbix.git cd zabbix ./bootstrap.sh CFLAGS="-Wno-unused-command-line-argument -framework Foundation -framework Security" \ > LIBS="-lgnutls -lhogweed -lnettle" \ > LDFLAGS="-L$GNUTLS_PREFIX/lib -L$NETTLE_PREFIX/lib" \ > ./configure --sysconfdir=/usr/local/etc/zabbix --enable-agent --enable-ipv6 --with-libpcre2="$PCRE_PREFIX" --with-gnutls="$GNUTLS_PREFIX" make make install #### Building agent binaries with static libraries with OpenSSL When building OpenSSL, it's recommended to run `make test` after successful building. Even if building was successful, tests sometimes fail. If this is the case, problems should be researched and resolved before continuing. Let's assume that PCRE and OpenSSL static libraries will be installed in `$HOME/static-libs`. We will use PCRE2 10.39 and OpenSSL 1.1.1a. PCRE_PREFIX="$HOME/static-libs/pcre2-10.39" OPENSSL_PREFIX="$HOME/static-libs/openssl-1.1.1a" Let's build static libraries in `static-libs-source`: mkdir static-libs-source cd static-libs-source Download and build PCRE with Unicode properties support: curl --remote-name https://github.com/PhilipHazel/pcre2/releases/download/pcre2-10.39/pcre2-10.39.tar.gz tar xf pcre2-10.39.tar.gz cd pcre2-10.39 ./configure --prefix="$PCRE_PREFIX" --disable-shared --enable-static --enable-unicode-properties make make check make install cd .. Download and build OpenSSL: curl --remote-name https://www.openssl.org/source/openssl-1.1.1a.tar.gz tar xf openssl-1.1.1a.tar.gz cd openssl-1.1.1a ./Configure --prefix="$OPENSSL_PREFIX" --openssldir="$OPENSSL_PREFIX" --api=1.1.0 no-shared no-capieng no-srp no-gost no-dgram no-dtls1-method no-dtls1_2-method darwin64-x86_64-cc make make test make install_sw cd .. Download Zabbix source and build agent: git clone https://git.zabbix.com/scm/zbx/zabbix.git cd zabbix ./bootstrap.sh ./configure --sysconfdir=/usr/local/etc/zabbix --enable-agent --enable-ipv6 --with-libpcre2="$PCRE_PREFIX" --with-openssl="$OPENSSL_PREFIX" make make install #### Aģenta bināro failu veidošana ar statiskajām bibliotēkām un OpenSSL Veidojot OpenSSL, pēc veiksmīgas veidošanas ir ieteicams palaist `make test`. Pat ja veidošana bija veiksmīga, testi dažkārt neizdodas. Ja tā notiek, problēmas ir jāizpēta un jānovērš, pirms turpināt. Pieņemsim, ka PCRE un OpenSSL statiskās bibliotēkas tiks instalētas mapē `$HOME/static-libs`. Mēs izmantosim PCRE2 10.39 un OpenSSL 1.1.1a. PCRE_PREFIX="$HOME/static-libs/pcre2-10.39" OPENSSL_PREFIX="$HOME/static-libs/openssl-1.1.1a" Izveidosim statiskās bibliotēkas mapē `static-libs-source`: mkdir static-libs-source cd static-libs-source Lejupielādējiet un izveidojiet PCRE ar Unicode īpašību atbalstu: curl --remote-name https://github.com/PhilipHazel/pcre2/releases/download/pcre2-10.39/pcre2-10.39.tar.gz tar xf pcre2-10.39.tar.gz cd pcre2-10.39 ./configure --prefix="$PCRE_PREFIX" --disable-shared --enable-static --enable-unicode-properties make make check make install cd .. Lejupielādējiet un izveidojiet OpenSSL: curl --remote-name https://www.openssl.org/source/openssl-1.1.1a.tar.gz tar xf openssl-1.1.1a.tar.gz cd openssl-1.1.1a ./Configure --prefix="$OPENSSL_PREFIX" --openssldir="$OPENSSL_PREFIX" --api=1.1.0 no-shared no-capieng no-srp no-gost no-dgram no-dtls1-method no-dtls1_2-method darwin64-x86_64-cc make make test make install_sw cd .. Lejupielādējiet Zabbix pirmkodu un izveidojiet aģentu: git clone https://git.zabbix.com/scm/zbx/zabbix.git cd zabbix ./bootstrap.sh ./configure --sysconfdir=/usr/local/etc/zabbix --enable-agent --enable-ipv6 --with-libpcre2="$PCRE_PREFIX" --with-openssl="$OPENSSL_PREFIX" make make install #### Building agent binaries with static libraries without TLS Let's assume that PCRE static libraries will be installed in `$HOME/static-libs`. We will use PCRE2 10.39. PCRE_PREFIX="$HOME/static-libs/pcre2-10.39" Download and build PCRE with Unicode properties support: mkdir static-libs-source cd static-libs-source curl --remote-name https://github.com/PhilipHazel/pcre2/releases/download/pcre2-10.39/pcre2-10.39.tar.gz tar xf pcre2-10.39.tar.gz cd pcre2-10.39 ./configure --prefix="$PCRE_PREFIX" --disable-shared --enable-static --enable-unicode-properties make make check make install Download Zabbix source and build agent: git clone https://git.zabbix.com/scm/zbx/zabbix.git cd zabbix ./bootstrap.sh ./configure --sysconfdir=/usr/local/etc/zabbix --enable-agent --enable-ipv6 --with-libpcre2="$PCRE_PREFIX" make make install #### Aģenta bināro failu veidošana ar statiskajām bibliotēkām bez TLS Pieņemsim, ka PCRE statiskās bibliotēkas tiks instalētas mapē `$HOME/static-libs`. Mēs izmantosim PCRE2 10.39. PCRE_PREFIX="$HOME/static-libs/pcre2-10.39" Lejupielādējiet un izveidojiet PCRE ar Unicode īpašību atbalstu: mkdir static-libs-source cd static-libs-source curl --remote-name https://github.com/PhilipHazel/pcre2/releases/download/pcre2-10.39/pcre2-10.39.tar.gz tar xf pcre2-10.39.tar.gz cd pcre2-10.39 ./configure --prefix="$PCRE_PREFIX" --disable-shared --enable-static --enable-unicode-properties make make check make install Lejupielādējiet Zabbix pirmkodu un izveidojiet aģentu: git clone https://git.zabbix.com/scm/zbx/zabbix.git cd zabbix ./bootstrap.sh ./configure --sysconfdir=/usr/local/etc/zabbix --enable-agent --enable-ipv6 --with-libpcre2="$PCRE_PREFIX" make make install #### Building inventory #### Inventāra veidošana ##### Building modules Modules are currently meant to be built inside Zabbix source tree, because the module API depends on some data structures that are defined in Zabbix headers. The most important header for loadable modules is **include/module.h**, which defines these data structures. Other necessary system headers that help **include/module.h** to work properly are **stdlib.h** and **stdint.h**. With this information in mind, everything is ready for the module to be built. The module should include **stdlib.h**, **stdint.h** and **module.h**, and the build script should make sure that these files are in the include path. See example "dummy" module below for details. Another useful header is **include/zbxcommon.h**, which defines **zabbix\_log()** function, which can be used for logging and debugging purposes. ##### Moduļu veidošana Pašlaik moduļus ir paredzēts veidot Zabbix pirmkoda kokā, jo moduļa API ir atkarīgs no dažām datu struktūrām, kas ir definētas Zabbix galvenēs. Svarīgākā galvene ielādējamiem moduļiem ir **include/module.h**, kas definē šīs datu struktūras. Citas nepieciešamās sistēmas galvenes, kas palīdz **include/module.h** darboties pareizi, ir **stdlib.h** un **stdint.h**. Ņemot vērā šo informāciju, viss ir gatavs moduļa veidošanai. Modulim jāiekļauj **stdlib.h**, **stdint.h** un **module.h**, un veidošanas skriptam jānodrošina, ka šie faili ir iekļaušanas ceļā. Sīkāku informāciju skatiet tālāk redzamajā "dummy" moduļa piemērā. Vēl viena noderīga galvene ir **include/zbxcommon.h**, kas definē funkciju **zabbix\_log()**, kuru var izmantot žurnalēšanai un atkļūdošanai. #### Building Zabbix agent 2 manually ::: noteimportant This method of building Zabbix agent 2 is suitable for users who require full control over the build environment or are in a restricted environment where [using vcpkg](#building-zabbix-agent-with-vcpkg) is not possible. ::: This section contains instructions for building Zabbix agent 2 manually, which includes installing the required build tools and dependencies, and then compiling the agent. #### Zabbix aģenta 2 manuāla būvēšana ::: noteimportant Šī Zabbix aģenta 2 būvēšanas metode ir piemērota lietotājiem, kuriem nepieciešama pilnīga kontrole pār būvēšanas vidi vai kuri darbojas ierobežotā vidē, kur [vcpkg izmantošana](#building-zabbix-agent-with-vcpkg) nav iespējama. ::: Šajā sadaļā ir sniegtas instrukcijas Zabbix aģenta 2 manuālai būvēšanai, kas ietver nepieciešamo būvēšanas rīku un atkarību instalēšanu, kā arī pēc tam aģenta kompilēšanu. #### Building Zabbix agent 2 with vcpkg This section contains instructions for building Zabbix agent with [vcpkg](https://learn.microsoft.com/en-us/vcpkg/get_started/overview), a package manager that simplifies dependency management and integration with C++ projects. 1\. Download and install [Build Tools for Visual Studio 2022](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022). During installation, make sure to select the *Desktop development with C++* workload, which includes the vcpkg package manager. 2\. Download and install [Go](https://go.dev/dl/) (available as an MSI installer). During installation, make sure to specify `C:\Zabbix\Go` as the installation folder. 3\. Download the [MinGW distribution](https://github.com/niXman/mingw-builds-binaries/releases) that uses the Microsoft Visual C runtime library; for example: - For 64-bit builds: `x86_64-16.1.0-release-win32-seh-msvcrt-rt_v14-rev0.7z` - For 32-bit builds: `i686-16.1.0-release-win32-dwarf-msvcrt-rt_v14-rev0.7z` ::: noteimportant The MinGW version must meet the [minimum requirements](https://go.dev/wiki/MinimumRequirements#cgo). ::: Then, extract it to `C:\Zabbix\mingw64` (or `C:\Zabbix\mingw32` for 32-bit builds). 4\. Initialize vcpkg and install the dependencies required for building Zabbix agent 2 (note that this may take some time): ```bash cd C:\Zabbix set PATH=%PATH%;"C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\VC\vcpkg" vcpkg new --application vcpkg add port pcre2 vcpkg add port libiconv vcpkg add port openssl # For 64-bit builds: set PATH=C:\Zabbix\mingw64\bin;%PATH% vcpkg install --triplet x64-mingw-static --x-install-root=x64 # For 32-bit builds: set PATH=C:\Zabbix\mingw32\bin;%PATH% vcpkg install --triplet x86-mingw-static --x-install-root=x86 ``` 5\. Download the [Zabbix source archive](https://www.zabbix.com/download_sources#70LTS) and extract it to `C:\Zabbix\zabbix-7.0.0`. 6\. Navigate to the Zabbix build directory (`C:\Zabbix\zabbix-7.0.0\build\mingw`) and create the following `build.bat` script: - For 64-bit builds: ```bash :: Add MinGW and Go to the system `PATH` variable for the current session: set PATH=C:\Zabbix\mingw64\bin;%PATH% set PATH=C:\Zabbix\Go\bin;%PATH% :: Set vcpkg installation path: set vcpkg="C:\Zabbix\x64\x64-mingw-static" :: Set linker flags for Crypt32 library: SET CGO_LDFLAGS="-lCrypt32" :: Run the build process: mingw32-make GOFLAGS="-buildvcs=false" ARCH=AMD64 ^ PCRE2="%vcpkg%" ^ OPENSSL="%vcpkg%" ^ all ``` - For 32-bit builds: ```bash :: Add MinGW and Go to the system `PATH` variable for the current session: set PATH=C:\Zabbix\mingw32\bin;%PATH% set PATH=C:\Zabbix\Go\bin;%PATH% :: Set vcpkg installation path: set vcpkg="C:\Zabbix\x86\x86-mingw-static" :: Set linker flags for Crypt32 library: SET CGO_LDFLAGS="-lCrypt32" :: Run the build process: mingw32-make GOFLAGS="-buildvcs=false" ARCH=x86 ^ PCRE2="%vcpkg%" ^ OPENSSL="%vcpkg%" ^ all ``` 7\. Compile Zabbix agent 2 by executing the script: ```bash build.bat ``` After compilation, the Zabbix agent 2 binary will be located in `C:\Zabbix\zabbix-7.0.0\bin\win64` (for 64-bit builds) or `C:\Zabbix\zabbix-7.0.0\bin\win32` (for 32-bit builds). Zabbix agent 2 configuration files are located in `C:\Zabbix\zabbix-7.0.0\src\go\conf`. To run the agent, `zabbix_agent2.exe` and its configuration files to a dedicated folder (e.g., `C:\Zabbix\agent2`) and then run the agent: ```bash mkdir C:\Zabbix\agent2 # For 64-bit builds: copy C:\Zabbix\zabbix-7.0.0\bin\win64\zabbix_agent2.exe C:\Zabbix\agent2\ # For 32-bit builds: copy C:\Zabbix\zabbix-7.0.0\bin\win32\zabbix_agent2.exe C:\Zabbix\agent2\ copy C:\Zabbix\zabbix-7.0.0\src\go\conf\zabbix_agent2.win.conf C:\Zabbix\agent2\ xcopy /E /I C:\Zabbix\zabbix-7.0.0\src\go\conf\zabbix_agent2.d C:\Zabbix\agent2\zabbix_agent2.d\ C:\Zabbix\agent2\zabbix_agent2.exe -c C:\Zabbix\agent2\zabbix_agent2.win.conf ``` If necessary, continue with compiling Zabbix agent 2 [loadable plugins](/manual/extensions/plugins#loadable-plugins). #### Zabbix agent 2 būvēšana ar vcpkg Šajā sadaļā ir sniegtas instrukcijas, kā būvēt Zabbix agent ar [vcpkg](https://learn.microsoft.com/en-us/vcpkg/get_started/overview) - pakešu pārvaldnieku, kas vienkāršo atkarību pārvaldību un integrāciju ar C++ projektiem. 1\. Lejupielādējiet un instalējiet [Build Tools for Visual Studio 2022](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022). Instalēšanas laikā noteikti atlasiet darba slodzi *Desktop development with C++*, kas ietver vcpkg pakešu pārvaldnieku. 2\. Lejupielādējiet un instalējiet [Go](https://go.dev/dl/) (pieejams kā MSI instalators). Instalēšanas laikā noteikti norādiet `C:\Zabbix\Go` kā instalācijas mapi. 3\. Lejupielādējiet [MinGW distribūciju](https://github.com/niXman/mingw-builds-binaries/releases), kas izmanto Microsoft Visual C runtime bibliotēku; piemēram: - 64 bitu būvēm: `x86_64-16.1.0-release-win32-seh-msvcrt-rt_v14-rev0.7z` - 32 bitu būvēm: `i686-16.1.0-release-win32-dwarf-msvcrt-rt_v14-rev0.7z` ::: noteimportant MinGW versijai ir jāatbilst [minimālajām prasībām](https://go.dev/wiki/MinimumRequirements#cgo). ::: Pēc tam izvelciet to uz `C:\Zabbix\mingw64` (vai `C:\Zabbix\mingw32` 32 bitu būvēm). 4\. Inicializējiet vcpkg un instalējiet Zabbix agent 2 būvēšanai nepieciešamās atkarības (ņemiet vērā, ka tas var aizņemt kādu laiku): ```bash cd C:\Zabbix set PATH=%PATH%;"C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\VC\vcpkg" vcpkg new --application vcpkg add port pcre2 vcpkg add port libiconv vcpkg add port openssl # For 64-bit builds: set PATH=C:\Zabbix\mingw64\bin;%PATH% vcpkg install --triplet x64-mingw-static --x-install-root=x64 # For 32-bit builds: set PATH=C:\Zabbix\mingw32\bin;%PATH% vcpkg install --triplet x86-mingw-static --x-install-root=x86 ``` 5\. Lejupielādējiet [Zabbix avota arhīvu](https://www.zabbix.com/download_sources#70LTS) un izvelciet to uz `C:\Zabbix\zabbix-7.0.0`. 6\. Dodieties uz Zabbix būvēšanas direktoriju (`C:\Zabbix\zabbix-7.0.0\build\mingw`) un izveidojiet šādu `build.bat` skriptu: - 64 bitu būvēm: ```bash :: Add MinGW and Go to the system `PATH` variable for the current session: set PATH=C:\Zabbix\mingw64\bin;%PATH% set PATH=C:\Zabbix\Go\bin;%PATH% :: Set vcpkg installation path: set vcpkg="C:\Zabbix\x64\x64-mingw-static" :: Set linker flags for Crypt32 library: SET CGO_LDFLAGS="-lCrypt32" :: Run the build process: mingw32-make GOFLAGS="-buildvcs=false" ARCH=AMD64 ^ PCRE2="%vcpkg%" ^ OPENSSL="%vcpkg%" ^ all ``` - 32 bitu būvēm: ```bash :: Add MinGW and Go to the system `PATH` variable for the current session: set PATH=C:\Zabbix\mingw32\bin;%PATH% set PATH=C:\Zabbix\Go\bin;%PATH% :: Set vcpkg installation path: set vcpkg="C:\Zabbix\x86\x86-mingw-static" :: Set linker flags for Crypt32 library: SET CGO_LDFLAGS="-lCrypt32" :: Run the build process: mingw32-make GOFLAGS="-buildvcs=false" ARCH=x86 ^ PCRE2="%vcpkg%" ^ OPENSSL="%vcpkg%" ^ all ``` 7\. Kompilējiet Zabbix agent 2, izpildot skriptu: ```bash build.bat ``` Pēc kompilēšanas Zabbix agent 2 binārais fails atradīsies `C:\Zabbix\zabbix-7.0.0\bin\win64` (64 bitu būvēm) vai `C:\Zabbix\zabbix-7.0.0\bin\win32` (32 bitu būvēm). Zabbix agent 2 konfigurācijas faili atrodas `C:\Zabbix\zabbix-7.0.0\src\go\conf`. Lai palaistu aģentu, kopējiet `zabbix_agent2.exe` un tā konfigurācijas failus uz atsevišķu mapi (piemēram, `C:\Zabbix\agent2`) un pēc tam palaidiet aģentu: ```bash mkdir C:\Zabbix\agent2 # For 64-bit builds: copy C:\Zabbix\zabbix-7.0.0\bin\win64\zabbix_agent2.exe C:\Zabbix\agent2\ # For 32-bit builds: copy C:\Zabbix\zabbix-7.0.0\bin\win32\zabbix_agent2.exe C:\Zabbix\agent2\ copy C:\Zabbix\zabbix-7.0.0\src\go\conf\zabbix_agent2.win.conf C:\Zabbix\agent2\ xcopy /E /I C:\Zabbix\zabbix-7.0.0\src\go\conf\zabbix_agent2.d C:\Zabbix\agent2\zabbix_agent2.d\ C:\Zabbix\agent2\zabbix_agent2.exe -c C:\Zabbix\agent2\zabbix_agent2.win.conf ``` Ja nepieciešams, turpiniet ar Zabbix agent 2 [ielādējamo spraudņu](/manual/extensions/plugins#loadable-plugins) kompilēšanu. #### Building Zabbix agent manually ::: noteimportant This method of building Zabbix agent is suitable for users who require full control over the build environment or are in a restricted environment where [using vcpkg](#building-zabbix-agent-with-vcpkg) is not possible. ::: This section contains instructions for building Zabbix agent manually, which includes installing the required build tools and dependencies (Perl, OpenSSL, PCRE2), and then compiling the agent. #### Zabbix aģenta manuāla būvēšana ::: noteimportant Šī Zabbix aģenta būvēšanas metode ir piemērota lietotājiem, kuriem nepieciešama pilnīga kontrole pār būvēšanas vidi vai kuri strādā ierobežotā vidē, kur [vcpkg izmantošana](#building-zabbix-agent-with-vcpkg) nav iespējama. ::: Šajā sadaļā ir sniegtas instrukcijas Zabbix aģenta manuālai būvēšanai, kas ietver nepieciešamo būvēšanas rīku un atkarību (Perl, OpenSSL, PCRE2) instalēšanu un pēc tam aģenta kompilēšanu. #### Building Zabbix agent with vcpkg This section contains instructions for building Zabbix agent with [vcpkg](https://learn.microsoft.com/en-us/vcpkg/get_started/overview), a package manager that simplifies dependency management and integration with C++ projects. 1\. Download and install [Build Tools for Visual Studio 2022](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022). During installation, make sure to select the *Desktop development with C++* workload, which includes the tools required for building the agent with vcpkg: - C compiler (Microsoft Visual C++) - NMake command-line tool - vcpkg package manager - x64 Native Tools Command Prompt 2\. Initialize vcpkg and install the dependencies required for building Zabbix agent (note that this may take some time): ```bash cd C:\Zabbix vcpkg new --application vcpkg add port pcre2 vcpkg add port openssl vcpkg install --triplet x64-windows-static --x-install-root="C:\Program Files\Zabbix\x64" ``` 3\. Download the [Zabbix source archive](https://www.zabbix.com/download_sources#70LTS) and extract it to `C:\Zabbix\zabbix-7.0.0`. 4\. Navigate to the Zabbix build directory (`C:\Zabbix\zabbix-7.0.0\build\win32\project`) and create the following `build.bat` script; make sure to correctly specify the directories where OpenSSL and PCRE2 are installed: ```bash :: Set vcpkg installation path: set vcpkg=C:\Program Files\Zabbix\x64\x64-windows-static :: Run the build process: nmake -f Makefile CPU=AMD64 ^ PCRE2INCDIR="%vcpkg%\include" ^ PCRE2LIBDIR="%vcpkg%\lib" ^ TLS=openssl ^ TLSINCDIR="%vcpkg%\include" ^ TLSLIBDIR="%vcpkg%\lib" ^ LIBS="$(LIBS) Crypt32.lib" ^ all ``` 5\. Compile Zabbix agent by executing the script: ```bash build.bat ``` After compilation, Zabbix component binaries will be located in `C:\Zabbix\zabbix-7.0.0\bin\win64`. Zabbix agent configuration file is located in `C:\Zabbix\zabbix-7.0.0\conf`. To run the agent, copy `zabbix_agent.exe` and its configuration file to a dedicated folder (e.g., `C:\Zabbix\agent`) and then run the agent: ```bash mkdir C:\Zabbix\agent copy C:\Zabbix\zabbix-7.0.0\bin\win64\zabbix_agent.exe C:\Zabbix\agent\ copy C:\Zabbix\zabbix-7.0.0\conf\zabbix_agent.win.conf C:\Zabbix\agent\ C:\Zabbix\agent\zabbix_agent.exe -c C:\Zabbix\agent\zabbix_agent.win.conf ``` #### Zabbix aģenta būvēšana ar vcpkg Šajā sadaļā ir sniegtas instrukcijas, kā būvēt Zabbix aģents ar [vcpkg](https://learn.microsoft.com/en-us/vcpkg/get_started/overview) - pakotņu pārvaldnieku, kas vienkāršo atkarību pārvaldību un integrāciju ar C++ projektiem. 1\. Lejupielādējiet un instalējiet [Build Tools for Visual Studio 2022](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022). Instalēšanas laikā noteikti atlasiet darba slodzi *Desktop development with C++*, kas ietver rīkus, kuri nepieciešami aģents būvēšanai ar vcpkg: - C kompilators (Microsoft Visual C++) - NMake komandrindas rīks - vcpkg pakotņu pārvaldnieks - x64 Native Tools Command Prompt 2\. Inicializējiet vcpkg un instalējiet Zabbix aģents būvēšanai nepieciešamās atkarības (ņemiet vērā, ka tas var aizņemt kādu laiku): ```bash cd C:\Zabbix vcpkg new --application vcpkg add port pcre2 vcpkg add port openssl vcpkg install --triplet x64-windows-static --x-install-root="C:\Program Files\Zabbix\x64" ``` 3\. Lejupielādējiet [Zabbix avota arhīvu](https://www.zabbix.com/download_sources#70LTS) un izvelciet to uz `C:\Zabbix\zabbix-7.0.0`. 4\. Pārejiet uz Zabbix būvēšanas direktoriju (`C:\Zabbix\zabbix-7.0.0\build\win32\project`) un izveidojiet šādu `build.bat` skriptu; pārliecinieties, ka ir pareizi norādīti direktoriji, kuros ir instalēti OpenSSL un PCRE2: ```bash :: Set vcpkg installation path: set vcpkg=C:\Program Files\Zabbix\x64\x64-windows-static :: Run the build process: nmake -f Makefile CPU=AMD64 ^ PCRE2INCDIR="%vcpkg%\include" ^ PCRE2LIBDIR="%vcpkg%\lib" ^ TLS=openssl ^ TLSINCDIR="%vcpkg%\include" ^ TLSLIBDIR="%vcpkg%\lib" ^ LIBS="$(LIBS) Crypt32.lib" ^ all ``` 5\. Kompilējiet Zabbix aģents, izpildot skriptu: ```bash build.bat ``` Pēc kompilēšanas Zabbix komponentu binārie faili atradīsies `C:\Zabbix\zabbix-7.0.0\bin\win64`. Zabbix aģents konfigurācijas fails atrodas `C:\Zabbix\zabbix-7.0.0\conf`. Lai palaistu aģents, nokopējiet `zabbix_agent.exe` un tā konfigurācijas failu uz atsevišķu mapi (piemēram, `C:\Zabbix\agent`) un pēc tam palaidiet aģents: ```bash mkdir C:\Zabbix\agent copy C:\Zabbix\zabbix-7.0.0\bin\win64\zabbix_agent.exe C:\Zabbix\agent\ copy C:\Zabbix\zabbix-7.0.0\conf\zabbix_agent.win.conf C:\Zabbix\agent\ C:\Zabbix\agent\zabbix_agent.exe -c C:\Zabbix\agent\zabbix_agent.win.conf ``` ## Build on Zabbix ## Veidojiet uz Zabbix bāzes ### Built-in objects ### Iebūvētie objekti #### Built-in plugins Zabbix agent 2 built-in plugins are available out-of-the-box. Click on the plugin name to go to the plugin repository with additional information. |Plugin name|Description|[Supported item keys](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2)|Comments| |--|--|--|----| |Agent|Metrics of the Zabbix agent being used.|agent.hostname, agent.ping, agent.version|Supported keys have the same parameters as Zabbix agent [keys](/manual/config/items/itemtypes/zabbix_agent).| |[Ceph](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/ceph/README.md?at=refs%2Fheads%2Frelease%2F7.0)|Ceph monitoring.|ceph.df.details, ceph.osd.stats, ceph.osd.discovery, ceph.osd.dump,<br>ceph.ping, ceph.pool.discovery, ceph.status| | |[CPU](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/system/cpu?at=refs%2Fheads%2Frelease%2F7.0)|System CPU monitoring (number of CPUs/CPU cores, discovered CPUs, utilization percentage).|system.cpu.discovery, system.cpu.num, system.cpu.util|Supported keys have the same parameters as Zabbix agent [keys](/manual/config/items/itemtypes/zabbix_agent).| |[Docker](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/docker?at=refs%2Fheads%2Frelease%2F7.0)|Monitoring of Docker containers.|docker.container\_info, docker.container\_stats, docker.containers, docker.containers.discovery,<br>docker.data\_usage, docker.images, docker.images.discovery, docker.info, docker.ping|See also:<br>[Configuration parameters](/manual/appendix/config/zabbix_agent2_plugins/d_plugin)| |File|File metrics collection.|vfs.file.cksum, vfs.file.contents, vfs.file.exists, vfs.file.md5sum,<br>vfs.file.regexp, vfs.file.regmatch, vfs.file.size, vfs.file.time|Supported keys have the same parameters as Zabbix agent [keys](/manual/config/items/itemtypes/zabbix_agent).| |[Kernel](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/kernel?at=refs%2Fheads%2Frelease%2F7.0)|Kernel monitoring.|kernel.maxfiles, kernel.maxproc|Supported keys have the same parameters as Zabbix agent [keys](/manual/config/items/itemtypes/zabbix_agent).| |[Log](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/log?at=refs%2Fheads%2Frelease%2F7.0)|Log file monitoring.|log, log.count, logrt, logrt.count|Supported keys have the same parameters as Zabbix agent [keys](/manual/config/items/itemtypes/zabbix_agent).<br><br>See also:<br>Plugin configuration parameters ([Unix](/manual/appendix/config/zabbix_agent2)/[Windows](/manual/appendix/config/zabbix_agent2_win))| |[Memcached](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/memcached/README.md?at=refs%2Fheads%2Frelease%2F7.0)|Memcached server monitoring.|memcached.ping, memcached.stats| | |[Modbus](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/modbus/README.md?at=refs%2Fheads%2Frelease%2F7.0)|Reads Modbus data.|modbus.get|Supported keys have the same parameters as Zabbix agent [keys](/manual/config/items/itemtypes/zabbix_agent).| |[MQTT](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/mqtt/README.md?at=refs%2Fheads%2Frelease%2F7.0)|Receives published values of MQTT topics.|mqtt.get|To configure an encrypted connection to the MQTT broker, specify TLS parameters in the agent configuration file as a [named session](#named-sessions) or [default](#default-values) parameters. Currently TLS parameters cannot be passed as item key parameters. | |[MySQL](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/mysql/README.md?at=refs%2Fheads%2Frelease%2F7.0)|Monitoring of MySQL and its forks.|mysql.custom.query, mysql.db.discovery, mysql.db.size, mysql.get\_status\_variables,<br>mysql.ping, mysql.replication.discovery, mysql.replication.get\_slave\_status, mysql.version|To configure an encrypted connection to the database, specify TLS parameters in the agent configuration file as a [named session](#named-sessions) or [default](#default-values) parameters. Currently TLS parameters cannot be passed as item key parameters.| |[NetIf](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/net/netif?at=refs%2Fheads%2Frelease%2F7.0)|Monitoring of network interfaces.|net.if.collisions, net.if.discovery, net.if.in, net.if.out, net.if.total|Supported keys have the same parameters as Zabbix agent [keys](/manual/config/items/itemtypes/zabbix_agent).| |[Oracle](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/oracle/README.md?at=refs%2Fheads%2Frelease%2F7.0)|Oracle Database monitoring.|oracle.diskgroups.stats, oracle.diskgroups.discovery, oracle.archive.info, oracle.archive.discovery,<br>oracle.cdb.info, oracle.custom.query, oracle.datafiles.stats, oracle.db.discovery,<br>oracle.fra.stats, oracle.instance.info, oracle.pdb.info, oracle.pdb.discovery,<br>oracle.pga.stats, oracle.ping, oracle.proc.stats, oracle.redolog.info,<br>oracle.sga.stats, oracle.sessions.stats, oracle.sys.metrics, oracle.sys.params,<br>oracle.ts.stats, oracle.ts.discovery, oracle.user.info, oracle.version|Install the [Oracle Instant Client](https://www.oracle.com/database/technologies/instant-client/downloads.html) before using the plugin.| |[Proc](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/proc?at=refs%2Fheads%2Frelease%2F7.0)|Process CPU utilization percentage.|proc.cpu.util|Supported key has the same parameters as Zabbix agent [key](/manual/config/items/itemtypes/zabbix_agent).| |[Redis](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/redis/README.md?at=refs%2Fheads%2Frelease%2F7.0)|Redis server monitoring.|redis.config, redis.info, redis.ping, redis.slowlog.count|To configure an encrypted connection to Redis, specify TLS parameters in the agent configuration file as a [named session](#named-sessions) or [default](#default-values) parameters. TLS parameters cannot be passed as item key parameters. Note that an incorrect or otherwise invalid TLS configuration can prevent Zabbix agent 2 from starting, so verify certificate files, permissions and paths before enabling TLS.| |[Smart](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/smart?at=refs%2Fheads%2Frelease%2F7.0)|S.M.A.R.T. monitoring.|smart.attribute.discovery, smart.disk.discovery, smart.disk.get|The minimum required smartctl version is 7.1. <br> Sudo/root access rights to smartctl are required for the user executing Zabbix agent 2. The plugin uses only the following commands: <br> ``/usr/sbin/smartctl -a *``<br> ``/usr/sbin/smartctl --scan *`` <br> ``/usr/sbin/smartctl -j -V``<br><br>Supported [keys](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2) can be used with Zabbix agent 2 only on Linux/Windows, both as a passive and active check.<br>See also:<br>[Configuration parameters](/manual/appendix/config/zabbix_agent2_plugins/smart_plugin)| |[SW](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/system/sw?at=refs%2Fheads%2Frelease%2F7.0)|Listing of installed packages.|system.sw.packages, system.sw.packages.get|The supported keys have the same parameters as Zabbix agent [key](/manual/config/items/itemtypes/zabbix_agent).| |[Swap](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/system/swap?at=refs%2Fheads%2Frelease%2F7.0)|Swap space size in bytes/percentage.|system.swap.size|Supported key has the same parameters as Zabbix agent [key](/manual/config/items/itemtypes/zabbix_agent).| |SystemRun|Runs specified command.|system.run|Supported key has the same parameters as Zabbix agent [key](/manual/config/items/itemtypes/zabbix_agent).<br><br>See also:<br>Plugin configuration parameters ([Unix](/manual/appendix/config/zabbix_agent2)/[Windows](/manual/appendix/config/zabbix_agent2_win))| |Systemd|Monitoring of systemd services.|systemd.unit.discovery, systemd.unit.get, systemd.unit.info| | |[TCP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/net/tcp?at=refs%2Fheads%2Frelease%2F7.0)|TCP connection availability check.|net.tcp.port|Supported key has the same parameters as Zabbix agent [key](/manual/config/items/itemtypes/zabbix_agent).| |[UDP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/net/udp?at=refs%2Fheads%2Frelease%2F7.0)|Monitoring of the UDP services availability and performance.|net.udp.service, net.udp.service.perf|Supported keys have the same parameters as Zabbix agent [keys](/manual/config/items/itemtypes/zabbix_agent).| |[Uname](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/system/uname?at=refs%2Fheads%2Frelease%2F7.0)|Retrieval of information about the system.|system.hostname, system.sw.arch, system.uname|Supported keys have the same parameters as Zabbix agent [keys](/manual/config/items/itemtypes/zabbix_agent).| |[Uptime](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/system/uptime?at=refs%2Fheads%2Frelease%2F7.0)|System uptime metrics collection.|system.uptime|Supported key has the same parameters as Zabbix agent [key](/manual/config/items/itemtypes/zabbix_agent).| |[VFSDev](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/vfs/dev?at=refs%2Fheads%2Frelease%2F7.0)|VFS metrics collection.|vfs.dev.discovery, vfs.dev.read, vfs.dev.write|Supported keys have the same parameters as Zabbix agent [keys](/manual/config/items/itemtypes/zabbix_agent).| |[WebCertificate](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/web/certificate?at=refs%2Fheads%2Frelease%2F7.0)|Monitoring of TLS/SSL website certificates.|web.certificate.get| | |[WebPage](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/web/page?at=refs%2Fheads%2Frelease%2F7.0)|Web page monitoring.|web.page.get, web.page.perf, web.page.regexp|Supported keys have the same parameters as Zabbix agent [keys](/manual/config/items/itemtypes/zabbix_agent).| |[ZabbixAsync](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/zabbix/async?at=refs%2Fheads%2Frelease%2F7.0)|Asynchronous metrics collection.|net.tcp.listen, net.udp.listen, sensor, system.boottime, system.cpu.intr, system.cpu.load,<br>system.cpu.switches, system.hw.cpu, system.hw.macaddr, system.localtime, system.sw.os,<br>system.swap.in, system.swap.out, vfs.fs.discovery|Supported keys have the same parameters as Zabbix agent [keys](/manual/config/items/itemtypes/zabbix_agent).| |[ZabbixStats](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/zabbix/stats?at=refs%2Fheads%2Frelease%2F7.0)|Zabbix server/proxy internal metrics or number of delayed items in a queue.|zabbix.stats|Supported keys have the same parameters as Zabbix agent [keys](/manual/config/items/itemtypes/zabbix_agent).| |[ZabbixSync](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/zabbix/sync?at=refs%2Fheads%2Frelease%2F7.0)|Synchronous metrics collection.|net.dns, net.dns.record, net.tcp.service, net.tcp.service.perf, proc.mem,<br>proc.num, system.hw.chassis, system.hw.devices, system.sw.packages,<br>system.users.num, vfs.dir.count, vfs.dir.size, vfs.fs.get, vfs.fs.inode,<br>vfs.fs.size, vm.memory.size.|Supported keys have the same parameters as Zabbix agent [keys](/manual/config/items/itemtypes/zabbix_agent).| #### Iebūvētie spraudņi Zabbix agent 2 iebūvētie spraudņi ir pieejami uzreiz pēc instalēšanas. Noklikšķiniet uz spraudņa nosaukuma, lai atvērtu spraudņa repozitoriju ar papildu informāciju. |Spraudņa nosaukums|Apraksts|[Atbalstītie vienumu atslēgas](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2)|Komentāri| |--|--|--|----| |Agent|Izmantotā Zabbix aģenta metrikas.|agent.hostname, agent.ping, agent.version|Atbalstītajām atslēgām ir tādi paši parametri kā Zabbix aģenta [atslēgām](/manual/config/items/itemtypes/zabbix_agent).| |[Ceph](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/ceph/README.md?at=refs%2Fheads%2Frelease%2F7.0)|Ceph uzraudzība.|ceph.df.details, ceph.osd.stats, ceph.osd.discovery, ceph.osd.dump,<br>ceph.ping, ceph.pool.discovery, ceph.status| | |[CPU](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/system/cpu?at=refs%2Fheads%2Frelease%2F7.0)|Sistēmas CPU uzraudzība (CPU skaits/CPU kodolu skaits, atklātie CPU, noslodzes procentuālā vērtība).|system.cpu.discovery, system.cpu.num, system.cpu.util|Atbalstītajām atslēgām ir tādi paši parametri kā Zabbix aģenta [atslēgām](/manual/config/items/itemtypes/zabbix_agent).| |[Docker](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/docker?at=refs%2Fheads%2Frelease%2F7.0)|Docker konteineru uzraudzība.|docker.container\_info, docker.container\_stats, docker.containers, docker.containers.discovery,<br>docker.data\_usage, docker.images, docker.images.discovery, docker.info, docker.ping|Skatiet arī:<br>[Konfigurācijas parametri](/manual/appendix/config/zabbix_agent2_plugins/d_plugin)| |File|Failu metrikas apkopošana.|vfs.file.cksum, vfs.file.contents, vfs.file.exists, vfs.file.md5sum,<br>vfs.file.regexp, vfs.file.regmatch, vfs.file.size, vfs.file.time|Atbalstītajām atslēgām ir tādi paši parametri kā Zabbix aģenta [atslēgām](/manual/config/items/itemtypes/zabbix_agent).| |[Kernel](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/kernel?at=refs%2Fheads%2Frelease%2F7.0)|Kodola uzraudzība.|kernel.maxfiles, kernel.maxproc|Atbalstītajām atslēgām ir tādi paši parametri kā Zabbix aģenta [atslēgām](/manual/config/items/itemtypes/zabbix_agent).| |[Log](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/log?at=refs%2Fheads%2Frelease%2F7.0)|Žurnālfailu uzraudzība.|log, log.count, logrt, logrt.count|Atbalstītajām atslēgām ir tādi paši parametri kā Zabbix aģenta [atslēgām](/manual/config/items/itemtypes/zabbix_agent).<br><br>Skatiet arī:<br>Spraudņa konfigurācijas parametri ([Unix](/manual/appendix/config/zabbix_agent2)/[Windows](/manual/appendix/config/zabbix_agent2_win))| |[Memcached](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/memcached/README.md?at=refs%2Fheads%2Frelease%2F7.0)|Memcached servera uzraudzība.|memcached.ping, memcached.stats| | |[Modbus](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/modbus/README.md?at=refs%2Fheads%2Frelease%2F7.0)|Nolasa Modbus datus.|modbus.get|Atbalstītajām atslēgām ir tādi paši parametri kā Zabbix aģenta [atslēgām](/manual/config/items/itemtypes/zabbix_agent).| |[MQTT](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/mqtt/README.md?at=refs%2Fheads%2Frelease%2F7.0)|Saņem publicētās MQTT tēmu vērtības.|mqtt.get|Lai konfigurētu šifrētu savienojumu ar MQTT brokeri, norādiet TLS parametrus aģenta konfigurācijas failā kā [nosauktas sesijas](#named-sessions) vai [noklusējuma](#default-values) parametrus. Pašlaik TLS parametrus nevar nodot kā vienuma atslēgas parametrus. | |[MySQL](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/mysql/README.md?at=refs%2Fheads%2Frelease%2F7.0)|MySQL un tā atzaru uzraudzība.|mysql.custom.query, mysql.db.discovery, mysql.db.size, mysql.get\_status\_variables,<br>mysql.ping, mysql.replication.discovery, mysql.replication.get\_slave\_status, mysql.version|Lai konfigurētu šifrētu savienojumu ar datubāzi, norādiet TLS parametrus aģenta konfigurācijas failā kā [nosauktas sesijas](#named-sessions) vai [noklusējuma](#default-values) parametrus. Pašlaik TLS parametrus nevar nodot kā vienuma atslēgas parametrus.| |[NetIf](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/net/netif?at=refs%2Fheads%2Frelease%2F7.0)|Tīkla saskarņu uzraudzība.|net.if.collisions, net.if.discovery, net.if.in, net.if.out, net.if.total|Atbalstītajām atslēgām ir tādi paši parametri kā Zabbix aģenta [atslēgām](/manual/config/items/itemtypes/zabbix_agent).| |[Oracle](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/oracle/README.md?at=refs%2Fheads%2Frelease%2F7.0)|Oracle Database uzraudzība.|oracle.diskgroups.stats, oracle.diskgroups.discovery, oracle.archive.info, oracle.archive.discovery,<br>oracle.cdb.info, oracle.custom.query, oracle.datafiles.stats, oracle.db.discovery,<br>oracle.fra.stats, oracle.instance.info, oracle.pdb.info, oracle.pdb.discovery,<br>oracle.pga.stats, oracle.ping, oracle.proc.stats, oracle.redolog.info,<br>oracle.sga.stats, oracle.sessions.stats, oracle.sys.metrics, oracle.sys.params,<br>oracle.ts.stats, oracle.ts.discovery, oracle.user.info, oracle.version|Pirms spraudņa izmantošanas instalējiet [Oracle Instant Client](https://www.oracle.com/database/technologies/instant-client/downloads.html).| |[Proc](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/proc?at=refs%2Fheads%2Frelease%2F7.0)|Procesa CPU noslodzes procentuālā vērtība.|proc.cpu.util|Atbalstītajai atslēgai ir tādi paši parametri kā Zabbix aģenta [atslēgai](/manual/config/items/itemtypes/zabbix_agent).| |[Redis](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/redis/README.md?at=refs%2Fheads%2Frelease%2F7.0)|Redis servera uzraudzība.|redis.config, redis.info, redis.ping, redis.slowlog.count|Lai konfigurētu šifrētu savienojumu ar Redis, norādiet TLS parametrus aģenta konfigurācijas failā kā [nosauktas sesijas](#named-sessions) vai [noklusējuma](#default-values) parametrus. TLS parametrus nevar nodot kā vienuma atslēgas parametrus. Ņemiet vērā, ka nepareiza vai citādi nederīga TLS konfigurācija var neļaut Zabbix agent 2 startēt, tāpēc pirms TLS iespējošanas pārbaudiet sertifikātu failus, atļaujas un ceļus.| |[Smart](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/smart?at=refs%2Fheads%2Frelease%2F7.0)|S.M.A.R.T. uzraudzība.|smart.attribute.discovery, smart.disk.discovery, smart.disk.get|Minimālā nepieciešamā smartctl versija ir 7.1. <br> Lietotājam, kas izpilda Zabbix agent 2, ir nepieciešamas sudo/root piekļuves tiesības smartctl. Spraudnis izmanto tikai šādas komandas: <br> ``/usr/sbin/smartctl -a *``<br> ``/usr/sbin/smartctl --scan *`` <br> ``/usr/sbin/smartctl -j -V``<br><br>Atbalstītās [atslēgas](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2) var izmantot ar Zabbix agent 2 tikai Linux/Windows vidē gan kā pasīvo, gan aktīvo pārbaudi.<br>Skatiet arī:<br>[Konfigurācijas parametri](/manual/appendix/config/zabbix_agent2_plugins/smart_plugin)| |[SW](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/system/sw?at=refs%2Fheads%2Frelease%2F7.0)|Instalēto pakotņu uzskaitījums.|system.sw.packages, system.sw.packages.get|Atbalstītajām atslēgām ir tādi paši parametri kā Zabbix aģenta [atslēgai](/manual/config/items/itemtypes/zabbix_agent).| |[Swap](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/system/swap?at=refs%2Fheads%2Frelease%2F7.0)|Maiņvietas apjoms baitos/procentos.|system.swap.size|Atbalstītajai atslēgai ir tādi paši parametri kā Zabbix aģenta [atslēgai](/manual/config/items/itemtypes/zabbix_agent).| |SystemRun|Izpilda norādīto komandu.|system.run|Atbalstītajai atslēgai ir tādi paši parametri kā Zabbix aģenta [atslēgai](/manual/config/items/itemtypes/zabbix_agent).<br><br>Skatiet arī:<br>Spraudņa konfigurācijas parametri ([Unix](/manual/appendix/config/zabbix_agent2)/[Windows](/manual/appendix/config/zabbix_agent2_win))| |Systemd|systemd pakalpojumu uzraudzība.|systemd.unit.discovery, systemd.unit.get, systemd.unit.info| | |[TCP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/net/tcp?at=refs%2Fheads%2Frelease%2F7.0)|TCP savienojuma pieejamības pārbaude.|net.tcp.port|Atbalstītajai atslēgai ir tādi paši parametri kā Zabbix aģenta [atslēgai](/manual/config/items/itemtypes/zabbix_agent).| |[UDP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/net/udp?at=refs%2Fheads%2Frelease%2F7.0)|UDP pakalpojumu pieejamības un veiktspējas uzraudzība.|net.udp.service, net.udp.service.perf|Atbalstītajām atslēgām ir tādi paši parametri kā Zabbix aģenta [atslēgām](/manual/config/items/itemtypes/zabbix_agent).| |[Uname](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/system/uname?at=refs%2Fheads%2Frelease%2F7.0)|Informācijas iegūšana par sistēmu.|system.hostname, system.sw.arch, system.uname|Atbalstītajām atslēgām ir tādi paši parametri kā Zabbix aģenta [atslēgām](/manual/config/items/itemtypes/zabbix_agent).| |[Uptime](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/system/uptime?at=refs%2Fheads%2Frelease%2F7.0)|Sistēmas darbības laika metrikas apkopošana.|system.uptime|Atbalstītajai atslēgai ir tādi paši parametri kā Zabbix aģenta [atslēgai](/manual/config/items/itemtypes/zabbix_agent).| |[VFSDev](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/vfs/dev?at=refs%2Fheads%2Frelease%2F7.0)|VFS metrikas apkopošana.|vfs.dev.discovery, vfs.dev.read, vfs.dev.write|Atbalstītajām atslēgām ir tādi paši parametri kā Zabbix aģenta [atslēgām](/manual/config/items/itemtypes/zabbix_agent).| |[WebCertificate](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/web/certificate?at=refs%2Fheads%2Frelease%2F7.0)|TLS/SSL vietņu sertifikātu uzraudzība.|web.certificate.get| | |[WebPage](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/web/page?at=refs%2Fheads%2Frelease%2F7.0)|Tīmekļa lapu uzraudzība.|web.page.get, web.page.perf, web.page.regexp|Atbalstītajām atslēgām ir tādi paši parametri kā Zabbix aģenta [atslēgām](/manual/config/items/itemtypes/zabbix_agent).| |[ZabbixAsync](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/zabbix/async?at=refs%2Fheads%2Frelease%2F7.0)|Asinhrona metrikas apkopošana.|net.tcp.listen, net.udp.listen, sensor, system.boottime, system.cpu.intr, system.cpu.load,<br>system.cpu.switches, system.hw.cpu, system.hw.macaddr, system.localtime, system.sw.os,<br>system.swap.in, system.swap.out, vfs.fs.discovery|Atbalstītajām atslēgām ir tādi paši parametri kā Zabbix aģenta [atslēgām](/manual/config/items/itemtypes/zabbix_agent).| |[ZabbixStats](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/zabbix/stats?at=refs%2Fheads%2Frelease%2F7.0)|Zabbix servera/starpniekservera iekšējās metrikas vai aizkavēto vienumu skaits rindā.|zabbix.stats|Atbalstītajām atslēgām ir tādi paši parametri kā Zabbix aģenta [atslēgām](/manual/config/items/itemtypes/zabbix_agent).| |[ZabbixSync](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/zabbix/sync?at=refs%2Fheads%2Frelease%2F7.0)|Sinhrona metrikas apkopošana.|net.dns, net.dns.record, net.tcp.service, net.tcp.service.perf, proc.mem,<br>proc.num, system.hw.chassis, system.hw.devices, system.sw.packages,<br>system.users.num, vfs.dir.count, vfs.dir.size, vfs.fs.get, vfs.fs.inode,<br>vfs.fs.size, vm.memory.size.|Atbalstītajām atslēgām ir tādi paši parametri kā Zabbix aģenta [atslēgām](/manual/config/items/itemtypes/zabbix_agent).| ##### Buttons Buttons to the right offer the following options: | | | |--|--------| ||Go to editing of the map content.| ||Add map to the favorites widget in [Dashboards](/manual/web_interface/frontend_sections/dashboards).| ||The map is in the favorites widget in [Dashboards](/manual/web_interface/frontend_sections/dashboards). Click to remove map from the favorites widget.| View mode buttons being common for all sections are described on the [Monitoring](/manual/web_interface/frontend_sections/monitoring#view-mode-buttons) page. ##### Pogas Pogas labajā pusē piedāvā šādas iespējas: | | | |--|--------| ||Pāriet uz kartes satura rediģēšanu.| ||Pievienot karti izlases logrīkam sadaļā [Paneļi](/manual/web_interface/frontend_sections/dashboards).| ||Karte atrodas izlases logrīkā sadaļā [Paneļi](/manual/web_interface/frontend_sections/dashboards). Noklikšķiniet, lai noņemtu karti no izlases logrīka.| Skata režīma pogas, kas ir kopīgas visām sadaļām, ir aprakstītas lapā [Uzraudzība](/manual/web_interface/frontend_sections/monitoring#view-mode-buttons). ##### Buttons *Create host* allows to create a [new host](/manual/config/hosts/host). This button is available for Admin and Super Admin users only. View mode buttons being common for all sections are described on the [Monitoring](/manual/web_interface/frontend_sections/monitoring#view-mode-buttons) page. ##### Pogas *Izveidot hostu* ļauj izveidot [jaunu hostu](/manual/config/hosts/host). Šī poga ir pieejama tikai Admin un Super Admin lietotājiem. Skata režīma pogas, kas ir kopīgas visām sadaļām, ir aprakstītas lapā [Monitoring](/manual/web_interface/frontend_sections/monitoring#view-mode-buttons). #### Buttons The button at the top right corner of the page offers the following option: | | | |--|--------| ||Export action log records from the current page to a CSV file. If a filter is applied, only the filtered records will be exported.<br>In the exported CSV file the columns "Recipient" and "Message" are divided into several columns - "Recipient's Zabbix username", "Recipient's name", "Recipient's surname", "Recipient", and "Subject", "Message", "Command".| #### Pogas Poga lapas augšējā labajā stūrī piedāvā šādu opciju: | | | |--|--------| ||Eksportēt darbību žurnāla ierakstus no pašreizējās lapas uz CSV failu. Ja ir lietots filtrs, tiks eksportēti tikai filtrētie ieraksti.<br>Eksportētajā CSV failā kolonnas "Recipient" un "Message" ir sadalītas vairākās kolonnās - "Recipient's Zabbix username", "Recipient's name", "Recipient's surname", "Recipient", kā arī "Subject", "Message", "Command".| ##### Buttons The button to the right offers the following option: | | | |--|--------| ||Export content from all pages to a CSV file.| View mode buttons, being common for all sections, are described on the [Monitoring](/manual/web_interface/frontend_sections/monitoring#view-mode-buttons) page. ##### Pogas Poga labajā pusē piedāvā šādu opciju: | | | |--|--------| ||Eksportēt saturu no visām lapām CSV failā.| Skata režīma pogas, kas ir kopīgas visām sadaļām, ir aprakstītas lapā [Monitoring](/manual/web_interface/frontend_sections/monitoring#view-mode-buttons). ##### Buttons View mode buttons being common for all sections are described on the [Monitoring](/manual/web_interface/frontend_sections/monitoring#view-mode-buttons) page. ##### Pogas Skata režīma pogas, kas ir kopīgas visām sadaļām, ir aprakstītas lapā [Monitoring](/manual/web_interface/frontend_sections/monitoring#view-mode-buttons). ##### Buttons View mode buttons being common for all sections are described on the [Monitoring](/manual/web_interface/frontend_sections/monitoring#view-mode-buttons) page. ##### Pogas Skata režīma pogas, kas ir kopīgas visām sadaļām, ir aprakstītas lapā [Monitoring](/manual/web_interface/frontend_sections/monitoring#view-mode-buttons). ##### Buttons View mode buttons being common for all sections are described on the [Monitoring](/manual/web_interface/frontend_sections/monitoring#view-mode-buttons) page. ##### Pogas Skata režīma pogas, kas ir kopīgas visām sadaļām, ir aprakstītas lapā [Monitoring](/manual/web_interface/frontend_sections/monitoring#view-mode-buttons). ##### Buttons View mode buttons being common for all sections are described on the [Monitoring](/manual/web_interface/frontend_sections/monitoring#view-mode-buttons) page. ##### Pogas Skata režīma pogas, kas ir kopīgas visām sadaļām, ir aprakstītas lapā [Monitoring](/manual/web_interface/frontend_sections/monitoring#view-mode-buttons). ##### Buttons View mode buttons, being common for all sections, are described on the [Monitoring](/manual/web_interface/frontend_sections/monitoring#view-mode-buttons) page. ##### Pogas Skata režīma pogas, kas ir kopīgas visām sadaļām, ir aprakstītas lapā [Monitoring](/manual/web_interface/frontend_sections/monitoring#view-mode-buttons). ##### By Authorization header All API requests require an authentication or an API token. You can provide the credentials by using the Authorization header in the request: ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer 0424bd59b807674191e7d77572075f33' ``` ::: noteimportant If you are experiencing authentication issues, see [Authorization header forwarding](/manual/installation/known_issues#authorization-header-forwarding). ::: Since Zabbix 7.0.7, the Authorization header is supported in cross-origin requests ([CORS](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS)). Since Zabbix 7.0.11, Zabbix API accepts headers in a case-insensitive way (e.g., `authorization`, `Authorization`, and `AUTHORIZATION` are treated the same). ##### Ar Authorization header Visi API pieprasījumi prasa autentifikāciju vai API tokenu. Akreditācijas datus varat norādīt, izmantojot Authorization header pieprasījumā: ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer 0424bd59b807674191e7d77572075f33' ``` ::: noteimportant Ja rodas autentifikācijas problēmas, skatiet [Authorization header forwarding](/manual/installation/known_issues#authorization-header-forwarding). ::: Kopš Zabbix 7.0.7 Authorization header tiek atbalstīts starpizcelsmes pieprasījumos ([CORS](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS)). Kopš Zabbix 7.0.11 Zabbix API pieņem galvenes, neņemot vērā burtu reģistru (piem., `authorization`, `Authorization` un `AUTHORIZATION` tiek apstrādāti vienādi). ##### By `auth` property An API request can be authorized by the `auth` property. ::: noteimportant Note that the `auth` property is deprecated. It will be removed in the future releases. ::: ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Content-Type: application/json-rpc' \ --data '{"jsonrpc":"2.0","method":"host.get","params":{"output":["hostid"]},"auth":"0424bd59b807674191e7d77572075f33","id":1}' ``` ##### Ar `auth` īpašību API pieprasījumu var autorizēt, izmantojot `auth` īpašību. ::: noteimportant Ņemiet vērā, ka `auth` īpašība ir novecojusi. Tā tiks noņemta nākamajos laidienos. ::: ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Content-Type: application/json-rpc' \ --data '{"jsonrpc":"2.0","method":"host.get","params":{"output":["hostid"]},"auth":"0424bd59b807674191e7d77572075f33","id":1}' ``` By default, the widget displays all enabled hosts that have valid coordinates defined in their [inventory](/manual/config/hosts/inventory). It is possible to configure host filtering in the widget parameters. The valid host coordinates are: - Latitude: from -90 to 90 (can be integer or float number) - Longitude: from -180 to 180 (can be integer or float number) Pēc noklusējuma logrīks parāda visus iespējotos hosts, kuriem ir definētas derīgas koordinātas to [inventarizācijā](/manual/config/hosts/inventory). Logrīka parametros ir iespējams konfigurēt hostu filtrēšanu. Derīgās hostu koordinātas ir: - Platums: no -90 līdz 90 (var būt vesels skaitlis vai peldošā komata skaitlis) - Garums: no -180 līdz 180 (var būt vesels skaitlis vai peldošā komata skaitlis) #### Bypass preprocessing manager for items without preprocessing To reduce processing load, item values from items that have neither preprocessing nor dependent items are added directly to the history cache or sent to the LLD manager (see [Preprocessing details](/manual/config/items/preprocessing/preprocessing_details)). Previously, all item values passed through the preprocessing manager regardless of preprocessing configuration. #### Apiet priekšapstrādes pārvaldnieku vienumiem bez priekšapstrādes Lai samazinātu apstrādes slodzi, vienumu vērtības no vienumiem, kuriem nav ne priekšapstrādes, ne atkarīgo vienumu, tiek pievienotas tieši vēstures kešatmiņai vai nosūtītas LLD pārvaldniekam (skatiet [Priekšapstrādes informāciju](/manual/config/items/preprocessing/preprocessing_details)). Iepriekš visas vienumu vērtības tika nodotas caur priekšapstrādes pārvaldnieku neatkarīgi no priekšapstrādes konfigurācijas. ##### bytelength(value) {#bytelength} The length of value in bytes.<br> Supported value types: *String*, *Text*, *Log*, *Integer*. Parameter: - **value** - the value to check Example: bytelength(last(/host/key)) ##### bytelength(value) {#bytelength} Vērtības garums baitos.<br> Atbalstītie vērtību tipi: *String*, *Text*, *Log*, *Integer*. Parametrs: - **value** - pārbaudāmā vērtība Piemērs: bytelength(last(/host/key)) ##### By Zabbix cookie A *"zbx_session"* cookie is used to authorize an API request from Zabbix UI performed using JavaScript (from a module or a custom widget). ##### Ar Zabbix sīkdatni Sīkdatne *"zbx_session"* tiek izmantota, lai autorizētu API pieprasījumu no Zabbix lietotāja saskarnes, kas izpildīts, izmantojot JavaScript (no moduļa vai pielāgota logrīka). ##### CacheSize The size of the configuration cache, in bytes. The shared memory size for storing host and item data. Default: `32M`<br> Range: 128K-64G ##### CacheSize Konfigurācijas kešatmiņas lielums baitos. Koplietotās atmiņas apjoms, kas tiek izmantots hosts un vienumu datu glabāšanai. Noklusējums: `32M`<br> Diapazons: 128K-64G ##### CacheSize The size of the configuration cache, in bytes. The shared memory size for storing host, item and trigger data. Default: `32M`<br> Range: 128K-64G ##### CacheSize Konfigurācijas kešatmiņas lielums baitos. Koplietotās atmiņas lielums, ko izmanto hosts, vienums un trigeris datu glabāšanai. Noklusējums: `32M`<br> Diapazons: 128K-64G ##### CacheUpdateFrequency This parameter determines how often Zabbix will perform the configuration cache update in seconds. See also [runtime control](/manual/concepts/server#runtime-control) options. Default: `10`<br> Range: 1-3600 ##### CacheUpdateFrequency Šis parametrs nosaka, cik bieži Zabbix veiks konfigurācijas kešatmiņas atjaunināšanu sekundēs. Skatiet arī [runtime control](/manual/concepts/server#runtime-control) opcijas. Noklusējums: `10`<br> Diapazons: 1-3600 ## Caching of secret values Vault secret macro values are retrieved by Zabbix server on every refresh of configuration data and then stored in the configuration cache. Zabbix proxy receives values of vault secret macros from Zabbix server on each configuration sync and stores them in its own configuration cache. ::: noteimportant Encryption must be enabled between Zabbix server and proxy; otherwise a server warning message is logged. ::: To manually trigger refresh of cached secret values from a vault, use the 'secrets_reload' command-line [option](/manual/concepts/server#runtime-control). For Zabbix frontend database credentials caching is disabled by default, but can be enabled by setting the option ``$DB['VAULT_CACHE'] = true`` in zabbix.conf.php. The credentials will be stored in a local cache using the filesystem temporary file directory. The web server must allow writing in a private temporary folder (for example, for Apache the configuration option ``PrivateTmp=True`` must be set). To control how often the data cache is refreshed/invalidated, use the ZBX\_DATA\_CACHE\_TTL [constant](/manual/web_interface/definitions) . ## Slepeno vērtību kešošana Vault slepeno makro vērtības Zabbix serveris izgūst katrā konfigurācijas datu atsvaidzināšanas reizē un pēc tam saglabā konfigurācijas kešatmiņā. Zabbix starpniekserveris saņem vault slepeno makro vērtības no Zabbix servera katrā konfigurācijas sinhronizācijā un saglabā tās savā konfigurācijas kešatmiņā. ::: noteimportant Starp Zabbix serveri un starpniekserveri ir jābūt iespējotai šifrēšanai; pretējā gadījumā serveris reģistrē brīdinājuma ziņojumu. ::: Lai manuāli aktivizētu kešoto slepeno vērtību atsvaidzināšanu no vault, izmantojiet komandrindas [opciju](/manual/concepts/server#runtime-control) `secrets_reload`. Zabbix lietotāja saskarnei datubāzes akreditācijas datu kešošana pēc noklusējuma ir atspējota, taču to var iespējot, zabbix.conf.php failā iestatot opciju ``$DB['VAULT_CACHE'] = true``. Akreditācijas dati tiks glabāti lokālā kešatmiņā, izmantojot failu sistēmas pagaidu failu direktoriju. Tīmekļa serverim ir jāatļauj rakstīšana privātā pagaidu mapē (piemēram, Apache gadījumā ir jāiestata konfigurācijas opcija ``PrivateTmp=True``). Lai kontrolētu, cik bieži datu kešatmiņa tiek atsvaidzināta/nederīga, izmantojiet ZBX\_DATA\_CACHE\_TTL [konstanti](/manual/web_interface/definitions). #### Calculating SLI for a daily SLA Retrieve SLI data for services with IDs "1" and "4" that are linked to the SLA with ID "1". Retrieve data for a single period until "1761861599" (Oct 30 2025 23:59:59 GMT+0200). Since the [reporting period](/manual/it_services/sla) of the SLA is daily, SLI data is retrieved from "1761775200" (Oct 30 2025 00:00:00 GMT+0200) to "1761861600" (Oct 31 2025 00:00:00 GMT+0200). [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "sla.getsli", "params": { "slaid": "1", "serviceids": [ 1, 4 ], "periods": 1, "period_to": 1761861599 }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "periods": [ { "period_from": 1761775200, "period_to": 1761861600 } ], "serviceids": [ 1, 4 ], "sli": [ [ { "uptime": 43843, "downtime": 0, "sli": 100, "error_budget": 0, "excluded_downtimes": [ { "name": "Maintenance OCT", "period_from": 1761825600, "period_to": 1761829200 } ] }, { "uptime": 32225, "downtime": 0, "sli": 100, "error_budget": 0, "excluded_downtimes": [] } ] ] }, "id": 1 } ``` #### SLI aprēķināšana dienas SLA Iegūstiet SLI datus pakalpojumiem ar ID "1" un "4", kas ir saistīti ar SLA ar ID "1". Iegūstiet datus vienam periodam līdz "1761861599" (30. okt. 2025 23:59:59 GMT+0200). Tā kā SLA [atskaites periods](/manual/it_services/sla) ir diena, SLI dati tiek iegūti no "1761775200" (30. okt. 2025 00:00:00 GMT+0200) līdz "1761861600" (31. okt. 2025 00:00:00 GMT+0200). [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "sla.getsli", "params": { "slaid": "1", "serviceids": [ 1, 4 ], "periods": 1, "period_to": 1761861599 }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "periods": [ { "period_from": 1761775200, "period_to": 1761861600 } ], "serviceids": [ 1, 4 ], "sli": [ [ { "uptime": 43843, "downtime": 0, "sli": 100, "error_budget": 0, "excluded_downtimes": [ { "name": "Maintenance OCT", "period_from": 1761825600, "period_to": 1761829200 } ] }, { "uptime": 32225, "downtime": 0, "sli": 100, "error_budget": 0, "excluded_downtimes": [] } ] ] }, "id": 1 } ``` #### Calculating SLI for a monthly SLA Retrieve SLI data on services with IDs "50", "60" and "70" that are linked to the SLA with ID "5". Retrieve data for three periods starting from "1635724800" (Nov 01 2021 00:00:00 UTC). Since the [reporting period](/manual/it_services/sla) of the SLA is monthly, SLI data is retrieved for the following three months: - From "1635724800" (Nov 01 2021 00:00:00 UTC) to "1638316800" (Dec 01 2021 00:00:00 UTC) - From "1638316800" (Dec 01 2021 00:00:00 UTC) to "1640995200" (Jan 01 2022 00:00:00 UTC) - From "1640995200" (Jan 01 2022 00:00:00 UTC) to "1643673600" (Feb 01 2022 00:00:00 UTC) [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "sla.getsli", "params": { "slaid": "5", "serviceids": [ 50, 60, 70 ], "periods": 3, "period_from": 1635724800 }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "periods": [ { "period_from": 1635724800, "period_to": 1638316800 }, { "period_from": 1638316800, "period_to": 1640995200 }, { "period_from": 1640995200, "period_to": 1643673600 } ], "serviceids": [ 50, 60, 70 ], "sli": [ [ { "uptime": 1186212, "downtime": 0, "sli": 100, "error_budget": 0, "excluded_downtimes": [ { "name": "Maintenance Nov 25 - Dec 01", "period_from": 1637836212, "period_to": 1638316800 } ] }, { "uptime": 1186212, "downtime": 0, "sli": 100, "error_budget": 0, "excluded_downtimes": [ { "name": "Maintenance Nov 25 - Dec 01", "period_from": 1637836212, "period_to": 1638316800 } ] }, { "uptime": 1186212, "downtime": 0, "sli": 100, "error_budget": 0, "excluded_downtimes": [ { "name": "Maintenance Nov 25 - Dec 01", "period_from": 1637836212, "period_to": 1638316800 } ] } ], [ { "uptime": 1147548, "downtime": 0, "sli": 100, "error_budget": 0, "excluded_downtimes": [ { "name": "Maintenance Dec 02 - Dec 10", "period_from": 1638439200, "period_to": 1639109652 } ] }, { "uptime": 1147548, "downtime": 0, "sli": 100, "error_budget": 0, "excluded_downtimes": [ { "name": "Maintenance Dec 02 - Dec 10", "period_from": 1638439200, "period_to": 1639109652 } ] }, { "uptime": 1147548, "downtime": 0, "sli": 100, "error_budget": 0, "excluded_downtimes": [ { "name": "Maintenance Dec 02 - Dec 10", "period_from": 1638439200, "period_to": 1639109652 } ] } ], [ { "uptime": 1674000, "downtime": 0, "sli": 100, "error_budget": 0, "excluded_downtimes": [] }, { "uptime": 1674000, "downtime": 0, "sli": 100, "error_budget": 0, "excluded_downtimes": [] }, { "uptime": 1674000, "downtime": 0, "sli": 100, "error_budget": 0, "excluded_downtimes": [] } ] ] }, "id": 1 } ``` #### SLI aprēķināšana mēneša SLA Iegūstiet SLI datus par pakalpojumiem ar ID "50", "60" un "70", kas ir saistīti ar SLA ar ID "5". Iegūstiet datus par trim periodiem, sākot no "1635724800" (2021. gada 1. novembris 00:00:00 UTC). Tā kā SLA [pārskata periods](/manual/it_services/sla) ir mēnesis, SLI dati tiek iegūti par šādiem trim mēnešiem: - No "1635724800" (2021. gada 1. novembris 00:00:00 UTC) līdz "1638316800" (2021. gada 1. decembris 00:00:00 UTC) - No "1638316800" (2021. gada 1. decembris 00:00:00 UTC) līdz "1640995200" (2022. gada 1. janvāris 00:00:00 UTC) - No "1640995200" (2022. gada 1. janvāris 00:00:00 UTC) līdz "1643673600" (2022. gada 1. februāris 00:00:00 UTC) [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "sla.getsli", "params": { "slaid": "5", "serviceids": [ 50, 60, 70 ], "periods": 3, "period_from": 1635724800 }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "periods": [ { "period_from": 1635724800, "period_to": 1638316800 }, { "period_from": 1638316800, "period_to": 1640995200 }, { "period_from": 1640995200, "period_to": 1643673600 } ], "serviceids": [ 50, 60, 70 ], "sli": [ [ { "uptime": 1186212, "downtime": 0, "sli": 100, "error_budget": 0, "excluded_downtimes": [ { "name": "Maintenance Nov 25 - Dec 01", "period_from": 1637836212, "period_to": 1638316800 } ] }, { "uptime": 1186212, "downtime": 0, "sli": 100, "error_budget": 0, "excluded_downtimes": [ { "name": "Maintenance Nov 25 - Dec 01", "period_from": 1637836212, "period_to": 1638316800 } ] }, { "uptime": 1186212, "downtime": 0, "sli": 100, "error_budget": 0, "excluded_downtimes": [ { "name": "Maintenance Nov 25 - Dec 01", "period_from": 1637836212, "period_to": 1638316800 } ] } ], [ { "uptime": 1147548, "downtime": 0, "sli": 100, "error_budget": 0, "excluded_downtimes": [ { "name": "Maintenance Dec 02 - Dec 10", "period_from": 1638439200, "period_to": 1639109652 } ] }, { "uptime": 1147548, "downtime": 0, "sli": 100, "error_budget": 0, "excluded_downtimes": [ { "name": "Maintenance Dec 02 - Dec 10", "period_from": 1638439200, "period_to": 1639109652 } ] }, { "uptime": 1147548, "downtime": 0, "sli": 100, "error_budget": 0, "excluded_downtimes": [ { "name": "Maintenance Dec 02 - Dec 10", "period_from": 1638439200, "period_to": 1639109652 } ] } ], [ { "uptime": 1674000, "downtime": 0, "sli": 100, "error_budget": 0, "excluded_downtimes": [] }, { "uptime": 1674000, "downtime": 0, "sli": 100, "error_budget": 0, "excluded_downtimes": [] }, { "uptime": 1674000, "downtime": 0, "sli": 100, "error_budget": 0, "excluded_downtimes": [] } ] ] }, "id": 1 } ``` #### Calculation of queues during maintenance ::: noteimportant The Zabbix proxy is not aware of maintenance periods; see [Calculation of queues during maintenance](/manual/maintenance#calculation-of-queues-during-maintenance) for details. ::: #### Rindas aprēķins apkopes laikā ::: noteimportant Zabbix starpniekserveris nav informēts par apkopes periodiem; skatiet [Rindas aprēķins apkopes laikā](/manual/maintenance#calculation-of-queues-during-maintenance), lai iegūtu detalizētu informāciju. ::: #### Calculation of queues during maintenance ::: noteimportant The Zabbix proxy is not aware of maintenance periods; see [Calculation of queues during maintenance](/manual/maintenance#calculation-of-queues-during-maintenance) for details. ::: #### Rindu aprēķināšana apkopes laikā ::: noteimportant Zabbix starpniekserveris nav informēts par apkopes periodiem; sīkāku informāciju skatiet [Rindu aprēķināšana apkopes laikā](/manual/maintenance#calculation-of-queues-during-maintenance). ::: #### Calculation of queues during maintenance ::: noteimportant The Zabbix proxy is not aware of maintenance periods; see [Calculation of queues during maintenance](/manual/maintenance#calculation-of-queues-during-maintenance) for details. ::: #### Rindu aprēķināšana apkopes laikā ::: noteimportant Zabbix starpniekserveris nav informēts par apkopes periodiem; sīkāku informāciju skatiet [Rindu aprēķināšana apkopes laikā](/manual/maintenance#calculation-of-queues-during-maintenance). ::: #### Calculation of queues during maintenance Queues displayed in the Zabbix frontend ([Administration > Queue](/manual/web_interface/frontend_sections/administration/queue)) are calculated by the Zabbix server. They do not include items in *No data collection* maintenance, and queue length is always zero for these items, even when their values are delayed. Delayed items in *With data collection* maintenance are still counted in the queue. The Zabbix [proxy](/manual/concepts/proxy) is not aware of maintenance periods because there is no synchronization of maintenance configuration between the Zabbix server and proxy. Internal checks calculated on Zabbix proxies (for example, [`zabbix[queue,,]`](/manual/config/items/itemtypes/internal#queue) and [`zabbix[stats,,,queue,,]`](/manual/config/items/itemtypes/internal#stats.queue)) report delayed items regardless of the maintenance status on the Zabbix server. As a result, different queue lengths may be reported for the same items in maintenance with *No data collection* by the Zabbix frontend and by internal checks on Zabbix proxies. #### Rindu aprēķināšana uzturēšanas laikā Rindas, kas tiek parādītas Zabbix lietotāja saskarnē ([Administration > Queue](/manual/web_interface/frontend_sections/administration/queue)), aprēķina Zabbix serveris. Tās neietver vienumus uzturēšanā *No data collection*, un šo vienumu rindas garums vienmēr ir nulle, pat ja to vērtību saņemšana kavējas. Kavētie vienumi uzturēšanā *With data collection* joprojām tiek ieskaitīti rindā. Zabbix [starpniekserveris](/manual/concepts/proxy) nezina par uzturēšanas periodiem, jo starp Zabbix serveri un starpniekserveri netiek sinhronizēta uzturēšanas konfigurācija. Iekšējās pārbaudes, kas tiek aprēķinātas Zabbix starpniekserveros (piemēram, [`zabbix[queue,,]`](/manual/config/items/itemtypes/internal#queue) un [`zabbix[stats,,,queue,,]`](/manual/config/items/itemtypes/internal#stats.queue)), ziņo par kavētiem vienumiem neatkarīgi no uzturēšanas statusa Zabbix serverī. Rezultātā Zabbix lietotāja saskarne un iekšējās pārbaudes Zabbix starpniekserveros var ziņot atšķirīgu rindas garumu tiem pašiem vienumiem uzturēšanā ar *No data collection*. #### Calculation time A trigger is recalculated every time Zabbix server receives a new value that is part of the expression. When a new value is received, each function that is included in the expression is recalculated (not just the one that received the new value). Additionally, a trigger is recalculated each time when a new value is received **and** every 30 seconds if [date and time](/manual/appendix/functions/time) and/or [nodata()](/manual/appendix/functions/history#nodata) functions are used in the expression. [Date and time](/manual/appendix/functions/time) and/or [nodata()](/manual/appendix/functions/history#nodata) functions are recalculated every 30 seconds by the Zabbix history syncer process. Triggers that reference trend functions **only** are evaluated once per the smallest time period in the expression. See also [trend functions](/manual/appendix/functions/trends). #### Aprēķina laiks Trigeris tiek pārrēķināts katru reizi, kad Zabbix serveris saņem jaunu vērtību, kas ir izteiksmes daļa. Kad tiek saņemta jauna vērtība, tiek pārrēķināta katra izteiksmē iekļautā funkcija (ne tikai tā, kas saņēma jauno vērtību). Turklāt trigeris tiek pārrēķināts katru reizi, kad tiek saņemta jauna vērtība, **un** ik pēc 30 sekundēm, ja izteiksmē tiek izmantotas [datuma un laika](/manual/appendix/functions/time) un/vai [nodata()](/manual/appendix/functions/history#nodata) funkcijas. [Datuma un laika](/manual/appendix/functions/time) un/vai [nodata()](/manual/appendix/functions/history#nodata) funkcijas Zabbix history syncer process pārrēķina ik pēc 30 sekundēm. Trigeri, kuros tiek izmantotas **tikai** trend funkcijas, tiek izvērtēti vienu reizi katrā izteiksmē norādītajā mazākajā laika periodā. Skatiet arī [trend funkcijas](/manual/appendix/functions/trends). ::: card #### Adding users Find out how to add and assign roles to users within a Zabbix Cloud organization and its nodes. [](/cloud/adding_users){.card-link} ::: ::: card #### Lietotāju pievienošana Uzziniet, kā pievienot lietotājus un piešķirt tiem lomas Zabbix Cloud organizācijā un tās mezglos. [](/cloud/adding_users){.card-link} ::: ::: card #### Explore Zabbix Cloud Get an overview of Zabbix Cloud, including its key features, perks, and what comes with a subscription. For common questions on setup and usage, see the FAQ. [](https://www.zabbix.com/cloud){.card-link} ::: ::: card #### Iepazīstiet Zabbix Cloud Iegūstiet pārskatu par Zabbix Cloud, tostarp tā galvenajām iespējām, priekšrocībām un to, kas ir iekļauts abonementā. Biežāk uzdotos jautājumus par iestatīšanu un lietošanu skatiet BUJ. [](https://www.zabbix.com/cloud){.card-link} ::: ::: card #### Explore Zabbix Cloud Get an overview of Zabbix Cloud, including its key features, perks, and what comes with a subscription. For common questions on setup and usage, see the FAQ. [](https://www.zabbix.com/cloud){.card-link} ::: ::: card #### Iepazīstiet Zabbix Cloud Iegūstiet pārskatu par Zabbix Cloud, tostarp tā galvenajām iespējām, priekšrocībām un to, kas ir iekļauts abonementā. Biežāk uzdotos jautājumus par iestatīšanu un lietošanu skatiet BUJ. [](https://www.zabbix.com/cloud){.card-link} ::: ::: card #### Frontend modules Guides and references for building custom modules that extend or modify the Zabbix frontend to suit specific use cases. [](/devel/modules){.card-link} ::: ::: card #### Lietotāja saskarnes moduļi Rokasgrāmatas un atsauces pielāgotu moduļu izveidei, kas paplašina vai modificē Zabbix lietotāja saskarni, lai tā atbilstu konkrētiem lietošanas gadījumiem. [](/devel/modules){.card-link} ::: ::: card #### Frontend modules Guides and references for building custom modules that extend or modify the Zabbix frontend to suit specific use cases. [](/devel/modules){.card-link} ::: ::: card #### Lietotāja saskarnes moduļi Rokasgrāmatas un atsauces pielāgotu moduļu izveidei, kas paplašina vai modificē Zabbix lietotāja saskarni, lai tā atbilstu konkrētiem lietošanas gadījumiem. [](/devel/modules){.card-link} ::: ::: card #### How-to videos A video library featuring demonstrations, discussions, and tips to help you make the most of Zabbix. [](https://www.youtube.com/playlist?list=PL0mpo4XDX5eE2lpPbtQioJUULLHGPpcJX){.card-link} ::: ::: card #### Pamācību video Videobibliotēka ar demonstrācijām, diskusijām un padomiem, kas palīdzēs jums maksimāli izmantot Zabbix iespējas. [](https://www.youtube.com/playlist?list=PL0mpo4XDX5eE2lpPbtQioJUULLHGPpcJX){.card-link} ::: ::: card #### Installation Step-by-step instructions to install Zabbix on your preferred platform, covering various operating systems and database configurations. [](/manual/installation/getting_zabbix){.card-link} ::: ::: card #### Instalēšana Soli pa solim instrukcijas Zabbix instalēšanai jūsu izvēlētajā platformā, aptverot dažādas operētājsistēmas un datubāzu konfigurācijas. [](/manual/installation/getting_zabbix){.card-link} ::: ::: card #### Node configuration Learn how to set up your Zabbix Cloud node, focusing on access, data handling, and resource settings. [](/cloud/node_configuration){.card-link} ::: ::: card #### Mezgla konfigurācija Uzziniet, kā iestatīt savu Zabbix Cloud mezglu, koncentrējoties uz piekļuvi, datu apstrādi un resursu iestatījumiem. [](/cloud/node_configuration){.card-link} ::: ::: card #### Plugins An overview on how to develop and manage Zabbix plugins to extend functionality or integrate with external systems. [](/devel/plugins){.card-link} ::: ::: card #### Spraudņi Pārskats par to, kā izstrādāt un pārvaldīt Zabbix spraudņus, lai paplašinātu funkcionalitāti vai integrētu ar ārējām sistēmām. [](/devel/plugins){.card-link} ::: ::: card #### Plugins An overview on how to develop and manage Zabbix plugins to extend functionality or integrate with external systems. [](/devel/plugins){.card-link} ::: ::: card #### Spraudņi Pārskats par to, kā izstrādāt un pārvaldīt Zabbix spraudņus, lai paplašinātu funkcionalitāti vai integrētu ar ārējām sistēmām. [](/devel/plugins){.card-link} ::: ::: card #### Python library for Zabbix Resources for using the official `zabbix_utils` library to interact with the Zabbix API and build integrations. [](/devel/python){.card-link} ::: ::: card #### Python bibliotēka Zabbix Resursi oficiālās `zabbix_utils` bibliotēkas izmantošanai, lai mijiedarbotos ar Zabbix API un veidotu integrācijas. [](/devel/python){.card-link} ::: ::: card #### Quickstart guides Concise, task-oriented how-tos that walk you through the basics—from your first configuration steps to receiving your first problem alert. [](/manual/quickstart){.card-link} ::: ::: card #### Ātrās darba sākšanas rokasgrāmatas Īsi, uz uzdevumiem orientēti pamācību materiāli, kas soli pa solim izskaidro pamatus — no pirmajiem konfigurācijas soļiem līdz pirmajam problēmas brīdinājumam. [](/manual/quickstart){.card-link} ::: ::: card #### Requirements A list of supported platforms and software prerequisites to help you prepare your environment for a successful Zabbix deployment. [](/manual/installation/requirements){.card-link} ::: ::: card #### Prasības Atbalstīto platformu un programmatūras priekšnosacījumu saraksts, kas palīdzēs jums sagatavot vidi veiksmīgai Zabbix izvietošanai. [](/manual/installation/requirements){.card-link} ::: ::: card #### Start using Zabbix Cloud Guided instructions to get your Zabbix Cloud instance up and running quickly, including initial configuration and connecting your monitored devices. [](/cloud/quickstart){.card-link} ::: ::: card #### Sāciet lietot Zabbix Cloud Norādījumi soli pa solim, lai ātri palaistu un sagatavotu darbam savu Zabbix Cloud instanci, tostarp sākotnējo konfigurāciju un pārraugāmo ierīču pievienošanu. [](/cloud/quickstart){.card-link} ::: ::: card #### Start using Zabbix Cloud Guided instructions to get your Zabbix Cloud instance up and running quickly, including initial configuration and connecting your monitored devices. [](/cloud/quickstart){.card-link} ::: ::: card #### Sāciet lietot Zabbix Cloud Norādījumi soli pa solim, lai ātri palaistu un sagatavotu darbam savu Zabbix Cloud instanci, tostarp sākotnējo konfigurēšanu un pārraugāmo ierīču pievienošanu. [](/cloud/quickstart){.card-link} ::: ::: card #### Widgets A breakdown of widget structure and logic, with instructions for creating custom dashboard elements tailored to your needs. [](/devel/modules/widgets){.card-link} ::: ::: card #### Logrīki Logrīku struktūras un loģikas pārskats, kā arī norādījumi pielāgotu paneļa elementu izveidei atbilstoši jūsu vajadzībām. [](/devel/modules/widgets){.card-link} ::: ::: card #### Widgets A breakdown of widget structure and logic, with instructions for creating custom dashboard elements tailored to your needs. [](/devel/modules/widgets){.card-link} ::: ::: card #### Logrīki Logrīku struktūras un loģikas pārskats, kā arī norādījumi pielāgotu paneļa elementu izveidei atbilstoši jūsu vajadzībām. [](/devel/modules/widgets){.card-link} ::: ::: card #### Zabbix Blog News, tutorials, and case studies curated by the Zabbix team and community contributors. [](https://blog.zabbix.com/){.card-link} ::: ::: card #### Zabbix emuārs Ziņas, pamācības un gadījumu izpētes, ko atlasījusi Zabbix komanda un kopienas līdzautori. [](https://blog.zabbix.com/){.card-link} ::: ::: card #### Zabbix Cloud vs. on-premises Compare the differences in management, scalability, and maintenance between the two deployments, and learn which can support your workflow most seamlessly. [](/cloud/key_differences){.card-link} ::: ::: card #### Zabbix Cloud salīdzinājumā ar lokālu izvietojumu Salīdziniet atšķirības pārvaldībā, mērogojamībā un uzturēšanā starp abiem izvietošanas veidiem un uzziniet, kurš no tiem var visvienkāršāk atbalstīt jūsu darbplūsmu. [](/cloud/key_differences){.card-link} ::: ::: card #### Zabbix Cloud vs. on-premises Compare the differences in management, scalability, and maintenance between the two deployments, and learn which can support your workflow most seamlessly. [](/cloud/key_differences){.card-link} ::: ::: card #### Zabbix Cloud salīdzinājumā ar lokālu izvietojumu Salīdziniet atšķirības pārvaldībā, mērogojamībā un uzturēšanā starp abiem izvietošanas veidiem un uzziniet, kurš no tiem var visvienkāršāk atbalstīt jūsu darbplūsmu. [](/cloud/key_differences){.card-link} ::: ::: card #### Zabbix Forums A space to exchange ideas, find solutions, and share experiences across all levels of Zabbix expertise. [](https://www.zabbix.com/forum/){.card-link} ::: ::: card #### Zabbix forumi Vieta, kur apmainīties ar idejām, atrast risinājumus un dalīties pieredzē visos Zabbix zināšanu līmeņos. [](https://www.zabbix.com/forum/){.card-link} ::: ### Cause and symptom events {EVENT.CAUSE.*} macros are used in the context of a symptom event, for example, in notifications; they return information about the cause event. The {EVENT.SYMPTOMS} macro is used in the context of the cause event and returns information about symptom events. |Macro|Supported in|Description| |--|--------|--------| |{EVENT.CAUSE.ACK.STATUS}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands|*Acknowledgment status of the cause event (Yes/No)*.| |{EVENT.CAUSE.AGE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands|*Age of the cause event*, with precision down to a second.<br>Useful in escalated messages.| |{EVENT.CAUSE.DATE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands|*Date of the cause event in yyyy.mm.dd format.*| |{EVENT.CAUSE.DURATION}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands|*Duration of the cause event (time difference between problem and recovery events)*, with precision down to a second.<br>Useful in problem recovery messages.| |{EVENT.CAUSE.ID}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands|*Numeric ID of the cause event .*| |{EVENT.CAUSE.NAME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands|*Name of the cause problem event.*| |{EVENT.CAUSE.NSEVERITY}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands|*Numeric value of the cause event severity.*<br>Possible values: 0 - Not classified, 1 - Information, 2 - Warning, 3 - Average, 4 - High, 5 - Disaster.| |{EVENT.CAUSE.OBJECT}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands|*Numeric value of the cause event object.*<br>Possible values: 0 - Trigger, 1 - Discovered host, 2 - Discovered service, 3 - Autoregistration, 4 - Item, 5 - Low-level discovery rule.| |{EVENT.CAUSE.OPDATA}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands|*Operational data of the underlying trigger of the cause problem.*| |{EVENT.CAUSE.SEVERITY}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands|*Name of the cause event severity.*| |{EVENT.CAUSE.SOURCE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands|*Numeric value of the cause event source.*<br>Possible values: 0 - Trigger, 1 - Discovery, 2 - Autoregistration, 3 - Internal.| |{EVENT.CAUSE.STATUS}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands|*Verbal value of the cause event.*| |{EVENT.CAUSE.TAGS}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands|*A comma separated list of cause event tags.*<br>Expanded to an empty string if no tags exist.| |{EVENT.CAUSE.TAGSJSON}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands|*A JSON array containing cause event tag [objects](/manual/api/reference/event/object#event-tag).*<br>Expanded to an empty array if no tags exist.| |{EVENT.CAUSE.TAGS.\<tag name>}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands|*Cause event tag value referenced by the tag name.*<br>A tag name containing non-alphanumeric characters (including non-English multibyte-UTF characters) should be double quoted. Quotes and backslashes inside a quoted tag name must be escaped with a backslash.| |{EVENT.CAUSE.TIME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands|*Time of the cause event in hh:mm:ss format.*| |{EVENT.CAUSE.UPDATE.HISTORY}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands|*Log of cause problem updates (acknowledgments, etc).*| |{EVENT.CAUSE.VALUE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands|*Numeric value of the cause event (1 for problem, 0 for recovering).*| |{EVENT.SYMPTOMS}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands|*The list of symptom events.*<br>Includes the following details: host name, event name, severity, age, service tags and values.| ### Cēloņa un simptomu notikumi {EVENT.CAUSE.*} makro tiek izmantoti simptomu notikuma kontekstā, piemēram, paziņojumos; tie atgriež informāciju par cēloņa notikumu. Makro {EVENT.SYMPTOMS} tiek izmantots cēloņa notikuma kontekstā un atgriež informāciju par simptomu notikumiem. |Makro|Atbalstīts|Apraksts| |--|--------|--------| |{EVENT.CAUSE.ACK.STATUS}|→ Uz trigeri balstīti paziņojumi un komandas<br>→ Problēmas atjauninājumu paziņojumi un komandas<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas|*Cēloņa notikuma apstiprinājuma statuss (Jā/Nē)*.| |{EVENT.CAUSE.AGE}|→ Uz trigeri balstīti paziņojumi un komandas<br>→ Problēmas atjauninājumu paziņojumi un komandas<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas|*Cēloņa notikuma vecums*, ar precizitāti līdz sekundei.<br>Noder eskalētos ziņojumos.| |{EVENT.CAUSE.DATE}|→ Uz trigeri balstīti paziņojumi un komandas<br>→ Problēmas atjauninājumu paziņojumi un komandas<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas|*Cēloņa notikuma datums formātā yyyy.mm.dd.*| |{EVENT.CAUSE.DURATION}|→ Uz trigeri balstīti paziņojumi un komandas<br>→ Problēmas atjauninājumu paziņojumi un komandas<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas|*Cēloņa notikuma ilgums (laika starpība starp problēmas un atjaunošanās notikumiem)*, ar precizitāti līdz sekundei.<br>Noder problēmas atjaunošanās ziņojumos.| |{EVENT.CAUSE.ID}|→ Uz trigeri balstīti paziņojumi un komandas<br>→ Problēmas atjauninājumu paziņojumi un komandas<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas|*Cēloņa notikuma skaitliskais ID .*| |{EVENT.CAUSE.NAME}|→ Uz trigeri balstīti paziņojumi un komandas<br>→ Problēmas atjauninājumu paziņojumi un komandas<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas|*Cēloņa problēmas notikuma nosaukums.*| |{EVENT.CAUSE.NSEVERITY}|→ Uz trigeri balstīti paziņojumi un komandas<br>→ Problēmas atjauninājumu paziņojumi un komandas<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas|*Cēloņa notikuma nopietnības skaitliskā vērtība.*<br>Iespējamās vērtības: 0 - Nav klasificēts, 1 - Informācija, 2 - Brīdinājums, 3 - Vidējs, 4 - Augsts, 5 - Katastrofāls.| |{EVENT.CAUSE.OBJECT}|→ Uz trigeri balstīti paziņojumi un komandas<br>→ Problēmas atjauninājumu paziņojumi un komandas<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas|*Cēloņa notikuma objekta skaitliskā vērtība.*<br>Iespējamās vērtības: 0 - Trigeris, 1 - Atklāts hosts, 2 - Atklāts pakalpojums, 3 - Automātiska reģistrācija, 4 - Vienums, 5 - Zema līmeņa atklāšanas noteikums.| |{EVENT.CAUSE.OPDATA}|→ Uz trigeri balstīti paziņojumi un komandas<br>→ Problēmas atjauninājumu paziņojumi un komandas<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas|*Cēloņa problēmas pamatā esošā trigera operatīvie dati.*| |{EVENT.CAUSE.SEVERITY}|→ Uz trigeri balstīti paziņojumi un komandas<br>→ Problēmas atjauninājumu paziņojumi un komandas<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas|*Cēloņa notikuma nopietnības nosaukums.*| |{EVENT.CAUSE.SOURCE}|→ Uz trigeri balstīti paziņojumi un komandas<br>→ Problēmas atjauninājumu paziņojumi un komandas<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas|*Cēloņa notikuma avota skaitliskā vērtība.*<br>Iespējamās vērtības: 0 - Trigeris, 1 - Atklāšana, 2 - Automātiska reģistrācija, 3 - Iekšējs.| |{EVENT.CAUSE.STATUS}|→ Uz trigeri balstīti paziņojumi un komandas<br>→ Problēmas atjauninājumu paziņojumi un komandas<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas|*Cēloņa notikuma verbālā vērtība.*| |{EVENT.CAUSE.TAGS}|→ Uz trigeri balstīti paziņojumi un komandas<br>→ Problēmas atjauninājumu paziņojumi un komandas<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas|*Ar komatiem atdalīts cēloņa notikuma tagu saraksts.*<br>Ja tagu nav, tiek izvērsts tukšā virknē.| |{EVENT.CAUSE.TAGSJSON}|→ Uz trigeri balstīti paziņojumi un komandas<br>→ Problēmas atjauninājumu paziņojumi un komandas<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas|*JSON masīvs, kas satur cēloņa notikuma taga [objektus](/manual/api/reference/event/object#event-tag).*<br>Ja tagu nav, tiek izvērsts tukšā masīvā.| |{EVENT.CAUSE.TAGS.\<tag name>}|→ Uz trigeri balstīti paziņojumi un komandas<br>→ Problēmas atjauninājumu paziņojumi un komandas<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas|*Cēloņa notikuma taga vērtība, kas norādīta ar taga nosaukumu.*<br>Taga nosaukums, kas satur ne burtciparu rakstzīmes (tostarp neangļu daudzbaitu UTF rakstzīmes), jāievieto dubultpēdiņās. Pēdiņas un slīpsvītras citētā taga nosaukumā ir jāekranē ar slīpsvītru.| |{EVENT.CAUSE.TIME}|→ Uz trigeri balstīti paziņojumi un komandas<br>→ Problēmas atjauninājumu paziņojumi un komandas<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas|*Cēloņa notikuma laiks formātā hh:mm:ss.*| |{EVENT.CAUSE.UPDATE.HISTORY}|→ Uz trigeri balstīti paziņojumi un komandas<br>→ Problēmas atjauninājumu paziņojumi un komandas<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas|*Cēloņa problēmas atjauninājumu žurnāls (apstiprinājumi u. c.).*| |{EVENT.CAUSE.VALUE}|→ Uz trigeri balstīti paziņojumi un komandas<br>→ Problēmas atjauninājumu paziņojumi un komandas<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas|*Cēloņa notikuma skaitliskā vērtība (1 problēmai, 0 atjaunošanai).*| |{EVENT.SYMPTOMS}|→ Uz trigeri balstīti paziņojumi un komandas<br>→ Problēmas atjauninājumu paziņojumi un komandas<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas|*Simptomu notikumu saraksts.*<br>Ietver šādu informāciju: hosts nosaukumu, notikuma nosaukumu, nopietnību, vecumu, pakalpojuma tagus un vērtības.| ##### cbrt(value) {#cbrt} The cube root of a value. Parameter: - **value** - the value to check For example, the cube root of '64' will be '4', of '63' will be '3.97905721'. Example: cbrt(last(/host/key)) ##### cbrt(value) {#cbrt} Vērtības kubsakne. Parametrs: - **value** - pārbaudāmā vērtība Piemēram, skaitļa '64' kubsakne būs '4', bet skaitļa '63' kubsakne būs '3.97905721'. Piemērs: cbrt(last(/host/key)) ##### ceil(value) {#ceil} Round the value up to the nearest greater or equal integer. Parameter: - **value** - the value to check For example, '2.4' will be rounded up to '3'. See also [floor()](#floor). Example: ceil(last(/host/key)) ##### ceil(value) {#ceil} Noapaļo vērtību uz augšu līdz tuvākajam lielākajam vai vienādam veselam skaitlim. Parametrs: - **value** - pārbaudāmā vērtība Piemēram, '2.4' tiks noapaļots uz augšu līdz '3'. Skatiet arī [floor()](#floor). Piemērs: ceil(last(/host/key)) ##### ceph.df.details[connString,<user>,<apikey>] {#ceph.df.details} <br> The cluster's data usage and distribution among pools.<br> Return value: *JSON object*. Parameters: - **connString** - the URI or session name;<br> - **user, apikey** - the user name and API key for connecting to Ceph.<br> ##### ceph.df.details[connString,<user>,<apikey>] {#ceph.df.details} <br> Klastera datu lietojums un sadalījums starp pūliem.<br> Atgrieztā vērtība: *JSON objekts*. Parametri: - **connString** - URI vai sesijas nosaukums;<br> - **user, apikey** - lietotājvārds un API atslēga savienojumam ar Ceph.<br> ##### ceph.osd.discovery[connString,<user>,<apikey>] {#ceph.osd.discovery} <br> The list of discovered OSDs. Used for [low-level discovery](/manual/discovery/low_level_discovery).<br> Return value: *JSON object*. Parameters: - **connString** - the URI or session name;<br> - **user, apikey** - the user name and API key for connecting to Ceph.<br> ##### ceph.osd.discovery[connString,<user>,<apikey>] {#ceph.osd.discovery} <br> Atklāto OSD saraksts. Izmanto [zemā līmeņa atklāšanai](/manual/discovery/low_level_discovery).<br> Atgrieztā vērtība: *JSON objekts*. Parametri: - **connString** - URI vai sesijas nosaukums;<br> - **user, apikey** - lietotājvārds un API atslēga savienojumam ar Ceph.<br> ##### ceph.osd.dump[connString,<user>,<apikey>] {#ceph.osd.dump} <br> The usage thresholds and statuses of OSDs.<br> Return value: *JSON object*. Parameters: - **connString** - the URI or session name;<br> - **user, apikey** - the user name and API key for connecting to Ceph.<br> ##### ceph.osd.dump[connString,<user>,<apikey>] {#ceph.osd.dump} <br> OSD lietojuma sliekšņi un statusi.<br> Atgrieztā vērtība: *JSON object*. Parametri: - **connString** - URI vai sesijas nosaukums;<br> - **user, apikey** - lietotājvārds un API atslēga savienojumam ar Ceph.<br> ##### ceph.osd.stats[connString,<user>,<apikey>] {#ceph.osd.stats} <br> Aggregated and per OSD statistics.<br> Return value: *JSON object*. Parameters: - **connString** - the URI or session name;<br> - **user, apikey** - the user name and API key for connecting to Ceph.<br> ##### ceph.osd.stats[connString,<user>,<apikey>] {#ceph.osd.stats} <br> Apkopotā un katra OSD statistika.<br> Atgrieztā vērtība: *JSON objekts*. Parametri: - **connString** - URI vai sesijas nosaukums;<br> - **user, apikey** - lietotājvārds un API atslēga savienojumam ar Ceph.<br> ##### ceph.ping[connString,<user>,<apikey>] {#ceph.ping} <br> Tests whether a connection to Ceph can be established.<br> Return value: *0* - connection is broken (if there is any error presented including AUTH and configuration issues); *1* - connection is successful. Parameters: - **connString** - the URI or session name;<br> - **user, apikey** - the user name and API key for connecting to Ceph.<br> ##### ceph.ping[connString,<user>,<apikey>] {#ceph.ping} <br> Pārbauda, vai var izveidot savienojumu ar Ceph.<br> Atgrieztā vērtība: *0* - savienojums ir pārtraukts (ja ir radusies jebkāda kļūda, tostarp AUTH un konfigurācijas problēmas); *1* - savienojums ir veiksmīgs. Parametri: - **connString** - URI vai sesijas nosaukums;<br> - **user, apikey** - lietotājvārds un API atslēga savienojuma izveidei ar Ceph.<br> ##### ceph.pool.discovery[connString,<user>,<apikey>] {#ceph.pool.discovery} <br> The list of discovered pools. Used for [low-level discovery](/manual/discovery/low_level_discovery).<br> Return value: *JSON object*. Parameters: - **connString** - the URI or session name;<br> - **user, apikey** - the user name and API key for connecting to Ceph.<br> ##### ceph.pool.discovery[connString,<user>,<apikey>] {#ceph.pool.discovery} <br> Atklāto pūlu saraksts. Izmanto [zema līmeņa atklāšanai](/manual/discovery/low_level_discovery).<br> Atgrieztā vērtība: *JSON objekts*. Parametri: - **connString** - URI vai sesijas nosaukums;<br> - **user, apikey** - lietotājvārds un API atslēga savienojumam ar Ceph.<br> ##### ceph.status[connString,<user>,<apikey>] {#ceph.status} <br> The overall cluster's status.<br> Return value: *JSON object*. Parameters: - **connString** - the URI or session name;<br> - **user, apikey** - the user name and API key for connecting to Ceph.<br> ##### ceph.status[connString,<user>,<apikey>] {#ceph.status} <br> Kopējā klastera statuss.<br> Atgrieztā vērtība: *JSON objekts*. Parametri: - **connString** - URI vai sesijas nosaukums;<br> - **user, apikey** - lietotājvārds un API atslēga savienojumam ar Ceph.<br> #### Certificate configuration parameters The following configuration parameters are supported for setting up certificates on Zabbix components. |Parameter|Mandatory|Description| |--|-|--------| |*TLSCAFile*|yes|Full pathname of a file containing the top-level CA(s) certificates for peer certificate verification.<br>If using a certificate chain with multiple members, order the certificates with lower level CA(s) certificates first, followed by higher level CA(s) certificates.<br>Certificates from multiple CAs can be included in a single file.| |*TLSCRLFile*|no|Full pathname of a file containing [Certificate Revocation Lists (CRL)](#certificate-revocation-lists-crl).| |*TLSCertFile*|yes|Full pathname of a file containing the certificate.<br>If using a certificate chain with multiple members, order the certificates with the server, proxy, or agent certificate first, followed by lower level CA(s) certificates, and concluded by higher level CA(s) certificates.| |*TLSKeyFile*|yes|Full pathname of a file containing the private key.<br>Ensure that this file is readable only by the [Zabbix user](/manual/installation/install#2-create-user-account) by setting appropriate access rights.| |*TLSServerCertIssuer*|no|Allowed server certificate issuer.| |*TLSServerCertSubject*|no|Allowed server certificate subject.| #### Sertifikātu konfigurācijas parametri Tālāk norādītie konfigurācijas parametri tiek atbalstīti sertifikātu iestatīšanai Zabbix komponentos. |Parameter|Mandatory|Description| |--|-|--------| |*TLSCAFile*|yes|Pilns ceļš uz failu, kurā ir augstākā līmeņa CA sertifikāti vienaudža sertifikāta verifikācijai.<br>Ja tiek izmantota sertifikātu ķēde ar vairākiem dalībniekiem, sertifikātus sakārtojiet tā, lai zemāka līmeņa CA sertifikāti būtu pirmie, kam seko augstāka līmeņa CA sertifikāti.<br>Vienā failā var iekļaut vairāku CA sertifikātus.| |*TLSCRLFile*|no|Pilns ceļš uz failu, kurā ir [sertifikātu atsaukšanas saraksti (CRL)](#certificate-revocation-lists-crl).| |*TLSCertFile*|yes|Pilns ceļš uz failu, kurā ir sertifikāts.<br>Ja tiek izmantota sertifikātu ķēde ar vairākiem dalībniekiem, sertifikātus sakārtojiet tā, lai vispirms būtu servera, starpniekservera vai aģenta sertifikāts, kam seko zemāka līmeņa CA sertifikāti, un beigās augstāka līmeņa CA sertifikāti.| |*TLSKeyFile*|yes|Pilns ceļš uz failu, kurā ir privātā atslēga.<br>Nodrošiniet, ka šo failu var lasīt tikai [Zabbix lietotājs](/manual/installation/install#2-create-user-account), iestatot atbilstošas piekļuves tiesības.| |*TLSServerCertIssuer*|no|Atļautais servera sertifikāta izdevējs.| |*TLSServerCertSubject*|no|Atļautais servera sertifikāta subjekts.| #### Certificate Revocation Lists (CRL) If a certificate is compromised, the Certificate Authority (CA) can revoke it by including the certificate in a Certificate Revocation List (CRL). CRLs are managed through configuration files and can be specified using the `TLSCRLFile` parameter in server, proxy, and agent configuration files. For example: ```ini TLSCRLFile=/home/zabbix/zabbix_crl_file.crt ``` In this case, `zabbix_crl_file.crt` may contain CRLs from multiple CAs, and could look like this: ```ini -----BEGIN X509 CRL----- MIIB/DCB5QIBATANBgkqhkiG9w0BAQUFADCBgTETMBEGCgmSJomT8ixkARkWA2Nv ... treZeUPjb7LSmZ3K2hpbZN7SoOZcAoHQ3GWd9npuctg= -----END X509 CRL----- -----BEGIN X509 CRL----- MIIB+TCB4gIBATANBgkqhkiG9w0BAQUFADB/MRMwEQYKCZImiZPyLGQBGRYDY29t ... CAEebS2CND3ShBedZ8YSil59O6JvaDP61lR5lNs= -----END X509 CRL----- ``` The CRL file is loaded only when Zabbix starts. To update the CRL, restart Zabbix. ::: noteimportant If Zabbix components are compiled with OpenSSL and CRLs are used, ensure that each top-level and intermediate CA in the certificate chains has a corresponding CRL (even if it is empty) included in the `TLSCRLFile`. ::: #### Sertifikātu atsaukšanas saraksti (CRL) Ja sertifikāts ir kompromitēts, sertifikācijas iestāde (CA) var to atsaukt, iekļaujot sertifikātu sertifikātu atsaukšanas sarakstā (CRL). CRL tiek pārvaldīti, izmantojot konfigurācijas failus, un tos var norādīt ar parametru `TLSCRLFile` servera, starpniekservera un aģenta konfigurācijas failos. Piemēram: ```ini TLSCRLFile=/home/zabbix/zabbix_crl_file.crt ``` Šajā gadījumā `zabbix_crl_file.crt` var saturēt CRL no vairākām CA, un tas var izskatīties šādi: ```ini -----BEGIN X509 CRL----- MIIB/DCB5QIBATANBgkqhkiG9w0BAQUFADCBgTETMBEGCgmSJomT8ixkARkWA2Nv ... treZeUPjb7LSmZ3K2hpbZN7SoOZcAoHQ3GWd9npuctg= -----END X509 CRL----- -----BEGIN X509 CRL----- MIIB+TCB4gIBATANBgkqhkiG9w0BAQUFADB/MRMwEQYKCZImiZPyLGQBGRYDY29t ... CAEebS2CND3ShBedZ8YSil59O6JvaDP61lR5lNs= -----END X509 CRL----- ``` CRL fails tiek ielādēts tikai Zabbix palaišanas laikā. Lai atjauninātu CRL, restartējiet Zabbix. ::: noteimportant Ja Zabbix komponenti ir kompilēti ar OpenSSL un tiek izmantoti CRL, pārliecinieties, ka katrai augstākā līmeņa un starpposma CA sertifikātu ķēdēs ir atbilstošs CRL (pat ja tas ir tukšs), kas iekļauts `TLSCRLFile`. ::: ##### changecount(/host/key,(sec|#num)<:time shift>,<mode>) {#changecount} The number of changes between adjacent values within the defined evaluation period.<br> Supported value types: *Float*, *Integer*, *String*, *Text*, *Log*. Parameters: - See [common parameters](#common-parameters)<br> - **mode** (must be double-quoted) - possible values: *all* - count all changes (default); *dec* - count decreases; *inc* - count increases For non-numeric value types, the *mode* parameter is ignored. Examples: ```default changecount(/host/icmpping,10m)>5 #ping status has changed more than 5 times in 10 minutes changecount(/host/vfs.file.contents["/sys/class/net/eth0/operstate"],1h)>5 #operational state of eth0 has changed more than 5 times in an hour changecount(/host/proc.num[httpd],15m)>10 #the number of httpd processes has changed more than 10 times in 15 minutes changecount(/host/key,#10,"inc") #the number of value increases (relative to the adjacent value) among the last 10 values changecount(/host/key,24h,"dec") #the number of value decreases (relative to the adjacent value) for the last 24 hours until now ``` ##### changecount(/host/key,(sec|#num)<:time shift>,<mode>) {#changecount} Izmaiņu skaits starp blakus esošajām vērtībām noteiktajā novērtēšanas periodā.<br> Atbalstītie vērtību tipi: *Float*, *Integer*, *String*, *Text*, *Log*. Parametri: - Skatiet [kopējos parametrus](#common-parameters)<br> - **mode** (jānorāda pēdiņās) - iespējamās vērtības: *all* - skaita visas izmaiņas (noklusējums); *dec* - skaita samazinājumus; *inc* - skaita palielinājumus Nekaitliskajiem vērtību tipiem parametrs *mode* tiek ignorēts. Piemēri: ```default changecount(/host/icmpping,10m)>5 #ping status ir mainījies vairāk nekā 5 reizes 10 minūšu laikā changecount(/host/vfs.file.contents["/sys/class/net/eth0/operstate"],1h)>5 #eth0 darbības stāvoklis ir mainījies vairāk nekā 5 reizes stundas laikā changecount(/host/proc.num[httpd],15m)>10 #httpd procesu skaits ir mainījies vairāk nekā 10 reizes 15 minūšu laikā changecount(/host/key,#10,"inc") #vērtības pieaugumu skaits (attiecībā pret blakus esošo vērtību) pēdējās 10 vērtībās changecount(/host/key,24h,"dec") #vērtības samazinājumu skaits (attiecībā pret blakus esošo vērtību) pēdējo 24 stundu laikā līdz šim brīdim ``` #### Change dashboard owner Available only for admins and super admins. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.update", "params": { "dashboardid": "2", "userid": "1" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "2" ] }, "id": 1 } ``` #### Mainīt paneļa īpašnieku Pieejams tikai administratoriem un super administratoriem. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.update", "params": { "dashboardid": "2", "userid": "1" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "2" ] }, "id": 1 } ``` ##### change(/host/key) {#change} The amount of difference between the previous and latest value.<br> Supported value types: *Float*, *Integer*, *String*, *Text*, *Log*.<br> For strings returns: 0 - values are equal; 1 - values differ. Parameters: see [common parameters](#common-parameters). Comments: - Numeric difference will be calculated, as seen with these incoming example values ('previous' and 'latest' value = difference):<br>'1' and '5' = `+4`<br>'3' and '1' = `-2`<br>'0' and '-2.5' = `-2.5`.<br> - See also: [abs](/manual/appendix/functions/math#abs) for comparison. Examples: ```default change(/host/system.uptime)<0 #system uptime change has been negative since the last value (indicating a reboot) change(/host/system.cpu.load[all,avg1])>2 #CPU load (for one minute) has jumped by more than 2 since the last value change(/host/vfs.fs.size[/,free])<-1G #free disk space has dropped by more than 1 GB between checks ``` ##### change(/host/key) {#change} Atšķirība starp iepriekšējo un jaunāko vērtību.<br> Atbalstītie vērtību tipi: *Float*, *Integer*, *String*, *Text*, *Log*.<br> Virknēm atgriež: 0 - vērtības ir vienādas; 1 - vērtības atšķiras. Parametri: skatiet [kopējos parametrus](#common-parameters). Komentāri: - Skaitliskā atšķirība tiks aprēķināta, kā redzams šajos ienākošo piemēru vērtību pāros ('previous' un 'latest' vērtība = atšķirība):<br>'1' un '5' = `+4`<br>'3' un '1' = `-2`<br>'0' un '-2.5' = `-2.5`.<br> - Skatiet arī: [abs](/manual/appendix/functions/math#abs) salīdzināšanai. Piemēri: ```default change(/host/system.uptime)<0 #sistēmas darbības laika izmaiņa kopš pēdējās vērtības ir bijusi negatīva (norādot uz pārstartēšanu) change(/host/system.cpu.load[all,avg1])>2 #CPU noslodze (vienas minūtes vidējā) kopš pēdējās vērtības ir pieaugusi par vairāk nekā 2 change(/host/vfs.fs.size[/,free])<-1G #brīvā diska vieta starp pārbaudēm ir samazinājusies par vairāk nekā 1 GB ``` #### Change hosts monitored by a proxy Update the proxy to monitor the two given hosts. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "proxy.update", "params": { "proxyid": "10293", "hosts": [ { "hostid": "10294" }, { "hostid": "10295" } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "proxyids": [ "10293" ] }, "id": 1 } ``` #### Mainīt starpniekservera uzraudzītos hostus Atjauniniet starpniekserveri, lai tas uzraudzītu divus norādītos hostus. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "proxy.update", "params": { "proxyid": "10293", "hosts": [ { "hostid": "10294" }, { "hostid": "10295" } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "proxyids": [ "10293" ] }, "id": 1 } ``` ##### Change indicator The following advanced configuration parameters are supported if *Show* is set to "Change indicator". |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Change indicator ↑ color*|1|up_color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `""` (empty).| |*Change indicator ↓ color*|1|down_color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `""` (empty).| |*Change indicator ↕ color*|1|updown_color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `""` (empty).| ##### Izmaiņu indikators Tālāk norādītie paplašinātās konfigurācijas parametri tiek atbalstīti, ja *Rādīt* ir iestatīts uz "Izmaiņu indikators". |Parametrs|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Izmaiņu indikatora ↑ krāsa*|1|up_color|Heksadecimāls krāsas kods (piemēram, `FF0000`).<br><br>Noklusējums: `""` (tukšs).| |*Izmaiņu indikatora ↓ krāsa*|1|down_color|Heksadecimāls krāsas kods (piemēram, `FF0000`).<br><br>Noklusējums: `""` (tukšs).| |*Izmaiņu indikatora ↕ krāsa*|1|updown_color|Heksadecimāls krāsas kods (piemēram, `FF0000`).<br><br>Noklusējums: `""` (tukšs).| #### Change macro value that was created by discovery rule Convert discovery rule created "automatic" macro to "manual" and change its value to "new-value". [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "usermacro.update", "params": { "hostmacroid": "1", "value": "new-value", "automatic": "0" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostmacroids": [ "1" ] }, "id": 1 } ``` #### Mainīt makro vērtību, ko izveidoja atklāšanas kārtula Pārveidot ar atklāšanas kārtulu izveidotu "automatic" makro par "manual" un mainīt tā vērtību uz "new-value". [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "usermacro.update", "params": { "hostmacroid": "1", "value": "new-value", "automatic": "0" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "hostmacroids": [ "1" ] }, "id": 1 } ``` #### Change map owner Available only for admins and super admins. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "map.update", "params": { "sysmapid": "9", "userid": "1" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "sysmapids": [ "9" ] }, "id": 1 } ``` #### Mainīt kartes īpašnieku Pieejams tikai administratoriem un super administratoriem. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "map.update", "params": { "sysmapid": "9", "userid": "1" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "sysmapids": [ "9" ] }, "id": 1 } ``` #### Change minimum number of online proxies Change minimum number of online proxies required for the group to be online. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "proxygroup.update", "params": { "proxy_groupid": "5", "min_online": "3" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "proxy_groupids": [ "5" ] }, "id": 1 } ``` #### Mainīt minimālo tiešsaistē esošo starpniekserveru skaitu Mainīt minimālo tiešsaistē esošo starpniekserveru skaitu, kas nepieciešams, lai grupa būtu tiešsaistē. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "proxygroup.update", "params": { "proxy_groupid": "5", "min_online": "3" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "proxy_groupids": [ "5" ] }, "id": 1 } ``` ##### Change per second {#changepersec} Calculate the value change (difference between the current and previous value) speed per second. Comments: - This step is useful for calculating the speed per second of a constantly growing value;<br> - As this calculation may produce floating-point numbers, it is recommended to set the 'Type of information' to *Numeric (float)*, even if the incoming raw values are integers. This is especially relevant for small numbers where the decimal part matters. If the floating-point values are large and may exceed the 'float' field length in which case the entire value may be lost, it is actually suggested to use *Numeric (unsigned)* and thus trim only the decimal part.<br> - Evaluated as (**value**-**prev\_value**)/(**time**-**prev\_time**), where *value* - the current value; *prev\_value* - the previously received value; *time* - the current timestamp; *prev\_time* - the timestamp of the previous value;<br> - Only one change operation per item ("Simple change" or "Change per second") is allowed; - If the current value is smaller than the previous value, Zabbix discards that difference (stores nothing) and waits for another value. This helps to work correctly with, for instance, a wrapping (overflow) of 32-bit SNMP counters.<br> - If you mark the *Custom on fail* checkbox, it is possible to specify custom error-handling options: either to discard the value, set a specified value, or set a specified error message. In case of a failed preprocessing step, the item will not become unsupported if the option to discard the value or set a specified value is selected. ##### Izmaiņa sekundē {#changepersec} Aprēķina vērtības izmaiņas ātrumu sekundē (starpību starp pašreizējo un iepriekšējo vērtību). Komentāri: - Šis solis ir noderīgs, lai aprēķinātu nepārtraukti augošas vērtības pieauguma ātrumu sekundē;<br> - Tā kā šis aprēķins var radīt peldošā komata skaitļus, ieteicams iestatīt *Informācijas tipu* uz *Skaitlis (peldošais komats)*, pat ja ienākošās neapstrādātās vērtības ir veseli skaitļi. Tas ir īpaši svarīgi maziem skaitļiem, kur nozīme ir decimālajai daļai. Ja peldošā komata vērtības ir lielas un var pārsniegt lauka *float* garumu, kā rezultātā var tikt zaudēta visa vērtība, patiesībā ieteicams izmantot *Skaitlis (bez zīmes)* un tādējādi nogriezt tikai decimālo daļu.<br> - Tiek aprēķināts kā (**value**-**prev\_value**)/(**time**-**prev\_time**), kur *value* - pašreizējā vērtība; *prev\_value* - iepriekš saņemtā vērtība; *time* - pašreizējais laikspiedols; *prev\_time* - iepriekšējās vērtības laikspiedols;<br> - Vienam vienumam ir atļauta tikai viena izmaiņu operācija ("Vienkārša izmaiņa" vai "Izmaiņa sekundē"); - Ja pašreizējā vērtība ir mazāka par iepriekšējo vērtību, Zabbix šo starpību ignorē (neuzglabā neko) un gaida nākamo vērtību. Tas palīdz pareizi strādāt, piemēram, ar 32 bitu SNMP skaitītāju apvēršanos (overflow).<br> - Ja atzīmējat izvēles rūtiņu *Pielāgots kļūmes gadījumā*, ir iespējams norādīt pielāgotas kļūdu apstrādes opcijas: vai nu ignorēt vērtību, iestatīt norādītu vērtību vai iestatīt norādītu kļūdas ziņojumu. Neizdevušās priekšapstrādes darbības gadījumā vienums netiks atzīts par neatbalstītu, ja ir izvēlēta opcija ignorēt vērtību vai iestatīt norādītu vērtību. #### Change proxy status Change the proxy to an active proxy and rename it to "Active proxy". [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "proxy.update", "params": { "proxyid": "10293", "name": "Active proxy", "operating_mode": "0" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "proxyids": [ "10293" ] }, "id": 1 } ``` #### Mainīt starpniekservera statusu Mainiet starpniekserveri uz aktīvu starpniekserveri un pārdēvējiet to par "Active proxy". [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "proxy.update", "params": { "proxyid": "10293", "name": "Active proxy", "operating_mode": "0" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "proxyids": [ "10293" ] }, "id": 1 } ``` #### Change script command and add manual input Change the command of the script to "/bin/ping -c {MANUALINPUT} {HOST.CONN} 2>&1". [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "script.update", "params": { "scriptid": "1", "command": "/bin/ping -c {MANUALINPUT} {HOST.CONN} 2>&1", "manualinput": "1", "manualinput_prompt": "Specify the number of ICMP packets to send with the ping command", "manualinput_validator": "^(?:[1-9]|10)$", "manualinput_validator_type": "0", "manualinput_default_value": "10" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "scriptids": [ "1" ] }, "id": 1 } ``` #### Mainīt skripta komandu un pievienot manuālu ievadi Mainiet skripta komandu uz "/bin/ping -c {MANUALINPUT} {HOST.CONN} 2>&1". [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "script.update", "params": { "scriptid": "1", "command": "/bin/ping -c {MANUALINPUT} {HOST.CONN} 2>&1", "manualinput": "1", "manualinput_prompt": "Norādiet ar ping komandu nosūtāmo ICMP pakešu skaitu", "manualinput_validator": "^(?:[1-9]|10)$", "manualinput_validator_type": "0", "manualinput_default_value": "10" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "scriptids": [ "1" ] }, "id": 1 } ``` #### Change script command Change the command of the script to "/bin/ping -c 10 {HOST.CONN} 2>&1". [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "script.update", "params": { "scriptid": "1", "command": "/bin/ping -c 10 {HOST.CONN} 2>&1" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "scriptids": [ "1" ] }, "id": 1 } ``` #### Mainīt skripta komandu Mainīt skripta komandu uz "/bin/ping -c 10 {HOST.CONN} 2>&1". [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "script.update", "params": { "scriptid": "1", "command": "/bin/ping -c 10 {HOST.CONN} 2>&1" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "scriptids": [ "1" ] }, "id": 1 } ``` ### Changes from 6.4 to 7.0 ### Izmaiņas no 6.4 uz 7.0 #### Changes in 7.0.0 #### Izmaiņas 7.0.0 versijā #### Changes in 7.0.1 #### Izmaiņas 7.0.1 #### Changes in 7.0.10 #### Izmaiņas 7.0.10 #### Changes in 7.0.11 #### Izmaiņas 7.0.11 #### Changes in 7.0.12 #### Izmaiņas 7.0.12 #### Changes in 7.0.13 #### Izmaiņas 7.0.13 #### Changes in 7.0.14 #### Izmaiņas 7.0.14 #### Changes in 7.0.17 #### Izmaiņas 7.0.17 #### Changes in 7.0.18 #### Izmaiņas 7.0.18 #### Changes in 7.0.19 #### Izmaiņas 7.0.19 #### Changes in 7.0.2 #### Izmaiņas 7.0.2 #### Changes in 7.0.20 #### Izmaiņas 7.0.20 #### Changes in 7.0.22 #### Izmaiņas 7.0.22 #### Changes in 7.0.23 #### Izmaiņas 7.0.23 #### Changes in 7.0.24 This minor version does not have any template changes. #### Izmaiņas 7.0.24 Šajā mazajā versijā nav nekādu veidņu izmaiņu. #### Changes in 7.0.25 This minor version does not have any template changes. #### Izmaiņas 7.0.25 Šajā mazajā versijā nav veidņu izmaiņu. #### Changes in 7.0.26 #### Izmaiņas 7.0.26 #### Changes in 7.0.3 This minor version does not have any template changes. #### Izmaiņas 7.0.3 Šajā mazajā versijā nav nekādu veidņu izmaiņu. #### Changes in 7.0.4 #### Izmaiņas 7.0.4 #### Changes in 7.0.5 #### Izmaiņas 7.0.5 #### Changes in 7.0.6 #### Izmaiņas 7.0.6 #### Changes in 7.0.7 #### Izmaiņas 7.0.7 #### Changes in 7.0.8 #### Izmaiņas 7.0.8 #### Changes in the resolution of certain built-in macros after upgrade to 7.0.4 In Zabbix 7.0.4, the behavior of resolving the macros `{HOST.CONN}`, `{HOST.DNS}`, `{HOST.IP}`, `{EVENT.CAUSE.*}`, `{EVENT.TAGS.*}`, and `{EVENT.SYMPTOMS}` has been corrected for consistency with other built-in macros. Now, they will resolve to `*UNKNOWN*` if an error occurs while evaluating their value. As a result of this change, to ensure proper functionality, it is necessary to update the media types for the following integrations: [iTop](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/itop?at=refs%2Fheads%2Frelease%2F7.0), [Jira Service Desk](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/jira_servicedesk?at=refs%2Fheads%2Frelease%2F7.0), [ManageEngine ServiceDesk](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/manageengine_servicedesk?at=refs%2Fheads%2Frelease%2F7.0), [SolarWinds Service Desk](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/solarwinds?at=refs%2Fheads%2Frelease%2F7.0). This change may also affect any custom scripts or integrations using the abovementioned macros. #### Izmaiņas noteiktu iebūvēto makro atrisināšanā pēc atjaunināšanas uz 7.0.4 Zabbix 7.0.4 ir izlabota makro `{HOST.CONN}`, `{HOST.DNS}`, `{HOST.IP}`, `{EVENT.CAUSE.*}`, `{EVENT.TAGS.*}` un `{EVENT.SYMPTOMS}` atrisināšanas darbība, lai tā būtu konsekventa ar citiem iebūvētajiem makro. Tagad, ja to vērtības aprēķināšanas laikā rodas kļūda, tās tiks atrisinātas kā `*UNKNOWN*`. Šīs izmaiņas rezultātā, lai nodrošinātu pareizu darbību, ir nepieciešams atjaunināt šādu integrāciju multivides tipus: [iTop](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/itop?at=refs%2Fheads%2Frelease%2F7.0), [Jira Service Desk](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/jira_servicedesk?at=refs%2Fheads%2Frelease%2F7.0), [ManageEngine ServiceDesk](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/manageengine_servicedesk?at=refs%2Fheads%2Frelease%2F7.0), [SolarWinds Service Desk](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/solarwinds?at=refs%2Fheads%2Frelease%2F7.0). Šīs izmaiņas var ietekmēt arī jebkurus pielāgotus skriptus vai integrācijas, kas izmanto iepriekš minētos makro. #### Changes in the resolution of certain built-in macros The behavior of resolving the macros `{HOST.CONN}`, `{HOST.DNS}`, `{HOST.IP}`, `{EVENT.CAUSE.*}`, `{EVENT.TAGS.*}`, and `{EVENT.SYMPTOMS}` has been corrected for consistency with other built-in macros. Now, they will resolve to `*UNKNOWN*` if an error occurs while evaluating their value. As a result of this change, to ensure proper functionality, it is necessary to update the media types for the following integrations: [iTop](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/itop?at=refs%2Fheads%2Frelease%2F7.0), [Jira Service Desk](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/jira_servicedesk?at=refs%2Fheads%2Frelease%2F7.0), [ManageEngine ServiceDesk](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/manageengine_servicedesk?at=refs%2Fheads%2Frelease%2F7.0), [SolarWinds Service Desk](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/solarwinds?at=refs%2Fheads%2Frelease%2F7.0). This change may also affect any custom scripts or integrations using the abovementioned macros. #### Izmaiņas noteiktu iebūvēto makro atrisināšanā Makro `{HOST.CONN}`, `{HOST.DNS}`, `{HOST.IP}`, `{EVENT.CAUSE.*}`, `{EVENT.TAGS.*}` un `{EVENT.SYMPTOMS}` atrisināšanas darbība ir labota, lai tā būtu konsekventa ar citiem iebūvētajiem makro. Tagad tie tiks atrisināti kā `*UNKNOWN*`, ja, aprēķinot to vērtību, radīsies kļūda. Šīs izmaiņas rezultātā, lai nodrošinātu pareizu darbību, ir nepieciešams atjaunināt šādu integrāciju multivides tipus: [iTop](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/itop?at=refs%2Fheads%2Frelease%2F7.0), [Jira Service Desk](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/jira_servicedesk?at=refs%2Fheads%2Frelease%2F7.0), [ManageEngine ServiceDesk](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/manageengine_servicedesk?at=refs%2Fheads%2Frelease%2F7.0), [SolarWinds Service Desk](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/solarwinds?at=refs%2Fheads%2Frelease%2F7.0). Šīs izmaiņas var ietekmēt arī jebkurus pielāgotus skriptus vai integrācijas, kas izmanto iepriekš minētos makro. #### Changes to AlmaLinux 8 configuration The appliance is based on AlmaLinux 8. There are some changes applied to the base AlmaLinux configuration. #### AlmaLinux 8 konfigurācijas izmaiņas Ierīce ir balstīta uz AlmaLinux 8. Bāzes AlmaLinux konfigurācijā ir veiktas dažas izmaiņas. # Changes to extension development This page lists all changes to developing custom Zabbix extensions. # Izmaiņas paplašinājumu izstrādē Šajā lapā ir uzskaitītas visas izmaiņas pielāgoto Zabbix paplašinājumu izstrādē. #### Changes to the Zabbix SELinux policy package For version 10 of AlmaLinux, CentOS Stream, RHEL, Rocky Linux, and Oracle Linux, the existing `zabbix-selinux-policy` package now has a dependency on either `zabbix-selinux-policy-main` or `selinux-policy-targeted-extra`.<br> If you have existing `zabbix-selinux-policy` installation, no manual changes are required. During package upgrade, `zabbix-selinux-policy-main` will be installed automatically. If `selinux-policy-targeted-extra` is already installed, no additional package will be installed. #### Izmaiņas Zabbix SELinux politikas pakotnē AlmaLinux, CentOS Stream, RHEL, Rocky Linux un Oracle Linux 10. versijai esošajai `zabbix-selinux-policy` pakotnei tagad ir atkarība no `zabbix-selinux-policy-main` vai `selinux-policy-targeted-extra`.<br> Ja jums jau ir instalēta `zabbix-selinux-policy`, manuālas izmaiņas nav nepieciešamas. Pakotnes jaunināšanas laikā `zabbix-selinux-policy-main` tiks instalēta automātiski. Ja `selinux-policy-targeted-extra` jau ir instalēta, papildu pakotne netiks instalēta. #### Changes to the Zabbix SELinux policy package For version 10 of AlmaLinux, CentOS Stream, RHEL, Rocky Linux, and Oracle Linux, the SELinux policy is provided by the new `zabbix-selinux-policy-main` package, which contains the SELinux policy from the upstream SELinux repository. The existing `zabbix-selinux-policy` package now has a dependency on either `zabbix-selinux-policy-main` or `selinux-policy-targeted-extra`. The `zabbix-selinux-policy-main` package conflicts with `selinux-policy-targeted-extra`; therefore, both packages cannot be installed at the same time. If you have existing `zabbix-selinux-policy` installation, no manual changes are required. During package upgrade, `zabbix-selinux-policy-main` will be installed automatically. If `selinux-policy-targeted-extra` is already installed, no additional package will be installed. #### Izmaiņas Zabbix SELinux politikas pakotnē AlmaLinux, CentOS Stream, RHEL, Rocky Linux un Oracle Linux 10. versijai SELinux politika tiek nodrošināta ar jauno `zabbix-selinux-policy-main` pakotni, kurā ir SELinux politika no augšupējās SELinux repozitorija. Esošajai `zabbix-selinux-policy` pakotnei tagad ir atkarība no vai nu `zabbix-selinux-policy-main`, vai `selinux-policy-targeted-extra`. `zabbix-selinux-policy-main` pakotne konfliktē ar `selinux-policy-targeted-extra`; tādēļ abas pakotnes nevar instalēt vienlaikus. Ja jums jau ir esoša `zabbix-selinux-policy` instalācija, manuālas izmaiņas nav nepieciešamas. Pakotnes jaunināšanas laikā `zabbix-selinux-policy-main` tiks instalēta automātiski. Ja `selinux-policy-targeted-extra` jau ir instalēta, papildu pakotne netiks instalēta. ##### Changes to Zabbix configuration - Frontend timezone is set to Europe/Riga (this can be modified in **/etc/php-fpm.d/zabbix.conf**); ##### Izmaiņas Zabbix konfigurācijā - Lietotāja saskarnes laika josla ir iestatīta uz Europe/Riga (to var mainīt **/etc/php-fpm.d/zabbix.conf**); #### Change the IP range of a discovery rule Change the IP range of a discovery rule to "192.168.2.1-255". [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "drule.update", "params": { "druleid": "6", "iprange": "192.168.2.1-255" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "druleids": [ "6" ] }, "id": 1 } ``` #### Mainīt atklāšanas kārtulas IP diapazonu Mainiet atklāšanas kārtulas IP diapazonu uz "192.168.2.1-255". [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "drule.update", "params": { "druleid": "6", "iprange": "192.168.2.1-255" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "druleids": [ "6" ] }, "id": 1 } ``` #### Changing a host interface port Change the port of a host interface. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "hostinterface.update", "params": { "interfaceid": "30048", "port": "30050" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "interfaceids": [ "30048" ] }, "id": 1 } ``` #### Hosts saskarnes porta maiņa Mainiet hosts saskarnes portu. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "hostinterface.update", "params": { "interfaceid": "30048", "port": "30050" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "interfaceids": [ "30048" ] }, "id": 1 } ``` #### Changing event's severity Change severity for multiple events and leave a message. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "event.acknowledge", "params": { "eventids": ["20427", "20428"], "action": 12, "message": "Maintenance required to fix it.", "severity": 4 }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "eventids": [ "20427", "20428" ] }, "id": 1 } ``` #### Notikuma nopietnības maiņa Mainiet vairāku notikumu nopietnību un atstājiet ziņojumu. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "event.acknowledge", "params": { "eventids": ["20427", "20428"], "action": 12, "message": "Maintenance required to fix it.", "severity": 4 }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "eventids": [ "20427", "20428" ] }, "id": 1 } ``` #### Changing HTTP authentication type Change HTTP authentication type to Bearer for connector with ID "3". [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "connector.update", "params": { "connectorid": 3, "authtype": 5, "token": "{$DATA_EXPORT_BEARER_TOKEN}" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "connectorids": [ "3" ] }, "id": 1 } ``` #### HTTP autentifikācijas tipa maiņa Mainiet HTTP autentifikācijas tipu uz Bearer savienotājam ar ID "3". [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "connector.update", "params": { "connectorid": 3, "authtype": 5, "token": "{$DATA_EXPORT_BEARER_TOKEN}" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "connectorids": [ "3" ] }, "id": 1 } ``` #### Changing mappings for one value map. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "valuemap.update", "params": { "valuemapid": "2", "mappings": [ { "type": "0", "value": "0", "newvalue": "Online" }, { "type": "0", "value": "1", "newvalue": "Offline" } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "valuemapids": [ "2" ] }, "id": 1 } ``` #### Vienas vērtību kartes atbilsmju maiņa. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "valuemap.update", "params": { "valuemapid": "2", "mappings": [ { "type": "0", "value": "0", "newvalue": "Online" }, { "type": "0", "value": "1", "newvalue": "Offline" } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "valuemapids": [ "2" ] }, "id": 1 } ``` #### Changing proxy setting The hosts discovered by different proxies are not always treated as different hosts. Discovery and uniqueness checks depend on the proxy group structure: when a proxy runs a discovery rule and creates a host, that host is added to the proxy's parent proxy group, not assigned to the proxy itself. When Zabbix evaluates IP uniqueness during discovery, it checks hosts monitored by the parent proxy group. Hosts monitored by individual proxies within that group (including the proxy that ran the discovery) are ignored for the uniqueness check, which can result in duplicate hosts if multiple proxies monitor overlapping subnets. While this behavior allows discovery to operate across overlapping IP ranges used by different subnets, changing the proxy assigned to an already monitored subnet is more complicated because proxy changes must be applied consistently to discovered hosts and to the membership of the parent proxy group to avoid duplicates. For example the steps to replace proxy in a discovery rule: 1. disable discovery rule 2. sync proxy configuration 3. replace the proxy in the discovery rule 4. replace the proxy for all hosts discovered by this rule (ensure hosts in the parent proxy group and any hosts monitored by individual proxies in that group are updated to avoid duplicates) 5. enable discovery rule #### Starpniekservera iestatījuma maiņa Dažādu starpniekserveru atklātie hosti ne vienmēr tiek apstrādāti kā atšķirīgi hosti. Atklāšanas un unikalitātes pārbaudes ir atkarīgas no starpniekserveru grupas struktūras: kad starpniekserveris izpilda atklāšanas kārtulu un izveido hostu, šis hosts tiek pievienots starpniekservera vecākajai starpniekserveru grupai, nevis piešķirts pašam starpniekserverim. Kad Zabbix atklāšanas laikā novērtē IP unikalitāti, tas pārbauda hostus, kurus uzrauga vecākā starpniekserveru grupa. Hosti, kurus uzrauga atsevišķi starpniekserveri šajā grupā (ieskaitot starpniekserveri, kas izpildīja atklāšanu), unikalitātes pārbaudē tiek ignorēti, kas var izraisīt dublētus hostus, ja vairāki starpniekserveri uzrauga pārklājošus apakštīklus. Lai gan šī darbība ļauj atklāšanai darboties pārklājošos IP diapazonos, ko izmanto dažādi apakštīkli, jau uzraudzīta apakštīkla piešķirtā starpniekservera maiņa ir sarežģītāka, jo starpniekservera izmaiņas ir konsekventi jāpiemēro atklātajiem hostiem un vecākās starpniekserveru grupas dalībai, lai izvairītos no dublikātiem. Piemēram, darbības, lai aizstātu starpniekserveri atklāšanas kārtulā: 1. atspējot atklāšanas kārtulu 2. sinhronizēt starpniekservera konfigurāciju 3. aizstāt starpniekserveri atklāšanas kārtulā 4. aizstāt starpniekserveri visiem hostiem, kas atklāti ar šo kārtulu (pārliecinieties, ka tiek atjaunināti hosti vecākajā starpniekserveru grupā un visi hosti, kurus uzrauga atsevišķi starpniekserveri šajā grupā, lai izvairītos no dublikātiem) 5. iespējot atklāšanas kārtulu #### Changing the excluded downtimes for an SLA Add a planned 4 hour long RAM upgrade downtime on the 6th of April, 2022, while keeping (needs to be defined anew) a previously existing software upgrade planned on the 4th of July for the SLA with ID "5". [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "sla.update", "params": { "slaid": "5", "excluded_downtimes": [ { "name": "Software version upgrade rollout", "period_from": "1648760400", "period_to": "1648764900" }, { "name": "RAM upgrade", "period_from": "1649192400", "period_to": "1649206800" } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "slaids": [ "5" ] }, "id": 1 } ``` #### SLA izslēgto dīkstāvju maiņa Pievienojiet plānotu 4 stundas ilgu RAM jaunināšanas dīkstāvi 2022. gada 6. aprīlī, vienlaikus saglabājot (to nepieciešams definēt no jauna) iepriekš esošu programmatūras jaunināšanas plānu 4. jūlijā SLA ar ID "5". [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "sla.update", "params": { "slaid": "5", "excluded_downtimes": [ { "name": "Software version upgrade rollout", "period_from": "1648760400", "period_to": "1648764900" }, { "name": "RAM upgrade", "period_from": "1649192400", "period_to": "1649206800" } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "slaids": [ "5" ] }, "id": 1 } ``` #### Changing the interface of an item prototype Change the host interface that will be used by discovered items. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "itemprototype.update", "params": { "itemid": "27428", "interfaceid": "132" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "27428" ] }, "id": 1 } ``` #### Vienuma prototipa saskarnes maiņa Mainiet hosta saskarni, kas tiks izmantota atklātajiem vienumiem. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "itemprototype.update", "params": { "itemid": "27428", "interfaceid": "132" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "27428" ] }, "id": 1 } ``` #### Changing the schedule of an SLA Switch the SLA with ID "5" to a 24x7 schedule. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "sla.update", "params": { "slaid": "5", "schedule": [] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "slaids": [ "5" ] }, "id": 1 } ``` #### SLA grafika maiņa Pārslēdziet SLA ar ID "5" uz 24x7 grafiku. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "sla.update", "params": { "slaid": "5", "schedule": [] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "slaids": [ "5" ] }, "id": 1 } ``` #### Changing the size of a graph prototype Change the size of a graph prototype to 1100 to 400 pixels. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "graphprototype.update", "params": { "graphid": "439", "width": 1100, "height": 400 }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "graphids": [ "439" ] }, "id": 1 } ``` #### Grafika prototipa izmēra maiņa Mainiet grafika prototipa izmēru uz 1100 x 400 pikseļiem. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "graphprototype.update", "params": { "graphid": "439", "width": 1100, "height": 400 }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "graphids": [ "439" ] }, "id": 1 } ``` #### Changing the standard template properties Change the technical name of the template to "Linux by Zabbix agent Custom", the visible name to "My template", and update the template description. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "template.update", "params": { "templateid": "10086", "host": "Linux by Zabbix agent Custom", "name": "My template", "description": "This is a custom Linux template." }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "templateids": [ "10086" ] }, "id": 1 } ``` #### Standarta veidnes īpašību maiņa Mainiet veidnes tehnisko nosaukumu uz "Linux by Zabbix aģents Custom", redzamo nosaukumu uz "My template" un atjauniniet veidnes aprakstu. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "template.update", "params": { "templateid": "10086", "host": "Linux by Zabbix aģents Custom", "name": "My template", "description": "This is a custom Linux template." }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "templateids": [ "10086" ] }, "id": 1 } ``` #### Changing the value of a global macro Change the value of a global macro to "public". [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "usermacro.updateglobal", "params": { "globalmacroid": "1", "value": "public" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "globalmacroids": [ "1" ] }, "id": 1 } ``` #### Globālā makro vērtības maiņa Mainiet globālā makro vērtību uz "public". [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "usermacro.updateglobal", "params": { "globalmacroid": "1", "value": "public" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "globalmacroids": [ "1" ] }, "id": 1 } ``` #### Changing the value of a host macro Change the value of a host macro to "public". [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "usermacro.update", "params": { "hostmacroid": "1", "value": "public" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostmacroids": [ "1" ] }, "id": 1 } ``` #### Hosta makro vērtības maiņa Mainiet hosta makro vērtību uz "public". [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "usermacro.update", "params": { "hostmacroid": "1", "value": "public" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "hostmacroids": [ "1" ] }, "id": 1 } ``` ##### Changing time zone By default the appliance uses UTC for the system clock. To change the time zone, copy the appropriate file from */usr/share/zoneinfo* to */etc/localtime*, for example: cp /usr/share/zoneinfo/Europe/Riga /etc/localtime ##### Laika joslas maiņa Pēc noklusējuma ierīce sistēmas pulkstenim izmanto UTC. Lai mainītu laika joslu, nokopējiet atbilstošo failu no */usr/share/zoneinfo* uz */etc/localtime*, piemēram: cp /usr/share/zoneinfo/Europe/Riga /etc/localtime #### Changing user role Change a role of a user. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "user.update", "params": { "userid": "12", "roleid": "6" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "userids": [ "12" ] }, "id": 1 } ``` #### Lietotāja lomas maiņa Mainiet lietotāja lomu. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "user.update", "params": { "userid": "12", "roleid": "6" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "userids": [ "12" ] }, "id": 1 } ``` #### Changing value map name Change value map name to "Device status". [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "valuemap.update", "params": { "valuemapid": "2", "name": "Device status" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "valuemapids": [ "2" ] }, "id": 1 } ``` #### Vērtību kartes nosaukuma maiņa Mainiet vērtību kartes nosaukumu uz "Device status". [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "valuemap.update", "params": { "valuemapid": "2", "name": "Device status" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "valuemapids": [ "2" ] }, "id": 1 } ``` ##### char(value) {#char} Return the character by interpreting the value as ASCII code.<br> Supported value types: *Integer*. Parameter: - **value** - the value to check The value must be in the 0-255 range. For example, a value like '65' (interpreted as ASCII code) will return 'A'. Example: char(last(/host/key)) ##### char(value) {#char} Atgriež rakstzīmi, interpretējot vērtību kā ASCII kodu.<br> Atbalstītie vērtību tipi: *Integer*. Parametrs: - **value** - pārbaudāmā vērtība Vērtībai jābūt diapazonā no 0 līdz 255. Piemēram, vērtība '65' (interpretēta kā ASCII kods) atgriezīs 'A'. Piemērs: char(last(/host/key)) ##### Check authentication using API token Check a user session using the user API token, and return additional information about the user. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "user.checkAuthentication", "params": { "token": "00aff470e07c12d707e50d98cfe39edef9e6ec349c14728dbdfbc8ddc5ea3eae" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "userid": "1", "username": "Admin", "name": "Zabbix", "surname": "Administrator", "url": "", "autologin": "1", "autologout": "0", "lang": "ru_RU", "refresh": "0", "theme": "default", "attempt_failed": "0", "attempt_ip": "127.0.0.1", "attempt_clock": "1355919338", "rows_per_page": "50", "timezone": "Europe/Riga", "roleid": "3", "userdirectoryid": "0", "ts_provisioned": "0", "debug_mode": 0, "deprovisioned": false, "gui_access": "1", "mfaid": 0, "auth_type": 0, "type": 3, "userip": "127.0.0.1" }, "id": 1 } ``` ##### Pārbaudīt autentifikāciju, izmantojot API pilnvaru Pārbaudiet lietotāja sesiju, izmantojot lietotāja API pilnvaru, un atgrieziet papildu informāciju par lietotāju. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "user.checkAuthentication", "params": { "token": "00aff470e07c12d707e50d98cfe39edef9e6ec349c14728dbdfbc8ddc5ea3eae" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "userid": "1", "username": "Admin", "name": "Zabbix", "surname": "Administrator", "url": "", "autologin": "1", "autologout": "0", "lang": "ru_RU", "refresh": "0", "theme": "default", "attempt_failed": "0", "attempt_ip": "127.0.0.1", "attempt_clock": "1355919338", "rows_per_page": "50", "timezone": "Europe/Riga", "roleid": "3", "userdirectoryid": "0", "ts_provisioned": "0", "debug_mode": 0, "deprovisioned": false, "gui_access": "1", "mfaid": 0, "auth_type": 0, "type": 3, "userip": "127.0.0.1" }, "id": 1 } ``` ##### Check authentication using authentication token Check and prolong a user session using the user authentication token, and return additional information about the user. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "user.checkAuthentication", "params": { "sessionid": "673b8ba11562a35da902c66cf5c23fa2" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "userid": "1", "username": "Admin", "name": "Zabbix", "surname": "Administrator", "url": "", "autologin": "1", "autologout": "0", "lang": "ru_RU", "refresh": "0", "theme": "default", "attempt_failed": "0", "attempt_ip": "127.0.0.1", "attempt_clock": "1355919038", "rows_per_page": "50", "timezone": "Europe/Riga", "roleid": "3", "userdirectoryid": "0", "ts_provisioned": "0", "type": 3, "userip": "127.0.0.1", "debug_mode": 0, "gui_access": "0", "deprovisioned": false, "auth_type": 0, "sessionid": "673b8ba11562a35da902c66cf5c23fa2", "secret": "0e329b933e46984e49a5c1051ecd0751" }, "id": 1 } ``` ##### Pārbaudīt autentifikāciju, izmantojot autentifikācijas marķieri Pārbaudiet un pagariniet lietotāja sesiju, izmantojot lietotāja autentifikācijas marķieri, un atgrieziet papildu informāciju par lietotāju. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "user.checkAuthentication", "params": { "sessionid": "673b8ba11562a35da902c66cf5c23fa2" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "userid": "1", "username": "Admin", "name": "Zabbix", "surname": "Administrator", "url": "", "autologin": "1", "autologout": "0", "lang": "ru_RU", "refresh": "0", "theme": "default", "attempt_failed": "0", "attempt_ip": "127.0.0.1", "attempt_clock": "1355919038", "rows_per_page": "50", "timezone": "Europe/Riga", "roleid": "3", "userdirectoryid": "0", "ts_provisioned": "0", "type": 3, "userip": "127.0.0.1", "debug_mode": 0, "gui_access": "0", "deprovisioned": false, "auth_type": 0, "sessionid": "673b8ba11562a35da902c66cf5c23fa2", "secret": "0e329b933e46984e49a5c1051ecd0751" }, "id": 1 } ``` ##### Check concurrency Checks from different plugins can be executed concurrently. The number of concurrent checks within one plugin is limited by the plugin capacity setting. Each plugin may have a hardcoded capacity setting (`1000` being default) that can be lowered using the `Plugins.<PluginName>.System.Capacity=N` setting in the `Plugins` configuration [parameter](#configuration-file). ##### Pārbaudes vienlaicīgums Pārbaudes no dažādiem spraudņiem var tikt izpildītas vienlaicīgi. Vienlaicīgo pārbaužu skaits vienā spraudnī ir ierobežots ar spraudņa kapacitātes iestatījumu. Katram spraudnim var būt iebūvēts kapacitātes iestatījums (`1000` ir noklusējums), ko var samazināt, izmantojot `Plugins.<PluginName>.System.Capacity=N` iestatījumu `Plugins` konfigurācijas [parametrā](#configuration-file). ##### Check for error in JSON {#errorinjson} Check for an application-level error message located at JSONPath. Stop processing if succeeded and the message is not empty; otherwise, continue processing with the value that was before this preprocessing step. Comments: - These external service errors are reported to the user as is, without adding preprocessing step information;<br> - No error will be reported in case of failing to parse invalid JSON;<br> - If you mark the *Custom on fail* checkbox, it is possible to specify custom error-handling options: either to discard the value, set a specified value, or set a specified error message. In case of a failed preprocessing step, the item will not become unsupported if the option to discard the value or set a specified value is selected. ##### Kļūdas pārbaude JSON formātā {#errorinjson} Pārbauda lietojumprogrammas līmeņa kļūdas ziņojumu, kas atrodas JSONPath. Pārtrauc apstrādi, ja darbība ir veiksmīga un ziņojums nav tukšs; pretējā gadījumā turpina apstrādi ar vērtību, kāda bija pirms šīs priekšapstrādes darbības. Komentāri: - Šīs ārējo pakalpojumu kļūdas lietotājam tiek parādītas tādas, kādas tās ir, nepievienojot informāciju par priekšapstrādes darbību;<br> - Kļūda netiks ziņota, ja neizdosies parsēt nederīgu JSON;<br> - Ja atzīmējat izvēles rūtiņu *Pielāgots kļūmes gadījumā*, ir iespējams norādīt pielāgotas kļūdu apstrādes opcijas: vai nu atmest vērtību, iestatīt norādīto vērtību vai iestatīt norādīto kļūdas ziņojumu. Neveiksmīgas priekšapstrādes darbības gadījumā vienums nekļūs neatbalstīts, ja ir atlasīta opcija atmest vērtību vai iestatīt norādīto vērtību. ##### Check for error in XML {#errorinxml} Check for an application-level error message located at XPath. Stop processing if succeeded and the message is not empty; otherwise, continue processing with the value that was before this preprocessing step. Comments: - These external service errors are reported to the user as is, without adding preprocessing step information;<br> - No error will be reported in case of failing to parse invalid XML;<br> - If you mark the *Custom on fail* checkbox, it is possible to specify custom error-handling options: either to discard the value, set a specified value, or set a specified error message. In case of a failed preprocessing step, the item will not become unsupported if the option to discard the value or set a specified value is selected. ##### Kļūdas pārbaude XML failā {#errorinxml} Pārbauda lietojumprogrammas līmeņa kļūdas ziņojumu, kas atrodas XPath. Pārtrauc apstrādi, ja darbība ir veiksmīga un ziņojums nav tukšs; pretējā gadījumā turpina apstrādi ar vērtību, kāda bija pirms šīs priekšapstrādes darbības. Komentāri: - Šīs ārējo pakalpojumu kļūdas lietotājam tiek parādītas tādas, kādas tās ir, nepievienojot informāciju par priekšapstrādes darbību;<br> - Kļūda netiks ziņota, ja neizdosies parsēt nederīgu XML;<br> - Ja atzīmējat izvēles rūtiņu *Pielāgots kļūmes gadījumā*, ir iespējams norādīt pielāgotas kļūdu apstrādes opcijas: vai nu atmest vērtību, iestatīt norādītu vērtību vai iestatīt norādītu kļūdas ziņojumu. Ja priekšapstrādes darbība neizdodas, vienums nekļūs neatbalstīts, ja ir atlasīta opcija atmest vērtību vai iestatīt norādītu vērtību. ##### Check for error using a regular expression {#errorbyregexp} Check for an application-level error message using a regular expression. Stop processing if succeeded and the message is not empty; otherwise, continue processing with the value that was before this preprocessing step. Parameters: - **pattern** - the regular expression;<br> - **output** - the output formatting template. An \\N (where N=1…9) escape sequence is replaced with the Nth matched group. A \\0 escape sequence is replaced with the matched text. Comments: - These external service errors are reported to the user as is, without adding preprocessing step information;<br> - If you mark the *Custom on fail* checkbox, it is possible to specify custom error-handling options: either to discard the value, set a specified value, or set a specified error message. In case of a failed preprocessing step, the item will not become unsupported if the option to discard the value or set a specified value is selected. ##### Kļūdas pārbaude, izmantojot regulāro izteiksmi {#errorbyregexp} Pārbaudiet lietojumprogrammas līmeņa kļūdas ziņojumu, izmantojot regulāro izteiksmi. Pārtrauciet apstrādi, ja pārbaude ir veiksmīga un ziņojums nav tukšs; pretējā gadījumā turpiniet apstrādi ar vērtību, kāda bija pirms šīs priekšapstrādes darbības. Parametri: - **pattern** - regulārā izteiksme;<br> - **output** - izvades formatēšanas veidne. Aizvietošanas secība \\N (kur N=1…9) tiek aizstāta ar N-to atrasto grupu. Aizvietošanas secība \\0 tiek aizstāta ar atrasto tekstu. Komentāri: - Šīs ārējo pakalpojumu kļūdas lietotājam tiek parādītas tādas, kādas tās ir, nepievienojot informāciju par priekšapstrādes darbību;<br> - Ja atzīmējat izvēles rūtiņu *Custom on fail*, ir iespējams norādīt pielāgotas kļūdu apstrādes opcijas: vai nu atmest vērtību, iestatīt norādītu vērtību vai iestatīt norādītu kļūdas ziņojumu. Neveiksmīgas priekšapstrādes darbības gadījumā vienums nekļūs par neatbalstītu, ja ir atlasīta opcija atmest vērtību vai iestatīt norādītu vērtību. ##### Check for not supported value {#checkunsupported} Check if no item value could be retrieved. Specify how the failure should be processed, based on inspecting the returned error message. Parameters: - **scope** - select the error processing scope:<br>*any error* - any error;<br>*error matches* - only the error that matches the regular expression specified in *pattern*;<br>*error does not match* - only the error that does not match the regular expression specified in *pattern*<br> - **pattern** - the regular expression to match the error to. If *any error* is selected in the scope parameter, this field is not displayed. If displayed, this field is mandatory.<br> Comments: - Normally, the absence/failure to retrieve a value would lead to the item becoming unsupported. This preprocessing step allows you to modify this behavior. If you mark the *Custom on fail* checkbox (always marked and grayed out for this preprocessing step), it is possible to specify custom error-handling options: either to discard the value, set a specified value, or set a specified error message. In case of a failed preprocessing step, the item will not become unsupported if the option to discard the value or set a specified value is selected. - This preprocessing step only checks if no item value could be retrieved. It does not check, for example, if the type of the retrieved value (e.g., string) matches the item's type of information (e.g., numeric); for details, see [Preprocessing examples](/manual/config/items/preprocessing/examples#checking-for-not-supported-value). If there is a type mismatch, the item may still become unsupported after all preprocessing steps are executed. To check for a type mismatch, you may use, for example, the *Custom multiplier* preprocessing step; see [Preprocessing examples](/manual/config/items/preprocessing/examples#checking-retrieved-value-type). - Capturing regular expression groups is supported in the *Set value to* or *Set error to* fields. Use \\N (where N=1…9) to retrieve the Nth matched group; use \\0 to retrieve the matched text; - These steps are always executed as the first preprocessing steps and are placed above all others after saving changes to the item; - Multiple *Check for not supported value* steps are supported, in the specified order. A step for *any error* will be automatically placed as the last step in this group. ##### Nepārbaudītas vērtības pārbaude {#checkunsupported} Pārbaudiet, vai nevarēja iegūt nevienu vienuma vērtību. Norādiet, kā kļūme jāapstrādā, pamatojoties uz atgrieztā kļūdas ziņojuma pārbaudi. Parametri: - **scope** - atlasiet kļūdu apstrādes tvērumu:<br>*jebkura kļūda* - jebkura kļūda;<br>*kļūda atbilst* - tikai kļūda, kas atbilst regulārajai izteiksmei, kas norādīta laukā *pattern*;<br>*kļūda neatbilst* - tikai kļūda, kas neatbilst regulārajai izteiksmei, kas norādīta laukā *pattern*<br> - **pattern** - regulārā izteiksme, ar kuru salīdzināt kļūdu. Ja parametrā scope ir atlasīts *jebkura kļūda*, šis lauks netiek parādīts. Ja tas tiek parādīts, šis lauks ir obligāts.<br> Komentāri: - Parasti vērtības neesamība/neizdošanās to iegūt noved pie tā, ka vienums kļūst neatbalstīts. Šī priekšapstrādes darbība ļauj mainīt šo uzvedību. Ja atzīmējat izvēles rūtiņu *Custom on fail* (šai priekšapstrādes darbībai tā vienmēr ir atzīmēta un pelēkota), ir iespējams norādīt pielāgotas kļūdu apstrādes opcijas: vai nu atmest vērtību, iestatīt norādītu vērtību vai iestatīt norādītu kļūdas ziņojumu. Ja priekšapstrādes darbība neizdodas, vienums nekļūs neatbalstīts, ja ir atlasīta opcija atmest vērtību vai iestatīt norādītu vērtību. - Šī priekšapstrādes darbība pārbauda tikai to, vai nevarēja iegūt nevienu vienuma vērtību. Tā nepārbauda, piemēram, vai iegūtās vērtības tips (piemēram, virkne) atbilst vienuma informācijas tipam (piemēram, skaitlisks); sīkāku informāciju skatiet sadaļā [Priekšapstrādes piemēri](/manual/config/items/preprocessing/examples#checking-for-not-supported-value). Ja ir tipu neatbilstība, vienums joprojām var kļūt neatbalstīts pēc visu priekšapstrādes darbību izpildes. Lai pārbaudītu tipu neatbilstību, varat izmantot, piemēram, priekšapstrādes darbību *Custom multiplier*; skatiet [Priekšapstrādes piemēri](/manual/config/items/preprocessing/examples#checking-retrieved-value-type). - Regulāro izteiksmju grupu uztveršana tiek atbalstīta laukos *Set value to* vai *Set error to*. Izmantojiet \\N (kur N=1…9), lai iegūtu N-to atbilstošo grupu; izmantojiet \\0, lai iegūtu atbilstošo tekstu; - Šīs darbības vienmēr tiek izpildītas kā pirmās priekšapstrādes darbības un pēc izmaiņu saglabāšanas vienumā tiek novietotas virs visām pārējām; - Tiek atbalstītas vairākas darbības *Nepārbaudītas vērtības pārbaude* norādītajā secībā. Darbība *jebkura kļūda* tiks automātiski novietota kā pēdējā darbība šajā grupā. #### Checking for not supported value This example uses the [Check for not supported value](/manual/config/items/preprocessing#checkunsupported) preprocessing step to check if the item value could not be retrieved. When a Zabbix server/proxy poller process attempts to collect an item value, it may: - Return a valid result. - Return a result that initially seems valid but may become unsupported later (e.g., due to a value type mismatch after preprocessing). - Return an error of collecting the value, causing the item to become unsupported. Common causes include: - Unknown item key (for Zabbix agent, Simple check, or Zabbix internal items) - Unknown OID (SNMP agent), unknown sensor (IPMI agent), or no JMX metric (JMX agent) - Cannot read trap file (SNMP trap) - Script not found (External check) - No such URL (HTTP agent, Browser) - Login failed (SSH agent, TELNET agent) - Invalid formula syntax (Calculated), JavaScript syntax error (Script), or invalid SQL (Database monitor) To detect and handle errors of collecting item values, you can use the *Check for not supported value* preprocessing step. Note that this step is always executed first and only detects errors that occur before preprocessing begins. In the *Preprocessing* tab of an item, select the *Check for not supported value* preprocessing step and specify one of the following parameters: - For any errors: ```bash Parameter: any error ``` - For errors containing "cannot connect": ```bash Parameter: error matches Pattern: (?i)cannot connect ``` Then, use the *Custom on fail* option to discard the value (in this case, the error), set a custom value, or return a custom error message. Please note that [discarded](/manual/config/items/preprocessing#discardunchanged) values are not stored in the database; as a result, triggers are not evaluated and trend data is not generated. #### Neatbalstītas vērtības pārbaude Šajā piemērā tiek izmantots priekšapstrādes solis [Check for not supported value](/manual/config/items/preprocessing#checkunsupported), lai pārbaudītu, vai vienuma vērtību neizdevās iegūt. Kad Zabbix servera/starpniekservera aptaujātāja process mēģina savākt vienuma vērtību, tas var: - Atgriezt derīgu rezultātu. - Atgriezt rezultātu, kas sākotnēji šķiet derīgs, bet vēlāk var kļūt neatbalstīts (piemēram, vērtības tipa neatbilstības dēļ pēc priekšapstrādes). - Atgriezt vērtības iegūšanas kļūdu, kā rezultātā vienums kļūst neatbalstīts. Biežākie iemesli: - Nezināma vienuma atslēga (Zabbix aģentam, vienkāršajai pārbaudei vai Zabbix iekšējiem vienumiem) - Nezināms OID (SNMP aģents), nezināms sensors (IPMI aģents) vai nav JMX metrikas (JMX aģents) - Nevar nolasīt slazdu failu (SNMP trap) - Skripts nav atrasts (ārējā pārbaude) - Šāds URL nepastāv (HTTP aģents, pārlūks) - Pieteikšanās neizdevās (SSH aģents, TELNET aģents) - Nederīga formulas sintakse (Calculated), JavaScript sintakses kļūda (Script) vai nederīgs SQL (Database monitor) Lai noteiktu un apstrādātu vienumu vērtību iegūšanas kļūdas, varat izmantot priekšapstrādes soli *Check for not supported value*. Ņemiet vērā, ka šis solis vienmēr tiek izpildīts pirmais un nosaka tikai tās kļūdas, kas rodas pirms priekšapstrādes sākuma. Vienuma cilnē *Preprocessing* atlasiet priekšapstrādes soli *Check for not supported value* un norādiet vienu no šiem parametriem: - Jebkurām kļūdām: ```bash Parameter: any error ``` - Kļūdām, kas satur "cannot connect": ```bash Parameter: error matches Pattern: (?i)cannot connect ``` Pēc tam izmantojiet opciju *Custom on fail*, lai atmestu vērtību (šajā gadījumā — kļūdu), iestatītu pielāgotu vērtību vai atgrieztu pielāgotu kļūdas ziņojumu. Lūdzu, ņemiet vērā, ka [discarded](/manual/config/items/preprocessing#discardunchanged) vērtības netiek saglabātas datubāzē; tādēļ trigeri netiek novērtēti un tendenču dati netiek ģenerēti. #### Checking retrieved value type This example uses the [Custom multiplier](/manual/config/items/preprocessing#multiplier) preprocessing step to check if the retrieved item value type is numeric. In the *Preprocessing* tab of an item, select the *Custom multiplier* preprocessing step and specify the following parameter (multiplies the retrieved value by 1): ```bash 1 ``` ::: noteimportant If preprocessing fails (e.g., input is not numeric), then the item becomes unsupported with a corresponding error message. To avoid this, mark the *Custom on fail* checkbox and select an option such as discarding the value or setting a custom one. Please note that [discarded](/manual/config/items/preprocessing#discardunchanged) values are not stored in the database; as a result, triggers are not evaluated and trend data is not generated. ::: #### Pārbaudīt iegūtās vērtības tipu Šajā piemērā tiek izmantots [Custom multiplier](/manual/config/items/preprocessing#multiplier) priekšapstrādes solis, lai pārbaudītu, vai iegūtā vienuma vērtības tips ir skaitlisks. Vienuma cilnē *Preprocessing* atlasiet priekšapstrādes soli *Custom multiplier* un norādiet šādu parametru (reizina iegūto vērtību ar 1): ```bash 1 ``` ::: noteimportant Ja priekšapstrāde neizdodas (piem., ievade nav skaitliska), tad vienums kļūst neatbalstīts ar atbilstošu kļūdas ziņojumu. Lai no tā izvairītos, atzīmējiet izvēles rūtiņu *Custom on fail* un atlasiet opciju, piemēram, vērtības atmešanu vai pielāgotas vērtības iestatīšanu. Ņemiet vērā, ka [discarded](/manual/config/items/preprocessing#discardunchanged) vērtības netiek saglabātas datubāzē; rezultātā trigeri netiek izvērtēti un trendu dati netiek ģenerēti. ::: #### Check of pre-requisites Make sure that all Zabbix frontend mandatory pre-requisites are met. {width="600"} |Pre-requisite|Minimum value|Description| |---|--|-----| |*PHP version*|8.0.0| | |*PHP option "memory\_limit"*|128MB|In php.ini: memory\_limit = 128M| |*PHP option "post\_max\_size"*|16MB|In php.ini: post\_max\_size = 16M| |*PHP option "upload\_max\_filesize"*|2MB|In php.ini: upload\_max\_filesize = 2M| |*PHP option "max\_execution\_time"*|300 seconds|In php.ini: max\_execution\_time = 300 (values 0 and -1 are also allowed)| |*PHP option "max\_input\_time"*|300 seconds|In php.ini: max\_input\_time = 300 (values 0 and -1 are also allowed)| |*PHP databases support*|One of: MySQL, PostgreSQL, Oracle|See [Requirements](/manual/installation/requirements#frontend) for the list of all mandatory and optional PHP extensions. Note that failed optional pre-requisites are displayed with a red *Warning* status, and the setup process can proceed even if they are not met.| |*PHP bcmath*|must be enabled|^| |*PHP mbstring*|must be enabled|^| |*PHP option "mbstring.func\_overload"*|must be disabled|In php.ini: mbstring.func\_overload = 0| |*PHP option "session.auto\_start"*|must be disabled|In php.ini: session.auto\_start = 0| |*PHP option "arg\_separator.output"*|&|In php.ini: arg\_separator.output = "&" (value "&amp;amp;" is also allowed)| ::: noteimportant If the Apache user or user group needs to be changed, verify the permissions to the session folder; otherwise, Zabbix setup may be unable to continue. ::: #### Priekšnosacījumu pārbaude Pārliecinieties, ka ir izpildīti visi Zabbix lietotāja saskarnes obligātie priekšnosacījumi. {width="600"} |Priekšnosacījums|Minimālā vērtība|Apraksts| |---|--|-----| |*PHP versija*|8.0.0| | |*PHP opcija "memory\_limit"*|128MB|php.ini: memory\_limit = 128M| |*PHP opcija "post\_max\_size"*|16MB|php.ini: post\_max\_size = 16M| |*PHP opcija "upload\_max\_filesize"*|2MB|php.ini: upload\_max\_filesize = 2M| |*PHP opcija "max\_execution\_time"*|300 sekundes|php.ini: max\_execution\_time = 300 (vērtības 0 un -1 arī ir atļautas)| |*PHP opcija "max\_input\_time"*|300 sekundes|php.ini: max\_input\_time = 300 (vērtības 0 un -1 arī ir atļautas)| |*PHP datubāzu atbalsts*|Viena no: MySQL, PostgreSQL, Oracle|Skatiet [Prasības](/manual/installation/requirements#frontend), lai iegūtu visu obligāto un papildu PHP paplašinājumu sarakstu. Ņemiet vērā, ka neveiksmīgi izpildīti papildu priekšnosacījumi tiek parādīti ar sarkanu *Brīdinājums* statusu, un iestatīšanas process var turpināties pat tad, ja tie nav izpildīti.| |*PHP bcmath*|jābūt iespējotam|^| |*PHP mbstring*|jābūt iespējotam|^| |*PHP opcija "mbstring.func\_overload"*|jābūt atspējotai|php.ini: mbstring.func\_overload = 0| |*PHP opcija "session.auto\_start"*|jābūt atspējotai|php.ini: session.auto\_start = 0| |*PHP opcija "arg\_separator.output"*|&|php.ini: arg\_separator.output = "&" (vērtība "&amp;amp;" arī ir atļauta)| ::: noteimportant Ja nepieciešams mainīt Apache lietotāju vai lietotāju grupu, pārbaudiet sesiju mapes atļaujas; pretējā gadījumā Zabbix iestatīšana var nespēt turpināties. ::: #### Check status of nodes at specific IP addresses [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "hanode.get", "params": { "output": ["name", "status"], "filter": { "address": ["192.168.1.7", "192.168.1.13"] } }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "name": "node3", "status": "0" }, { "name": "node-active", "status": "3" } ], "id": 1 } ``` #### Pārbaudīt mezglu statusu noteiktās IP adresēs [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "hanode.get", "params": { "output": ["name", "status"], "filter": { "address": ["192.168.1.7", "192.168.1.13"] } }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": [ { "name": "node3", "status": "0" }, { "name": "node-active", "status": "3" } ], "id": 1 } ``` ##### Check the results Save the finished web monitoring scenario. The scenario will be added to the host. To view web scenario information go to *Monitoring → Hosts*, locate the host in the list and click on the Web hyperlink in the last column. {width="600"} Click on the scenario name to see more detailed statistics: {width="600"} ##### Pārbaudiet rezultātus Saglabājiet pabeigto tīmekļa uzraudzības scenāriju. Scenārijs tiks pievienots hostam. Lai skatītu tīmekļa scenārija informāciju, dodieties uz *Monitoring → Hosts*, atrodiet hostu sarakstā un pēdējā kolonnā noklikšķiniet uz Web hipersaites. {width="600"} Noklikšķiniet uz scenārija nosaukuma, lai skatītu detalizētāku statistiku: {width="600"} ##### Check Zabbix login The following script: 1. Initializes a browser session. 2. Navigates to a page (specified as a parameter, see below). 3. Enters the username and password (specified as parameters, see below). 4. Finds and clicks the login button. 5. Finds and clicks the logout button. 6. Collects performance data before and after login, as well as after logout. 7. Handles errors by capturing error messages and a screenshot. 8. Returns the collected results as a JSON string. The script also uses parameters from the [item configuration form](#configuration): - webURL - http://{HOST.CONN}/index.php - username - {$USERNAME} - password - {$PASSWORD} In the *Script* field, enter: ```javascript var browser, result; browser = new Browser(Browser.chromeOptions()); try { var params = JSON.parse(value); // Parse the JSON string containing parameters passed from Zabbix. browser.navigate(params.webURL); browser.collectPerfEntries("open page"); var el = browser.findElement("xpath", "//input[@id='name']"); if (el === null) { throw Error("cannot find name input field"); } el.sendKeys(params.username); el = browser.findElement("xpath", "//input[@id='password']"); if (el === null) { throw Error("cannot find password input field"); } el.sendKeys(params.password); el = browser.findElement("xpath", "//button[@id='enter']"); if (el === null) { throw Error("cannot find login button"); } el.click(); browser.collectPerfEntries("login"); el = browser.findElement("link text", "Sign out"); if (el === null) { throw Error("cannot find logout button"); } el.click(); browser.collectPerfEntries("logout"); result = browser.getResult(); } catch (err) { if (!(err instanceof BrowserError)) { browser.setError(err.message); } result = browser.getResult(); result.error.screenshot = browser.getScreenshot(); } finally { return JSON.stringify(result); } ``` ##### Pārbaudīt Zabbix pieteikšanos Šis skripts: 1. Inicializē pārlūka sesiju. 2. Atver lapu (norādīta kā parametrs, skatiet zemāk). 3. Ievada lietotājvārdu un paroli (norādīti kā parametri, skatiet zemāk). 4. Atrod un noklikšķina uz pieteikšanās pogas. 5. Atrod un noklikšķina uz atteikšanās pogas. 6. Apkopo veiktspējas datus pirms pieteikšanās un pēc tās, kā arī pēc atteikšanās. 7. Apstrādā kļūdas, iegūstot kļūdu ziņojumus un ekrānuzņēmumu. 8. Atgriež apkopotos rezultātus kā JSON virkni. Skripts izmanto arī parametrus no [vienuma konfigurācijas formas](#configuration): - webURL - http://{HOST.CONN}/index.php - username - {$USERNAME} - password - {$PASSWORD} Laukā *Script* ievadiet: ```javascript var browser, result; browser = new Browser(Browser.chromeOptions()); try { var params = JSON.parse(value); // Parse the JSON string containing parameters passed from Zabbix. browser.navigate(params.webURL); browser.collectPerfEntries("open page"); var el = browser.findElement("xpath", "//input[@id='name']"); if (el === null) { throw Error("cannot find name input field"); } el.sendKeys(params.username); el = browser.findElement("xpath", "//input[@id='password']"); if (el === null) { throw Error("cannot find password input field"); } el.sendKeys(params.password); el = browser.findElement("xpath", "//button[@id='enter']"); if (el === null) { throw Error("cannot find login button"); } el.click(); browser.collectPerfEntries("login"); el = browser.findElement("link text", "Sign out"); if (el === null) { throw Error("cannot find logout button"); } el.click(); browser.collectPerfEntries("logout"); result = browser.getResult(); } catch (err) { if (!(err instanceof BrowserError)) { browser.setError(err.message); } result = browser.getResult(); result.error.screenshot = browser.getScreenshot(); } finally { return JSON.stringify(result); } ``` #### Chromium for Zabbix web service on Ubuntu 20 Though in most cases, Zabbix web service can run with Chromium, on Ubuntu 20.04 using Chromium causes the following error: ```default Cannot fetch data: chrome failed to start:cmd_run.go:994: WARNING: cannot create user data directory: cannot create "/var/lib/zabbix/snap/chromium/1564": mkdir /var/lib/zabbix: permission denied Sorry, home directories outside of /home are not currently supported. See https://forum.snapcraft.io/t/11209 for details. ``` This error occurs because `/var/lib/zabbix` is used as a home directory of user 'zabbix'. #### Chromium Zabbix tīmekļa servisam uz Ubuntu 20 Lai gan vairumā gadījumu Zabbix tīmekļa serviss var darboties ar Chromium, Ubuntu 20.04 vidē Chromium izmantošana izraisa šādu kļūdu: ```default Cannot fetch data: chrome failed to start:cmd_run.go:994: WARNING: cannot create user data directory: cannot create "/var/lib/zabbix/snap/chromium/1564": mkdir /var/lib/zabbix: permission denied Sorry, home directories outside of /home are not currently supported. See https://forum.snapcraft.io/t/11209 for details. ``` Šī kļūda rodas tāpēc, ka `/var/lib/zabbix` tiek izmantots kā lietotāja 'zabbix' mājas direktorijs. #### Ciphersuites Ciphersuites by default are configured internally during Zabbix startup. Also user-configured ciphersuites are supported for GnuTLS and OpenSSL. Users may [configure](#userconfigured-ciphersuites) ciphersuites according to their security policies. Using this feature is optional (built-in default ciphersuites still work). For crypto libraries compiled with default settings Zabbix built-in rules typically result in the following ciphersuites (in order from higher to lower priority): |Library|Certificate ciphersuites|PSK ciphersuites| |-------|------------------------|----------------| |*GnuTLS 3.1.18*|TLS\_ECDHE\_RSA\_AES\_128\_GCM\_SHA256<br>TLS\_ECDHE\_RSA\_AES\_128\_CBC\_SHA256<br>TLS\_ECDHE\_RSA\_AES\_128\_CBC\_SHA1<br>TLS\_RSA\_AES\_128\_GCM\_SHA256<br>TLS\_RSA\_AES\_128\_CBC\_SHA256<br>TLS\_RSA\_AES\_128\_CBC\_SHA1|TLS\_ECDHE\_PSK\_AES\_128\_CBC\_SHA256<br>TLS\_ECDHE\_PSK\_AES\_128\_CBC\_SHA1<br>TLS\_PSK\_AES\_128\_GCM\_SHA256<br>TLS\_PSK\_AES\_128\_CBC\_SHA256<br>TLS\_PSK\_AES\_128\_CBC\_SHA1| |*OpenSSL 1.0.2c*|ECDHE-RSA-AES128-GCM-SHA256<br>ECDHE-RSA-AES128-SHA256<br>ECDHE-RSA-AES128-SHA<br>AES128-GCM-SHA256<br>AES128-SHA256<br>AES128-SHA|PSK-AES128-CBC-SHA| |*OpenSSL 1.1.0*|ECDHE-RSA-AES128-GCM-SHA256<br>ECDHE-RSA-AES128-SHA256<br>ECDHE-RSA-AES128-SHA<br>AES128-GCM-SHA256<br>AES128-CCM8<br>AES128-CCM<br>AES128-SHA256<br>AES128-SHA<br>|ECDHE-PSK-AES128-CBC-SHA256<br>ECDHE-PSK-AES128-CBC-SHA<br>PSK-AES128-GCM-SHA256<br>PSK-AES128-CCM8<br>PSK-AES128-CCM<br>PSK-AES128-CBC-SHA256<br>PSK-AES128-CBC-SHA| |*OpenSSL 1.1.1d*|TLS\_AES\_256\_GCM\_SHA384<br>TLS\_CHACHA20\_POLY1305\_SHA256<br>TLS\_AES\_128\_GCM\_SHA256<br>ECDHE-RSA-AES128-GCM-SHA256<br>ECDHE-RSA-AES128-SHA256<br>ECDHE-RSA-AES128-SHA<br>AES128-GCM-SHA256<br>AES128-CCM8<br>AES128-CCM<br>AES128-SHA256<br>AES128-SHA|TLS\_CHACHA20\_POLY1305\_SHA256<br>TLS\_AES\_128\_GCM\_SHA256<br>ECDHE-PSK-AES128-CBC-SHA256<br>ECDHE-PSK-AES128-CBC-SHA<br>PSK-AES128-GCM-SHA256<br>PSK-AES128-CCM8<br>PSK-AES128-CCM<br>PSK-AES128-CBC-SHA256<br>PSK-AES128-CBC-SHA| #### Šifru komplekti Pēc noklusējuma šifru komplekti tiek konfigurēti iekšēji Zabbix palaišanas laikā. Tiek atbalstīti arī lietotāja konfigurēti šifru komplekti GnuTLS un OpenSSL bibliotēkām. Lietotāji var [konfigurēt](#userconfigured-ciphersuites) šifru komplektus atbilstoši savām drošības politikām. Šīs iespējas izmantošana nav obligāta (iebūvētie noklusējuma šifru komplekti joprojām darbojas). Kriptogrāfiskajām bibliotēkām, kas kompilētas ar noklusējuma iestatījumiem, Zabbix iebūvētie noteikumi parasti nodrošina šādus šifru komplektus (secībā no augstākas uz zemāku prioritāti): |Bibliotēka|Sertifikātu šifru komplekti|PSK šifru komplekti| |-------|------------------------|----------------| |*GnuTLS 3.1.18*|TLS\_ECDHE\_RSA\_AES\_128\_GCM\_SHA256<br>TLS\_ECDHE\_RSA\_AES\_128\_CBC\_SHA256<br>TLS\_ECDHE\_RSA\_AES\_128\_CBC\_SHA1<br>TLS\_RSA\_AES\_128\_GCM\_SHA256<br>TLS\_RSA\_AES\_128\_CBC\_SHA256<br>TLS\_RSA\_AES\_128\_CBC\_SHA1|TLS\_ECDHE\_PSK\_AES\_128\_CBC\_SHA256<br>TLS\_ECDHE\_PSK\_AES\_128\_CBC\_SHA1<br>TLS\_PSK\_AES\_128\_GCM\_SHA256<br>TLS\_PSK\_AES\_128\_CBC\_SHA256<br>TLS\_PSK\_AES\_128\_CBC\_SHA1| |*OpenSSL 1.0.2c*|ECDHE-RSA-AES128-GCM-SHA256<br>ECDHE-RSA-AES128-SHA256<br>ECDHE-RSA-AES128-SHA<br>AES128-GCM-SHA256<br>AES128-SHA256<br>AES128-SHA|PSK-AES128-CBC-SHA| |*OpenSSL 1.1.0*|ECDHE-RSA-AES128-GCM-SHA256<br>ECDHE-RSA-AES128-SHA256<br>ECDHE-RSA-AES128-SHA<br>AES128-GCM-SHA256<br>AES128-CCM8<br>AES128-CCM<br>AES128-SHA256<br>AES128-SHA<br>|ECDHE-PSK-AES128-CBC-SHA256<br>ECDHE-PSK-AES128-CBC-SHA<br>PSK-AES128-GCM-SHA256<br>PSK-AES128-CCM8<br>PSK-AES128-CCM<br>PSK-AES128-CBC-SHA256<br>PSK-AES128-CBC-SHA| |*OpenSSL 1.1.1d*|TLS\_AES\_256\_GCM\_SHA384<br>TLS\_CHACHA20\_POLY1305\_SHA256<br>TLS\_AES\_128\_GCM\_SHA256<br>ECDHE-RSA-AES128-GCM-SHA256<br>ECDHE-RSA-AES128-SHA256<br>ECDHE-RSA-AES128-SHA<br>AES128-GCM-SHA256<br>AES128-CCM8<br>AES128-CCM<br>AES128-SHA256<br>AES128-SHA|TLS\_CHACHA20\_POLY1305\_SHA256<br>TLS\_AES\_128\_GCM\_SHA256<br>ECDHE-PSK-AES128-CBC-SHA256<br>ECDHE-PSK-AES128-CBC-SHA<br>PSK-AES128-GCM-SHA256<br>PSK-AES128-CCM8<br>PSK-AES128-CCM<br>PSK-AES128-CBC-SHA256<br>PSK-AES128-CBC-SHA| #### Clear history [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "history.clear", "params": [ "10325", "13205" ], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "10325", "13205" ] }, "id": 1 } ``` #### Notīrīt vēsturi [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "history.clear", "params": [ "10325", "13205" ], "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "10325", "13205" ] }, "id": 1 } ``` #### Clearing template linked templates Unlink and clear the given template from a specific linked template. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "template.update", "params": { "templateid": "10086", "templates_clear": [ { "templateid": "10087" } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "templateids": [ "10086" ] }, "id": 1 } ``` #### Veidnes saistīto veidņu notīrīšana Atsaistīt un notīrīt norādīto veidni no konkrētas saistītās veidnes. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "template.update", "params": { "templateid": "10086", "templates_clear": [ { "templateid": "10087" } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "templateids": [ "10086" ] }, "id": 1 } ``` ##### Cloning a report To quickly clone an existing report, click the *Clone* button at the bottom of an existing report configuration form. When cloning a report created by another user, the current user becomes the owner of the new report. Report settings will be copied to the new report configuration form with respect to user permissions: - If the user who clones a report has no permissions to a dashboard, the *Dashboard* field will be cleared. - If the user who clones a report has no permissions to some users or user groups in the *Subscriptions* list, inaccessible recipients will not be cloned. - *Generate report by* settings will be updated to display the current user (unless *Generate report by* is set to the recipient). Change the required settings and the report name, then click *Add*. ##### Pārskata klonēšana Lai ātri klonētu esošu pārskatu, noklikšķiniet uz pogas *Klonēt* esoša pārskata konfigurācijas formas apakšdaļā. Klonējot cita lietotāja izveidotu pārskatu, pašreizējais lietotājs kļūst par jaunā pārskata īpašnieku. Pārskata iestatījumi tiks kopēti uz jaunā pārskata konfigurācijas formu, ievērojot lietotāja atļaujas: - Ja lietotājam, kurš klonē pārskatu, nav atļauju informācijas panelim, lauks *Informācijas panelis* tiks notīrīts. - Ja lietotājam, kurš klonē pārskatu, nav atļauju dažiem lietotājiem vai lietotāju grupām sarakstā *Abonementi*, nepieejamie saņēmēji netiks klonēti. - Iestatījumi *Ģenerēt pārskatu kā* tiks atjaunināti, lai parādītu pašreizējo lietotāju (ja vien *Ģenerēt pārskatu kā* nav iestatīts uz saņēmēju). Mainiet nepieciešamos iestatījumus un pārskata nosaukumu, pēc tam noklikšķiniet uz *Pievienot*. #### Cloning simplified Previously it was possible to *Clone* and *Full clone* [hosts](/manual/config/hosts/host#overview), [templates](/manual/config/templates/template#creating-a-template) and [maps](/manual/config/visualization/maps/map#creating-a-map). Now the option *Clone* has been removed, and the option *Full clone* has been renamed to *Clone* while still preserving all of the previous functionality of *Full clone*. #### Klonēšana ir vienkāršota Iepriekš bija iespējams veikt *Klonēt* un *Pilnu klonēšanu* [hosts](/manual/config/hosts/host#overview), [veidnēm](/manual/config/templates/template#creating-a-template) un [kartēm](/manual/config/visualization/maps/map#creating-a-map). Tagad opcija *Klonēt* ir noņemta, bet opcija *Pilna klonēšana* ir pārdēvēta par *Klonēt*, vienlaikus saglabājot visu iepriekšējo *Pilnas klonēšanas* funkcionalitāti. ### Code |Type|Size|Comments| |-----|-----|----------| |Byte| 4 |Payload type, currently only JSON is supported.| ### Kods |Type|Size|Comments| |-----|-----|----------| |Baits| 4 |Derīgās slodzes tips, pašlaik tiek atbalstīts tikai JSON.| ##### Collapsed menu When the menu is collapsed to icons only, a full menu reappears as soon as the mouse cursor is placed upon it. Note that it reappears over page content; to move page content to the right you have to click on the expand button. If the mouse cursor again is placed outside the full menu, the menu will collapse again after two seconds. You can also make a collapsed menu reappear fully by hitting the Tab key. Hitting the Tab key repeatedly will allow to focus on the next menu element. ##### Sakļautā izvēlne Kad izvēlne ir sakļauta līdz tikai ikonām, pilna izvēlne atkal parādās, tiklīdz virs tās tiek novietots peles kursors. Ņemiet vērā, ka tā parādās virs lapas satura; lai pārvietotu lapas saturu pa labi, ir jānoklikšķina uz izvēršanas pogas. Ja peles kursors atkal tiek novietots ārpus pilnās izvēlnes, izvēlne pēc divām sekundēm atkal sakļausies. Varat arī panākt, lai sakļautā izvēlne pilnībā atkal parādītos, nospiežot Tab taustiņu. Atkārtoti nospiežot Tab taustiņu, būs iespējams pāriet uz nākamo izvēlnes elementu. #### Collapsible advanced configuration The *Advanced configuration* checkboxes, responsible for displaying advanced configuration options, have been replaced with collapsible blocks (see, for example, [Connector configuration](/manual/config/export/streaming#configuration), [Service configuration](/manual/it_services/service_tree#service-configuration), [*Clock* widget configuration](/manual/web_interface/frontend_sections/dashboards/widgets/clock#configuration), etc.). This improves user experience, as collapsing these blocks and saving the configuration will no longer reset the configured advanced options to their default values. #### Salokāma papildu konfigurācija *Papildu konfigurācija* izvēles rūtiņas, kas bija atbildīgas par papildu konfigurācijas opciju attēlošanu, ir aizstātas ar salokāmiem blokiem (sk., piemēram, [Savienotāja konfigurācija](/manual/config/export/streaming#configuration), [Pakalpojuma konfigurācija](/manual/it_services/service_tree#service-configuration), [*Pulksteņa* logrīka konfigurācija](/manual/web_interface/frontend_sections/dashboards/widgets/clock#configuration) u. c.). Tas uzlabo lietotāja pieredzi, jo šo bloku sakļaušana un konfigurācijas saglabāšana vairs neatjaunos konfigurētās papildu opcijas uz to noklusējuma vērtībām. # Collect data from Zabbix agent # Datu vākšana no Zabbix aģenta ##### Column configuration {width="600"} ##### Kolonnu konfigurācija {width="600"} #### Column configuration To configure columns, click *Add* in the *Columns* parameter: {width="600"} #### Kolonnu konfigurācija Lai konfigurētu kolonnas, noklikšķiniet uz *Add* parametra *Columns*: {width="600"} Column parameters specific to binary type items: | | | |--|--------| |*Show thumbnail*|Mark this checkbox to display a thumbnail for image binaries or a "Show" option for non-image binaries.<br>Unmark this checkbox to display a "Show" option for all binary item values.<br>Hovering or clicking the "Show" option opens a pop-up window with the item value (image or Base64 string).<br>If the item value is an empty string, the "Show" option is displayed; hovering or clicking it opens a pop-up containing "Empty string".| Kolonnu parametri, kas raksturīgi binārā tipa vienumiem: | | | |--|--------| |*Rādīt sīktēlu*|Atzīmējiet šo izvēles rūtiņu, lai attēlotu sīktēlu attēlu binārajiem datiem vai opciju "Rādīt" binārajiem datiem, kas nav attēli.<br>Noņemiet atzīmi no šīs izvēles rūtiņas, lai attēlotu opciju "Rādīt" visām bināro vienumu vērtībām.<br>Novietojot kursoru virs opcijas "Rādīt" vai noklikšķinot uz tās, tiek atvērts uznirstošais logs ar vienuma vērtību (attēlu vai Base64 virkni).<br>Ja vienuma vērtība ir tukša virkne, tiek attēlota opcija "Rādīt"; novietojot kursoru virs tās vai noklikšķinot uz tās, tiek atvērts uznirstošais logs ar tekstu "Tukša virkne".| Column parameters specific to character, text, and log type items: | | | |--|--------| |*Highlights*|Click *Add* to add a highlight, select a highlight color from the color picker, and specify a regular expression.<br>The selected color will be used as the background color for item values where the specified regular expression matches the text.| |*Display*|Select how the item value should be displayed:<br>**As is** - exactly as received. Line breaks are preserved (since Zabbix 7.0.5) if the value contains line returns. Word wrapping is applied if *Layout* is set to "Vertical" and more than one column is configured;<br>**HTML** - as HTML-formatted text;<br>**Single line** - as a single line, truncated to a specified length (1-500 characters).<br>Hovering or clicking on the truncated value opens a pop-up with the full value.| |*Use monospace font*|Mark this checkbox to display the item value in monospace font (unmarked by default).| |*Display local time*|Mark this checkbox to display local time instead of timestamp in the timestamp column.<br>Note that the *Show timestamp* checkbox in [advanced configuration](#advanced-configuration) must also be marked.<br>This parameter is available only for log type items.| Kolonnu parametri, kas raksturīgi rakstzīmju, teksta un žurnāla tipa vienumiem: | | | |--|--------| |*Highlights*|Noklikšķiniet uz *Add*, lai pievienotu izcēlumu, izvēlieties izcēluma krāsu no krāsu atlasītāja un norādiet regulāro izteiksmi.<br>Atlasītā krāsa tiks izmantota kā vienuma vērtību fona krāsa, ja norādītā regulārā izteiksme atbilst tekstam.| |*Display*|Izvēlieties, kā vienuma vērtība jāattēlo:<br>**As is** - tieši tā, kā saņemta. Rindu pārneses tiek saglabātas (kopš Zabbix 7.0.5), ja vērtība satur rindu atgriezes;<br>**HTML** - kā HTML formatēts teksts;<br>**Single line** - kā viena rinda, saīsināta līdz norādītam garumam (1-500 rakstzīmes).<br>Novietojot kursoru virs saīsinātās vērtības vai noklikšķinot uz tās, tiek atvērts uznirstošais logs ar pilnu vērtību.| |*Use monospace font*|Atzīmējiet šo izvēles rūtiņu, lai attēlotu vienuma vērtību monospace fontā (pēc noklusējuma nav atzīmēta).| |*Display local time*|Atzīmējiet šo izvēles rūtiņu, lai timestamp kolonnā attēlotu vietējo laiku, nevis timestamp.<br>Ņemiet vērā, ka arī izvēles rūtiņai *Show timestamp* sadaļā [advanced configuration](#advanced-configuration) jābūt atzīmētai.<br>Šis parametrs ir pieejams tikai žurnāla tipa vienumiem.| Column parameters specific to numeric type items: | | | |--|--------| |*Display*|Select how the item value should be displayed:<br>**As is** - as regular text;<br>**Bar** - as solid, color-filled bar;<br>**Indicators** - as segmented, color-filled bar.| |*Min*|Enter the minimum value for bar/indicators.<br>If left empty, the widget will use the minimum value of the item.<br>This parameter is available only when *Display* is set to "Bar" or "Indicators".| |*Max*|Enter the maximum value for bar/indicators.<br>If left empty, the widget will use the maximum value of the item.<br>This parameter is available only when *Display* is set to "Bar" or "Indicators".| |*Thresholds*|Click *Add* to add a threshold, select a threshold color from the color picker, and specify a numeric value.<br>The thresholds list will be sorted in ascending order when saved.<br>[Suffixes](/manual/appendix/suffixes) (for example, "1d", "2w", "4K", "8G") are supported. [Value mappings](/manual/config/items/mapping) are supported.| |*History data*|Select whether to take data from history or trends:<br>**Auto** - automatic selection;<br>**History** - take history data;<br>**Trends** - take trend data.| Kolonnu parametri, kas raksturīgi skaitliska tipa vienumiem: | | | |--|--------| |*Attēlojums*|Izvēlieties, kā jāattēlo vienuma vērtība:<br>**Kā ir** — kā parasts teksts;<br>**Josla** — kā vienlaidus, ar krāsu aizpildīta josla;<br>**Indikatori** — kā segmentēta, ar krāsu aizpildīta josla.| |*Min*|Ievadiet minimālo vērtību joslai/indikatoriem.<br>Ja lauks tiek atstāts tukšs, logrīks izmantos vienuma minimālo vērtību.<br>Šis parametrs ir pieejams tikai tad, ja *Attēlojums* ir iestatīts uz "Josla" vai "Indikatori".| |*Max*|Ievadiet maksimālo vērtību joslai/indikatoriem.<br>Ja lauks tiek atstāts tukšs, logrīks izmantos vienuma maksimālo vērtību.<br>Šis parametrs ir pieejams tikai tad, ja *Attēlojums* ir iestatīts uz "Josla" vai "Indikatori".| |*Sliekšņi*|Noklikšķiniet uz *Pievienot*, lai pievienotu slieksni, izvēlieties sliekšņa krāsu no krāsu atlasītāja un norādiet skaitlisku vērtību.<br>Saglabājot sliekšņu saraksts tiks sakārtots augošā secībā.<br>Tiek atbalstīti [sufiksi](/manual/appendix/suffixes) (piemēram, "1d", "2w", "4K", "8G"). Tiek atbalstītas arī [vērtību kartēšanas](/manual/config/items/mapping).| |*Vēstures dati*|Izvēlieties, vai ņemt datus no vēstures vai tendencēm:<br>**Auto** — automātiska atlase;<br>**Vēsture** — ņemt vēstures datus;<br>**Tendences** — ņemt tendenču datus.| #### Columns Columns have common parameters and additional parameters depending on the configuration of the *Item* parameter. ::: noteclassic For all parameters related to columns, the number in the property name (e.g. columns.0.name) references a column for which the parameter is configured. ::: #### Kolonnas Kolonnām ir kopīgi parametri un papildu parametri atkarībā no parametra *Vienums* konfigurācijas. ::: noteclassic Visiem ar kolonnām saistītajiem parametriem skaitlis īpašības nosaukumā (piemēram, columns.0.name) norāda kolonnu, kurai parametrs ir konfigurēts. ::: #### Columns Columns have common parameters and additional parameters depending on the configuration of the parameter *Data*. ::: noteclassic For all parameters related to columns the number in the property name (e.g. columns.0.name) references a column for which the parameter is configured. ::: #### Kolonnas Kolonnām ir kopīgi parametri un papildu parametri atkarībā no parametra *Dati* konfigurācijas. ::: noteclassic Visiem ar kolonnām saistītajiem parametriem skaitlis īpašības nosaukumā (piemēram, columns.0.name) norāda kolonnu, kurai parametrs ir konfigurēts. ::: #### Command result The return value of the command is a standard output together with a standard error produced by the command. ::: noteimportant An item that returns text (character, log, or text type of information) will not become unsupported in case of a standard error output. ::: The return value is limited to 16MB (including trailing whitespace that is truncated); [database limits](/manual/config/items/item#text-data-limits) also apply. User parameters that return text (character, log, or text type of information) can also return a whitespace. In case of an invalid result, the item will become unsupported. #### Komandas rezultāts Komandas atgrieztā vērtība ir standarta izvade kopā ar standarta kļūdu, ko ģenerē komanda. ::: noteimportant Vienums, kas atgriež tekstu (rakstzīmju, žurnāla vai teksta tipa informāciju), nekļūs neatbalstīts standarta kļūdas izvades gadījumā. ::: Atgrieztās vērtības apjoms ir ierobežots līdz 16 MB (ieskaitot beigu atstarpes rakstzīmes, kas tiek saīsinātas); [datubāzes ierobežojumi](/manual/config/items/item#text-data-limits) arī ir spēkā. Lietotāja parametri, kas atgriež tekstu (rakstzīmju, žurnāla vai teksta tipa informāciju), var atgriezt arī atstarpi. Nederīga rezultāta gadījumā vienums kļūs neatbalstīts. #### Common agent items supported on Windows |Item key|User group|<| |--------|----------|-| | |Recommended|Minimum technically acceptable (functionality is limited)| |agent.hostname|Guests|Guests| |agent.ping|Guests|Guests| |agent.variant|Guests|Guests| |agent.version|Guests|Guests| |log|Administrators|Guests| |log.count|Administrators|Guests| |logrt|Administrators|Guests| |logrt.count|Administrators|Guests| |net.dns|Guests|Guests| |net.dns.perf|Guests|Guests| |net.dns.record|Guests|Guests| |net.if.discovery|Guests|Guests| |net.if.in|Guests|Guests| |net.if.out|Guests|Guests| |net.if.total|Guests|Guests| |net.tcp.listen|Guests|Guests| |net.tcp.port|Guests|Guests| |net.tcp.service|Guests|Guests| |net.tcp.service.perf|Guests|Guests| |net.udp.service|Guests|Guests| |net.udp.service.perf|Guests|Guests| |proc.num|Administrators|Guests| |system.cpu.discovery|Performance Monitor Users|Performance Monitor Users| |system.cpu.load|Performance Monitor Users|Performance Monitor Users| |system.cpu.num|Guests|Guests| |system.cpu.util|Performance Monitor Users|Performance Monitor Users| |system.hostname|Guests|Guests| |system.localtime|Guests|Guests| |system.run|Administrators|Guests| |system.sw.arch|Guests|Guests| |system.swap.size|Guests|Guests| |system.uname|Guests|Guests| |system.uptime|Performance Monitor Users|Performance Monitor Users| |vfs.dir.count|Administrators|Guests| |vfs.dir.get|Administrators|Guests| |vfs.dir.size|Administrators|Guests| |vfs.file.cksum|Administrators|Guests| |vfs.file.contents|Administrators|Guests| |vfs.file.exists|Administrators|Guests| |vfs.file.md5sum|Administrators|Guests| |vfs.file.regexp|Administrators|Guests| |vfs.file.regmatch|Administrators|Guests| |vfs.file.size|Administrators|Guests| |vfs.file.time|Administrators|Guests| |vfs.fs.discovery|Administrators|Guests| |vfs.fs.get|Administrators|Guests| |vfs.fs.size|Administrators|Guests| |vm.memory.size|Guests|Guests| |web.page.get|Guests|Guests| |web.page.perf|Guests|Guests| |web.page.regexp|Guests|Guests| |zabbix.stats|Guests|Guests| #### Windows atbalstītie aģenta vienumi |Vienuma atslēga|Lietotāju grupa|<| |--------|----------|-| | |Ieteicamais|Minimāli tehniski pieņemamais (funkcionalitāte ir ierobežota)| |agent.hostname|Viesi|Viesi| |agent.ping|Viesi|Viesi| |agent.variant|Viesi|Viesi| |agent.version|Viesi|Viesi| |log|Administratori|Viesi| |log.count|Administratori|Viesi| |logrt|Administratori|Viesi| |logrt.count|Administratori|Viesi| |net.dns|Viesi|Viesi| |net.dns.perf|Viesi|Viesi| |net.dns.record|Viesi|Viesi| |net.if.discovery|Viesi|Viesi| |net.if.in|Viesi|Viesi| |net.if.out|Viesi|Viesi| |net.if.total|Viesi|Viesi| |net.tcp.listen|Viesi|Viesi| |net.tcp.port|Viesi|Viesi| |net.tcp.service|Viesi|Viesi| |net.tcp.service.perf|Viesi|Viesi| |net.udp.service|Viesi|Viesi| |net.udp.service.perf|Viesi|Viesi| |proc.num|Administratori|Viesi| |system.cpu.discovery|Veiktspējas monitora lietotāji|Veiktspējas monitora lietotāji| |system.cpu.load|Veiktspējas monitora lietotāji|Veiktspējas monitora lietotāji| |system.cpu.num|Viesi|Viesi| |system.cpu.util|Veiktspējas monitora lietotāji|Veiktspējas monitora lietotāji| |system.hostname|Viesi|Viesi| |system.localtime|Viesi|Viesi| |system.run|Administratori|Viesi| |system.sw.arch|Viesi|Viesi| |system.swap.size|Viesi|Viesi| |system.uname|Viesi|Viesi| |system.uptime|Veiktspējas monitora lietotāji|Veiktspējas monitora lietotāji| |vfs.dir.count|Administratori|Viesi| |vfs.dir.get|Administratori|Viesi| |vfs.dir.size|Administratori|Viesi| |vfs.file.cksum|Administratori|Viesi| |vfs.file.contents|Administratori|Viesi| |vfs.file.exists|Administratori|Viesi| |vfs.file.md5sum|Administratori|Viesi| |vfs.file.regexp|Administratori|Viesi| |vfs.file.regmatch|Administratori|Viesi| |vfs.file.size|Administratori|Viesi| |vfs.file.time|Administratori|Viesi| |vfs.fs.discovery|Administratori|Viesi| |vfs.fs.get|Administratori|Viesi| |vfs.fs.size|Administratori|Viesi| |vm.memory.size|Viesi|Viesi| |web.page.get|Viesi|Viesi| |web.page.perf|Viesi|Viesi| |web.page.regexp|Viesi|Viesi| |zabbix.stats|Viesi|Viesi| Common column parameters: | | | |--|--------| |*Name*|Enter the name of the column.<br>If left empty, the item name from the *Item* parameter is used.| |*Item*|Select the item.<br>Note that column configuration parameters vary based on the information type of the selected item; for more information, see individual parameters below.<br>When configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards), only [items configured on the template](/manual/config/templates/template#adding-items-triggers-graphs) can be selected.| |*Base color*|Select the column's background color or fill color if *Display* is set to "Bar" or "Indicators".<br>Note that the base color can be overridden by threshold or highlight colors.| Biežāk lietotie kolonnas parametri: | | | |--|--------| |*Nosaukums*|Ievadiet kolonnas nosaukumu.<br>Ja tas ir atstāts tukšs, tiek izmantots vienuma nosaukums no parametra *Vienums*.| |*Vienums*|Atlasiet vienumu.<br>Ņemiet vērā, ka kolonnas konfigurācijas parametri atšķiras atkarībā no atlasītā vienuma informācijas tipa; plašāku informāciju skatiet atsevišķajos parametros zemāk.<br>Konfigurējot logrīku [veidnes panelī](/manual/config/templates/template#adding-dashboards), var atlasīt tikai [vienumus, kas konfigurēti veidnē](/manual/config/templates/template#adding-items-triggers-graphs).| |*Pamatkrāsa*|Atlasiet kolonnas fona krāsu vai aizpildījuma krāsu, ja parametrs *Attēlojums* ir iestatīts uz "Bar" vai "Indicators".<br>Ņemiet vērā, ka pamatkrāsu var pārrakstīt sliekšņa vai izcelšanas krāsas.| Common column parameters: | | | |--|--------| |*Name*|Name of the column.| |*Data*|Data type to display in the column:<br>**Item value** - value of the specified item;<br>**Host name** - name of the host;<br>**Text** - static text string.| |*Base color*|Background color of the column; fill color if *Item value* data is displayed as bar/indicators.<br>For *Item value* data the default color can be overridden by custom color, if the item value is over one of the specified thresholds.| Kopīgie kolonnas parametri: | | | |--|--------| |*Nosaukums*|Kolonnas nosaukums.| |*Dati*|Kolonnā attēlojamais datu tips:<br>**Vienuma vērtība** - norādītā vienuma vērtība;<br>**Hosts nosaukums** - hosta nosaukums;<br>**Teksts** - statiska teksta virkne.| |*Pamata krāsa*|Kolonnas fona krāsa; aizpildījuma krāsa, ja *Vienuma vērtība* dati tiek attēloti kā josla/rādītāji.<br>Ja *Vienuma vērtība* dati tiek izmantoti, noklusējuma krāsu var aizstāt ar pielāgotu krāsu, ja vienuma vērtība pārsniedz kādu no norādītajiem sliekšņiem.| ###### Common fields For each step described below, fill out the following fields in addition to the step-specific fields: - **URL** - the URL of Zabbix frontend - **Timeout** - 15s - **Required status codes** - 200 ###### Kopīgie lauki Katram tālāk aprakstītajam solim papildus konkrētajam solim paredzētajiem laukiem aizpildiet šādus laukus: - **URL** - Zabbix lietotāja saskarnes URL - **Timeout** - 15s - **Required status codes** - 200 ### Common "get" method parameters The following parameters are supported by all `get` methods: |Parameter|[Type](#data-types)|Description| |-|-|--------| |countOutput|boolean|Return the number of records in the result instead of the actual data.| |editable|boolean|If set to `true`, return only objects that the user has write permissions to.<br><br>Default: `false`.| |excludeSearch|boolean|Return results that do not match the criteria given in the `search` parameter.| |filter|object|Return only those results that exactly match the given filter.<br><br>Accepts an object, where the keys are property names (e.g., Host object properties in `host.get`, Item object properties in `item.get`, etc.), and the values are either a single value or an array of values to match against.<br><br>Does not support properties of `text` [data type](#data-types).<br><br>Note that some methods have specific functionality for this parameter, which is described on the method page (e.g., the `filter` parameter in [host.get](/manual/api/reference/host/get) also supports Host interface properties).| |limit|integer|Limit the number of records returned.| |output|query|Object properties to be returned.<br><br>Note that the object ID (i.e., `hostid`, `itemid`, etc.) is always included in the response, even if it is not specified in the `output` parameter.<br><br>Default: `extend`.| |preservekeys|boolean|Use IDs as keys in the resulting array.| |search|object|Return results that match the given pattern (case-insensitive).<br><br>Accepts an object, where the keys are property names (e.g., Host object properties in `host.get`, Item object properties in `item.get`, etc.), and the values are strings to search for. If no additional options are given, this will perform a `LIKE "%…%"` search.<br><br>Supports only properties of `string` and `text` [data type](#data-types).<br><br>Note that some methods have specific functionality for this parameter, which is described on the method page (e.g., the `search` parameter in [host.get](/manual/api/reference/host/get) also supports Host interface properties).| |searchByAny|boolean|If set to `true`, return results that match any of the criteria given in the `filter` or `search` parameter instead of all of them.<br><br>Default: `false`.| |searchWildcardsEnabled|boolean|If set to `true`, enables the use of "\*" as a wildcard character in the `search` parameter.<br><br>Default: `false`.| |sortfield|string/array|Sort the result by the given properties. Refer to a specific API get method description for a list of properties that can be used for sorting. Macros are not expanded before sorting.<br><br>If no value is specified, data will be returned unsorted.| |sortorder|string/array|Order of sorting. If an array is passed, each value will be matched to the corresponding property given in the `sortfield` parameter.<br><br>Possible values:<br>`ASC` - *(default)* ascending;<br>`DESC` - descending.| |startSearch|boolean|The `search` parameter will compare the beginning of fields, that is, perform a `LIKE "…%"` search instead.<br><br>Ignored if `searchWildcardsEnabled` is set to `true`.| ### Biežāk izmantotie "get" metožu parametri Tālāk norādītie parametri tiek atbalstīti visās `get` metodēs: |Parametrs|[Tips](#data-types)|Apraksts| |-|-|--------| |countOutput|boolean|Atgriezt rezultātā esošo ierakstu skaitu faktiskās datu izvades vietā.| |editable|boolean|Ja iestatīts uz `true`, atgriezt tikai tos objektus, kuriem lietotājam ir rakstīšanas atļaujas.<br><br>Noklusējums: `false`.| |excludeSearch|boolean|Atgriezt rezultātus, kas neatbilst `search` parametrā norādītajiem kritērijiem.| |filter|object|Atgriezt tikai tos rezultātus, kas precīzi atbilst norādītajam filtram.<br><br>Pieņem objektu, kurā atslēgas ir īpašību nosaukumi (piemēram, Host objekta īpašības `host.get`, Item objekta īpašības `item.get` utt.), bet vērtības ir vai nu viena vērtība, vai vērtību masīvs, ar ko salīdzināt.<br><br>Neatbalsta `text` [datu tipa](#data-types) īpašības.<br><br>Ņemiet vērā, ka dažām metodēm šim parametram ir specifiska funkcionalitāte, kas ir aprakstīta metodes lapā (piemēram, parametrs `filter` metodē [host.get](/manual/api/reference/host/get) atbalsta arī Host interfeisa īpašības).| |limit|integer|Ierobežot atgriezto ierakstu skaitu.| |output|query|Atgriežamās objekta īpašības.<br><br>Ņemiet vērā, ka objekta ID (t.i., `hostid`, `itemid` utt.) vienmēr ir iekļauts atbildē, pat ja tas nav norādīts parametrā `output`.<br><br>Noklusējums: `extend`.| |preservekeys|boolean|Izmantot ID kā atslēgas rezultējošajā masīvā.| |search|object|Atgriezt rezultātus, kas atbilst norādītajam paraugam (reģistrnejutīgi).<br><br>Pieņem objektu, kurā atslēgas ir īpašību nosaukumi (piemēram, Host objekta īpašības `host.get`, Item objekta īpašības `item.get` utt.), bet vērtības ir virknes, kuras meklēt. Ja nav norādītas papildu opcijas, tiks veikta `LIKE "%…%"` meklēšana.<br><br>Atbalsta tikai `string` un `text` [datu tipa](#data-types) īpašības.<br><br>Ņemiet vērā, ka dažām metodēm šim parametram ir specifiska funkcionalitāte, kas ir aprakstīta metodes lapā (piemēram, parametrs `search` metodē [host.get](/manual/api/reference/host/get) atbalsta arī Host interfeisa īpašības).| |searchByAny|boolean|Ja iestatīts uz `true`, atgriezt rezultātus, kas atbilst jebkuram no `filter` vai `search` parametrā norādītajiem kritērijiem, nevis visiem.<br><br>Noklusējums: `false`.| |searchWildcardsEnabled|boolean|Ja iestatīts uz `true`, parametrā `search` tiek iespējota "\*" izmantošana kā aizstājējzīme.<br><br>Noklusējums: `false`.| |sortfield|string/array|Kārtot rezultātu pēc norādītajām īpašībām. Skatiet konkrētās API get metodes aprakstu, lai iegūtu to īpašību sarakstu, kuras var izmantot kārtošanai. Makrosi pirms kārtošanas netiek izvērsti.<br><br>Ja vērtība nav norādīta, dati tiks atgriezti bez kārtošanas.| |sortorder|string/array|Kārtošanas secība. Ja tiek nodots masīvs, katra vērtība tiks piesaistīta atbilstošajai īpašībai, kas norādīta parametrā `sortfield`.<br><br>Iespējamās vērtības:<br>`ASC` - *(noklusējums)* augošā secībā;<br>`DESC` - dilstošā secībā.| |startSearch|boolean|Parametrs `search` salīdzinās lauku sākumu, tas ir, tā vietā veiks `LIKE "…%"` meklēšanu.<br><br>Tiek ignorēts, ja `searchWildcardsEnabled` ir iestatīts uz `true`.| #### Common parameters - `/host/key` is a common mandatory first parameter for the functions referencing the host item history - `(sec|#num)<:time shift>` is a common second parameter for the functions referencing the host item history, where: - **sec** - maximum [evaluation period](/manual/config/triggers#evaluation-period) in seconds (time [suffixes](/manual/appendix/suffixes) can be used), or - **\#num** - maximum [evaluation range](/manual/config/triggers#evaluation-period) in latest collected values (if preceded by a hash mark) - **time shift** (optional) allows to move the evaluation point back in time. See [more details](/manual/config/triggers/expression#time-shift) on specifying time shift. #### Kopējie parametri - `/host/key` ir kopīgs obligāts pirmais parametrs funkcijām, kas atsaucas uz hosts vienuma vēsturi - `(sec|#num)<:time shift>` ir kopīgs otrais parametrs funkcijām, kas atsaucas uz hosts vienuma vēsturi, kur: - **sec** - maksimālais [izvērtēšanas periods](/manual/config/triggers#evaluation-period) sekundēs (var izmantot laika [sufiksus](/manual/appendix/suffixes)), vai - **\#num** - maksimālais [izvērtēšanas diapazons](/manual/config/triggers#evaluation-period) pēdējās savāktajās vērtībās (ja priekšā ir hash zīme) - **time shift** (neobligāts) ļauj pārvietot izvērtēšanas punktu atpakaļ laikā. Skatiet [papildu informāciju](/manual/config/triggers/expression#time-shift) par time shift norādīšanu. ##### Common parameters - `/host/key` is a common mandatory first parameter for the functions referencing the host item history - `(sec|#num)<:time shift>` is a common second parameter for the functions referencing the host item history, where: - **sec** - maximum [evaluation period](/manual/config/triggers#evaluation-period) in seconds (time [suffixes](/manual/appendix/suffixes) can be used), or - **#num** - maximum [evaluation range](/manual/config/triggers#evaluation-period) in latest collected values (if preceded by a hash mark) - **time shift** (optional) allows to move the evaluation point back in time. See [more details](/manual/config/triggers/expression#time-shift) on specifying time shift. ##### Kopējie parametri - `/host/key` ir kopīgs obligāts pirmais parametrs funkcijām, kas atsaucas uz hosts vienuma vēsturi - `(sec|#num)<:time shift>` ir kopīgs otrais parametrs funkcijām, kas atsaucas uz hosts vienuma vēsturi, kur: - **sec** - maksimālais [izvērtēšanas periods](/manual/config/triggers#evaluation-period) sekundēs (var izmantot laika [sufiksus](/manual/appendix/suffixes)), vai - **#num** - maksimālais [izvērtēšanas diapazons](/manual/config/triggers#evaluation-period) pēdējās savāktajās vērtībās (ja priekšā ir hash zīme) - **time shift** (neobligāts) ļauj pārvietot izvērtēšanas punktu atpakaļ laikā. Skatiet [papildu informāciju](/manual/config/triggers/expression#time-shift) par laika nobīdes norādīšanu. ##### Common parameters - `/host/key` is a common mandatory first parameter for the functions referencing the host item history - `(sec|#num)<:time shift>` is a common second parameter for the functions referencing the host item history, where: - **sec** - maximum [evaluation period](/manual/config/triggers#evaluation-period) in seconds (time [suffixes](/manual/appendix/suffixes) can be used), or - **\#num** - maximum [evaluation range](/manual/config/triggers#evaluation-period) in latest collected values (if preceded by a hash mark) - **time shift** (optional) allows to move the evaluation point back in time. See [more details](/manual/config/triggers/expression#time-shift) on specifying time shift. ##### Kopējie parametri - `/host/key` ir kopīgs obligāts pirmais parametrs funkcijām, kas atsaucas uz host vienuma vēsturi - `(sec|#num)<:time shift>` ir kopīgs otrais parametrs funkcijām, kas atsaucas uz host vienuma vēsturi, kur: - **sec** - maksimālais [izvērtēšanas periods](/manual/config/triggers#evaluation-period) sekundēs (var izmantot laika [piedēkļus](/manual/appendix/suffixes)), vai - **\#num** - maksimālais [izvērtēšanas diapazons](/manual/config/triggers#evaluation-period) pēdējās savāktajās vērtībās (ja tam priekšā ir restes zīme) - **time shift** (neobligāts) ļauj pārbīdīt izvērtēšanas punktu atpakaļ laikā. Skatiet [papildu informāciju](/manual/config/triggers/expression#time-shift) par time shift norādīšanu. ##### Common parameters - `/host/key` is a common mandatory first parameter - `time period:time shift` is a common second parameter, where: - **time period** - the time period (minimum '1h'), defined as \<N>\<time unit> where `N` - the number of time units, `time unit` - h (hour), d (day), w (week), M (month) or y (year). - **time shift** - the [time period offset](/manual/config/triggers/expression#time-shift) (see function examples) ##### Bieži izmantotie parametri - `/host/key` ir bieži izmantots obligātais pirmais parametrs - `time period:time shift` ir bieži izmantots otrais parametrs, kur: - **time period** - laika periods (minimums '1h'), definēts kā \<N>\<time unit>, kur `N` - laika vienību skaits, `time unit` - h (stunda), d (diena), w (nedēļa), M (mēnesis) vai y (gads). - **time shift** - [laika perioda nobīde](/manual/config/triggers/expression#time-shift) (skatiet funkciju piemērus) ##### Common use cases of global and host macros - use a global macro in several locations; then change the macro value and apply configuration changes to all locations with one click - take advantage of templates with host-specific attributes: passwords, port numbers, file names, regular expressions, etc. ##### Globālo un hostu makrosu biežākie lietošanas gadījumi - izmantot globālu makrosu vairākās vietās; pēc tam mainīt makrosa vērtību un ar vienu klikšķi piemērot konfigurācijas izmaiņas visām vietām - izmantot veidņu priekšrocības ar hostam specifiskiem atribūtiem: paroles, portu numuri, failu nosaukumi, regulārās izteiksmes utt. #### Communication framework for widgets Dashboard widgets can now connect and communicate with each other, making widgets and dashboards more dynamic. Multiple widgets have parameters that enable them to share configuration data between compatible widgets or the dashboard. This feature introduces the following changes: - *Host groups*, *Hosts*, and *Item* parameters allow you to select either the respective entities or a data source providing them. - *Enable host selection* parameter has been replaced with the *Override host* parameter, which allows you to select a data source that provides hosts. - *Time period* parameter has been added to multiple widgets, which allows you to select a data source that provides a time period. - *Map* parameter in *Map* widget allows to select either a map or another widget as a data source for maps. - *Graph* parameter in *Graph (classic)* widget allows to select either a graph or another widget as a data source for graphs. Depending on the widget and its parameters, the data source can be either a compatible widget from the same dashboard or the dashboard itself. For more information, see [Dashboard widgets](/manual/web_interface/frontend_sections/dashboards/widgets#dynamic-parameters). For changes to stock templates that are shipped with Zabbix, see [Template changes](/manual/installation/template_changes#changes-in-7.0.0). #### Sakaru ietvars logrīkiem Informācijas paneļa logrīki tagad var savienoties un sazināties savā starpā, padarot logrīkus un informācijas paneļus dinamiskākus. Vairākiem logrīkiem ir parametri, kas ļauj tiem koplietot konfigurācijas datus starp saderīgiem logrīkiem vai informācijas paneli. Šī funkcija ievieš šādas izmaiņas: - *Host groups*, *Hosts* un *Item* parametri ļauj izvēlēties vai nu attiecīgos objektus, vai datu avotu, kas tos nodrošina. - Parametrs *Enable host selection* ir aizstāts ar parametru *Override host*, kas ļauj izvēlēties datu avotu, kas nodrošina hosts. - Parametrs *Time period* ir pievienots vairākiem logrīkiem, un tas ļauj izvēlēties datu avotu, kas nodrošina laika periodu. - Parametrs *Map* logrīkā *Map* ļauj izvēlēties vai nu karti, vai citu logrīku kā karšu datu avotu. - Parametrs *Graph* logrīkā *Graph (classic)* ļauj izvēlēties vai nu grafiku, vai citu logrīku kā grafiku datu avotu. Atkarībā no logrīka un tā parametriem datu avots var būt vai nu saderīgs logrīks no tā paša informācijas paneļa, vai pats informācijas panelis. Papildinformāciju skatiet sadaļā [Dashboard widgets](/manual/web_interface/frontend_sections/dashboards/widgets#dynamic-parameters). Informāciju par izmaiņām standarta veidnēs, kas tiek piegādātas kopā ar Zabbix, skatiet sadaļā [Template changes](/manual/installation/template_changes#changes-in-7.0.0). ## Community & other resources ## Kopiena un citi resursi #### Comparing the import of a template Compare the template contained in the XML string to the current system elements, and show what will be changed if this template will be imported. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "configuration.importcompare", "params": { "format": "xml", "rules": { "discoveryRules": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "graphs": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "host_groups": { "createMissing": true, "updateExisting": true }, "template_groups": { "createMissing": true, "updateExisting": true }, "httptests": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "items": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "templateLinkage": { "createMissing": true, "deleteMissing": true }, "templates": { "createMissing": true, "updateExisting": true }, "templateDashboards": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "triggers": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "valueMaps": { "createMissing": true, "updateExisting": true, "deleteMissing": true } }, "source": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<zabbix_export><version>7.0</version><template_groups><template_group><uuid>7df96b18c230490a9a0a9e2307226338</uuid><name>Templates</name></template_group></template_groups><templates><template><uuid>5aef0444a82a4d8cb7a95dc4c0c85330</uuid><template>New template</template><name>New template</name><groups><group><name>Templates</name></group></groups><items><item><uuid>7f1e6f1e48aa4a128e5b6a958a5d11c3</uuid><name>Zabbix agent ping</name><key>agent.ping</key><delay>3m</delay></item><item><uuid>77ba228662be4570830aa3c503fcdc03</uuid><name>Apache server uptime</name><type>DEPENDENT</type><key>apache.server.uptime</key><delay>0</delay><trends>0</trends><value_type>TEXT</value_type><preprocessing><step><type>REGEX</type><parameters><parameter>&lt;dt&gt;Server uptime: (.*)&lt;/dt&gt;</parameter><parameter>\\1</parameter></parameters></step></preprocessing><master_item><key>web.page.get[127.0.0.1/server-status]</key></master_item></item><item><uuid>648006da5971424ead0c47ddbbf1ea2e</uuid><name>CPU utilization</name><key>system.cpu.util</key><value_type>FLOAT</value_type><units>%</units><triggers><trigger><uuid>736225012c534ec480c2a66a91322ce0</uuid><expression>avg(/New template/system.cpu.util,3m)&gt;70</expression><name>CPU utilization too high on 'New host' for 3 minutes</name><priority>WARNING</priority></trigger></triggers></item><item><uuid>590efe5731254f089265c76ff9320726</uuid><name>Apache server status</name><key>web.page.get[127.0.0.1/server-status]</key><trends>0</trends><value_type>TEXT</value_type></item></items><valuemaps><valuemap><uuid>8fd5814c45d44a00a15ac6eaae1f3946</uuid><name>Zabbix agent ping</name><mappings><mapping><value>1</value><newvalue>Available</newvalue></mapping><mapping><value>0</value><newvalue>Not available</newvalue></mapping></mappings></valuemap></valuemaps></template></templates></zabbix_export>\n" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "templates": { "updated": [ { "before": { "uuid": "5aef0444a82a4d8cb7a95dc4c0c85330", "template": "New template", "name": "New template", "groups": [ { "name": "Templates" } ] }, "after": { "uuid": "5aef0444a82a4d8cb7a95dc4c0c85330", "template": "New template", "name": "New template", "groups": [ { "name": "Templates" } ] }, "items": { "added": [ { "after": { "uuid": "648006da5971424ead0c47ddbbf1ea2e", "name": "CPU utilization", "key": "system.cpu.util", "value_type": "FLOAT", "units": "%" }, "triggers": { "added": [ { "after": { "uuid": "736225012c534ec480c2a66a91322ce0", "expression": "avg(/New template/system.cpu.util,3m)>70", "name": "CPU utilization too high on 'New host' for 3 minutes", "priority": "WARNING" } } ] } } ], "removed": [ { "before": { "uuid": "6805d4c39a624a8bab2cc8ab63df1ab3", "name": "CPU load", "key": "system.cpu.load", "value_type": "FLOAT" }, "triggers": { "removed": [ { "before": { "uuid": "ab4c2526c2bc42e48a633082255ebcb3", "expression": "avg(/New template/system.cpu.load,3m)>2", "name": "CPU load too high on 'New host' for 3 minutes", "priority": "WARNING" } } ] } } ], "updated": [ { "before": { "uuid": "7f1e6f1e48aa4a128e5b6a958a5d11c3", "name": "Zabbix agent ping", "key": "agent.ping" }, "after": { "uuid": "7f1e6f1e48aa4a128e5b6a958a5d11c3", "name": "Zabbix agent ping", "key": "agent.ping", "delay": "3m" } } ] } } ] } }, "id": 1 } ``` #### Veidnes importēšanas salīdzināšana Salīdziniet XML virknē ietverto veidni ar pašreizējiem sistēmas elementiem un parādiet, kas tiks mainīts, ja šī veidne tiks importēta. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "configuration.importcompare", "params": { "format": "xml", "rules": { "discoveryRules": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "graphs": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "host_groups": { "createMissing": true, "updateExisting": true }, "template_groups": { "createMissing": true, "updateExisting": true }, "httptests": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "items": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "templateLinkage": { "createMissing": true, "deleteMissing": true }, "templates": { "createMissing": true, "updateExisting": true }, "templateDashboards": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "triggers": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "valueMaps": { "createMissing": true, "updateExisting": true, "deleteMissing": true } }, "source": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<zabbix_export><version>7.0</version><template_groups><template_group><uuid>7df96b18c230490a9a0a9e2307226338</uuid><name>Templates</name></template_group></template_groups><templates><template><uuid>5aef0444a82a4d8cb7a95dc4c0c85330</uuid><template>New template</template><name>New template</name><groups><group><name>Templates</name></group></groups><items><item><uuid>7f1e6f1e48aa4a128e5b6a958a5d11c3</uuid><name>Zabbix agent ping</name><key>agent.ping</key><delay>3m</delay></item><item><uuid>77ba228662be4570830aa3c503fcdc03</uuid><name>Apache server uptime</name><type>DEPENDENT</type><key>apache.server.uptime</key><delay>0</delay><trends>0</trends><value_type>TEXT</value_type><preprocessing><step><type>REGEX</type><parameters><parameter>&lt;dt&gt;Server uptime: (.*)&lt;/dt&gt;</parameter><parameter>\\1</parameter></parameters></step></preprocessing><master_item><key>web.page.get[127.0.0.1/server-status]</key></master_item></item><item><uuid>648006da5971424ead0c47ddbbf1ea2e</uuid><name>CPU utilization</name><key>system.cpu.util</key><value_type>FLOAT</value_type><units>%</units><triggers><trigger><uuid>736225012c534ec480c2a66a91322ce0</uuid><expression>avg(/New template/system.cpu.util,3m)&gt;70</expression><name>CPU utilization too high on 'New host' for 3 minutes</name><priority>WARNING</priority></trigger></triggers></item><item><uuid>590efe5731254f089265c76ff9320726</uuid><name>Apache server status</name><key>web.page.get[127.0.0.1/server-status]</key><trends>0</trends><value_type>TEXT</value_type></item></items><valuemaps><valuemap><uuid>8fd5814c45d44a00a15ac6eaae1f3946</uuid><name>Zabbix agent ping</name><mappings><mapping><value>1</value><newvalue>Available</newvalue></mapping><mapping><value>0</value><newvalue>Not available</newvalue></mapping></mappings></valuemap></valuemaps></template></templates></zabbix_export>\n" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "templates": { "updated": [ { "before": { "uuid": "5aef0444a82a4d8cb7a95dc4c0c85330", "template": "New template", "name": "New template", "groups": [ { "name": "Templates" } ] }, "after": { "uuid": "5aef0444a82a4d8cb7a95dc4c0c85330", "template": "New template", "name": "New template", "groups": [ { "name": "Templates" } ] }, "items": { "added": [ { "after": { "uuid": "648006da5971424ead0c47ddbbf1ea2e", "name": "CPU utilization", "key": "system.cpu.util", "value_type": "FLOAT", "units": "%" }, "triggers": { "added": [ { "after": { "uuid": "736225012c534ec480c2a66a91322ce0", "expression": "avg(/New template/system.cpu.util,3m)>70", "name": "CPU utilization too high on 'New host' for 3 minutes", "priority": "WARNING" } } ] } } ], "removed": [ { "before": { "uuid": "6805d4c39a624a8bab2cc8ab63df1ab3", "name": "CPU load", "key": "system.cpu.load", "value_type": "FLOAT" }, "triggers": { "removed": [ { "before": { "uuid": "ab4c2526c2bc42e48a633082255ebcb3", "expression": "avg(/New template/system.cpu.load,3m)>2", "name": "CPU load too high on 'New host' for 3 minutes", "priority": "WARNING" } } ] } } ], "updated": [ { "before": { "uuid": "7f1e6f1e48aa4a128e5b6a958a5d11c3", "name": "Zabbix agent ping", "key": "agent.ping" }, "after": { "uuid": "7f1e6f1e48aa4a128e5b6a958a5d11c3", "name": "Zabbix agent ping", "key": "agent.ping", "delay": "3m" } } ] } } ] } }, "id": 1 } ``` #### Comparison table While most of the functionality overlaps between on-premise Zabbix installations and cloud nodes, there are also differences. A summary comparison table is provided below. Subsequent sections describe selected items in detail. |Feature / Aspect|Zabbix Cloud|Zabbix on‑premises| |--|----|----| |*Release cycle*|In step with LTS [releases](https://www.zabbix.com/life_cycle_and_release_policy)|You choose your Zabbix version (stable, beta, custom builds)| |*Ease of use*|Ready-to-use platform, fully managed by Zabbix|Requires [installation](/manual/installation), configuration and maintenance| |*Vulnerability patching*|Automatic OS/Zabbix patching|Manual patching by user| |*HTTPS certificate*|Valid certificate out‑of‑the‑box (no Let's Encrypt)|Self‑signed by default (Let's Encrypt or other CA can be configured)| |*DB performance*<br>(INSERT/UPDATE/SELECT)|Auto‑partitioning for max speed; no long-running DELETEs|Manual partitioning & cleanup (long DELETE transactions possible)| |*Performance tuning*|Pre‑tuned by Zabbix Cloud team (no changelogs)|Full visibility & control over tuning parameters| |*Firewall control*|Managed by Zabbix Cloud team; GUI/trapper ports not exposed publicly|Full control of firewall rules and port exposure| |*DB isolation & protection*|Highly isolated, no direct DB/SSH access|Depends on your network and host [security](/manual/best_practices/security)| |*High availability (HA)*|Runs on a highly-available cloud platform,<br>Zabbix proxies can be used for higher data-collection resilience|User-managed HA| |*[SNMP traps](#snmp-traps)*|Only via dedicated proxy (no HA/load‑balanced trap receiver)|Direct or via proxy, HA/load‑balance possible| |*[SNMP polling](#snmp-polling)*|Hard without proxies (each device needs NAT/custom port)|Native [SNMP polling](/manual/config/items/itemtypes/snmp); proxy optional| |*[Retention settings](#retention-settings)*|[History/Trends/Audit](/cloud/node_configuration#history-tab) only via UI (no API or configuration file)|Configurable in Zabbix [server configuration file](/manual/appendix/config/zabbix_server) or via [API](/manual/api/reference#monitoring)| |*[Custom scripts](#custom-scripts)*|[`AlertScriptsPath`](/manual/appendix/config/zabbix_server#alertscriptspath), [`ExternalScripts`](/manual/appendix/config/zabbix_server#externalscripts), frontend & community modules not supported|Fully supported ([scripts](/manual/config/notifications/media/script) path, [modules](/manual/extensions/frontendmodules), integrations)| |*[ODBC monitoring](#odbc-monitoring)*|Only PostgreSQL (driver `{postgresql}`); MariaDB plugin present as a placeholder|ODBC for PostgreSQL, MySQL, Oracle, etc. - fully configurable| |*Limiting ODBC calls*|Not possible ([`StartODBCPollers=1`]((/manual/appendix/config/zabbix_server#startodbcpollers)) only; heavy sync queries block other work)|Fully tunable poller count & scheduling| |*[SAML certificate upload](#saml-certificate-upload)*|Not supported|Supported via UI or API| |*[Scheduled reports](#scheduled-reports)*|Must [create](/manual/config/notifications/media#configuring-media-type) own Email media (script media unsupported)|Supports both script and Email media out‑of‑the‑box| |*[Host interface for active checks](#active-checks-interface)*|Platform-issued IP address (created automatically)|Interfaces managed by you; IPs under your control| #### Salīdzinājuma tabula Lai gan lielākā daļa funkcionalitātes pārklājas starp lokālajām Zabbix instalācijām un mākoņa mezgliem, pastāv arī atšķirības. Tālāk ir sniegta kopsavilkuma salīdzinājuma tabula. Nākamajās sadaļās atsevišķi vienumi ir aprakstīti detalizēti. |Funkcija / aspekts|Zabbix Cloud|Zabbix lokāli instalēts| |--|----|----| |*Izlaiduma cikls*|Saskaņots ar LTS [laidieniem](https://www.zabbix.com/life_cycle_and_release_policy)|Jūs izvēlaties savu Zabbix versiju (stabila, beta, pielāgoti būvējumi)| |*Lietošanas ērtums*|Gatava lietošanai platforma, pilnībā pārvaldīta no Zabbix puses|Nepieciešama [instalēšana](/manual/installation), konfigurēšana un uzturēšana| |*Ievainojamību ielāgošana*|Automātiska OS/Zabbix ielāgošana|Lietotājs veic manuālu ielāgošanu| |*HTTPS sertifikāts*|Derīgs sertifikāts jau pēc noklusējuma (nav Let's Encrypt)|Pēc noklusējuma pašparakstīts (var konfigurēt Let's Encrypt vai citu CA)| |*DB veiktspēja*<br>(INSERT/UPDATE/SELECT)|Automātiska sadalīšana nodalījumos maksimālam ātrumam; nav ilgstošu DELETE|Manuāla sadalīšana nodalījumos un tīrīšana (iespējami gari DELETE darījumi)| |*Veiktspējas pielāgošana*|Iepriekš pielāgota Zabbix Cloud komandas vadībā (nav izmaiņu žurnālu)|Pilnīga redzamība un kontrole pār pielāgošanas parametriem| |*Ugunsmūra kontrole*|Pārvalda Zabbix Cloud komanda; GUI/trapper porti nav publiski pieejami|Pilnīga kontrole pār ugunsmūra noteikumiem un portu pieejamību| |*DB izolācija un aizsardzība*|Ļoti izolēta, nav tiešas piekļuves DB/SSH|Atkarīgs no jūsu tīkla un hosts [drošības](/manual/best_practices/security)| |*Augsta pieejamība (HA)*|Darbojas uz augsti pieejamas mākoņa platformas,<br>Zabbix starpniekserveri var izmantot, lai palielinātu datu vākšanas noturību|Lietotāja pārvaldīta HA| |*[SNMP trapi](#snmp-traps)*|Tikai caur īpašu starpniekserveri (nav HA/slodzes balansēta trapu uztvērēja)|Tieši vai caur starpniekserveri, iespējama HA/slodzes balansēšana| |*[SNMP aptauja](#snmp-polling)*|Grūti bez starpniekserveriem (katrai ierīcei nepieciešams NAT/pielāgots ports)|Iebūvēta [SNMP aptauja](/manual/config/items/itemtypes/snmp); starpniekserveris nav obligāts| |*[Saglabāšanas iestatījumi](#retention-settings)*|[Vēsture/Trendi/Audits](/cloud/node_configuration#history-tab) tikai caur lietotāja saskarni (nav API vai konfigurācijas faila)|Konfigurējams Zabbix [servera konfigurācijas failā](/manual/appendix/config/zabbix_server) vai caur [API](/manual/api/reference#monitoring)| |*[Pielāgoti skripti](#custom-scripts)*|[`AlertScriptsPath`](/manual/appendix/config/zabbix_server#alertscriptspath), [`ExternalScripts`](/manual/appendix/config/zabbix_server#externalscripts), lietotāja saskarne un kopienas moduļi netiek atbalstīti|Pilnībā atbalstīti ([skriptu](/manual/config/notifications/media/script) ceļš, [moduļi](/manual/extensions/frontendmodules), integrācijas)| |*[ODBC monitorings](#odbc-monitoring)*|Tikai PostgreSQL (draiveris `{postgresql}`); MariaDB spraudnis ir pieejams kā vietturis|ODBC PostgreSQL, MySQL, Oracle u. c. - pilnībā konfigurējams| |*ODBC izsaukumu ierobežošana*|Nav iespējama (tikai [`StartODBCPollers=1`]((/manual/appendix/config/zabbix_server#startodbcpollers)); smagas sinhronās vaicājumu izpildes bloķē citu darbu)|Pilnībā pielāgojams aptaujātāju skaits un plānošana| |*[SAML sertifikāta augšupielāde](#saml-certificate-upload)*|Netiek atbalstīta|Atbalstīta caur lietotāja saskarni vai API| |*[Plānotie pārskati](#scheduled-reports)*|Jāizveido pašam sava Email medija tips ([izveidot](/manual/config/notifications/media#configuring-media-type); skriptu medija tips netiek atbalstīts)|Pēc noklusējuma atbalsta gan skriptu, gan Email medija tipu| |*[Hosts interfeiss aktīvajām pārbaudēm](#active-checks-interface)*|Platformas piešķirta IP adrese (izveidota automātiski)|Interfeisi tiek pārvaldīti jūsu; IP adreses ir jūsu kontrolē| #### Compatibility #### Saderība ##### Compiling Zabbix agent 1\. Download the [Zabbix source archive](https://www.zabbix.com/download_sources#70LTS) and extract it to `C:\Zabbix\zabbix-7.0.0`. If you need to generate a source archive from the raw source repository (e.g., to apply custom patches or build from the latest source code), run the following commands on a **Linux** machine: ```bash git clone https://git.zabbix.com/scm/zbx/zabbix.git cd zabbix ./bootstrap.sh ./configure --enable-agent --enable-ipv6 --prefix=`pwd` make dist ``` This will create a source archive, which can then be copied to a Windows machine. 2\. Navigate to the Zabbix build directory and compile Zabbix agent (or other components); make sure to correctly specify the directories where OpenSSL and PCRE2 are installed: ```bash cd C:\Zabbix\zabbix-7.0.0\build\win32\project # With TLS support: nmake /K -f Makefile_agent PCRE2INCDIR="C:\Program Files\Zabbix\x64\PCRE2\include" PCRE2LIBDIR="C:\Program Files\Zabbix\x64\PCRE2\lib" TLS=openssl TLSINCDIR="C:\Program Files\Zabbix\x64\OpenSSL\include" TLSLIBDIR="C:\Program Files\Zabbix\x64\OpenSSL\lib" nmake /K -f Makefile_get PCRE2INCDIR="C:\Program Files\Zabbix\x64\PCRE2\include" PCRE2LIBDIR="C:\Program Files\Zabbix\x64\PCRE2\lib" TLS=openssl TLSINCDIR="C:\Program Files\Zabbix\x64\OpenSSL\include" TLSLIBDIR="C:\Program Files\Zabbix\x64\OpenSSL\lib" nmake /K -f Makefile_sender PCRE2INCDIR="C:\Program Files\Zabbix\x64\PCRE2\include" PCRE2LIBDIR="C:\Program Files\Zabbix\x64\PCRE2\lib" TLS=openssl TLSINCDIR="C:\Program Files\Zabbix\x64\OpenSSL\include" TLSLIBDIR="C:\Program Files\Zabbix\x64\OpenSSL\lib" # Without TLS support: nmake /K -f Makefile_agent PCRE2INCDIR="C:\Program Files\Zabbix\x64\PCRE2\include" PCRE2LIBDIR="C:\Program Files\Zabbix\x64\PCRE2\lib" nmake /K -f Makefile_get PCRE2INCDIR="C:\Program Files\Zabbix\x64\PCRE2\include" PCRE2LIBDIR="C:\Program Files\Zabbix\x64\PCRE2\lib" nmake /K -f Makefile_sender PCRE2INCDIR="C:\Program Files\Zabbix\x64\PCRE2\include" PCRE2LIBDIR="C:\Program Files\Zabbix\x64\PCRE2\lib" ``` After compilation, Zabbix component binaries will be located in `C:\Zabbix\zabbix-7.0.0\bin\win64`. Zabbix agent configuration file is located in `C:\Zabbix\zabbix-7.0.0\conf`. To run the agent, copy `zabbix_agent.exe` and its configuration file to a dedicated folder (e.g., `C:\Zabbix\agent`) and then run the agent: ```bash mkdir C:\Zabbix\agent copy C:\Zabbix\zabbix-7.0.0\bin\win64\zabbix_agentd.exe C:\Zabbix\agent\ copy C:\Zabbix\zabbix-7.0.0\conf\zabbix_agentd.win.conf C:\Zabbix\agent\ C:\Zabbix\agent\zabbix_agentd.exe -c C:\Zabbix\agent\zabbix_agentd.win.conf -f ``` ##### Zabbix aģenta kompilēšana 1\. Lejupielādējiet [Zabbix avota arhīvu](https://www.zabbix.com/download_sources#70LTS) un izvelciet to uz `C:\Zabbix\zabbix-7.0.0`. Ja nepieciešams izveidot avota arhīvu no neapstrādātās avota repozitorijas (piem., lai lietotu pielāgotus ielāpus vai veidotu no jaunākā avota koda), izpildiet šādas komandas **Linux** datorā: ```bash git clone https://git.zabbix.com/scm/zbx/zabbix.git cd zabbix ./bootstrap.sh ./configure --enable-agent --enable-ipv6 --prefix=`pwd` make dist ``` Tas izveidos avota arhīvu, ko pēc tam var kopēt uz Windows datoru. 2\. Pārejiet uz Zabbix būvēšanas direktoriju un kompilējiet Zabbix aģentu (vai citus komponentus); pārliecinieties, ka ir pareizi norādīti direktoriji, kuros ir instalēti OpenSSL un PCRE2: ```bash cd C:\Zabbix\zabbix-7.0.0\build\win32\project # Ar TLS atbalstu: nmake /K -f Makefile_agent PCRE2INCDIR="C:\Program Files\Zabbix\x64\PCRE2\include" PCRE2LIBDIR="C:\Program Files\Zabbix\x64\PCRE2\lib" TLS=openssl TLSINCDIR="C:\Program Files\Zabbix\x64\OpenSSL\include" TLSLIBDIR="C:\Program Files\Zabbix\x64\OpenSSL\lib" nmake /K -f Makefile_get PCRE2INCDIR="C:\Program Files\Zabbix\x64\PCRE2\include" PCRE2LIBDIR="C:\Program Files\Zabbix\x64\PCRE2\lib" TLS=openssl TLSINCDIR="C:\Program Files\Zabbix\x64\OpenSSL\include" TLSLIBDIR="C:\Program Files\Zabbix\x64\OpenSSL\lib" nmake /K -f Makefile_sender PCRE2INCDIR="C:\Program Files\Zabbix\x64\PCRE2\include" PCRE2LIBDIR="C:\Program Files\Zabbix\x64\PCRE2\lib" TLS=openssl TLSINCDIR="C:\Program Files\Zabbix\x64\OpenSSL\include" TLSLIBDIR="C:\Program Files\Zabbix\x64\OpenSSL\lib" # Bez TLS atbalsta: nmake /K -f Makefile_agent PCRE2INCDIR="C:\Program Files\Zabbix\x64\PCRE2\include" PCRE2LIBDIR="C:\Program Files\Zabbix\x64\PCRE2\lib" nmake /K -f Makefile_get PCRE2INCDIR="C:\Program Files\Zabbix\x64\PCRE2\include" PCRE2LIBDIR="C:\Program Files\Zabbix\x64\PCRE2\lib" nmake /K -f Makefile_sender PCRE2INCDIR="C:\Program Files\Zabbix\x64\PCRE2\include" PCRE2LIBDIR="C:\Program Files\Zabbix\x64\PCRE2\lib" ``` Pēc kompilēšanas Zabbix komponentu binārie faili atradīsies `C:\Zabbix\zabbix-7.0.0\bin\win64`. Zabbix aģenta konfigurācijas fails atrodas `C:\Zabbix\zabbix-7.0.0\conf`. Lai palaistu aģentu, nokopējiet `zabbix_agent.exe` un tā konfigurācijas failu uz atsevišķu mapi (piem., `C:\Zabbix\agent`) un pēc tam palaidiet aģentu: ```bash mkdir C:\Zabbix\agent copy C:\Zabbix\zabbix-7.0.0\bin\win64\zabbix_agentd.exe C:\Zabbix\agent\ copy C:\Zabbix\zabbix-7.0.0\conf\zabbix_agentd.win.conf C:\Zabbix\agent\ C:\Zabbix\agent\zabbix_agentd.exe -c C:\Zabbix\agent\zabbix_agentd.win.conf -f ``` ##### Compiling Zabbix agent 2 1\. Download the [Zabbix source archive](https://www.zabbix.com/download_sources#70LTS) and extract it to `C:\Zabbix\zabbix-7.0.0`. If you need to generate a source archive from the raw source repository (e.g., to apply custom patches or build from the latest source code), run the following commands on a **Linux** machine with [Go](https://go.dev/) installed (required for configuring Zabbix agent 2): ```bash git clone https://git.zabbix.com/scm/zbx/zabbix.git cd zabbix ./bootstrap.sh ./configure --enable-agent2 --enable-ipv6 --prefix=`pwd` make dist ``` This will create a source archive, which can then be copied to a Windows machine. 2\. Open the Command Prompt with administrator privileges. Then, navigate to the Zabbix build directory and compile Zabbix agent; make sure to correctly specify the directories where OpenSSL and PCRE2 are installed: - For 64-bit builds: ```bash cd C:\Zabbix\zabbix-7.0.0\build\mingw set PATH=C:\Zabbix\mingw64\bin;%PATH% mklink /D C:\Zabbix\x64\OpenSSL-Win64-350-static\lib C:\Zabbix\x64\OpenSSL-Win64-350-static\lib64 # With TLS support: mingw32-make ARCH=AMD64 PCRE2="C:\Zabbix\x64\PCRE2" OPENSSL="C:\Zabbix\x64\OpenSSL-Win64-350-static" # Without TLS support: mingw32-make ARCH=AMD64 PCRE2="C:\Zabbix\x64\PCRE2" ``` - For 32-bit builds: ```bash cd C:\Zabbix\zabbix-7.0.0\build\mingw set PATH=C:\Zabbix\mingw32\bin;%PATH% # With TLS support: mingw32-make ARCH=x86 PCRE2="C:\Zabbix\x86\PCRE2" OPENSSL="C:\Zabbix\x86\OpenSSL-Win64-350-static" # Without TLS support: mingw32-make ARCH=x86 PCRE2="C:\Zabbix\x86\PCRE2" ``` After compilation, the Zabbix agent 2 binary will be located in `C:\Zabbix\zabbix-7.0.0\bin\win64` (or `C:\Zabbix\zabbix-7.0.0\bin\win32` for 32-bit builds). Zabbix agent 2 configuration files are located in `C:\Zabbix\zabbix-7.0.0\src\go\conf`. To run the agent, copy the `zabbix_agent2.exe` binary and its configuration files to a dedicated folder (e.g., `C:\Zabbix\agent2`) and then run the agent: ```bash mkdir C:\Zabbix\agent2 copy C:\Zabbix\zabbix-7.0.0\bin\win64\zabbix_agent2.exe C:\Zabbix\agent2\ copy C:\Zabbix\zabbix-7.0.0\src\go\conf\zabbix_agent2.win.conf C:\Zabbix\agent2\ xcopy /E /I C:\Zabbix\zabbix-7.0.0\src\go\conf\zabbix_agent2.d C:\Zabbix\agent2\zabbix_agent2.d\ C:\Zabbix\agent2\zabbix_agent2.exe -c C:\Zabbix\agent2\zabbix_agent2.win.conf ``` If necessary, continue with [compiling Zabbix agent 2 loadable plugins](#compiling-zabbix-agent-2-loadable-plugins). ##### Zabbix aģenta 2 kompilēšana 1\. Lejupielādējiet [Zabbix avota arhīvu](https://www.zabbix.com/download_sources#70LTS) un izpakojiet to uz `C:\Zabbix\zabbix-7.0.0`. Ja nepieciešams izveidot avota arhīvu no neapstrādātās avota repozitorijas (piemēram, lai piemērotu pielāgotus ielāpus vai veiktu būvēšanu no jaunākā avota koda), izpildiet šādas komandas **Linux** datorā, kurā ir instalēts [Go](https://go.dev/) (tas ir nepieciešams Zabbix aģenta 2 konfigurēšanai): ```bash git clone https://git.zabbix.com/scm/zbx/zabbix.git cd zabbix ./bootstrap.sh ./configure --enable-agent2 --enable-ipv6 --prefix=`pwd` make dist ``` Tas izveidos avota arhīvu, ko pēc tam varēs kopēt uz Windows datoru. 2\. Atveriet Command Prompt ar administratora tiesībām. Pēc tam pārejiet uz Zabbix būvēšanas direktoriju un kompilējiet Zabbix aģentu; pārliecinieties, ka ir pareizi norādīti direktoriji, kuros ir instalēts OpenSSL un PCRE2: - 64 bitu būvēšanai: ```bash cd C:\Zabbix\zabbix-7.0.0\build\mingw set PATH=C:\Zabbix\mingw64\bin;%PATH% mklink /D C:\Zabbix\x64\OpenSSL-Win64-350-static\lib C:\Zabbix\x64\OpenSSL-Win64-350-static\lib64 # Ar TLS atbalstu: mingw32-make ARCH=AMD64 PCRE2="C:\Zabbix\x64\PCRE2" OPENSSL="C:\Zabbix\x64\OpenSSL-Win64-350-static" # Bez TLS atbalsta: mingw32-make ARCH=AMD64 PCRE2="C:\Zabbix\x64\PCRE2" ``` - 32 bitu būvēšanai: ```bash cd C:\Zabbix\zabbix-7.0.0\build\mingw set PATH=C:\Zabbix\mingw32\bin;%PATH% # Ar TLS atbalstu: mingw32-make ARCH=x86 PCRE2="C:\Zabbix\x86\PCRE2" OPENSSL="C:\Zabbix\x86\OpenSSL-Win64-350-static" # Bez TLS atbalsta: mingw32-make ARCH=x86 PCRE2="C:\Zabbix\x86\PCRE2" ``` Pēc kompilēšanas Zabbix aģenta 2 binārais fails atradīsies `C:\Zabbix\zabbix-7.0.0\bin\win64` (vai `C:\Zabbix\zabbix-7.0.0\bin\win32` 32 bitu būvēšanai). Zabbix aģenta 2 konfigurācijas faili atrodas `C:\Zabbix\zabbix-7.0.0\src\go\conf`. Lai palaistu aģentu, nokopējiet `zabbix_agent2.exe` bināro failu un tā konfigurācijas failus uz atsevišķu mapi (piemēram, `C:\Zabbix\agent2`) un pēc tam palaidiet aģentu: ```bash mkdir C:\Zabbix\agent2 copy C:\Zabbix\zabbix-7.0.0\bin\win64\zabbix_agent2.exe C:\Zabbix\agent2\ copy C:\Zabbix\zabbix-7.0.0\src\go\conf\zabbix_agent2.win.conf C:\Zabbix\agent2\ xcopy /E /I C:\Zabbix\zabbix-7.0.0\src\go\conf\zabbix_agent2.d C:\Zabbix\agent2\zabbix_agent2.d\ C:\Zabbix\agent2\zabbix_agent2.exe -c C:\Zabbix\agent2\zabbix_agent2.win.conf ``` Ja nepieciešams, turpiniet ar [Zabbix aģenta 2 ielādējamo spraudņu kompilēšanu](#compiling-zabbix-agent-2-loadable-plugins). ##### Compiling Zabbix agent 2 loadable plugins 1\. Download the [Zabbix plugin source](https://cdn.zabbix.com/zabbix-agent2-plugins/sources/) that matches your Zabbix agent 2 version (e.g., `zabbix-agent2-plugin-postgresql-7.0.0.tar.gz`) and extract it to `C:\Zabbix`. ::: noteimportant Before installing a plugin, please check its README file. It may contain specific requirements and installation instructions. ::: 2\. Navigate to the extracted plugin directory and compile the plugin: ```bash cd C:\Zabbix\zabbix-agent2-plugin-ember-plus-7.0.0 # For 64-bit builds: mingw32-make ARCH=AMD64 # For 32-bit builds: mingw32-make ARCH=x86 ``` After compilation, the Zabbix agent 2 plugin binary and its configuration file will be located in the same plugin directory. The plugin executable may be placed anywhere as long as it is loadable by Zabbix agent 2. Specify the path to the plugin binary in the plugin configuration file, e.g. in postgresql.conf for the [PostgreSQL](/manual/appendix/config/zabbix_agent2_plugins/postgresql_plugin) plugin: ```ini Plugins.PostgreSQL.System.Path=/path/to/executable/zabbix-agent2-plugin-postgresql ``` The path to the plugin configuration file must be specified in the [Include](/manual/appendix/config/zabbix_agent2_win#include) parameter of the Zabbix agent 2 configuration file: ```ini Include=/path/to/plugin/configuration/file/postgresql.conf ``` Proceed to [setup](/manual/extensions/plugins#configuring-plugins) for more details on configuring plugins. ##### Zabbix aģents 2 ielādējamo spraudņu kompilēšana 1\. Lejupielādējiet [Zabbix spraudņa avotu](https://cdn.zabbix.com/zabbix-agent2-plugins/sources/), kas atbilst jūsu Zabbix aģents 2 versijai (piem., `zabbix-agent2-plugin-postgresql-7.0.0.tar.gz`), un izvelciet to uz `C:\Zabbix`. ::: noteimportant Pirms spraudņa instalēšanas, lūdzu, pārbaudiet tā README failu. Tajā var būt norādītas konkrētas prasības un instalēšanas instrukcijas. ::: 2\. Pārejiet uz izvilkto spraudņa direktoriju un kompilējiet spraudni: ```bash cd C:\Zabbix\zabbix-agent2-plugin-ember-plus-7.0.0 # 64 bitu būvēm: mingw32-make ARCH=AMD64 # 32 bitu būvēm: mingw32-make ARCH=x86 ``` Pēc kompilēšanas Zabbix aģents 2 spraudņa binārais fails un tā konfigurācijas fails atradīsies tajā pašā spraudņa direktorijā. Spraudņa izpildāmo failu var novietot jebkurā vietā, ja vien to var ielādēt Zabbix aģents 2. Norādiet spraudņa binārā faila ceļu spraudņa konfigurācijas failā, piemēram, postgresql.conf failā [PostgreSQL](/manual/appendix/config/zabbix_agent2_plugins/postgresql_plugin) spraudnim: ```ini Plugins.PostgreSQL.System.Path=/path/to/executable/zabbix-agent2-plugin-postgresql ``` Spraudņa konfigurācijas faila ceļš ir jānorāda Zabbix aģents 2 konfigurācijas faila parametrā [Include](/manual/appendix/config/zabbix_agent2_win#include): ```ini Include=/path/to/plugin/configuration/file/postgresql.conf ``` Lai iegūtu plašāku informāciju par spraudņu konfigurēšanu, pārejiet uz [iestatīšanu](/manual/extensions/plugins#configuring-plugins). #### Compiling Zabbix agent on HP-UX If you install the PCRE library from the popular HP-UX package site <http://hpux.connect.org.uk> (for example, from file `pcre-8.42-ia64_64-11.31.depot`), only the 64-bit version of the library will be installed in the `/usr/local/lib/hpux64` directory. In this case, for successful agent compilation, a customized option is needed for the `configure` script, for example: CFLAGS="+DD64" ./configure --enable-agent --with-libpcre-include=/usr/local/include --with-libpcre-lib=/usr/local/lib/hpux64 #### Zabbix aģenta kompilēšana HP-UX Ja instalējat PCRE bibliotēku no populārās HP-UX pakotņu vietnes <http://hpux.connect.org.uk> (piemēram, no faila `pcre-8.42-ia64_64-11.31.depot`), bibliotēkas tiks instalēta tikai 64 bitu versija direktorijā `/usr/local/lib/hpux64`. Šādā gadījumā veiksmīgai aģenta kompilēšanai `configure` skriptam ir nepieciešama pielāgota opcija, piemēram: CFLAGS="+DD64" ./configure --enable-agent --with-libpcre-include=/usr/local/include --with-libpcre-lib=/usr/local/lib/hpux64 #### Compiling Zabbix with encryption support To support encryption Zabbix must be compiled and linked with one of the supported crypto libraries: - GnuTLS - from version 3.1.18 - OpenSSL - versions 1.0.1, 1.0.2, 1.1.0, 1.1.1, 3.0.x - LibreSSL - tested with versions 2.7.4, 2.8.2: - LibreSSL 2.6.x is not supported - LibreSSL is supported as a compatible replacement of OpenSSL; the new `tls_*()` LibreSSL-specific API functions are not used. Zabbix components compiled with LibreSSL will not be able to use PSK, only certificates can be used. :::notetip You can find out more about setting up SSL for Zabbix frontend by referring to these [best practices](/manual/best_practices/security/cryptography#setting-up-ssl-for-zabbix-frontend). ::: The library is selected by specifying the respective option to "configure" script: - `--with-gnutls[=DIR]` - `--with-openssl[=DIR]` (also used for LibreSSL) For example, to configure the sources for server and agent with *OpenSSL* you may use something like: ./configure --enable-server --enable-agent --with-mysql --enable-ipv6 --with-net-snmp --with-libcurl --with-libxml2 --with-openssl Different Zabbix components may be compiled with different crypto libraries (e.g. a server with *OpenSSL*, an agent with *GnuTLS*). ::: noteimportant If you plan to use pre-shared keys (PSK), consider using *GnuTLS* or *OpenSSL 1.1.0* (or newer) libraries in Zabbix components using PSKs. *GnuTLS* and *OpenSSL 1.1.0* libraries support PSK ciphersuites with [Perfect Forward Secrecy](https://en.wikipedia.org/wiki/Forward_secrecy#Perfect_forward_secrecy_.28PFS.29). Older versions of the *OpenSSL* library (1.0.1, 1.0.2c) also support PSKs, but available PSK ciphersuites do not provide Perfect Forward Secrecy. ::: #### Zabbix kompilēšana ar šifrēšanas atbalstu Lai nodrošinātu šifrēšanu, Zabbix ir jākopilē un jāsaista ar vienu no atbalstītajām kriptogrāfijas bibliotēkām: - GnuTLS - no versijas 3.1.18 - OpenSSL - versijas 1.0.1, 1.0.2, 1.1.0, 1.1.1, 3.0.x - LibreSSL - testēts ar versijām 2.7.4, 2.8.2: - LibreSSL 2.6.x netiek atbalstīts - LibreSSL tiek atbalstīts kā saderīga OpenSSL aizstāšana; jaunās `tls_*()` LibreSSL specifiskās API funkcijas netiek izmantotas. Zabbix komponenti, kas kompilēti ar LibreSSL, nevarēs izmantot PSK, var izmantot tikai sertifikātus. :::notetip Plašāku informāciju par SSL iestatīšanu Zabbix lietotāja saskarnei varat atrast, skatot šīs [labākās prakses](/manual/best_practices/security/cryptography#setting-up-ssl-for-zabbix-frontend). ::: Bibliotēka tiek izvēlēta, norādot attiecīgo opciju "configure" skriptam: - `--with-gnutls[=DIR]` - `--with-openssl[=DIR]` (tiek izmantots arī LibreSSL) Piemēram, lai konfigurētu servera un aģenta avotus ar *OpenSSL*, varat izmantot kaut ko līdzīgu: ./configure --enable-server --enable-agent --with-mysql --enable-ipv6 --with-net-snmp --with-libcurl --with-libxml2 --with-openssl Dažādus Zabbix komponentus var kompilēt ar dažādām kriptogrāfijas bibliotēkām (piem., serveri ar *OpenSSL*, aģentu ar *GnuTLS*). ::: noteimportant Ja plānojat izmantot iepriekš koplietotas atslēgas (PSK), apsveriet iespēju Zabbix komponentos, kas izmanto PSK, lietot *GnuTLS* vai *OpenSSL 1.1.0* (vai jaunākas) bibliotēkas. *GnuTLS* un *OpenSSL 1.1.0* bibliotēkas atbalsta PSK šifru kopas ar [Perfect Forward Secrecy](https://en.wikipedia.org/wiki/Forward_secrecy#Perfect_forward_secrecy_.28PFS.29). Vecākas *OpenSSL* bibliotēkas versijas (1.0.1, 1.0.2c) arī atbalsta PSK, taču pieejamās PSK šifru kopas nenodrošina Perfect Forward Secrecy. ::: #### Complete script Below is the complete script that combines all the steps: retrieving the hostname, creating the host and item using Zabbix API, and sending data to Zabbix. ```python import time from zabbix_utils import Getter, ZabbixAPI, Sender # Retrieve host name from Zabbix agent agent = Getter(host='127.0.0.1', port=10050) hostname = agent.get('system.hostname').value # Connect and log in to Zabbix API api = ZabbixAPI(url='127.0.0.1/zabbix') api.login(user='Admin', password='zabbix') # Create host in Zabbix host = api.host.create( host=hostname, interfaces=[{ 'type': 1, 'main': 1, 'useip': 1, 'ip': '127.0.0.1', 'dns': '', 'port': '10050', }], groups=[{'groupid': '2'}] ) host_id = host['hostids'][0] print(f"Host '{hostname}' created with ID {host_id}") # Create item in Zabbix item_key = 'app.myservice.heartbeat' item = api.item.create( hostid=host_id, name='App heartbeat', key_=item_key, type=2, value_type=3 ) item_id = item['itemids'][0] print(f"Item '{item_key}' created with ID {item_id}") # Log out from API api.logout() # Wait for Zabbix to process new host time.sleep(10) # Send value to host sender = Sender(server='127.0.0.1', port=10051) response = sender.send_value(hostname, item_key, 1) print(f"Sender response: {response}") ``` #### Pilns skripts Zemāk ir pilns skripts, kas apvieno visas darbības: hosta nosaukuma iegūšanu, hosta un vienuma izveidi, izmantojot Zabbix API, un datu nosūtīšanu uz Zabbix. ```python import time from zabbix_utils import Getter, ZabbixAPI, Sender # Iegūt hosta nosaukumu no Zabbix aģenta agent = Getter(host='127.0.0.1', port=10050) hostname = agent.get('system.hostname').value # Izveidot savienojumu ar Zabbix API un pieteikties api = ZabbixAPI(url='127.0.0.1/zabbix') api.login(user='Admin', password='zabbix') # Izveidot hostu Zabbix host = api.host.create( host=hostname, interfaces=[{ 'type': 1, 'main': 1, 'useip': 1, 'ip': '127.0.0.1', 'dns': '', 'port': '10050', }], groups=[{'groupid': '2'}] ) host_id = host['hostids'][0] print(f"Hosts '{hostname}' izveidots ar ID {host_id}") # Izveidot vienumu Zabbix item_key = 'app.myservice.heartbeat' item = api.item.create( hostid=host_id, name='App heartbeat', key_=item_key, type=2, value_type=3 ) item_id = item['itemids'][0] print(f"Vienums '{item_key}' izveidots ar ID {item_id}") # Atteikties no API api.logout() # Gaidīt, līdz Zabbix apstrādā jauno hostu time.sleep(10) # Nosūtīt vērtību hostam sender = Sender(server='127.0.0.1', port=10051) response = sender.send_value(hostname, item_key, 1) print(f"Sender atbilde: {response}") ``` ### Complete source code ```go package main import ( "io" "net/http" "golang.zabbix.com/sdk/errs" "golang.zabbix.com/sdk/plugin" "golang.zabbix.com/sdk/plugin/container" ) var _ plugin.Exporter = (*myIP)(nil) type myIP struct { plugin.Base } func main() { err := run() if err != nil { panic(err) } } func run() error { p := &myIP{} // Register the `myip` item key. err := plugin.RegisterMetrics( p, "MyIP", // Plugin name "myip", // Item key name "Returns the host's IP address.", // Item key description ) if err != nil { return errs.Wrap(err, "failed to register metrics") } // Create a new handler. h, err := container.NewHandler("MyIP") // Plugin name if err != nil { return errs.Wrap(err, "failed to create new handler") } // Setup logging to forward logs from the plugin to the agent. // Available via p.Logger.Infof, p.Logger.Debugf, etc. p.Logger = h // Start plugin execution. // Blocks until a termination request from the agent is received. err = h.Execute() if err != nil { return errs.Wrap(err, "failed to execute plugin handler") } return nil } func (p *myIP) Export( key string, params []string, context plugin.ContextProvider, ) (any, error) { // The plugin can use different data collection logic based on the `key` parameter. // This implementation only verifies that the provided `key` is supported. if key != "myip" { return nil, errs.Errorf("unknown item key %q", key) } // The log will get forwarded to the agent 2 log. p.Infof( "received request to handle %q key with %d parameters", key, len(params), ) // Collect the data and return it. resp, err := http.Get("https://api.ipify.org") if err != nil { return nil, errs.Wrap(err, "failed to get IP address") } defer resp.Body.Close() body, err := io.ReadAll(resp.Body) if err != nil { return nil, errs.Wrap(err, "failed to read response body") } return string(body), nil } ``` ### Pilns avota kods ```go package main import ( "io" "net/http" "golang.zabbix.com/sdk/errs" "golang.zabbix.com/sdk/plugin" "golang.zabbix.com/sdk/plugin/container" ) var _ plugin.Exporter = (*myIP)(nil) type myIP struct { plugin.Base } func main() { err := run() if err != nil { panic(err) } } func run() error { p := &myIP{} // Reģistrē `myip` vienuma atslēgu. err := plugin.RegisterMetrics( p, "MyIP", // Spraudņa nosaukums "myip", // Vienuma atslēgas nosaukums "Atgriež hosts IP adresi.", // Vienuma atslēgas apraksts ) if err != nil { return errs.Wrap(err, "neizdevās reģistrēt metriku") } // Izveido jaunu apstrādātāju. h, err := container.NewHandler("MyIP") // Spraudņa nosaukums if err != nil { return errs.Wrap(err, "neizdevās izveidot jaunu apstrādātāju") } // Iestata reģistrēšanu, lai pārsūtītu žurnālus no spraudņa uz aģentu. // Pieejams, izmantojot p.Logger.Infof, p.Logger.Debugf u. c. p.Logger = h // Sāk spraudņa izpildi. // Bloķējas, līdz no aģenta tiek saņemts pārtraukšanas pieprasījums. err = h.Execute() if err != nil { return errs.Wrap(err, "neizdevās izpildīt spraudņa apstrādātāju") } return nil } func (p *myIP) Export( key string, params []string, context plugin.ContextProvider, ) (any, error) { // Spraudnis var izmantot atšķirīgu datu vākšanas loģiku atkarībā no `key` parametra. // Šī implementācija tikai pārbauda, vai norādītais `key` tiek atbalstīts. if key != "myip" { return nil, errs.Errorf("nezināma vienuma atslēga %q", key) } // Žurnāls tiks pārsūtīts uz aģenta 2 žurnālu. p.Infof( "saņemts pieprasījums apstrādāt %q atslēgu ar %d parametriem", key, len(params), ) // Savāc datus un atgriež tos. resp, err := http.Get("https://api.ipify.org") if err != nil { return nil, errs.Wrap(err, "neizdevās iegūt IP adresi") } defer resp.Body.Close() body, err := io.ReadAll(resp.Body) if err != nil { return nil, errs.Wrap(err, "neizdevās nolasīt atbildes pamattekstu") } return string(body), nil } ``` ##### concat(<value1>,<value2>,...) {#concat} The string resulting from concatenating the referenced item values or constant values.<br> Supported value types: *String*, *Text*, *Log*, *Float*, *Integer*. Parameter: - **valueX** - the value returned by one of the history functions or a constant value (string, integer, or float number). Must contain at least two parameters. For example, a value like 'Zab' concatenated to 'bix' (the constant string) will return 'Zabbix'. Examples: concat(last(/host/key),"bix") concat("1 min: ",last(/host/system.cpu.load[all,avg1]),", 15 min: ",last(/host/system.cpu.load[all,avg15])) ##### concat(<value1>,<value2>,...) {#concat} Virkne, kas iegūta, savienojot norādīto vienumu vērtības vai konstantās vērtības.<br> Atbalstītie vērtību tipi: *String*, *Text*, *Log*, *Float*, *Integer*. Parametrs: - **valueX** - vērtība, ko atgriež kāda no vēstures funkcijām, vai konstanta vērtība (virkne, vesels skaitlis vai peldošā komata skaitlis). Jāsatur vismaz divi parametri. Piemēram, vērtība 'Zab', kas savienota ar 'bix' (konstanta virkne), atgriezīs 'Zabbix'. Piemēri: concat(last(/host/key),"bix") concat("1 min: ",last(/host/system.cpu.load[all,avg1]),", 15 min: ",last(/host/system.cpu.load[all,avg15])) #### Concurrency in network discovery In the new version the network discovery process has been reworked to allow concurrency between service checks. A new discovery manager process has been added along with a configurable number of discovery workers (or threads). The discovery manager processes discovery rules and creates a discovery job per each rule with tasks (service checks). The service checks are picked up and performed by the discovery workers. The [StartDiscoverers](/manual/appendix/config/zabbix_server#startdiscoverers) parameter now determines the total number of available discovery workers for discovery. The default number of StartDiscoverers has been upped from 1 to 5, and the range from 0-250 to 0-1000. The `discoverer` processes from previous Zabbix versions have been dropped. Additionally, the number of available workers per each rule is now configurable in the frontend. This parameter is optional. During the upgrade it will be set to "One" as in previous Zabbix versions. #### Vienlaicīga izpilde tīkla atklāšanā Jaunajā versijā tīkla atklāšanas process ir pārstrādāts, lai nodrošinātu vienlaicīgu izpildi starp pakalpojumu pārbaudēm. Ir pievienots jauns atklāšanas pārvaldnieka process kopā ar konfigurējamu atklāšanas darba procesu (vai pavedienu) skaitu. Atklāšanas pārvaldnieks apstrādā atklāšanas noteikumus un izveido atklāšanas darbu katram noteikumam ar uzdevumiem (pakalpojumu pārbaudēm). Pakalpojumu pārbaudes tiek paņemtas un izpildītas ar atklāšanas darba procesiem. Parametrs [StartDiscoverers](/manual/appendix/config/zabbix_server#startdiscoverers) tagad nosaka kopējo pieejamo atklāšanas darba procesu skaitu atklāšanai. Noklusējuma StartDiscoverers vērtība ir palielināta no 1 līdz 5, bet diapazons - no 0-250 līdz 0-1000. Iepriekšējo Zabbix versiju `discoverer` procesi ir noņemti. Turklāt pieejamo darba procesu skaits katram noteikumam tagad ir konfigurējams lietotāja saskarnē. Šis parametrs nav obligāts. Atjaunināšanas laikā tas tiks iestatīts uz "One", kā iepriekšējās Zabbix versijās. #### Concurrency in network discovery Previously each network discovery rule was processed by one discoverer process. Thus all service checks within the rule could only be performed sequentially. In the new version the network discovery process has been reworked to allow concurrency between service checks. A new discovery manager process has been added along with a configurable number of discovery workers (or threads). The discovery manager processes discovery rules and creates a discovery job per each rule with tasks (service checks). The service checks are picked up and performed by the discovery workers. Only those checks that have the same IP and port are scheduled sequentially because some devices may not allow concurrent connections on the same port. A new `zabbix[discovery_queue]` internal item allows to monitor the number of discovery checks in the queue. The [StartDiscoverers](/manual/appendix/config/zabbix_server#startdiscoverers) parameter now determines the total number of available discovery workers for discovery. The default number of StartDiscoverers has been upped from 1 to 5, and the range from 0-250 to 0-1000. The `discoverer` processes from previous Zabbix versions have been dropped. Additionally: - All service checks are now performed [asynchronously](#asynchronous-pollers), except for LDAP checks; - The number of simultaneous asynchronous checks per each service check type (or the number of available workers for all synchronous service checks) is now configurable in the [frontend](/manual/discovery/network_discovery/rule) (see *Maximum concurrent checks per type*). This parameter is optional. - HTTP service check previously was the same as TCP check. Now HTTP/HTTPs checking is done via libcurl. If Zabbix server/proxy is compiled without libcurl, then HTTP checks will work like previously (i.e. as TCP checks), but HTTPS checks will not work. - Errors in the network discovery process will now be displayed in the frontend (in *Data collection* -> *Discovery*), for example: - fping errors; - incorrect SNMP OID; - incorrect macro for item timeout; - address range errors. #### Vienlaicīgums tīkla atklāšanā Iepriekš katrs tīkla atklāšanas noteikums tika apstrādāts ar vienu discoverer procesu. Tādējādi visas pakalpojumu pārbaudes noteikuma ietvaros varēja tikt veiktas tikai secīgi. Jaunajā versijā tīkla atklāšanas process ir pārstrādāts, lai ļautu vienlaicīgumu starp pakalpojumu pārbaudēm. Ir pievienots jauns discovery manager process, kā arī konfigurējams discovery worker procesu (vai pavedienu) skaits. Discovery manager apstrādā atklāšanas noteikumus un izveido vienu atklāšanas darbu katram noteikumam ar uzdevumiem (pakalpojumu pārbaudēm). Pakalpojumu pārbaudes tiek paņemtas un izpildītas ar discovery workers. Secīgi tiek ieplānotas tikai tās pārbaudes, kurām ir vienāda IP adrese un ports, jo dažas ierīces var neatļaut vienlaicīgus savienojumus uz viena un tā paša porta. Jauns iekšējais vienums `zabbix[discovery_queue]` ļauj uzraudzīt atklāšanas pārbaužu skaitu rindā. Parametrs [StartDiscoverers](/manual/appendix/config/zabbix_server#startdiscoverers) tagad nosaka kopējo pieejamo discovery workers skaitu atklāšanai. Noklusējuma StartDiscoverers vērtība ir palielināta no 1 līdz 5, bet diapazons — no 0-250 līdz 0-1000. Iepriekšējo Zabbix versiju `discoverer` procesi ir noņemti. Papildus: - Visas pakalpojumu pārbaudes tagad tiek veiktas [asinhroni](#asynchronous-pollers), izņemot LDAP pārbaudes; - Vienlaicīgo asinhrono pārbaužu skaits katram pakalpojumu pārbaužu tipam (vai pieejamo worker skaits visām sinhronajām pakalpojumu pārbaudēm) tagad ir konfigurējams [lietotāja saskarne](/manual/discovery/network_discovery/rule) (skatiet *Maksimālais vienlaicīgo pārbaužu skaits uz tipu*). Šis parametrs nav obligāts. - HTTP pakalpojumu pārbaude iepriekš bija tāda pati kā TCP pārbaude. Tagad HTTP/HTTPS pārbaude tiek veikta, izmantojot libcurl. Ja Zabbix serveris/starpniekserveris ir kompilēts bez libcurl, tad HTTP pārbaudes darbosies kā iepriekš (t. i., kā TCP pārbaudes), bet HTTPS pārbaudes nedarbosies. - Kļūdas tīkla atklāšanas procesā tagad tiks parādītas lietotāja saskarne (sadaļā *Datu vākšana* -> *Atklāšana*), piemēram: - fping kļūdas; - nepareizs SNMP OID; - nepareiza makro vērtība vienuma taimautam; - adrešu diapazona kļūdas. #### Concurrent processing of SNMPv1 and SNMPv2 checks SNMPv1 and SNMPv2 asynchronous service checks are now processed concurrently by available discovery workers. #### SNMPv1 un SNMPv2 pārbaužu vienlaicīga apstrāde SNMPv1 un SNMPv2 asinhronie servisa pārbaudes tagad tiek apstrādātas vienlaicīgi ar pieejamajiem atklāšanas darbiniekiem. ### config Default values for the module options. The object may contain any custom keys. If specified, these values will be written into the database during module registration. New variables added later will be written upon the first call. Afterwards, the variable values can only be changed directly in the database. *Type*: Object *Example*: ```json "config": { "username": "Admin", "password": "", "auth_url": "https://example.com/auth" } ``` ### config Noklusējuma vērtības moduļa opcijām. Objekts var saturēt jebkādas pielāgotas atslēgas. Ja norādīts, šīs vērtības moduļa reģistrācijas laikā tiks ierakstītas datubāzē. Jaunas mainīgās vērtības, kas pievienotas vēlāk, tiks ierakstītas pirmajā izsaukuma reizē. Pēc tam mainīgo vērtības var mainīt tikai tieši datubāzē. *Type*: Object *Piemērs*: ```json "config": { "username": "Admin", "password": "", "auth_url": "https://example.com/auth" } ``` ##### ConfigFrequency This parameter is **deprecated** (use ProxyConfigFrequency instead).<br>How often the proxy retrieves configuration data from Zabbix server in seconds.<br>Active proxy parameter. Ignored for passive proxies (see ProxyMode parameter). Default: `3600`<br> Range: 1-604800 ##### ConfigFrequency Šis parametrs ir **novecojis** (izmantojiet ProxyConfigFrequency tā vietā).<br>Ik pēc cik sekundēm starpniekserveris izgūst konfigurācijas datus no Zabbix serveris.<br>Aktīvs starpniekservera parametrs. Tiek ignorēts pasīvajiem starpniekserveriem (skatiet ProxyMode parametru). Noklusējums: `3600`<br> Diapazons: 1-604800 #### Configurable fields Actual command(s) to be executed must be placed in the **Executed script** field in the item configuration.<br> Multiple commands can be executed one after another by placing them on a new line. In this case returned value also will be formatted as multilined. Supported characters that the shell prompt can end with: - $ - \# - \> - % ::: noteclassic A telnet prompt line which ended with one of these characters will be removed from the returned value, but only for the first command in the commands list, i.e. only at a start of the telnet session. ::: |Key|Description| |--|------| |**telnet.run\[<unique short description>,<ip>,<port>,<encoding>\]**|Run a command on a remote device using telnet connection| | ::: noteimportant If a telnet check returns a value with non-ASCII characters and in non-UTF8 encoding then the *<encoding>* parameter of the key should be properly specified. See [encoding of returned values](/manual/appendix/items/encoding_of_values) page for more details. ::: #### Konfigurējamie lauki Faktiskā(-ās) izpildāmā(-ās) komanda(-as) jānorāda vienuma konfigurācijas laukā **Executed script**.<br> Vairākas komandas var izpildīt vienu pēc otras, ievietojot katru jaunā rindā. Šajā gadījumā arī atgrieztā vērtība tiks formatēta kā vairākrindu. Atbalstītās rakstzīmes, ar kurām var beigties čaulas uzvedne: - $ - \# - \> - % ::: noteclassic Telnet uzvednes rinda, kas beidzas ar vienu no šīm rakstzīmēm, tiks noņemta no atgrieztās vērtības, bet tikai pirmajai komandai komandu sarakstā, t.i., tikai telnet sesijas sākumā. ::: |Atslēga|Apraksts| |--|------| |**telnet.run\[<unikāls īss apraksts>,<ip>,<ports>,<kodējums>\]**|Izpildīt komandu attālinātā ierīcē, izmantojot telnet savienojumu| | ::: noteimportant Ja telnet pārbaude atgriež vērtību ar rakstzīmēm, kas nav ASCII, un kodējumā, kas nav UTF8, tad atslēgas parametrs *<encoding>* ir jānorāda pareizi. Plašāku informāciju skatiet lapā [atgriezto vērtību kodējums](/manual/appendix/items/encoding_of_values). ::: #### Configurable fields The **key** is a unique item identifier (per host). You can create any key name using supported symbols. The calculation definition should be entered in the **Formula** field. There is no connection between the formula and the key. The key parameters are not used in the formula in any way. The syntax of a simple formula is: function(/host/key,<parameter1>,<parameter2>,...) where: | | | |--|--------| |*function*|One of the [supported functions](/manual/appendix/functions): last, min, max, avg, count, etc| |*host*|Host of the item that is used for calculation.<br>The current host can be omitted (i.e. as in `function(//key,parameter,...)`).| |*key*|Key of the item that is used for calculation.<br>Items returning values with the binary [data type](/manual/config/items/item#configuration) are not supported.| |*parameter(s)*|Parameters of the function, if required.<br>[Time suffixes](/manual/appendix/suffixes#time-suffixes) and [memory size suffixes](/manual/appendix/suffixes#memory-size-suffixes) are supported.| ::: noteimportant [User macros](/manual/config/macros/user_macros) in the formula will be expanded if used to reference a function parameter, item filter parameter, or a constant. User macros will NOT be expanded if referencing a function, host name, item key, item key parameter or operator. ::: A more complex formula may use a combination of functions, operators and brackets. You can use all functions and [operators](/manual/config/triggers/expression#operators) supported in trigger expressions. The logic and operator precedence are exactly the same. Unlike trigger expressions, Zabbix processes calculated items according to the item update interval, not upon receiving a new value. All items that are referenced by history functions in the calculated item formula must exist and be collecting data. Also, if you change the item key of a referenced item, you have to manually update any formulas using that key. A calculated item may become unsupported in several cases: - referenced item(s) - is not found - is disabled - belongs to a disabled host - is not supported (except with nodata() function and [operators](/manual/config/triggers/expression#operators) with unknown values) - no data to calculate a function - division by zero - incorrect syntax used #### Konfigurējamie lauki **key** ir unikāls vienuma identifikators (katram hostam). Varat izveidot jebkuru key nosaukumu, izmantojot atbalstītos simbolus. Aprēķina definīcija jāievada laukā **Formula**. Starp formulu un key nav savienojuma. Key parametri formulā nekādā veidā netiek izmantoti. Vienkāršas formulas sintakse ir: function(/host/key,<parameter1>,<parameter2>,...) kur: | | | |--|--------| |*function*|Viena no [atbalstītajām funkcijām](/manual/appendix/functions): last, min, max, avg, count u. c.| |*host*|Hosta, no kura tiek izmantots vienums aprēķinam.<br>Pašreizējo hostu var izlaist (t. i., kā `function(//key,parameter,...)`).| |*key*|Vienuma key, kas tiek izmantots aprēķinam.<br>Vienumi, kas atgriež vērtības ar bināro [datu tipu](/manual/config/items/item#configuration), netiek atbalstīti.| |*parameter(s)*|Funkcijas parametri, ja nepieciešams.<br>Tiek atbalstīti [laika sufiksi](/manual/appendix/suffixes#time-suffixes) un [atmiņas apjoma sufiksi](/manual/appendix/suffixes#memory-size-suffixes).| ::: noteimportant [User macros](/manual/config/macros/user_macros) formulā tiks izvērsti, ja tie tiek izmantoti, lai norādītu funkcijas parametru, vienuma filtra parametru vai konstanti. User macros NETIKS izvērsti, ja tie attiecas uz funkciju, hosta nosaukumu, vienuma key, vienuma key parametru vai operatoru. ::: Sarežģītāka formula var izmantot funkciju, operatoru un iekavu kombināciju. Varat izmantot visas funkcijas un [operatorus](/manual/config/triggers/expression#operators), kas atbalstīti trigeru izteiksmēs. Loģika un operatoru prioritāte ir tieši tāda pati. Atšķirībā no trigeru izteiksmēm, Zabbix apstrādā aprēķinātos vienumus atbilstoši vienuma atjaunināšanas intervālam, nevis pēc jaunas vērtības saņemšanas. Visiem vienumiem, uz kuriem tiek atsaukties, izmantojot vēstures funkcijas aprēķinātā vienuma formulā, ir jāeksistē un jāapkopo dati. Tāpat, ja maināt atsauktā vienuma key, jums manuāli jāatjaunina visas formulas, kurās tiek izmantots šis key. Aprēķinātais vienums vairākos gadījumos var kļūt neatbalstīts: - atsauktais vienums(-i) - nav atrasts - ir atspējots - pieder atspējotam hostam - nav atbalstīts (izņemot ar nodata() funkciju un [operatoriem](/manual/config/triggers/expression#operators) ar nezināmām vērtībām) - nav datu funkcijas aprēķinam - dalīšana ar nulli - izmantota nepareiza sintakse #### Configurable timeouts per item Timeout configuration per item is now available for more item types (see [supported](/manual/web_interface/frontend_sections/administration/general#timeouts) item types). In addition to setting the timeout values on the item level, it is possible to define [global](/manual/web_interface/frontend_sections/administration/general#timeouts) and [proxy](/manual/distributed_monitoring/proxies#adding-proxies) timeouts for various item types. Timeouts configured on the item level have the highest priority. By default, global timeouts are applied to all items; however, if proxy timeouts are set, they will override the global ones. #### Konfigurējami noildzes laiki katram vienumam Tagad noildzes laika konfigurēšana katram vienumam ir pieejama vairākām vienumu tipiem (skatiet [atbalstītos](/manual/web_interface/frontend_sections/administration/general#timeouts) vienumu tipus). Papildus noildzes vērtību iestatīšanai vienuma līmenī ir iespējams definēt [globālos](/manual/web_interface/frontend_sections/administration/general#timeouts) un [starpniekservera](/manual/distributed_monitoring/proxies#adding-proxies) noildzes laikus dažādiem vienumu tipiem. Vienuma līmenī konfigurētajiem noildzes laikiem ir visaugstākā prioritāte. Pēc noklusējuma globālie noildzes laiki tiek piemēroti visiem vienumiem; tomēr, ja ir iestatīti starpniekservera noildzes laiki, tie aizstās globālos. ### Configuration ### Konfigurācija #### Configuration #### Konfigurācija #### Configuration #### Konfigurācija #### Configuration #### Konfigurācija #### Configuration #### Konfigurācija #### Configuration #### Konfigurācija #### Configuration #### Konfigurācija ### Configuration 1. Create disabled Script item on the main VMware host (where the **eventlog[]** item is present) with the following parameters: {width="600"} - *Name*: VMware metrics - *Type*: Script - *Key*: vmware.metrics - *Type of information*: Text - *Script*: copy and paste the [script](#script) provided below - *Timeout*: 10 - *History*: Do not store - *Enabled*: unmarked #### Script try { Zabbix.log(4, 'vmware metrics script'); var result, resp, req = new HttpRequest(); req.addHeader('Content-Type: application/xml'); req.addHeader('SOAPAction: "urn:vim25/6.0"'); login = '<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:vim25">\ <soapenv:Header/>\ <soapenv:Body>\ <urn:Login>\ <urn:_this type="SessionManager">SessionManager</urn:_this>\ <urn:userName>{$VMWARE.USERNAME}</urn:userName>\ <urn:password>{$VMWARE.PASSWORD}</urn:password>\ </urn:Login>\ </soapenv:Body>\ </soapenv:Envelope>' resp = req.post("{$VMWARE.URL}", login); if (req.getStatus() != 200) { throw 'Response code: '+req.getStatus(); } query = '<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:vim25">\ <soapenv:Header/>\ <soapenv:Body>\ <urn:RetrieveProperties>\ <urn:_this type="PropertyCollector">propertyCollector</urn:_this>\ <urn:specSet>\ <urn:propSet>\ <urn:type>PerformanceManager</urn:type>\ <urn:pathSet>perfCounter</urn:pathSet>\ </urn:propSet>\ <urn:objectSet>\ <urn:obj type="PerformanceManager">PerfMgr</urn:obj>\ </urn:objectSet>\ </urn:specSet>\ </urn:RetrieveProperties>\ </soapenv:Body>\ </soapenv:Envelope>' resp = req.post("{$VMWARE.URL}", query); if (req.getStatus() != 200) { throw 'Response code: '+req.getStatus(); } Zabbix.log(4, 'vmware metrics=' + resp); result = resp; logout = '<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:vim25">\ <soapenv:Header/>\ <soapenv:Body>\ <urn:Logout>\ <urn:_this type="SessionManager">SessionManager</urn:_this>\ </urn:Logout>\ </soapenv:Body>\ </soapenv:Envelope>' resp = req.post("{$VMWARE.URL}",logout); if (req.getStatus() != 200) { throw 'Response code: '+req.getStatus(); } } catch (error) { Zabbix.log(4, 'vmware call failed : '+error); result = {}; } return result; Once the item is configured, press *Test* button, then press *Get value*. {width=600} Copy received XML to any XML formatter and find the desired metric. An example of XML for one metric: <PerfCounterInfo xsi:type="PerfCounterInfo"> <key>6</key> <nameInfo> <label>Usage in MHz</label> <summary>CPU usage in megahertz during the interval</summary> <key>usagemhz</key> </nameInfo> <groupInfo> <label>CPU</label> <summary>CPU</summary> <key>cpu</key> </groupInfo> <unitInfo> <label>MHz</label> <summary>Megahertz</summary> <key>megaHertz</key> </unitInfo> <rollupType>average</rollupType> <statsType>rate</statsType> <level>1</level> <perDeviceLevel>3</perDeviceLevel> </PerfCounterInfo> Use XPath to extract the counter path from received XML. For the example above, the XPath will be: |field |xPath | value | |--|--|--| |group | //groupInfo[../key=6]/key | cpu | |counter |//nameInfo[../key=6]/key |usagemhz | |rollup |//rollupType[../key=6] |average | Resulting performance counter path in this case is: `cpu/usagemhz[average]` ### Konfigurācija 1. Izveidojiet atspējotu Script vienumu galvenajā VMware hostā (kur ir pieejams **eventlog[]** vienums) ar šādiem parametriem: {width="600"} - *Name*: VMware metrics - *Type*: Script - *Key*: vmware.metrics - *Type of information*: Text - *Script*: kopējiet un ielīmējiet zemāk norādīto [skriptu](#script) - *Timeout*: 10 - *History*: Do not store - *Enabled*: unmarked #### Skripts try { Zabbix.log(4, 'vmware metrics script'); var result, resp, req = new HttpRequest(); req.addHeader('Content-Type: application/xml'); req.addHeader('SOAPAction: "urn:vim25/6.0"'); login = '<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:vim25">\ <soapenv:Header/>\ <soapenv:Body>\ <urn:Login>\ <urn:_this type="SessionManager">SessionManager</urn:_this>\ <urn:userName>{$VMWARE.USERNAME}</urn:userName>\ <urn:password>{$VMWARE.PASSWORD}</urn:password>\ </urn:Login>\ </soapenv:Body>\ </soapenv:Envelope>' resp = req.post("{$VMWARE.URL}", login); if (req.getStatus() != 200) { throw 'Response code: '+req.getStatus(); } query = '<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:vim25">\ <soapenv:Header/>\ <soapenv:Body>\ <urn:RetrieveProperties>\ <urn:_this type="PropertyCollector">propertyCollector</urn:_this>\ <urn:specSet>\ <urn:propSet>\ <urn:type>PerformanceManager</urn:type>\ <urn:pathSet>perfCounter</urn:pathSet>\ </urn:propSet>\ <urn:objectSet>\ <urn:obj type="PerformanceManager">PerfMgr</urn:obj>\ </urn:objectSet>\ </urn:specSet>\ </urn:RetrieveProperties>\ </soapenv:Body>\ </soapenv:Envelope>' resp = req.post("{$VMWARE.URL}", query); if (req.getStatus() != 200) { throw 'Response code: '+req.getStatus(); } Zabbix.log(4, 'vmware metrics=' + resp); result = resp; logout = '<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:vim25">\ <soapenv:Header/>\ <soapenv:Body>\ <urn:Logout>\ <urn:_this type="SessionManager">SessionManager</urn:_this>\ </urn:Logout>\ </soapenv:Body>\ </soapenv:Envelope>' resp = req.post("{$VMWARE.URL}",logout); if (req.getStatus() != 200) { throw 'Response code: '+req.getStatus(); } } catch (error) { Zabbix.log(4, 'vmware call failed : '+error); result = {}; } return result; Kad vienums ir konfigurēts, nospiediet pogu *Test*, pēc tam nospiediet *Get value*. {width=600} Kopējiet saņemto XML jebkurā XML formatētājā un atrodiet vajadzīgo metriku. XML piemērs vienai metrikai: <PerfCounterInfo xsi:type="PerfCounterInfo"> <key>6</key> <nameInfo> <label>Usage in MHz</label> <summary>CPU usage in megahertz during the interval</summary> <key>usagemhz</key> </nameInfo> <groupInfo> <label>CPU</label> <summary>CPU</summary> <key>cpu</key> </groupInfo> <unitInfo> <label>MHz</label> <summary>Megahertz</summary> <key>megaHertz</key> </unitInfo> <rollupType>average</rollupType> <statsType>rate</statsType> <level>1</level> <perDeviceLevel>3</perDeviceLevel> </PerfCounterInfo> Izmantojiet XPath, lai no saņemtā XML izgūtu skaitītāja ceļu. Iepriekš minētajam piemēram XPath būs: |field |xPath | value | |--|--|--| |group | //groupInfo[../key=6]/key | cpu | |counter |//nameInfo[../key=6]/key |usagemhz | |rollup |//rollupType[../key=6] |average | Šajā gadījumā iegūtais veiktspējas skaitītāja ceļš ir: `cpu/usagemhz[average]` #### Configuration 1\. Install KDC and client utilities: ```bash sudo apt update sudo apt install krb5-kdc krb5-admin-server krb5-user ``` During package setup answer the prompts, e.g.: ```default Default Kerberos version 5 realm: EXAMPLE.COM Kerberos servers for your realm: localhost (or your FQDN) Administrative server for your Kerberos realm: localhost (or your FQDN) ``` 2\. Map a friendly hostname (optional, for local testing). Edit /etc/hosts and add an entry for your DC and webserver if you don't have DNS: ```bash sudo vi /etc/hosts ``` Example line you might add: ```ini 192.168.1.100 dc01.example.com dc01 ``` 3\. Configure the Kerberos client and KDC realm: ```bash sudo vi /etc/krb5.conf ``` Example settings: ```ini [libdefaults] default_realm = EXAMPLE.COM dns_lookup_realm = false dns_lookup_kdc = false rdns = false ticket_lifetime = 24h renew_lifetime = 7d forwardable = true [realms] EXAMPLE.COM = { kdc = dc01.example.com admin_server = dc01.example.com } [domain_realm] .example.com = EXAMPLE.COM example.com = EXAMPLE.COM ``` If you plan to use `.localdomain` or other non-public names, add explicit domain→realm mappings so hostname→realm mapping works. Mismatches here cause `Server not found in Kerberos database` errors. 4\. Initialize the Kerberos database (one-time, KDC host). Set a secure master password when prompted: ```bash sudo krb5_newrealm ``` 5\. Create the `HTTP/host.fqdn@REALM` principal using the exact hostname clients will use; prefer lowercase (e.g. `HTTP/web.example.com@EXAMPLE.COM`). A case/name mismatch causes `Server not found in Kerberos database`. ```bash sudo kadmin.local ``` Inside `kadmin.local`: ```bash addprinc kerb-admin@EXAMPLE.COM # administrative principal addprinc -randkey HTTP/dc01.example.com@EXAMPLE.COM ktadd -k /etc/apache2/http.keytab HTTP/dc01.example.com@EXAMPLE.COM quit ``` Move the keytab to the web host (or keep local if same machine) and set permissions usable by Apache: ```bash chown www-data:www-data /etc/apache2/http.keytab chmod 600 /etc/apache2/http.keytab # verify sudo -u www-data -k /etc/apache2/http.keytab ``` 6\. Install and enable Apache GSSAPI module: ```bash sudo apt install libapache2-mod-auth-gssapi sudo a2enmod auth_gssapi sudo a2enmod headers sudo systemctl restart apache2 ``` :::noteimportant Not all mod_auth_gssapi versions support every `Gssapi*` directive. If Apache fails with `Invalid command 'GssapiCredStore'` remove the unsupported directive or upgrade the module. ::: 7\. Configure a VirtualHost (adjust `DocumentRoot` / path to your Zabbix UI): ```bash sudo vi /etc/apache2/sites-available/zabbix.conf ``` Inside `zabbix.conf`: ```apache <VirtualHost *:80> ServerName dc01.example.com DocumentRoot /usr/share/zabbix/ui <Directory /usr/share/zabbix/ui> Options FollowSymLinks AllowOverride None Require all granted AuthType GSSAPI AuthName "Kerberos Login" GssapiCredStore keytab:/etc/apache2/http.keytab GssapiLocalName On Require valid-user </Directory> RequestHeader set X-Remote-User %{REMOTE_USER}s env=REMOTE_USER RequestHeader unset Authorization </VirtualHost> ``` Restart Apache: ```bash sudo systemctl restart apache2 ``` 8\. Enable/start KDC services and verify listening ports (KDC host): ```bash sudo systemctl enable --now krb5-kdc krb5-admin-server ss -tnlp | grep :80 # or: sudo netstat -tnlp | grep :80 ``` 9\. Obtain a TGT for testing (run as the user that will use the ticket). Expect to see `krbtgt/EXAMPLE.COM@EXAMPLE.COM` in the ticket list. Run `kinit` as the same OS user that needs the ticket (e.g., `zabbix` for web checks or `www-data`/Apache for interactive browser SSO tests). Tickets issued to a different OS user won't be visible unless `KRB5CCNAME` and permissions are adjusted. ```bash kinit kerb-admin@EXAMPLE.COM klist ``` 10\. Test SPNEGO exchange with curl (from a client with a valid TGT). A `200 OK` (or redirect to app) indicates SPNEGO succeeded: ```bash curl -v --negotiate -u : http://dc01.example.com/ ``` 11\. Optionally, if Zabbix UI should accept HTTP-authenticated logins, enable HTTP auth in Zabbix front end (ui/conf/zabbix.conf.php): ```php $ALLOW_HTTP_AUTH = true; ``` In the web UI go to *Users* > *Authentication* and move to [*HTTP settings*](/manual/web_interface/frontend_sections/users/authentication/http) tab. Mark *Enable HTTP authentication* checkbox and click *Ok* in the pop-up. Select "HTTP login form" in the *Default login form* drop-down. Decide whether *Case-sensitive login* fits your directory policy. Click on *Update* button to finish. 12\. Browser configuration (Firefox is used as an example): set `network.negotiate-auth.trusted-uris` to the host(s) performing Negotiate (`dc01.example.com`) so the browser will send Kerberos tokens automatically. Inside `about:config`: ```default network.negotiate-auth.trusted-uris = dc01.example.com ``` Now visiting `http://dc01.example.com` should log you straight into Zabbix without the form. 13\. Keep keys/tickets fresh. Default Kerberos ticket lifetime is approximately 10 hours. Add a cron/systemd timer to avoid expirations: ```bash #for the web service kinit -kt /etc/apache2/http.keytab HTTP/dc01.example.com@EXAMPLE.COM #for the monitoring user kinit -kt /var/lib/zabbix/kerb.keytab kerb-admin@EXAMPLE.COM ``` 14\. Housekeeping checks: - `klist -k /etc/apache2/http.keytab` — verify service principal present in keytab. - `sudo tail -f /var/log/apache2/error.log` — watch for GSSAPI errors (`gss_acquire_cred[_from]() failed to get server creds` means keytab/permissions or missing principal). - `curl --negotiate` returning 401/403 often means wrong principal, no ticket, host header mismatch, or filesystem permission issue; check logs and `/etc/krb5.conf` domain mappings. #### Konfigurācija 1\. Instalējiet KDC un klienta utilītprogrammas: ```bash sudo apt update sudo apt install krb5-kdc krb5-admin-server krb5-user ``` Pakotņu iestatīšanas laikā atbildiet uz uzvednēm, piemēram: ```default Default Kerberos version 5 realm: EXAMPLE.COM Kerberos servers for your realm: localhost (or your FQDN) Administrative server for your Kerberos realm: localhost (or your FQDN) ``` 2\. Piesaistiet draudzīgu resursdatora nosaukumu (pēc izvēles, lokālai testēšanai). Rediģējiet /etc/hosts un pievienojiet ierakstu savam DC un tīmekļa serverim, ja jums nav DNS: ```bash sudo vi /etc/hosts ``` Piemēra rinda, ko varat pievienot: ```ini 192.168.1.100 dc01.example.com dc01 ``` 3\. Konfigurējiet Kerberos klientu un KDC realm: ```bash sudo vi /etc/krb5.conf ``` Piemēra iestatījumi: ```ini [libdefaults] default_realm = EXAMPLE.COM dns_lookup_realm = false dns_lookup_kdc = false rdns = false ticket_lifetime = 24h renew_lifetime = 7d forwardable = true [realms] EXAMPLE.COM = { kdc = dc01.example.com admin_server = dc01.example.com } [domain_realm] .example.com = EXAMPLE.COM example.com = EXAMPLE.COM ``` Ja plānojat izmantot `.localdomain` vai citus nepubliskus nosaukumus, pievienojiet skaidrus domain→realm piesaistes ierakstus, lai hostname→realm piesaiste darbotos. Neatbilstības šeit izraisa `Server not found in Kerberos database` kļūdas. 4\. Inicializējiet Kerberos datubāzi (vienreizēji, KDC resursdatorā). Kad tiek prasīts, iestatiet drošu galveno paroli: ```bash sudo krb5_newrealm ``` 5\. Izveidojiet `HTTP/host.fqdn@REALM` principalu, izmantojot tieši to resursdatora nosaukumu, ko izmantos klienti; priekšroka dodama mazajiem burtiem (piem., `HTTP/web.example.com@EXAMPLE.COM`). Rakstzīmju reģistra/nosaukuma neatbilstība izraisa `Server not found in Kerberos database`. ```bash sudo kadmin.local ``` `kadmin.local` vidē: ```bash addprinc kerb-admin@EXAMPLE.COM # administratīvais principals addprinc -randkey HTTP/dc01.example.com@EXAMPLE.COM ktadd -k /etc/apache2/http.keytab HTTP/dc01.example.com@EXAMPLE.COM quit ``` Pārvietojiet keytab uz tīmekļa resursdatoru (vai atstājiet lokāli, ja tā ir tā pati mašīna) un iestatiet Apache izmantojamās atļaujas: ```bash chown www-data:www-data /etc/apache2/http.keytab chmod 600 /etc/apache2/http.keytab # pārbaude sudo -u www-data -k /etc/apache2/http.keytab ``` 6\. Instalējiet un iespējojiet Apache GSSAPI moduli: ```bash sudo apt install libapache2-mod-auth-gssapi sudo a2enmod auth_gssapi sudo a2enmod headers sudo systemctl restart apache2 ``` :::noteimportant Ne visas mod_auth_gssapi versijas atbalsta katru `Gssapi*` direktīvu. Ja Apache neizdodas ar `Invalid command 'GssapiCredStore'`, noņemiet neatbalstīto direktīvu vai atjauniniet moduli. ::: 7\. Konfigurējiet VirtualHost (pielāgojiet `DocumentRoot` / ceļu uz jūsu Zabbix lietotāja saskarni): ```bash sudo vi /etc/apache2/sites-available/zabbix.conf ``` `zabbix.conf` iekšpusē: ```apache <VirtualHost *:80> ServerName dc01.example.com DocumentRoot /usr/share/zabbix/ui <Directory /usr/share/zabbix/ui> Options FollowSymLinks AllowOverride None Require all granted AuthType GSSAPI AuthName "Kerberos Login" GssapiCredStore keytab:/etc/apache2/http.keytab GssapiLocalName On Require valid-user </Directory> RequestHeader set X-Remote-User %{REMOTE_USER}s env=REMOTE_USER RequestHeader unset Authorization </VirtualHost> ``` Pārstartējiet Apache: ```bash sudo systemctl restart apache2 ``` 8\. Iespējojiet/palaidiet KDC pakalpojumus un pārbaudiet klausīšanās portus (KDC resursdatorā): ```bash sudo systemctl enable --now krb5-kdc krb5-admin-server ss -tnlp | grep :80 # vai: sudo netstat -tnlp | grep :80 ``` 9\. Iegūstiet TGT testēšanai (palaidiet kā lietotājs, kurš izmantos biļeti). Biļešu sarakstā vajadzētu redzēt `krbtgt/EXAMPLE.COM@EXAMPLE.COM`. Palaidiet `kinit` ar to pašu OS lietotāju, kuram nepieciešama biļete (piem., `zabbix` tīmekļa pārbaudēm vai `www-data`/Apache interaktīviem pārlūka SSO testiem). Biļetes, kas izdotas citam OS lietotājam, nebūs redzamas, ja vien netiks pielāgots `KRB5CCNAME` un atļaujas. ```bash kinit kerb-admin@EXAMPLE.COM klist ``` 10\. Pārbaudiet SPNEGO apmaiņu ar curl (no klienta ar derīgu TGT). `200 OK` (vai pāradresācija uz lietotni) norāda, ka SPNEGO ir izdevies: ```bash curl -v --negotiate -u : http://dc01.example.com/ ``` 11\. Pēc izvēles, ja Zabbix lietotāja saskarnei jāpieņem HTTP autentificēti pieteikumi, iespējojiet HTTP autentifikāciju Zabbix lietotāja saskarnē (ui/conf/zabbix.conf.php): ```php $ALLOW_HTTP_AUTH = true; ``` Tīmekļa lietotāja saskarnē dodieties uz *Users* > *Authentication* un pārejiet uz [*HTTP settings*](/manual/web_interface/frontend_sections/users/authentication/http) cilni. Atzīmējiet izvēles rūtiņu *Enable HTTP authentication* un uznirstošajā logā noklikšķiniet *Ok*. Nolaižamajā sarakstā *Default login form* izvēlieties "HTTP login form". Izlemiet, vai *Case-sensitive login* atbilst jūsu direktorijas politikai. Lai pabeigtu, noklikšķiniet uz pogas *Update*. 12\. Pārlūka konfigurācija (Firefox izmantots kā piemērs): iestatiet `network.negotiate-auth.trusted-uris` uz resursdatoru(-iem), kas veic Negotiate (`dc01.example.com`), lai pārlūks automātiski nosūtītu Kerberos žetonus. `about:config` iekšpusē: ```default network.negotiate-auth.trusted-uris = dc01.example.com ``` Tagad, apmeklējot `http://dc01.example.com`, jums vajadzētu tikt uzreiz pieteiktam Zabbix bez formas. 13\. Uzturiet atslēgas/biļetes aktuālas. Kerberos biļetes noklusējuma derīguma termiņš ir aptuveni 10 stundas. Pievienojiet cron/systemd taimeri, lai novērstu derīguma termiņa beigšanos: ```bash # tīmekļa pakalpojumam kinit -kt /etc/apache2/http.keytab HTTP/dc01.example.com@EXAMPLE.COM # uzraudzības lietotājam kinit -kt /var/lib/zabbix/kerb.keytab kerb-admin@EXAMPLE.COM ``` 14\. Apkopes pārbaudes: - `klist -k /etc/apache2/http.keytab` — pārbaudiet, vai service principal ir keytab failā. - `sudo tail -f /var/log/apache2/error.log` — sekojiet GSSAPI kļūdām (`gss_acquire_cred[_from]() failed to get server creds` nozīmē problēmas ar keytab/atļaujām vai trūkstošu principalu). - `curl --negotiate` atgriežot 401/403, bieži nozīmē nepareizu principalu, nav biļetes, host galvenes neatbilstību vai failu sistēmas atļauju problēmu; pārbaudiet žurnālus un `/etc/krb5.conf` domain piesaistes. #### Configuration A problem can be suppressed through the **[problem update](/manual/acknowledgment#updating-problems)** window, where suppression is one of the problem update options along with commenting, changing severity, acknowledging, etc. A problem may also be unsuppressed through the same problem update window. #### Konfigurācija Problēmu var apspiest, izmantojot **[problēmas atjaunināšanas](/manual/acknowledgment#updating-problems)** logu, kur apspiešana ir viena no problēmas atjaunināšanas opcijām līdzās komentēšanai, svarīguma līmeņa maiņai, apstiprināšanai u.c. Problēmai var arī noņemt apspiešanu, izmantojot to pašu problēmas atjaunināšanas logu. #### Configuration {width="600"} All mandatory input fields are marked with a red asterisk. This table consists of parameters typical for *Host group* element type: |Parameter|Description| |--|--------| |*Type*|Select Type of the element:<br>**Host group** - Icon representing the status of all triggers of all hosts belonging to the selected group.| |*Show*|Show options:<br>**Host group** - Selecting this option will result as one single icon displaying corresponding information about the certain host group.<br>**Host group elements** - Selecting this option will result as multiple icons displaying corresponding information about every single element (host) of the certain host group.| |*Area type*|This setting is available if *Show* is set to *Host group elements*:<br>**Fit to map** - All host group elements are equally placed within the map.<br>**Custom size** - A manual setting of the map area for all the host group elements to be displayed.| |*Area size*|This setting is available if *Area type* is set to *Custom size*:<br>**Width** - Value in pixels to specify the map area width.<br>**Height** - Value in pixels to specify the map area height.| |*Placing algorithm*|**Grid** - Only available option of displaying all the host group elements.| |*Label*|Icon label, any string.<br>[Macros](/manual/config/macros) and multiline strings can be used in labels.<br>If the type of the map element is *Host group* specifying certain macros has an impact on the map view displaying corresponding information about every single host. For example, if [{HOST.IP}](/manual/appendix/macros/supported_by_location#hosts) macro is used, the edit map view will only display the macro {HOST.IP} itself while map view will include and display each host's unique IP address.| #### Konfigurācija {width="600"} Visi obligātie ievades lauki ir atzīmēti ar sarkanu zvaigznīti. Šī tabula sastāv no parametriem, kas raksturīgi elementa tipam *Host group*: |Parameter|Description| |--|--------| |*Type*|Atlasiet elementa tipu:<br>**Host group** - ikona, kas attēlo visu trigeru statusu visiem hostiem, kas pieder atlasītajai grupai.| |*Show*|Rādīšanas opcijas:<br>**Host group** - izvēloties šo opciju, tiks parādīta viena ikona ar attiecīgo informāciju par konkrēto host group.<br>**Host group elements** - izvēloties šo opciju, tiks parādītas vairākas ikonas ar attiecīgo informāciju par katru atsevišķu konkrētās host group elementu (host).| |*Area type*|Šis iestatījums ir pieejams, ja *Show* ir iestatīts uz *Host group elements*:<br>**Fit to map** - visi host group elementi tiek vienmērīgi izvietoti kartē.<br>**Custom size** - manuāls kartes apgabala iestatījums, kurā tiks attēloti visi host group elementi.| |*Area size*|Šis iestatījums ir pieejams, ja *Area type* ir iestatīts uz *Custom size*:<br>**Width** - vērtība pikseļos, lai norādītu kartes apgabala platumu.<br>**Height** - vērtība pikseļos, lai norādītu kartes apgabala augstumu.| |*Placing algorithm*|**Grid** - vienīgā pieejamā opcija visu host group elementu attēlošanai.| |*Label*|Ikonas etiķete, jebkura virkne.<br>[Macros](/manual/config/macros) un vairākrindu virknes var izmantot etiķetēs.<br>Ja kartes elementa tips ir *Host group*, noteiktu makro norādīšana ietekmē kartes skatu, attēlojot attiecīgo informāciju par katru atsevišķu hostu. Piemēram, ja tiek izmantots makro [{HOST.IP}](/manual/appendix/macros/supported_by_location#hosts), kartes rediģēšanas skatā tiks rādīts tikai pats makro {HOST.IP}, savukārt kartes skatā tiks iekļauta un parādīta katra hosta unikālā IP adrese.| #### Configuration {width="600"} Configuration parameters: |Parameter|Description| |--|--------| |*Enable HTTP authentication*|Mark the checkbox to enable HTTP authentication. Hovering the mouse over  will bring up a hint box warning that in the case of web server authentication, all users (even with [frontend access](/manual/config/users_and_usergroups/usergroup#configuration) set to LDAP/Internal) will be authenticated by the web server, not by Zabbix.| |*Default login form*|Specify whether to direct non-authenticated users to:<br>**Zabbix login form** - standard Zabbix login page.<br>**HTTP login form** - HTTP login page.<br>It is recommended to enable web-server based authentication for the `index_http.php` page only. If *Default login form* is set to 'HTTP login page' the user will be logged in automatically if web server authentication module will set valid user login in the `$_SERVER` variable.<br>Supported `$_SERVER` keys are `PHP_AUTH_USER`, `REMOTE_USER`, `AUTH_USER`.| |*Remove domain name*|A comma-delimited list of domain names that should be removed from the username.<br>E.g. `comp,any` - if username is 'Admin\@any', 'comp\\Admin', user will be logged in as 'Admin'; if username is 'notacompany\\Admin', login will be denied.| |*Case-sensitive login*|Unmark the checkbox to disable case-sensitive login for usernames (enabled by default).<br>Disabling case-sensitive login allows, for example, to log in as "admin" even if the Zabbix user is "Admin" or "ADMIN".<br>Please note that if case-sensitive login is disabled and there are multiple Zabbix users with similar usernames (e.g., Admin and admin), the login for those users will always be denied with the following error message: "Authentication failed: supplied credentials are not unique."| ::: notetip For internal users who are unable to log in using HTTP credentials (with HTTP login form set as default) leading to the 401 error, you may want to add a `ErrorDocument 401 /index.php?form=default` line to basic authentication directives, which will redirect to the regular Zabbix login form. ::: #### Konfigurācija {width="600"} Konfigurācijas parametri: |Parametrs|Apraksts| |--|--------| |*Iespējot HTTP autentifikāciju*|Atzīmējiet izvēles rūtiņu, lai iespējotu HTTP autentifikāciju. Novietojot peles kursoru virs , tiks parādīts paskaidrojuma lodziņš ar brīdinājumu, ka tīmekļa servera autentifikācijas gadījumā visi lietotāji (pat ar [lietotāja saskarnes piekļuvi](/manual/config/users_and_usergroups/usergroup#configuration), kas iestatīta uz LDAP/Internal) tiks autentificēti tīmekļa serverī, nevis Zabbix.| |*Noklusējuma pieteikšanās forma*|Norādiet, vai neautentificētus lietotājus novirzīt uz:<br>**Zabbix pieteikšanās formu** - standarta Zabbix pieteikšanās lapu.<br>**HTTP pieteikšanās formu** - HTTP pieteikšanās lapu.<br>Ieteicams iespējot uz tīmekļa serveri balstītu autentifikāciju tikai lapai `index_http.php`. Ja *Noklusējuma pieteikšanās forma* ir iestatīta uz 'HTTP pieteikšanās lapa', lietotājs tiks pieteikts automātiski, ja tīmekļa servera autentifikācijas modulis iestatīs derīgu lietotāja pieteikšanās vārdu mainīgajā `$_SERVER`.<br>Atbalstītās `$_SERVER` atslēgas ir `PHP_AUTH_USER`, `REMOTE_USER`, `AUTH_USER`.| |*Noņemt domēna nosaukumu*|Ar komatiem atdalīts domēnu nosaukumu saraksts, kas jānoņem no lietotājvārda.<br>Piemēram, `comp,any` - ja lietotājvārds ir 'Admin\@any' vai 'comp\\Admin', lietotājs tiks pieteikts kā 'Admin'; ja lietotājvārds ir 'notacompany\\Admin', pieteikšanās tiks liegta.| |*Reģistrjutīga pieteikšanās*|Noņemiet atzīmi no izvēles rūtiņas, lai atspējotu reģistrjutīgu pieteikšanos lietotājvārdiem (pēc noklusējuma iespējota).<br>Atspējojot reģistrjutīgu pieteikšanos, ir iespējams, piemēram, pieteikties kā "admin", pat ja Zabbix lietotājs ir "Admin" vai "ADMIN".<br>Lūdzu, ņemiet vērā, ka, ja reģistrjutīga pieteikšanās ir atspējota un pastāv vairāki Zabbix lietotāji ar līdzīgiem lietotājvārdiem (piemēram, Admin un admin), šo lietotāju pieteikšanās vienmēr tiks liegta ar šādu kļūdas ziņojumu: "Autentifikācija neizdevās: norādītie akreditācijas dati nav unikāli."| ::: notetip Iekšējiem lietotājiem, kuri nevar pieteikties, izmantojot HTTP akreditācijas datus (ja HTTP pieteikšanās forma ir iestatīta kā noklusējuma), kā rezultātā tiek saņemta 401 kļūda, varat pievienot rindu `ErrorDocument 401 /index.php?form=default` pamata autentifikācijas direktīvām, kas novirzīs uz parasto Zabbix pieteikšanās formu. ::: #### Configuration {width="600"} ::: noteclassic In cases when a user does not have permission to access certain widget elements, that element's name will appear as *Inaccessible* during the widget's configuration. This results in *Inaccessible Item, Inaccessible Host, Inaccessible Group, Inaccessible Map, and Inaccessible Graph* appearing instead of the "real" name of the element. ::: In addition to the parameters that are [common](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters) for all widgets, you may set the following specific options: | | | |--|--------| |*Host groups*|Select host groups to display in the widget.<br>Alternatively, select a compatible widget as the [data source](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) for host groups.<br>This field is auto-complete, so starting to type the name of a group will offer a dropdown of matching groups.<br>Specifying a parent host group implicitly selects all nested host groups.<br>Host data from these host groups will be displayed in the widget; if no host groups are entered, all host groups will be displayed.<br>This parameter is not available when configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards).| |*Exclude host groups*|Select host groups to hide from the widget.<br>This field is auto-complete, so starting to type the name of a group will offer a dropdown of matching groups.<br>Specifying a parent host group implicitly selects all nested host groups.<br>Host data from these host groups will not be displayed in the widget. For example, hosts 001, 002, 003 may be in Group A and hosts 002, 003 in Group B as well. If we select to *show* Group A and *exclude* Group B at the same time, only data from host 001 will be displayed in the dashboard.<br>This parameter is not available when configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards).| |*Hosts*|Select hosts to display in the widget.<br>Alternatively, select a compatible widget or the dashboard as the [data source](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) for hosts.<br>This field is auto-complete, so starting to type the name of a host will offer a dropdown of matching hosts.<br>If no hosts are entered, all hosts will be displayed.<br>This parameter is not available when configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards).| |*Scenario tags*|Specify tags to limit the number of web scenarios displayed in the widget.<br>It is possible to include as well as exclude specific tags and tag values. Several conditions can be set. Tag name matching is always case-sensitive.<br><br>There are several operators available for each condition:<br>**Exists** - include the specified tag names;<br>**Equals** - include the specified tag names and values (case-sensitive);<br>**Contains** - include the specified tag names where the tag values contain the entered string (substring match, case-insensitive);<br>**Does not exist** - exclude the specified tag names;<br>**Does not equal** - exclude the specified tag names and values (case-sensitive);<br>**Does not contain** - exclude the specified tag names where the tag values contain the entered string (substring match, case-insensitive).<br><br>There are two calculation types for conditions:<br>**And/Or** - all conditions must be met, conditions having the same tag name will be grouped by the *Or* condition;<br>**Or** - enough if one condition is met.| |*Show hosts in maintenance*|Include hosts that are in maintenance in the statistics.<br>This parameter is labeled *Show data in maintenance* when configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards).| #### Konfigurācija {width="600"} ::: noteclassic Gadījumos, kad lietotājam nav atļaujas piekļūt noteiktiem logrīka elementiem, šī elementa nosaukums logrīka konfigurēšanas laikā tiks rādīts kā *Inaccessible*. Tādēļ *Inaccessible Item, Inaccessible Host, Inaccessible Group, Inaccessible Map, and Inaccessible Graph* tiks rādīti elementa "īstā" nosaukuma vietā. ::: Papildus parametriem, kas ir [kopīgi](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters) visiem logrīkiem, varat iestatīt šādas specifiskās opcijas: | | | |--|--------| |*Host groups*|Atlasiet hostu grupas, ko rādīt logrīkā.<br>Alternatīvi atlasiet saderīgu logrīku kā [datu avotu](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) hostu grupām.<br>Šis lauks atbalsta automātisko pabeigšanu, tāpēc, sākot rakstīt grupas nosaukumu, tiks piedāvāts nolaižamais saraksts ar atbilstošajām grupām.<br>Norādot vecāko hostu grupu, netieši tiek atlasītas visas ligzdotās hostu grupas.<br>Šo hostu grupu hostu dati tiks rādīti logrīkā; ja hostu grupas netiek ievadītas, tiks rādītas visas hostu grupas.<br>Šis parametrs nav pieejams, konfigurējot logrīku [veidnes informācijas panelī](/manual/config/templates/template#adding-dashboards).| |*Exclude host groups*|Atlasiet hostu grupas, ko paslēpt no logrīka.<br>Šis lauks atbalsta automātisko pabeigšanu, tāpēc, sākot rakstīt grupas nosaukumu, tiks piedāvāts nolaižamais saraksts ar atbilstošajām grupām.<br>Norādot vecāko hostu grupu, netieši tiek atlasītas visas ligzdotās hostu grupas.<br>Šo hostu grupu hostu dati netiks rādīti logrīkā. Piemēram, hosti 001, 002, 003 var būt Grupā A, bet hosti 002, 003 arī Grupā B. Ja vienlaikus izvēlamies *rādīt* Grupu A un *izslēgt* Grupu B, informācijas panelī tiks rādīti tikai hosta 001 dati.<br>Šis parametrs nav pieejams, konfigurējot logrīku [veidnes informācijas panelī](/manual/config/templates/template#adding-dashboards).| |*Hosts*|Atlasiet hostus, ko rādīt logrīkā.<br>Alternatīvi atlasiet saderīgu logrīku vai informācijas paneli kā [datu avotu](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) hostiem.<br>Šis lauks atbalsta automātisko pabeigšanu, tāpēc, sākot rakstīt hosta nosaukumu, tiks piedāvāts nolaižamais saraksts ar atbilstošajiem hostiem.<br>Ja hosti netiek ievadīti, tiks rādīti visi hosti.<br>Šis parametrs nav pieejams, konfigurējot logrīku [veidnes informācijas panelī](/manual/config/templates/template#adding-dashboards).| |*Scenario tags*|Norādiet tagus, lai ierobežotu logrīkā rādīto tīmekļa scenāriju skaitu.<br>Ir iespējams iekļaut, kā arī izslēgt konkrētus tagus un tagu vērtības. Var iestatīt vairākus nosacījumus. Tagu nosaukumu salīdzināšana vienmēr ir reģistrjutīga.<br><br>Katram nosacījumam ir pieejami vairāki operatori:<br>**Exists** - iekļaut norādītos tagu nosaukumus;<br>**Equals** - iekļaut norādītos tagu nosaukumus un vērtības (reģistrjutīgi);<br>**Contains** - iekļaut norādītos tagu nosaukumus, kuru tagu vērtības satur ievadīto virkni (apakšvirknes atbilstība, nereģistrjutīgi);<br>**Does not exist** - izslēgt norādītos tagu nosaukumus;<br>**Does not equal** - izslēgt norādītos tagu nosaukumus un vērtības (reģistrjutīgi);<br>**Does not contain** - izslēgt norādītos tagu nosaukumus, kuru tagu vērtības satur ievadīto virkni (apakšvirknes atbilstība, nereģistrjutīgi).<br><br>Nosacījumiem ir pieejami divi aprēķina tipi:<br>**And/Or** - jāizpildās visiem nosacījumiem, nosacījumi ar vienādu taga nosaukumu tiks grupēti pēc *Or* nosacījuma;<br>**Or** - pietiek, ja izpildās viens nosacījums.| |*Show hosts in maintenance*|Iekļaut statistikā hostus, kas ir apkopē.<br>Konfigurējot logrīku [veidnes informācijas panelī](/manual/config/templates/template#adding-dashboards), šis parametrs ir apzīmēts kā *Show data in maintenance*.| #### Configuration  Configuration parameters: |Parameter|Description| |--|--------| |*Enable LDAP authentication*|Mark the checkbox to enable LDAP authentication.| |*Enable JIT provisioning*|Mark the checkbox to enable JIT provisioning.| |*Servers*|Click on *Add* to configure an LDAP server (see [LDAP server configuration](#ldap-server-configuration) below).| |*Case-sensitive login*|Unmark the checkbox to disable case-sensitive login for usernames (enabled by default).<br>Disabling case-sensitive login allows, for example, to log in as "admin" even if the Zabbix user is "Admin" or "ADMIN".<br>Please note that if case-sensitive login is disabled and there are multiple Zabbix users with similar usernames (e.g., Admin and admin), the login for those users will always be denied with the following error message: "Authentication failed: supplied credentials are not unique."| |*Provisioning period*|Set the provisioning period, i.e. how often the logged in user will be provisioned while working with the frontend.| #### Konfigurācija  Konfigurācijas parametri: |Parameter|Description| |--|--------| |*Enable LDAP authentication*|Atzīmējiet izvēles rūtiņu, lai iespējotu LDAP autentifikāciju.| |*Enable JIT provisioning*|Atzīmējiet izvēles rūtiņu, lai iespējotu JIT nodrošināšanu.| |*Servers*|Noklikšķiniet uz *Add*, lai konfigurētu LDAP serveri (skatiet tālāk [LDAP servera konfigurācija](#ldap-server-configuration)).| |*Case-sensitive login*|Noņemiet atzīmi no izvēles rūtiņas, lai atspējotu reģistrjutīgu lietotājvārdu pieteikšanos (pēc noklusējuma iespējots).<br>Reģistrjutīgas pieteikšanās atspējošana, piemēram, ļauj pieteikties kā "admin", pat ja Zabbix lietotājs ir "Admin" vai "ADMIN".<br>Lūdzu, ņemiet vērā: ja reģistrjutīga pieteikšanās ir atspējota un ir vairāki Zabbix lietotāji ar līdzīgiem lietotājvārdiem (piem., Admin un admin), šo lietotāju pieteikšanās vienmēr tiks liegta ar šādu kļūdas ziņojumu: "Authentication failed: supplied credentials are not unique."| |*Provisioning period*|Iestatiet nodrošināšanas periodu, t. i., cik bieži pieteicies lietotājs tiks nodrošināts, strādājot ar lietotāja saskarni.| #### Configuration {width="600"} Configuration parameters: |Parameter|Description| |--|--------| |*Enable multi-factor authentication*|Mark the checkbox to enable multi-factor authentication.| |*Methods*|Click *Add* to configure an MFA method (see [method configuration](#method-configuration) below).| #### Konfigurācija {width="600"} Konfigurācijas parametri: |Parametrs|Apraksts| |--|--------| |*Iespējot daudzfaktoru autentifikāciju*|Atzīmējiet izvēles rūtiņu, lai iespējotu daudzfaktoru autentifikāciju.| |*Metodes*|Noklikšķiniet uz *Pievienot*, lai konfigurētu MFA metodi (skatiet [metodes konfigurāciju](#method-configuration) zemāk).| #### Configuration Debug mode can be activated for individual users who belong to a user group: - when configuring a [user group](/manual/config/users_and_usergroups/usergroup#configuration); - when viewing configured [user groups](//manual/web_interface/frontend_sections/users/user_groups). When *Debug mode* is enabled for a user group, its users will see a *Debug* button in the lower right corner of the browser window:  Clicking on the *Debug* button opens a new window below the page contents which contains the SQL statistics of the page, along with a list of API calls and individual SQL statements: {width="600"} In case of performance problems with the page, this window may be used to search for the root cause of the problem. ::: notewarning Enabled *Debug mode* negatively affects frontend performance. ::: #### Konfigurācija Atkļūdošanas režīmu var aktivizēt atsevišķiem lietotājiem, kuri pieder lietotāju grupai: - konfigurējot [lietotāju grupu](/manual/config/users_and_usergroups/usergroup#configuration); - skatot konfigurētās [lietotāju grupas](//manual/web_interface/frontend_sections/users/user_groups). Ja lietotāju grupai ir iespējots *Atkļūdošanas režīms*, tās lietotāji pārlūkprogrammas loga apakšējā labajā stūrī redzēs pogu *Debug*:  Noklikšķinot uz pogas *Debug*, zem lapas satura tiek atvērts jauns logs, kurā ir lapas SQL statistika, kā arī API izsaukumu un atsevišķu SQL priekšrakstu saraksts: {width="600"} Ja lapā rodas veiktspējas problēmas, šo logu var izmantot, lai meklētu problēmas pamatcēloni. ::: notewarning Iespējots *Atkļūdošanas režīms* negatīvi ietekmē lietotāja saskarnes veiktspēju. ::: #### Configuration examples After setting up the necessary certificates, configure Zabbix components to use certificate-based encryption. Below are detailed steps for configuring: - [Zabbix server](#zabbix-server) - [Zabbix proxy](#zabbix-proxy) - [Zabbix agent](#zabbix-agent) #### Konfigurācijas piemēri Pēc nepieciešamo sertifikātu iestatīšanas konfigurējiet Zabbix komponentus, lai izmantotu uz sertifikātiem balstītu šifrēšanu. Tālāk ir sniegti detalizēti konfigurēšanas soļi: - [Zabbix serveris](#zabbix-server) - [Zabbix starpniekserveris](#zabbix-proxy) - [Zabbix aģents](#zabbix-agent) ##### Configuration examples For a basic example of how to set up Zabbix for monitoring VMware using the *VMware FQDN* template, see [*Monitor VMware with Zabbix*](/manual/quickstart/monitor_vmware). For a more detailed example of how to create a host, a low-level discovery rule, and a host prototype for monitoring VMware, see [*Setup example*](/manual/vm_monitoring/example). ##### Konfigurācijas piemēri Pamata piemēram, kā iestatīt Zabbix VMware uzraudzībai, izmantojot *VMware FQDN* veidni, skatiet [*Monitor VMware with Zabbix*](/manual/quickstart/monitor_vmware). Detalizētākam piemēram, kā izveidot hostu, zema līmeņa atklāšanas noteikumu un hosta prototipu VMware uzraudzībai, skatiet [*Setup example*](/manual/vm_monitoring/example). #### Configuration examples This section provides examples of configuring MFA using [Time-Based One-Time Password](#totp) (TOTP) and [Duo Universal Prompt](#duo-universal-prompt). #### Konfigurācijas piemēri Šajā sadaļā ir sniegti piemēri MFA konfigurēšanai, izmantojot [Time-Based One-Time Password](#totp) (TOTP) un [Duo Universal Prompt](#duo-universal-prompt). # configuration.export # configuration.export ##### Configuration file See the [configuration file](/manual/appendix/config/zabbix_proxy) options for details on configuring `zabbix_proxy`. ##### Konfigurācijas fails Skatiet [konfigurācijas faila](/manual/appendix/config/zabbix_proxy) opcijas, lai iegūtu detalizētu informāciju par `zabbix_proxy` konfigurēšanu. ##### Configuration file See the [configuration file](/manual/appendix/config/zabbix_server) options for details on configuring `zabbix_server`. ##### Konfigurācijas fails Skatiet [konfigurācijas faila](/manual/appendix/config/zabbix_server) opcijas, lai iegūtu detalizētu informāciju par `zabbix_server` konfigurēšanu. #### Configuration file The default path to the configuration file is: - On UNIX, default is `/usr/local/etc/zabbix_agent2.conf` or as set by [compile-time](/manual/installation/install#4-configure-the-sources) variables `--sysconfdir` or `--prefix`. - On Windows, default is `C:\\Program Files\\Zabbix Agent 2\\zabbix_agent2.conf`. If a single instance of the agent is running on a host, it can use the default configuration file or a configuration file specified on the [command line](/manual/concepts/agent2#options). In case of multiple instances, each agent instance must have its own configuration file (one of the instances can use the default configuration file). The configuration parameters of Zabbix agent 2 mostly match those of Zabbix agent, with some exceptions: |Parameters|<|Description| |-|---------|----------| |Zabbix agent 2-specific configuration parameters|<|<| | |`ControlSocket`|The runtime control socket path. Zabbix agent 2 uses a control socket for [runtime commands](#runtime-control).| | |`EnablePersistentBuffer`,<br>`PersistentBufferFile`,<br>`PersistentBufferPeriod`|These parameters are used to configure persistent storage on Zabbix agent 2 for active items.| | |`ForceActiveChecksOnStart`|Determines whether the agent should perform active checks immediately after restart or spread evenly over time.| | |`Plugins`|Plugins may have their own parameters, in the format `Plugins.<Plugin name>.<Parameter>=<value>`. A common plugin parameter is `System.Capacity`, setting the limit of checks that can be executed at the same time.| | |`StatusPort`|The port Zabbix agent 2 will be listening on for HTTP status request and display of a list of configured plugins and some internal parameters.| |Zabbix agent-specific configuration parameters not supported on Zabbix agent 2|<|<| | |`AllowRoot`,<br>`User`|Not supported on Zabbix agent 2 because it does not support daemonization.| | |`EnableRemoteCommands`|Deprecated; the `AllowKey` and `DenyKey` parameters are used instead in both agents.| | |`ListenBacklog`|Used in Zabbix agent to define the maximum number of pending connections in the TCP queue. Not supported on Zabbix agent 2.| | |`LoadModule`,<br>`LoadModulePath`|Loadable modules are not supported on Zabbix agent 2.| | |`MaxLinesPerSecond`,<br>`LogRemoteCommands`|In Zabbix agent 2, `Plugins.Log.MaxLinesPerSecond` and `Plugins.SystemRun.LogRemoteCommands` are used instead.| | |`StartAgents`|This parameter is used in Zabbix agent to increase passive check concurrency or disable them. In Zabbix agent 2, the concurrency is configured at a plugin level and can be limited by a capacity setting. Passive checks are disabled in Zabbix Agent 2 if the `Server` parameter is not specified.| For more details, see the configuration file options for [Zabbix agent2](/manual/appendix/config/zabbix_agent2). #### Konfigurācijas fails Noklusējuma ceļš uz konfigurācijas failu ir: - UNIX sistēmās noklusējums ir `/usr/local/etc/zabbix_agent2.conf` vai tas ir iestatīts ar [kompilēšanas laika](/manual/installation/install#4-configure-the-sources) mainīgajiem `--sysconfdir` vai `--prefix`. - Windows sistēmās noklusējums ir `C:\\Program Files\\Zabbix Agent 2\\zabbix_agent2.conf`. Ja uz host darbojas viena aģenta instance, tā var izmantot noklusējuma konfigurācijas failu vai konfigurācijas failu, kas norādīts [komandrindā](/manual/concepts/agent2#options). 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). Zabbix agent 2 konfigurācijas parametri lielākoties atbilst Zabbix agent parametriem, ar dažiem izņēmumiem: |Parameters|<|Description| |-|---------|----------| |Zabbix agent 2-specific configuration parameters|<|<| | |`ControlSocket`|Izpildlaika vadības ligzdas ceļš. Zabbix agent 2 izmanto vadības ligzdu [izpildlaika komandām](#runtime-control).| | |`EnablePersistentBuffer`,<br>`PersistentBufferFile`,<br>`PersistentBufferPeriod`|Šie parametri tiek izmantoti, lai konfigurētu pastāvīgo krātuvi Zabbix agent 2 aktīvajiem vienumiem.| | |`ForceActiveChecksOnStart`|Nosaka, vai aģentam pēc restartēšanas nekavējoties jāveic aktīvās pārbaudes vai tās jāizkliedē vienmērīgi laika gaitā.| | |`Plugins`|Spraudņiem var būt savi parametri formātā `Plugins.<Plugin name>.<Parameter>=<value>`. Biežs spraudņa parametrs ir `System.Capacity`, kas nosaka vienlaikus izpildāmo pārbaužu limitu.| | |`StatusPort`|Ports, kurā Zabbix agent 2 klausīsies HTTP statusa pieprasījumiem un rādīs konfigurēto spraudņu sarakstu, kā arī dažus iekšējos parametrus.| |Zabbix agent-specific configuration parameters not supported on Zabbix agent 2|<|<| | |`AllowRoot`,<br>`User`|Nav atbalstīts Zabbix agent 2, jo tas neatbalsta dēmonizāciju.| | |`EnableRemoteCommands`|Novecojis; tā vietā abos aģentos tiek izmantoti parametri `AllowKey` un `DenyKey`.| | |`ListenBacklog`|Tiek izmantots Zabbix agent, lai definētu maksimālo gaidošo savienojumu skaitu TCP rindā. Nav atbalstīts Zabbix agent 2.| | |`LoadModule`,<br>`LoadModulePath`|Ielādējamie moduļi nav atbalstīti Zabbix agent 2.| | |`MaxLinesPerSecond`,<br>`LogRemoteCommands`|Zabbix agent 2 vietā tiek izmantoti `Plugins.Log.MaxLinesPerSecond` un `Plugins.SystemRun.LogRemoteCommands`.| | |`StartAgents`|Šis parametrs tiek izmantots Zabbix agent, lai palielinātu pasīvo pārbaužu paralēlismu vai tās atspējotu. Zabbix agent 2 paralēlisms tiek konfigurēts spraudņa līmenī, un to var ierobežot ar kapacitātes iestatījumu. Pasīvās pārbaudes Zabbix Agent 2 ir atspējotas, ja nav norādīts parametrs `Server`.| Plašāku informāciju skatiet konfigurācijas faila opcijās priekš [Zabbix agent2](/manual/appendix/config/zabbix_agent2). #### Configuration file The default path to the configuration file is: - On UNIX, default is `/usr/local/etc/zabbix_agentd.conf` or as set by [compile-time](/manual/installation/install#4-configure-the-sources) variables `--sysconfdir` or `--prefix`. - On Windows, default is `C:\\Program Files\\Zabbix Agent\\zabbix_agentd.conf`. If a single instance of the agent is running on a host, it can use the default configuration file or a configuration file specified on the [command line](/manual/concepts/agent#options). In case of multiple instances, each agent instance must have its own configuration file (one of the instances can use the default configuration file). For details on configuring Zabbix agent see the configuration file options for [Unix Zabbix agent](/manual/appendix/config/zabbix_agentd) or [Windows Zabbix agent](/manual/appendix/config/zabbix_agentd_win). #### Konfigurācijas fails Noklusējuma konfigurācijas faila ceļš ir: - UNIX sistēmās noklusējuma vērtība ir `/usr/local/etc/zabbix_agentd.conf` vai tā, kas iestatīta ar [kompilēšanas laika](/manual/installation/install#4-configure-the-sources) mainīgajiem `--sysconfdir` vai `--prefix`. - Windows sistēmās noklusējuma vērtība ir `C:\\Program Files\\Zabbix Agent\\zabbix_agentd.conf`. Ja uz hosta darbojas viena aģenta instance, tā var izmantot noklusējuma konfigurācijas failu vai konfigurācijas failu, kas norādīts [komandrindā](/manual/concepts/agent#options). Ja ir vairākas instances, katrai aģenta instancei jābūt savam konfigurācijas failam (viena no instancēm var izmantot noklusējuma konfigurācijas failu). Sīkāku informāciju par Zabbix aģenta konfigurēšanu skatiet konfigurācijas faila opcijās [Unix Zabbix aģentam](/manual/appendix/config/zabbix_agentd) vai [Windows Zabbix aģentam](/manual/appendix/config/zabbix_agentd_win). #### Configuration file validation The possibility of configuration file validation has been added to the maintenance commands of Zabbix [server](/manpages/zabbix_server), [proxy](/manpages/zabbix_proxy), [agent](/manpages/zabbix_agentd), [agent 2](/manpages/zabbix_agent2), and [web service](/manpages/zabbix_web_service). The validation can be done using the *-T --test-config* option. In case of successful validation, the exit code will be "0"; otherwise, the component will exit with non-zero exit code and a corresponding error message. Warnings (e.g., in case of a deprecated parameter) will not affect successful exit code. #### Konfigurācijas faila validācija Konfigurācijas faila validācijas iespēja ir pievienota Zabbix [serveris](/manpages/zabbix_server), [starpniekserveris](/manpages/zabbix_proxy), [aģents](/manpages/zabbix_agentd), [aģents 2](/manpages/zabbix_agent2) un [web service](/manpages/zabbix_web_service) uzturēšanas komandām. Validāciju var veikt, izmantojot opciju *-T --test-config*. Veiksmīgas validācijas gadījumā izejas kods būs "0"; pretējā gadījumā komponents beigs darbu ar nenulles izejas kodu un atbilstošu kļūdas ziņojumu. Brīdinājumi (piemēram, novecojuša parametra gadījumā) neietekmēs veiksmīgu izejas kodu. #### Configuration Global notifications can be enabled per user in the **Frontend notifications** tab of [profile configuration](/manual/web_interface/user_profile). {width="600"} |Parameter|Description| |--|--------| |*Frontend notifications*|Mark the checkbox to enable global notifications.| |*Message timeout*|Set the duration for which the message will be displayed. By default, messages remain on the screen for 60 seconds.<br>[Time suffixes](/manual/appendix/suffixes) are supported, for example: 30s, 5m, 2h, 1d.| |*Play sound*|Set the duration for which the sound will be played.<br>**Once** - sound is played once and fully;<br>**10 seconds** - sound is repeated for 10 seconds;<br>**Message timeout** - sound is repeated while the message is visible.| |*Trigger severity*|Set the trigger severities for which global notifications and sounds will be activated. You can also select sounds appropriate for various severities.<br>If no severity is marked, no messages will be displayed.<br>Additionally, recovery messages will only be displayed for marked severities. For instance, if *Recovery* and *Disaster* are marked, global notifications will be displayed for problems and recoveries of *Disaster* severity triggers.| |*Show suppressed problems*|Mark the checkbox to display notifications for problems that would otherwise be suppressed (not shown) due to host maintenance.| #### Konfigurācija Globālos paziņojumus var iespējot katram lietotājam atsevišķi cilnē **Lietotāja saskarnes paziņojumi** [profila konfigurācijā](/manual/web_interface/user_profile). {width="600"} |Parameter|Description| |--|--------| |*Lietotāja saskarnes paziņojumi*|Atzīmējiet izvēles rūtiņu, lai iespējotu globālos paziņojumus.| |*Ziņojuma noildze*|Iestatiet ilgumu, cik ilgi ziņojums tiks rādīts. Pēc noklusējuma ziņojumi ekrānā paliek 60 sekundes.<br>[Laika sufiksi](/manual/appendix/suffixes) tiek atbalstīti, piemēram: 30s, 5m, 2h, 1d.| |*Atskaņot skaņu*|Iestatiet ilgumu, cik ilgi skaņa tiks atskaņota.<br>**Vienreiz** - skaņa tiek atskaņota vienu reizi pilnā apjomā;<br>**10 sekundes** - skaņa tiek atkārtota 10 sekundes;<br>**Ziņojuma noildze** - skaņa tiek atkārtota, kamēr ziņojums ir redzams.| |*Trigera smaguma pakāpe*|Iestatiet trigeru smaguma pakāpes, kurām tiks aktivizēti globālie paziņojumi un skaņas. Varat arī atlasīt dažādām smaguma pakāpēm atbilstošas skaņas.<br>Ja neviena smaguma pakāpe nav atzīmēta, ziņojumi netiks rādīti.<br>Turklāt atjaunošanās ziņojumi tiks rādīti tikai atzīmētajām smaguma pakāpēm. Piemēram, ja ir atzīmētas *Recovery* un *Disaster*, globālie paziņojumi tiks rādīti problēmām un atjaunošanās notikumiem ar *Disaster* smaguma pakāpes trigeriem.| |*Rādīt nomāktās problēmas*|Atzīmējiet izvēles rūtiņu, lai rādītu paziņojumus par problēmām, kas citādi tiktu nomāktas (nerādītas) hosts uzturēšanas dēļ.| #### Configuration Google Chrome on Linux uses a per-user NSS certificate database for trusted certificates. To make Chrome trust a self-signed certificate or a private certificate authority, add the required certificates to the NSS database of the user account that runs Chrome. 1\. Install required packages. For Debian/Ubuntu: ```bash sudo apt install ca-certificates libnss3-tools ``` For RHEL-based systems: ```bash sudo dnf install ca-certificates nss-tools ``` Or: ```bash sudo yum install ca-certificates nss-tools ``` 2\. Prepare certificate files. For each certificate needed: create a PEM-based `.crt` file for the self-signed certificate, or create separate PEM-based `.crt` files for the root certificate authority certificate and, if required, each intermediate certificate. 3\. Create the NSS database directory. Use the home directory of the user that runs Chrome. For example: ```bash sudo mkdir -p /var/lib/zabbix/.pki/nssdb sudo -u zabbix certutil -N -d sql:/var/lib/zabbix/.pki/nssdb sudo chown -R zabbix:zabbix /var/lib/zabbix/.pki/nssdb ``` If Chrome on the target system uses a different NSS database location, use that directory instead. Make sure the certificate files are readable by the user that runs Google Chrome. If necessary, copy them to a location accessible to that user. 4\. Import the certificates. If using a self-signed certificate: ```bash sudo -u zabbix certutil -d sql:/var/lib/zabbix/.pki/nssdb \ -A -t "P,," \ -n "Zabbix self-signed certificate" \ -i /path/to/self-signed.crt ``` If using a private certificate authority, import the root certificate authority certificate into the database: ```bash sudo -u zabbix certutil -d sql:/var/lib/zabbix/.pki/nssdb \ -A -t "C,," \ -n "Zabbix root certificate authority" \ -i /path/to/root-ca.crt ``` If any intermediate certificates are used, import each one separately: ```bash sudo -u zabbix certutil -d sql:/var/lib/zabbix/.pki/nssdb \ -A -t ",," \ -n "Zabbix intermediate certificate" \ -i /path/to/intermediate-ca.crt ``` 5\. Verify the certificate database. ```bash sudo -u zabbix certutil -d sql:/var/lib/zabbix/.pki/nssdb -L ``` 6\. Test Chrome. Google Chrome uses the certificate database of the user account that launches it. If the user account does not have a writable home directory, configure a writable home and XDG directories before running the test. Example (replace `google-chrome` with `chromium` if Chromium is used.): ```bash sudo -u zabbix env \ HOME=/var/lib/zabbix-home \ XDG_CONFIG_HOME=/var/lib/zabbix-home/.config \ XDG_DATA_HOME=/var/lib/zabbix-home/.local/share \ XDG_CACHE_HOME=/var/lib/zabbix-home/.cache \ google-chrome --headless --disable-gpu \ --user-data-dir=/var/lib/zabbix-home/chrome-profile \ --dump-dom https://FQDN_OF_ZABBIX_SERVER ``` If the configuration is correct, the command returns the HTML of the requested page. If Chrome does not trust the certificate, the command returns a certificate error page containing messages such as `NET::ERR_CERT_AUTHORITY_INVALID`. #### Konfigurācija Google Chrome operētājsistēmā Linux uzticamajiem sertifikātiem izmanto katram lietotājam atsevišķu NSS sertifikātu datubāzi. Lai Chrome uzticētos pašparakstītam sertifikātam vai privātai sertifikātu iestādei, pievienojiet nepieciešamos sertifikātus tās lietotāja konta NSS datubāzei, kas palaiž Chrome. 1\. Instalējiet nepieciešamās pakotnes. Debian/Ubuntu: ```bash sudo apt install ca-certificates libnss3-tools ``` RHEL bāzētām sistēmām: ```bash sudo dnf install ca-certificates nss-tools ``` Vai: ```bash sudo yum install ca-certificates nss-tools ``` 2\. Sagatavojiet sertifikātu failus. Katram nepieciešamajam sertifikātam: izveidojiet uz PEM balstītu `.crt` failu pašparakstītajam sertifikātam vai izveidojiet atsevišķus uz PEM balstītus `.crt` failus saknes sertifikātu iestādes sertifikātam un, ja nepieciešams, katram starpsertifikātam. 3\. Izveidojiet NSS datubāzes direktoriju. Izmantojiet tās lietotāja mājas direktoriju, kas palaiž Chrome. Piemēram: ```bash sudo mkdir -p /var/lib/zabbix/.pki/nssdb sudo -u zabbix certutil -N -d sql:/var/lib/zabbix/.pki/nssdb sudo chown -R zabbix:zabbix /var/lib/zabbix/.pki/nssdb ``` Ja Chrome mērķa sistēmā izmanto citu NSS datubāzes atrašanās vietu, izmantojiet šo direktoriju. Pārliecinieties, ka sertifikātu faili ir lasāmi lietotājam, kas palaiž Google Chrome. Ja nepieciešams, nokopējiet tos uz vietu, kurai šis lietotājs var piekļūt. 4\. Importējiet sertifikātus. Ja izmantojat pašparakstītu sertifikātu: ```bash sudo -u zabbix certutil -d sql:/var/lib/zabbix/.pki/nssdb \ -A -t "P,," \ -n "Zabbix self-signed certificate" \ -i /path/to/self-signed.crt ``` Ja izmantojat privātu sertifikātu iestādi, importējiet saknes sertifikātu iestādes sertifikātu datubāzē: ```bash sudo -u zabbix certutil -d sql:/var/lib/zabbix/.pki/nssdb \ -A -t "C,," \ -n "Zabbix root certificate authority" \ -i /path/to/root-ca.crt ``` Ja tiek izmantoti starpsertifikāti, importējiet katru atsevišķi: ```bash sudo -u zabbix certutil -d sql:/var/lib/zabbix/.pki/nssdb \ -A -t ",," \ -n "Zabbix intermediate certificate" \ -i /path/to/intermediate-ca.crt ``` 5\. Pārbaudiet sertifikātu datubāzi. ```bash sudo -u zabbix certutil -d sql:/var/lib/zabbix/.pki/nssdb -L ``` 6\. Pārbaudiet Chrome. Google Chrome izmanto tās lietotāja konta sertifikātu datubāzi, kas to palaiž. Ja lietotāja kontam nav rakstāma mājas direktorija, pirms testa palaišanas konfigurējiet rakstāmu mājas direktoriju un XDG direktorijus. Piemērs (aizstājiet `google-chrome` ar `chromium`, ja tiek izmantots Chromium.): ```bash sudo -u zabbix env \ HOME=/var/lib/zabbix-home \ XDG_CONFIG_HOME=/var/lib/zabbix-home/.config \ XDG_DATA_HOME=/var/lib/zabbix-home/.local/share \ XDG_CACHE_HOME=/var/lib/zabbix-home/.cache \ google-chrome --headless --disable-gpu \ --user-data-dir=/var/lib/zabbix-home/chrome-profile \ --dump-dom https://FQDN_OF_ZABBIX_SERVER ``` Ja konfigurācija ir pareiza, komanda atgriež pieprasītās lapas HTML. Ja Chrome neuzticas sertifikātam, komanda atgriež sertifikāta kļūdas lapu ar tādiem ziņojumiem kā `NET::ERR_CERT_AUTHORITY_INVALID`. #### Configuration Host dashboards are configured at the [template](/manual/config/templates/template#adding-dashboards) level. Once a template is linked to a host, host dashboards are generated for that host. Note that host dashboards *cannot* be configured in the [*Dashboards*](/manual/web_interface/frontend_sections/dashboards) section, which is reserved for global dashboards. Widgets of host dashboards can also be configured only at the [template](/manual/config/templates/template#adding-dashboards) level, except for changing the [refresh interval](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters). Moreover, widgets of host dashboards can only be copied to other host dashboards within the same template. Note that widgets from global dashboards *cannot* be copied to host dashboards. ::: noteclassic Host dashboards used to be host screens before Zabbix 5.2. When importing an older template that contains screens, the screen import will be ignored. ::: #### Konfigurācija Hostu paneļi tiek konfigurēti [veidnes](/manual/config/templates/template#adding-dashboards) līmenī. Kad veidne ir piesaistīta hostam, šim hostam tiek ģenerēti hostu paneļi. Ņemiet vērā, ka hostu paneļus *nevar* konfigurēt sadaļā [*Paneļi*](/manual/web_interface/frontend_sections/dashboards), kas ir paredzēta globālajiem paneļiem. Hostu paneļu logrīkus arī var konfigurēt tikai [veidnes](/manual/config/templates/template#adding-dashboards) līmenī, izņemot [atsvaidzināšanas intervāla](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters) maiņu. Turklāt hostu paneļu logrīkus var kopēt tikai uz citiem hostu paneļiem tās pašas veidnes ietvaros. Ņemiet vērā, ka logrīkus no globālajiem paneļiem *nevar* kopēt uz hostu paneļiem. ::: noteclassic Pirms Zabbix 5.2 hostu paneļi bija hostu ekrāni. Importējot vecāku veidni, kas satur ekrānus, ekrānu imports tiks ignorēts. ::: #### Configuration Host prototypes are configured under [low-level discovery rules](/manual/discovery/low_level_discovery#discovery-rule). To create a host prototype: 1\. Go to [*Data collection* → *Hosts*](/manual/web_interface/frontend_sections/data_collection/hosts). 2\. Click *Discovery* for the required host to navigate to the list of low-level discovery rules configured for that host. 3\. Click *Host prototypes* for the required discovery rule. 4\. Click the *Create host prototype* button in the upper right corner. {width=600} Host prototypes have the same parameters as regular [hosts](/manual/config/hosts/host); however, the following parameters support different or additional configuration: |Parameter|Description| |--|--------| |*Host name*|This parameter must contain at least one [low-level discovery macro](/manual/config/macros/lld_macros) to ensure unique host names for created hosts.| |*Visible name*|[Low-level discovery macros](/manual/config/macros/lld_macros) are supported.| |*Group prototypes*|Allows specifying host group prototypes by using [low-level discovery macros](/manual/config/macros/lld_macros).<br>Based on the specified group prototypes, [host groups](/manual/web_interface/frontend_sections/data_collection/hostgroups) will be discovered, created and linked to the created hosts; discovered groups that have already been created by other low-level discovery rules will also be linked to the created hosts. However, discovered host groups that match [manually](/manual/config/hosts/host_groups) created host groups will not be linked to the created hosts.| |*Interfaces*|Set whether discovered hosts inherit the IP from the host that the discovery rule belongs to (default), or get [custom interfaces](#host-interfaces).<br>[Low-level discovery macros](/manual/config/macros/lld_macros) and [user macros](/manual/config/macros/user_macros) are supported.| |*Create enabled*|Set the status of discovered hosts; if unchecked, hosts will be created as disabled.| |*Discover*|Set whether hosts will be created from the host prototype; if unchecked, hosts will not be created from the host prototype (unless this setting is [overridden](/manual/discovery/low_level_discovery#override) in the low-level discovery rule).| ::: noteclassic [Low-level discovery macros](/manual/config/macros/lld_macros) are also supported for tag values and host prototype user macro values.<br> *Value maps* are not supported for host prototypes. ::: For an example of how to configure a host prototype, see [*Virtual machine monitoring*](/manual/vm_monitoring#configuration-examples). #### Konfigurācija Hosts prototipi tiek konfigurēti sadaļā [zemlīmeņa atklāšanas noteikumi](/manual/discovery/low_level_discovery#discovery-rule). Lai izveidotu hosts prototipu: 1\. Dodieties uz [*Datu vākšana* → *Hosts*](/manual/web_interface/frontend_sections/data_collection/hosts). 2\. Noklikšķiniet uz *Atklāšana* attiecīgajam hostam, lai pārietu uz šim hostam konfigurēto zemlīmeņa atklāšanas noteikumu sarakstu. 3\. Noklikšķiniet uz *Hosts prototipi* attiecīgajam atklāšanas noteikumam. 4\. Noklikšķiniet uz pogas *Izveidot hosts prototipu* augšējā labajā stūrī. {width=600} Hosts prototipiem ir tādi paši parametri kā parastiem [hosts](/manual/config/hosts/host); tomēr šiem parametriem tiek atbalstīta atšķirīga vai papildu konfigurācija: |Parameter|Description| |--|--------| |*Host name*|Šim parametram jāietver vismaz viena [zemlīmeņa atklāšanas makro](/manual/config/macros/lld_macros), lai nodrošinātu izveidoto hosts unikālus nosaukumus.| |*Visible name*|Tiek atbalstīti [zemlīmeņa atklāšanas makro](/manual/config/macros/lld_macros).| |*Group prototypes*|Ļauj norādīt hosts grupu prototipus, izmantojot [zemlīmeņa atklāšanas makro](/manual/config/macros/lld_macros).<br>Balstoties uz norādītajiem grupu prototipiem, tiks atklātas, izveidotas un piesaistītas izveidotajiem hosts [hosts grupas](/manual/web_interface/frontend_sections/data_collection/hostgroups); atklātās grupas, kas jau ir izveidotas ar citiem zemlīmeņa atklāšanas noteikumiem, arī tiks piesaistītas izveidotajiem hosts. Tomēr atklātās hosts grupas, kas atbilst [manuāli](/manual/config/hosts/host_groups) izveidotām hosts grupām, netiks piesaistītas izveidotajiem hosts.| |*Interfaces*|Norādiet, vai atklātie hosts pārmanto IP no hosta, kuram pieder atklāšanas noteikums (noklusējums), vai arī saņem [pielāgotas saskarnes](#host-interfaces).<br>Tiek atbalstīti [zemlīmeņa atklāšanas makro](/manual/config/macros/lld_macros) un [lietotāja makro](/manual/config/macros/user_macros).| |*Create enabled*|Norādiet atklāto hosts statusu; ja šī opcija nav atzīmēta, hosts tiks izveidoti kā atspējoti.| |*Discover*|Norādiet, vai hosts tiks izveidoti no hosts prototipa; ja šī opcija nav atzīmēta, hosts netiks izveidoti no hosts prototipa (ja vien šis iestatījums nav [pārrakstīts](/manual/discovery/low_level_discovery#override) zemlīmeņa atklāšanas noteikumā).| ::: noteclassic [Zemlīmeņa atklāšanas makro](/manual/config/macros/lld_macros) tiek atbalstīti arī tagu vērtībām un hosts prototipa lietotāja makro vērtībām.<br> *Vērtību kartes* hosts prototipiem netiek atbalstītas. ::: Piemēru, kā konfigurēt hosts prototipu, skatiet sadaļā [*Virtuālās mašīnas uzraudzība*](/manual/vm_monitoring#configuration-examples). #### Configuration If Zabbix server is compiled from [sources](/manual/installation/install#4-configure-the-sources), it must be compiled with the `--with-libcurl --with-libxml2` configuration options to enable virtual machine monitoring. Zabbix packages are compiled with these options already enabled. The following Zabbix server configuration file parameters can be modified for virtual machine monitoring: - [`StartVMwareCollectors`](/manual/appendix/config/zabbix_server#startvmwarecollectors) ::: noteclassic It is recommended to enable more collectors than the number of monitored VMware services; otherwise, the retrieval of VMware performance counter statistics might be delayed by the retrieval of VMware configuration data (which takes a while for large installations). <br><br> Generally, the value of `StartVMwareCollectors` should not dip below `2` and should not exceed twice the amount of monitored VMware services: Amount of services < `StartVMwareCollectors` < (Amount of services \* 2). For example, when monitoring one VMware service, set `StartVMwareCollectors` to `2`; when monitoring three services, set `StartVMwareCollectors` to `5`. <br><br> Note that the required number of collectors also depends on the scope of the VMware environment, and the `VMwareFrequency` and `VMwarePerfFrequency` configuration parameters. ::: - [`VMwareCacheSize`](/manual/appendix/config/zabbix_server#vmwarecachesize) - [`VMwareFrequency`](/manual/appendix/config/zabbix_server#vmwarefrequency) - [`VMwarePerfFrequency`](/manual/appendix/config/zabbix_server#vmwareperffrequency) - [`VMwareTimeout`](/manual/appendix/config/zabbix_server#vmwaretimeout) ::: noteimportant To support datastore capacity metrics, ensure that the value of the VMware `vpxd.stats.maxQueryMetrics` key is set to at least `64`. For more information, see the [*VMware Knowledge Base* article](https://kb.vmware.com/s/article/2107096). ::: #### Konfigurācija Ja Zabbix serveris ir kompilēts no [avotiem](/manual/installation/install#4-configure-the-sources), tas ir jākompilē ar konfigurācijas opcijām `--with-libcurl --with-libxml2`, lai iespējotu virtuālo mašīnu uzraudzību. Zabbix pakotnes jau ir kompilētas ar šīm opcijām. Virtuālo mašīnu uzraudzībai var modificēt šādus Zabbix servera konfigurācijas faila parametrus: - [`StartVMwareCollectors`](/manual/appendix/config/zabbix_server#startvmwarecollectors) ::: noteclassic Ieteicams iespējot vairāk kolektoru nekā uzraudzīto VMware pakalpojumu skaits; pretējā gadījumā VMware veiktspējas skaitītāju statistikas izgūšanu var aizkavēt VMware konfigurācijas datu izgūšana (kas lielās instalācijās aizņem kādu laiku). <br><br> Parasti `StartVMwareCollectors` vērtībai nevajadzētu būt mazākai par `2` un tā nedrīkst pārsniegt divkāršu uzraudzīto VMware pakalpojumu skaitu: Pakalpojumu skaits < `StartVMwareCollectors` < (Pakalpojumu skaits \* 2). Piemēram, uzraugot vienu VMware pakalpojumu, iestatiet `StartVMwareCollectors` uz `2`; uzraugot trīs pakalpojumus, iestatiet `StartVMwareCollectors` uz `5`. <br><br> Ņemiet vērā, ka nepieciešamais kolektoru skaits ir atkarīgs arī no VMware vides apjoma, kā arī no konfigurācijas parametriem `VMwareFrequency` un `VMwarePerfFrequency`. ::: - [`VMwareCacheSize`](/manual/appendix/config/zabbix_server#vmwarecachesize) - [`VMwareFrequency`](/manual/appendix/config/zabbix_server#vmwarefrequency) - [`VMwarePerfFrequency`](/manual/appendix/config/zabbix_server#vmwareperffrequency) - [`VMwareTimeout`](/manual/appendix/config/zabbix_server#vmwaretimeout) ::: noteimportant Lai atbalstītu datu krātuves ietilpības metriku, pārliecinieties, ka VMware `vpxd.stats.maxQueryMetrics` atslēgas vērtība ir iestatīta vismaz uz `64`. Papildinformāciju skatiet [*VMware Knowledge Base* rakstā](https://kb.vmware.com/s/article/2107096). ::: # configuration.import # configuration.import # configuration.importcompare # configuration.importcompare #### Configuration In the *Type* field of [item configuration form](/manual/config/items/item), select Browser and then fill out the required fields. {width="600"} All mandatory input fields are marked with a red asterisk. The fields that require specific information for Browser items are: |Field|Description| |--|--------| |*Key*|Enter a unique key that will be used to identify the item.| |*Parameters*|Specify the variables to be passed to the script as the attribute and value pairs.<br>[User macros](/manual/config/macros/user_macros) are supported. To see which built-in macros are supported, do a search for "Browser-type item" in the [supported macro](/manual/appendix/macros/supported_by_location) table.| |*Script*|Enter JavaScript code in the modal editor that opens when clicking in the parameter field or on the pencil icon next to it. This code must provide the logic for returning the metric value.<br>The code has access to all parameters, all [additional JavaScript objects](/manual/config/items/preprocessing/javascript/javascript_objects) and [Browser item JavaScript objects](/manual/config/items/preprocessing/javascript/browser_item_javascript_objects) added by Zabbix.<br>See also: [JavaScript Guide](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide).| |*Timeout*|JavaScript execution timeout (1-600s; exceeding it will return an error).<br>Note that depending on the script, it might take longer for the timeout to trigger.<br>For more information on the *Timeout* parameter, see [general item attributes](/manual/config/items/item#configuration).| #### Konfigurācija Laukā *Type* [vienuma konfigurācijas formā](/manual/config/items/item) atlasiet Browser un pēc tam aizpildiet obligātos laukus. {width="600"} Visi obligātie ievades lauki ir atzīmēti ar sarkanu zvaigznīti. Lauki, kuriem Browser vienumiem ir nepieciešama specifiska informācija, ir šādi: |Lauks|Apraksts| |--|--------| |*Key*|Ievadiet unikālu atslēgu, kas tiks izmantota vienuma identificēšanai.| |*Parameters*|Norādiet mainīgos, kas tiks nodoti skriptam kā atribūta un vērtības pāri.<br>Tiek atbalstīti [lietotāja makrosi](/manual/config/macros/user_macros). Lai redzētu, kuri iebūvētie makrosi tiek atbalstīti, meklējiet "Browser-type item" [atbalstīto makrosu](/manual/appendix/macros/supported_by_location) tabulā.| |*Script*|Ievadiet JavaScript kodu modālajā redaktorā, kas tiek atvērts, noklikšķinot parametra laukā vai uz zīmuļa ikonas blakus tam. Šim kodam jānodrošina loģika metrikas vērtības atgriešanai.<br>Kodam ir piekļuve visiem parametriem, visiem Zabbix pievienotajiem [papildu JavaScript objektiem](/manual/config/items/preprocessing/javascript/javascript_objects) un [Browser vienuma JavaScript objektiem](/manual/config/items/preprocessing/javascript/browser_item_javascript_objects).<br>Skatiet arī: [JavaScript Guide](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide).| |*Timeout*|JavaScript izpildes noildze (1-600s; tās pārsniegšana atgriezīs kļūdu).<br>Ņemiet vērā, ka atkarībā no skripta var būt nepieciešams ilgāks laiks, līdz noildze nostrādā.<br>Papildinformāciju par parametru *Timeout* skatiet sadaļā [vispārīgie vienuma atribūti](/manual/config/items/item#configuration).| ### Configuration In the *Type* field of [item configuration form](/manual/config/items/item) select Script then fill out required fields. {width="600"} All mandatory input fields are marked with a red asterisk. The fields that require specific information for Script items are: |Field|Description| |--|--------| |*Key*|Enter a unique key that will be used to identify the item.| |*Parameters*|Specify the variables to be passed to the script as the attribute and value pairs.<br>[User macros](/manual/config/macros/user_macros) are supported. To see which built-in macros are supported, do a search for "Script-type item" in the [supported macro](/manual/appendix/macros/supported_by_location) table.| |*Script*|Enter JavaScript code in the modal editor that opens when clicking in the parameter field or on the pencil icon next to it. This code must provide the logic for returning the metric value.<br>The code has access to all parameters and all [additional JavaScript objects](/manual/config/items/preprocessing/javascript/javascript_objects) added by Zabbix.<br>See also: [JavaScript Guide](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide).| |*Timeout*|JavaScript execution timeout (1-600s; exceeding it will return an error).<br>Note that depending on the script, it might take longer for the timeout to trigger.<br>For more information on the *Timeout* parameter, see [general item attributes](/manual/config/items/item#configuration).| ### Konfigurācija Laukā *Type* [vienuma konfigurācijas veidlapā](/manual/config/items/item) atlasiet Script, pēc tam aizpildiet obligātos laukus. {width="600"} Visi obligātie ievades lauki ir atzīmēti ar sarkanu zvaigznīti. Lauki, kuros Script vienumiem ir jānorāda specifiska informācija, ir šādi: |Lauks|Apraksts| |--|--------| |*Key*|Ievadiet unikālu atslēgu, kas tiks izmantota vienuma identificēšanai.| |*Parameters*|Norādiet mainīgos, kas tiks nodoti skriptam kā atribūta un vērtības pāri.<br>Tiek atbalstīti [lietotāja makrosi](/manual/config/macros/user_macros). Lai redzētu, kuri iebūvētie makrosi tiek atbalstīti, meklējiet "Script-type item" tabulā [supported macro](/manual/appendix/macros/supported_by_location).| |*Script*|Ievadiet JavaScript kodu modālajā redaktorā, kas tiek atvērts, noklikšķinot parametra laukā vai uz zīmuļa ikonas blakus tam. Šim kodam jānodrošina loģika metrikas vērtības atgriešanai.<br>Kodam ir piekļuve visiem parametriem un visiem [papildu JavaScript objektiem](/manual/config/items/preprocessing/javascript/javascript_objects), ko pievieno Zabbix.<br>Skatiet arī: [JavaScript Guide](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide).| |*Timeout*|JavaScript izpildes noildze (1-600s; tās pārsniegšana atgriezīs kļūdu).<br>Ņemiet vērā, ka atkarībā no skripta var būt nepieciešams ilgāks laiks, līdz noildze nostrādā.<br>Papildinformāciju par parametru *Timeout* skatiet sadaļā [general item attributes](/manual/config/items/item#configuration).| #### Configuration ::: noteimportant Only Super admin users can create host groups. ::: There are two options of creating a host group in Zabbix frontend. **Option one**: 1. Go to *Data collection* > *Host groups*. 2. Click *Create host group* in the upper right corner of the screen. 3. Enter the group name in the form.  **Option two**: when [configuring a host](/manual/config/hosts/host#configuration), enter a non-existing group name in the *Host groups* input field. Once the host group is created, you can click the group name in the list under *Data collection* > *Host groups* to edit the group name, clone the group, or delete the group. Deleting a host group only deletes the logical group, not the hosts in the group. It is not possible to delete a host group that is the only group for any existing host. #### Konfigurācija ::: noteimportant Tikai Super admin lietotāji var izveidot hostu grupas. ::: Zabbix lietotāja saskarnē ir divas hostu grupas izveides iespējas. **Pirmā iespēja**: 1. Dodieties uz *Datu vākšana* > *Hostu grupas*. 2. Ekrāna augšējā labajā stūrī noklikšķiniet uz *Izveidot hostu grupu*. 3. Formā ievadiet grupas nosaukumu.  **Otrā iespēja**: [konfigurējot hostu](/manual/config/hosts/host#configuration), laukā *Hostu grupas* ievadiet neeksistējošas grupas nosaukumu. Kad hostu grupa ir izveidota, varat noklikšķināt uz grupas nosaukuma sarakstā zem *Datu vākšana* > *Hostu grupas*, lai rediģētu grupas nosaukumu, klonētu grupu vai dzēstu to. Dzēšot hostu grupu, tiek dzēsta tikai loģiskā grupa, nevis grupā esošie hosts. Nav iespējams dzēst hostu grupu, ja tā ir vienīgā grupa kādam esošam hostam. #### Configuration ::: noteimportant Only Super admin users can create template groups. ::: There are two options of creating a template group in Zabbix frontend. **Option one**: 1. Go to *Data collection* > *Template groups*. 2. Click *Create template group* in the upper-right corner of the screen. 3. Enter the group name in the form.  **Option two**: when [configuring a template](/manual/config/templates/template#creating-a-template), enter a non-existing group name in the *Template groups* input field. Once the template group is created, you can click the template name in the list under *Data collection* > *Template groups* to edit the group name, clone the group, or delete the group. Deleting a template group only deletes the logical group, not the templates in the group. It is not possible to delete a template group that is the only group for any existing template. #### Konfigurācija ::: noteimportant Tikai Super admin lietotāji var izveidot veidņu grupas. ::: Zabbix lietotāja saskarnē ir divas veidņu grupas izveides iespējas. **Pirmais variants**: 1. Dodieties uz *Datu vākšana* > *Veidņu grupas*. 2. Ekrāna augšējā labajā stūrī noklikšķiniet uz *Izveidot veidņu grupu*. 3. Formā ievadiet grupas nosaukumu.  **Otrais variants**: konfigurējot [veidni](/manual/config/templates/template#creating-a-template), laukā *Veidņu grupas* ievadiet neesošas grupas nosaukumu. Kad veidņu grupa ir izveidota, varat sarakstā zem *Datu vākšana* > *Veidņu grupas* noklikšķināt uz veidnes nosaukuma, lai rediģētu grupas nosaukumu, klonētu grupu vai dzēstu grupu. Dzēšot veidņu grupu, tiek dzēsta tikai loģiskā grupa, nevis grupā esošās veidnes. Nav iespējams dzēst veidņu grupu, ja tā ir vienīgā grupa kādai esošai veidnei. ### Configuration Once you have [installed](/manual/installation/install) and [configured](/manual/appendix/config/zabbix_proxy) a proxy, it is time to configure it in the Zabbix frontend. ### Konfigurācija Kad esat [instalējis](/manual/installation/install) un [konfigurējis](/manual/appendix/config/zabbix_proxy) starpniekserveri, ir pienācis laiks to konfigurēt Zabbix lietotāja saskarnē. #### Configuration Overall, the process of setting up the notification should feel familiar to those who have set up alerts in Zabbix before. #### Konfigurācija Kopumā paziņojuma iestatīšanas procesam vajadzētu būt pazīstamam tiem, kuri iepriekš jau ir konfigurējuši brīdinājumus Zabbix. #### Configuration parameters The default value for several configuration parameters has been changed: - [BufferSize](/manual/appendix/config/zabbix_agent2#buffersize) configuration parameter for Zabbix agent 2 has been increased from 100 to 1000; - [Plugins.<PluginName>.System.Capacity](/manual/appendix/config/zabbix_agent2#plugins.systemcapacity) configuration parameter for Zabbix agent 2 has been increased from 100 to 1000 (maximum). Note that the parameter `Plugins.<PluginName>.Capacity`, deprecated in Zabbix 6.0, has been removed completely; - [StartAgents](/manual/appendix/config/zabbix_agentd#startagents) configuration parameter for Zabbix agent has been increased from 3 to 10. Note in packaging that for smaller systems (i.e. Raspberry Pi) the default value may remain 3. These changes do not affect existing installations where these parameters are explicitly set. #### Konfigurācijas parametri Vairāku konfigurācijas parametru noklusējuma vērtība ir mainīta: - [BufferSize](/manual/appendix/config/zabbix_agent2#buffersize) konfigurācijas parametrs Zabbix aģents 2 ir palielināts no 100 līdz 1000; - [Plugins.<PluginName>.System.Capacity](/manual/appendix/config/zabbix_agent2#plugins.systemcapacity) konfigurācijas parametrs Zabbix aģents 2 ir palielināts no 100 līdz 1000 (maksimums). Ņemiet vērā, ka parametrs `Plugins.<PluginName>.Capacity`, kas Zabbix 6.0 ir novecojis, ir pilnībā noņemts; - [StartAgents](/manual/appendix/config/zabbix_agentd#startagents) konfigurācijas parametrs Zabbix aģents ir palielināts no 3 līdz 10. Ņemiet vērā, ka pakotnēs mazākām sistēmām (piem., Raspberry Pi) noklusējuma vērtība var palikt 3. Šīs izmaiņas neietekmē esošas instalācijas, kur šie parametri ir skaidri iestatīti. ### Configuration parameters The **ProxyConfigFrequency** parameter determines how often the proxy configuration is synced with the server (10 seconds by default). Note that ProxyConfigFrequency is: - server parameter for passive proxies - proxy parameter for active proxies On active proxies ProxyConfigFrequency is a new parameter since Zabbix 6.4 and must be used instead of the now-deprecated ConfigFrequency. ::: noteimportant If both ProxyConfigFrequency and ConfigFrequency are used, the proxy will log an error and terminate. ::: ### Konfigurācijas parametri Parametrs **ProxyConfigFrequency** nosaka, cik bieži starpniekservera konfigurācija tiek sinhronizēta ar serveri (pēc noklusējuma ik pēc 10 sekundēm). Ņemiet vērā, ka ProxyConfigFrequency ir: - servera parametrs pasīvajiem starpniekserveriem - starpniekservera parametrs aktīvajiem starpniekserveriem Aktīvajos starpniekserveros ProxyConfigFrequency ir jauns parametrs kopš Zabbix 6.4, un tas jāizmanto tagad novecojušā ConfigFrequency vietā. ::: noteimportant Ja tiek izmantoti gan ProxyConfigFrequency, gan ConfigFrequency, starpniekserveris reģistrēs kļūdu žurnālā un pārtrauks darbību. ::: #### Configuration parameters Zabbix agent, server and proxy support two [parameters](/manual/appendix/config/zabbix_server) to deal with modules: - LoadModulePath - full path to the location of loadable modules - LoadModule - module(s) to load at startup. The modules must be located in a directory specified by LoadModulePath or the path must precede the module name. If the preceding path is absolute (starts with '/') then LoadModulePath is ignored. It is allowed to include multiple LoadModule parameters. For example, to extend Zabbix agent we could add the following parameters: ```ini LoadModulePath=/usr/local/lib/zabbix/agent/ LoadModule=mariadb.so LoadModule=apache.so LoadModule=kernel.so LoadModule=/usr/local/lib/zabbix/dummy.so ``` Upon agent startup it will load the mariadb.so, apache.so and kernel.so modules from the /usr/local/lib/zabbix/agent directory while dummy.so will be loaded from /usr/local/lib/zabbix. The agent will fail to start if a module is missing, in case of bad permissions or if a shared library is not a Zabbix module. #### Konfigurācijas parametri Zabbix aģents, serveris un starpniekserveris atbalsta divus [parametrus](/manual/appendix/config/zabbix_server), lai strādātu ar moduļiem: - LoadModulePath - pilns ceļš uz ielādējamo moduļu atrašanās vietu - LoadModule - modulis(-i), ko ielādēt startēšanas laikā. Moduļiem jāatrodas direktorijā, kas norādīta ar LoadModulePath, vai arī ceļam jābūt norādītam pirms moduļa nosaukuma. Ja norādītais ceļš ir absolūts (sākas ar '/') , tad LoadModulePath tiek ignorēts. Ir atļauts norādīt vairākus LoadModule parametrus. Piemēram, lai paplašinātu Zabbix aģents, varētu pievienot šādus parametrus: ```ini LoadModulePath=/usr/local/lib/zabbix/agent/ LoadModule=mariadb.so LoadModule=apache.so LoadModule=kernel.so LoadModule=/usr/local/lib/zabbix/dummy.so ``` Pēc aģenta startēšanas tas ielādēs mariadb.so, apache.so un kernel.so moduļus no /usr/local/lib/zabbix/agent direktorijas, savukārt dummy.so tiks ielādēts no /usr/local/lib/zabbix. Aģents neizdosies startēties, ja modulis nav pieejams, ja ir nepareizas atļaujas vai ja koplietojamā bibliotēka nav Zabbix modulis. #### Configuration Preprocessing steps are defined in the **Preprocessing** tab of the item [configuration](/manual/config/items/item#configuration) form. {width="500"} Click on *Add* to select a supported transformation. The *Type of information* field is displayed at the bottom of the tab when at least one preprocessing step is defined. If required, it is possible to change the type of information without leaving the *Preprocessing* tab. See [Creating an item](/manual/config/items/item) for the detailed parameter description. #### Konfigurācija Priekšapstrādes soļi ir definēti vienuma [konfigurācijas](/manual/config/items/item#configuration) formas cilnē **Priekšapstrāde**. {width="500"} Noklikšķiniet uz *Pievienot*, lai atlasītu atbalstītu transformāciju. Lauks *Informācijas tips* tiek parādīts cilnes apakšdaļā, kad ir definēts vismaz viens priekšapstrādes solis. Ja nepieciešams, informācijas tipu var mainīt, neatstājot cilni *Priekšapstrāde*. Detalizētu parametru aprakstu skatiet sadaļā [Vienuma izveide](/manual/config/items/item). #### Configuration **Pre-requisites**: TimescaleDB extension of a [supported version](/manual/installation/requirements#thirdparty-external-surrounding-software) installed on the database server. For installation instructions, see [TimescaleDB documentation](https://docs.tigerdata.com/self-hosted/latest/install/). ::: notewarning Before installing TimescaleDB, install a supported PostgreSQL release from the [official PostgreSQL](https://www.postgresql.org/download/) repository. ::: Enable TimescaleDB extension for the specific database by executing: ```bash echo "CREATE EXTENSION IF NOT EXISTS timescaledb CASCADE;" | sudo -u postgres psql zabbix ``` Running this command requires database administrator privileges. ::: noteclassic If you use a database schema other than 'public' you need to add a SCHEMA clause to the command above. E.g.:<br> `echo "CREATE EXTENSION IF NOT EXISTS timescaledb SCHEMA yourschema CASCADE;" | sudo -u postgres psql zabbix` ::: Then run the `postgresql/timescaledb/schema.sql` script. For new installations, the script must be run after the regular PostgreSQL database has been created with initial schema/data (see [database creation](/manual/appendix/install/db_scripts)). ```bash cat /usr/share/zabbix-sql-scripts/postgresql/timescaledb/schema.sql | sudo -u zabbix psql zabbix ``` ::: noteimportant Please ignore warning messages informing that the best practices are not followed while running `schema.sql` script on TimescaleDB version 2.9.0 and higher. Regardless of this warning, the configuration will be completed successfully. ::: The migration of existing history, trends and audit log data may take a lot of time. Zabbix server and frontend must be down for the period of migration. The `schema.sql` script sets the following housekeeping parameters: - Override item history period - Override item trend period In order to use partitioned housekeeping for history and trends, both these options must be enabled. It is also possible to enable override individually either for history only or trends only. The `postgresql/timescaledb/schema.sql` script sets two additional parameters: - Enable compression - Compress records older than 7 days #### Konfigurācija **Priekšnosacījumi**: datubāzes serverī ir instalēts [atbalstītas versijas](/manual/installation/requirements#thirdparty-external-surrounding-software) TimescaleDB paplašinājums. Instalēšanas norādījumus skatiet [TimescaleDB dokumentācijā](https://docs.tigerdata.com/self-hosted/latest/install/). ::: notewarning Pirms TimescaleDB instalēšanas instalējiet atbalstītu PostgreSQL laidienu no [oficiālā PostgreSQL](https://www.postgresql.org/download/) repozitorija. ::: Iespējojiet TimescaleDB paplašinājumu konkrētajai datubāzei, izpildot: ```bash echo "CREATE EXTENSION IF NOT EXISTS timescaledb CASCADE;" | sudo -u postgres psql zabbix ``` Šīs komandas izpildei ir nepieciešamas datubāzes administratora tiesības. ::: noteclassic Ja izmantojat datubāzes shēmu, kas nav 'public', iepriekš minētajai komandai jāpievieno klauzula SCHEMA. Piem.:<br> `echo "CREATE EXTENSION IF NOT EXISTS timescaledb SCHEMA yourschema CASCADE;" | sudo -u postgres psql zabbix` ::: Pēc tam palaidiet skriptu `postgresql/timescaledb/schema.sql`. Jaunām instalācijām skripts jāpalaiž pēc tam, kad parastā PostgreSQL datubāze ir izveidota ar sākotnējo shēmu/datiem (skatiet [datubāzes izveide](/manual/appendix/install/db_scripts)). ```bash cat /usr/share/zabbix-sql-scripts/postgresql/timescaledb/schema.sql | sudo -u zabbix psql zabbix ``` ::: noteimportant Lūdzu, ignorējiet brīdinājuma ziņojumus, kas informē, ka, palaižot skriptu `schema.sql` TimescaleDB versijā 2.9.0 un jaunākās, netiek ievērotas labākās prakses. Neraugoties uz šo brīdinājumu, konfigurācija tiks veiksmīgi pabeigta. ::: Esošo vēstures, tendenču un audita žurnāla datu migrācija var aizņemt daudz laika. Migrācijas laikā Zabbix serverim un lietotāja saskarnei jābūt apturētiem. Skripts `schema.sql` iestata šādus apkopes parametrus: - Ignorēt vienuma vēstures periodu - Ignorēt vienuma tendenču periodu Lai izmantotu sadalītu apkopes mehānismu vēsturei un tendencēm, abām šīm opcijām jābūt iespējotām. Ir iespējams arī iespējot ignorēšanu atsevišķi tikai vēsturei vai tikai tendencēm. Skripts `postgresql/timescaledb/schema.sql` iestata divus papildu parametrus: - Iespējot saspiešanu - Saspiest ierakstus, kas vecāki par 7 dienām #### Configuration Real-time export of trigger events, item values and trends is configured by specifying a directory for the export files - see the [ExportDir](/manual/appendix/config/zabbix_server#exportdir) parameter in server configuration. Two other parameters are available: - `ExportFileSize` may be used to set the maximum allowed size of an individual export file. When a process needs to write to a file it checks the size of the file first. If it exceeds the configured size limit, the file is renamed by appending .old to its name and a new file with the original name is created. ::: noteimportant A file will be created per each process that will write data (i.e. approximately 4-30 files). As the default size per export file is 1G, keeping large export files may drain the disk space fast. ::: - `ExportType` allows to specify which entity types (events, history, trends) will be exported. #### Konfigurācija Trigeru notikumu, vienumu vērtību un tendenču reāllaika eksportēšana tiek konfigurēta, norādot eksportēšanas failu direktoriju - skatiet [ExportDir](/manual/appendix/config/zabbix_server#exportdir) parametru serveris konfigurācijā. Pieejami vēl divi parametri: - `ExportFileSize` var izmantot, lai iestatītu maksimāli atļauto atsevišķa eksportēšanas faila lielumu. Kad procesam ir jāieraksta failā, tas vispirms pārbauda faila lielumu. Ja tas pārsniedz konfigurēto lieluma ierobežojumu, faila nosaukums tiek mainīts, tam pievienojot .old, un tiek izveidots jauns fails ar sākotnējo nosaukumu. ::: noteimportant Katram procesam, kas rakstīs datus, tiks izveidots atsevišķs fails (t. i., aptuveni 4-30 faili). Tā kā noklusējuma lielums vienam eksportēšanas failam ir 1G, lielu eksportēšanas failu glabāšana var ātri iztukšot diska vietu. ::: - `ExportType` ļauj norādīt, kādi entītiju tipi (notikumi, vēsture, tendences) tiks eksportēti. ##### Configuration request The `proxy config` request is sent by active proxy to obtain proxy configuration data. This request is sent every `ProxyConfigFrequency` (proxy configuration parameter) seconds. | name | < | < | < | < | value type | description | |-|-|-|-|----------|----------|----------------------------------------| | proxy→server: | < | < | < | < | < | < | | **request** | < | < | < | < | *string* | 'proxy config' | | **host** | < | < | < | < | *string<br>* | Proxy name. | | **version** | < | < | < | < | *string* | Proxy version (\<major>.\<minor>.\<build>). | | **session** | < | < | < | < | *string* | Proxy configuration session token. | | **config_revision** | < | < | < | < | *number* | Proxy configuration revision. | | **hostmap_revision** | < | < | < | < | *number* | Current host-to-proxy mapping revision. | | | < | < | < | < | < | < | | server→proxy: | < | < | < | < | < | < | | **full_sync** | < | < | < | < | *number* | 1 - if full configuration data is sent, absent otherwise (optional). | | **data** | < | < | < | < | *array* | Object of table data. Absent if configuration has not been changed (optional). | | | **\<table>** | < | < | < | *object* | One or more objects with \<table> data (optional, depending on changes). | | ^ | | **fields** | < | < | *array* | Array of field names. | | ^ | ^ | | - | < | *string* | Field name. | | ^ | ^ | **data** | < | < | *array* | Array of rows. | | ^ | ^ | | - | < | *array* | Array of columns. | | ^ | ^ | ^ | | - | *string*,*number* | Column value with type depending on column type in database schema. | | | < | < | < | < | < | < | | **macro.secrets** | < | < | < | < | *object* | Secret macro information, absent if there are no changes in vault macros (optional). | | **proxy_group** | < | < | < | < | *string* | The name of the proxy group to which the proxy belongs. | | **config_revision** | < | < | < | < | *number* | Configuration cache revision - sent with configuration data (optional). | | **del_hostids** | < | < | < | < | *array* | Array of removed hostids (optional). | | | - | < | < | < | *number* | Host identifier. | | **del_macro_hostids** | < | < | < | < | *array* | Array of hostids with all macros removed (optional). | | | - | < | < | < | *number* | Host identifier. | Example: proxy→server: ```{.javascript} { "request": "proxy config", "host": "Zabbix proxy", "version":"7.0.0", "session": "fd59a09ff4e9d1fb447de1f04599bcf6", "config_revision": 0 } ``` server→proxy: ```{.javascript} { "full_sync": 1, "data": { "hosts": { "fields": ["hostid", "host", "status", "ipmi_authtype", "ipmi_privilege", "ipmi_username", "ipmi_password", "name", "tls_connect", "tls_accept", "tls_issuer", "tls_subject", "tls_psk_identity", "tls_psk"], "data": [ [10084, "Zabbix server", 0, -1, 2, "", "", "Zabbix server", 1, 1, "", "", "", ""] ] }, "interface": { "fields": ["interfaceid", "hostid", "main", "type", "useip", "ip", "dns", "port", "available"], "data": [ [1, 10084, 1, 1, 1, "127.0.0.1", "", "10053", 1] ] }, "interface_snmp": { "fields": ["interfaceid", "version", "bulk", "community", "securityname", "securitylevel", "authpassphrase", "privpassphrase", "authprotocol", "privprotocol", "contextname"], "data": [] }, "host_inventory": { "fields": ["hostid", "type", "type_full", "name", "alias", "os", "os_full", "os_short", "serialno_a", "serialno_b", "tag", "asset_tag", "macaddress_a", "macaddress_b", "hardware", "hardware_full", "software", "software_full", "software_app_a", "software_app_b", "software_app_c", "software_app_d", "software_app_e", "contact", "location", "location_lat", "location_lon", "notes", "chassis", "model", "hw_arch", "vendor", "contract_number", "installer_name", "deployment_status", "url_a", "url_b", "url_c", "host_networks", "host_netmask", "host_router", "oob_ip", "oob_netmask", "oob_router", "date_hw_purchase", "date_hw_install", "date_hw_expiry", "date_hw_decomm", "site_address_a", "site_address_b", "site_address_c", "site_city", "site_state", "site_country", "site_zip", "site_rack", "site_notes", "poc_1_name", "poc_1_email", "poc_1_phone_a", "poc_1_phone_b", "poc_1_cell", "poc_1_screen", "poc_1_notes", "poc_2_name", "poc_2_email", "poc_2_phone_a", "poc_2_phone_b", "poc_2_cell", "poc_2_screen", "poc_2_notes"], "data": [ [10084, "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "56.95387", "24.22067", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", ""] ] }, "items": { "fields": ["itemid", "type", "snmp_oid", "hostid", "key_", "delay", "history", "status", "value_type", "trapper_hosts", "logtimefmt", "params", "ipmi_sensor", "authtype", "username", "password", "publickey", "privatekey", "flags", "interfaceid", "inventory_link", "jmx_endpoint", "master_itemid", "timeout", "url", "query_fields", "posts", "status_codes", "follow_redirects", "post_type", "http_proxy", "headers", "retrieve_mode", "request_method", "output_format", "ssl_cert_file", "ssl_key_file", "ssl_key_password", "verify_peer", "verify_host", "allow_traps"], "data": [ [44161, 7, "", 10084, "agent.hostmetadata", "10s", "90d", 0, 1, "", "", "", "", 0, "", "", "", "", 0, null, 0, "", null, "3s", "", "", "", "200", 1, 0, "", "", 0, 0, 0, "", "", "", 0, 0, 0], [44162, 0, "", 10084, "agent.ping", "10s", "90d", 0, 3, "", "", "", "", 0, "", "", "", "", 0, 1, 0, "", null, "3s", "", "", "", "200", 1, 0, "", "", 0, 0, 0, "", "", "", 0, 0, 0] ] }, "item_rtdata": { "fields": ["itemid", "lastlogsize", "mtime"], "data": [ [44161, 0, 0], [44162, 0, 0] ] }, "item_preproc": { "fields": ["item_preprocid", "itemid", "step", "type", "params", "error_handler", "error_handler_params"], "data": [] }, "item_parameter": { "fields": ["item_parameterid", "itemid", "name", "value"], "data": [] }, "globalmacro": { "fields": ["globalmacroid", "macro", "value", "type"], "data": [ [2, "{$SNMP_COMMUNITY}", "public", 0] ] }, "hosts_templates": { "fields": ["hosttemplateid", "hostid", "templateid", "link_type"], "data": [] }, "hostmacro": { "fields": ["hostmacroid", "hostid", "macro", "value", "type", "automatic"], "data": [ [5676, 10084, "{$M}", "AppID=zabbix_server&Query=Safe=passwordSafe;Object=zabbix:Content", 2, 0] ] }, "drules": { "fields": ["druleid", "name", "iprange", "delay"], "data": [ [2, "Local network", "127.0.0.1", "10s"] ] }, "dchecks": { "fields": ["dcheckid", "druleid", "type", "key_", "snmp_community", "ports", "snmpv3_securityname", "snmpv3_securitylevel", "snmpv3_authpassphrase", "snmpv3_privpassphrase", "uniq", "snmpv3_authprotocol", "snmpv3_privprotocol", "snmpv3_contextname", "host_source", "name_source"], "data": [ [2, 2, 9, "system.uname", "", "10052", "", 0, "", "", 0, 0, 0, "", 1, 0] ] }, "regexps": { "fields": ["regexpid", "name"], "data": [ [1, "File systems for discovery"], [2, "Network interfaces for discovery"], [3, "Storage devices for SNMP discovery"], [4, "Windows service names for discovery"], [5, "Windows service startup states for discovery"] ] }, "expressions": { "fields": ["expressionid", "regexpid", "expression", "expression_type", "exp_delimiter", "case_sensitive"], "data": [ [1, 1, "^(btrfs|ext2|ext3|ext4|reiser|xfs|ffs|ufs|jfs|jfs2|vxfs|hfs|apfs|refs|ntfs|fat32|zfs)$", 3, ",", 0], [3, 3, "^(Physical memory|Virtual memory|Memory buffers|Cached memory|Swap space)$", 4, ",", 1], [5, 4, "^(MMCSS|gupdate|SysmonLog|clr_optimization_v2.0.50727_32|clr_optimization_v4.0.30319_32)$", 4, ",", 1], [6, 5, "^(automatic|automatic delayed)$", 3, ",", 1], [7, 2, "^Software Loopback Interface", 4, ",", 1], [8, 2, "^(In)?[Ll]oop[Bb]ack[0-9._]*$", 4, ",", 1], [9, 2, "^NULL[0-9.]*$", 4, ",", 1], [10, 2, "^[Ll]o[0-9.]*$", 4, ",", 1], [11, 2, "^[Ss]ystem$", 4, ",", 1], [12, 2, "^Nu[0-9.]*$", 4, ",", 1] ] }, "config": { "fields": ["configid", "snmptrap_logging", "hk_history_global", "hk_history", "autoreg_tls_accept"], "data": [ [1, 1, 0, "90d", 1] ] }, "httptest": { "fields": ["httptestid", "name", "delay", "agent", "authentication", "http_user", "http_password", "hostid", "http_proxy", "retries", "ssl_cert_file", "ssl_key_file", "ssl_key_password", "verify_peer", "verify_host"], "data": [] }, "httptestitem": { "fields": ["httptestitemid", "httptestid", "itemid", "type"], "data": [] }, "httptest_field": { "fields": ["httptest_fieldid", "httptestid", "type", "name", "value"], "data": [] }, "httpstep": { "fields": ["httpstepid", "httptestid", "name", "no", "url", "timeout", "posts", "required", "status_codes", "follow_redirects", "retrieve_mode", "post_type"], "data": [] }, "httpstepitem": { "fields": ["httpstepitemid", "httpstepid", "itemid", "type"], "data": [] }, "httpstep_field": { "fields": ["httpstep_fieldid", "httpstepid", "type", "name", "value"], "data": [] }, "config_autoreg_tls": { "fields": ["autoreg_tlsid", "tls_psk_identity", "tls_psk"], "data": [ [1, "", ""] ] } }, "macro.secrets": { "AppID=zabbix_server&Query=Safe=passwordSafe;Object=zabbix": { "Content": "738" } }, "config_revision": 2 } ``` ##### Konfigurācijas pieprasījums `proxy config` pieprasījumu aktīvais starpniekserveris nosūta, lai iegūtu starpniekservera konfigurācijas datus. Šis pieprasījums tiek nosūtīts ik pēc `ProxyConfigFrequency` (starpniekservera konfigurācijas parametrs) sekundēm. | name | < | < | < | < | value type | description | |-|-|-|-|----------|----------|----------------------------------------| | proxy→server: | < | < | < | < | < | < | | **request** | < | < | < | < | *string* | 'proxy config' | | **host** | < | < | < | < | *string<br>* | Starpniekservera nosaukums. | | **version** | < | < | < | < | *string* | Starpniekservera versija (\<major>.\<minor>.\<build>). | | **session** | < | < | < | < | *string* | Starpniekservera konfigurācijas sesijas marķieris. | | **config_revision** | < | < | < | < | *number* | Starpniekservera konfigurācijas revīzija. | | **hostmap_revision** | < | < | < | < | *number* | Pašreizējā hostu un starpniekserveru kartējuma revīzija. | | | < | < | < | < | < | < | | server→proxy: | < | < | < | < | < | < | | **full_sync** | < | < | < | < | *number* | 1 - ja tiek nosūtīti pilni konfigurācijas dati, citādi nav klāt (neobligāti). | | **data** | < | < | < | < | *array* | Tabulas datu objekts. Nav klāt, ja konfigurācija nav mainīta (neobligāti). | | | **\<table>** | < | < | < | *object* | Viens vai vairāki objekti ar \<table> datiem (neobligāti, atkarībā no izmaiņām). | | ^ | | **fields** | < | < | *array* | Lauku nosaukumu masīvs. | | ^ | ^ | | - | < | *string* | Lauka nosaukums. | | ^ | ^ | **data** | < | < | *array* | Rindu masīvs. | | ^ | ^ | | - | < | *array* | Kolonnu masīvs. | | ^ | ^ | ^ | | - | *string*,*number* | Kolonnas vērtība ar tipu, kas atkarīgs no kolonnas tipa datubāzes shēmā. | | | < | < | < | < | < | < | | **macro.secrets** | < | < | < | < | *object* | Slepeno makro informācija, nav klāt, ja vault makrosos nav izmaiņu (neobligāti). | | **proxy_group** | < | < | < | < | *string* | Starpniekserveru grupas nosaukums, kurai pieder starpniekserveris. | | **config_revision** | < | < | < | < | *number* | Konfigurācijas kešatmiņas revīzija - nosūtīta kopā ar konfigurācijas datiem (neobligāti). | | **del_hostids** | < | < | < | < | *array* | Noņemto hostid masīvs (neobligāti). | | | - | < | < | < | *number* | Host identifikators. | | **del_macro_hostids** | < | < | < | < | *array* | Hostid masīvs ar visām noņemtajām makro vērtībām (neobligāti). | | | - | < | < | < | *number* | Host identifikators. | Piemērs: proxy→server: ```{.javascript} { "request": "proxy config", "host": "Zabbix proxy", "version":"7.0.0", "session": "fd59a09ff4e9d1fb447de1f04599bcf6", "config_revision": 0 } ``` server→proxy: ```{.javascript} { "full_sync": 1, "data": { "hosts": { "fields": ["hostid", "host", "status", "ipmi_authtype", "ipmi_privilege", "ipmi_username", "ipmi_password", "name", "tls_connect", "tls_accept", "tls_issuer", "tls_subject", "tls_psk_identity", "tls_psk"], "data": [ [10084, "Zabbix server", 0, -1, 2, "", "", "Zabbix server", 1, 1, "", "", "", ""] ] }, "interface": { "fields": ["interfaceid", "hostid", "main", "type", "useip", "ip", "dns", "port", "available"], "data": [ [1, 10084, 1, 1, 1, "127.0.0.1", "", "10053", 1] ] }, "interface_snmp": { "fields": ["interfaceid", "version", "bulk", "community", "securityname", "securitylevel", "authpassphrase", "privpassphrase", "authprotocol", "privprotocol", "contextname"], "data": [] }, "host_inventory": { "fields": ["hostid", "type", "type_full", "name", "alias", "os", "os_full", "os_short", "serialno_a", "serialno_b", "tag", "asset_tag", "macaddress_a", "macaddress_b", "hardware", "hardware_full", "software", "software_full", "software_app_a", "software_app_b", "software_app_c", "software_app_d", "software_app_e", "contact", "location", "location_lat", "location_lon", "notes", "chassis", "model", "hw_arch", "vendor", "contract_number", "installer_name", "deployment_status", "url_a", "url_b", "url_c", "host_networks", "host_netmask", "host_router", "oob_ip", "oob_netmask", "oob_router", "date_hw_purchase", "date_hw_install", "date_hw_expiry", "date_hw_decomm", "site_address_a", "site_address_b", "site_address_c", "site_city", "site_state", "site_country", "site_zip", "site_rack", "site_notes", "poc_1_name", "poc_1_email", "poc_1_phone_a", "poc_1_phone_b", "poc_1_cell", "poc_1_screen", "poc_1_notes", "poc_2_name", "poc_2_email", "poc_2_phone_a", "poc_2_phone_b", "poc_2_cell", "poc_2_screen", "poc_2_notes"], "data": [ [10084, "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "56.95387", "24.22067", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", ""] ] }, "items": { "fields": ["itemid", "type", "snmp_oid", "hostid", "key_", "delay", "history", "status", "value_type", "trapper_hosts", "logtimefmt", "params", "ipmi_sensor", "authtype", "username", "password", "publickey", "privatekey", "flags", "interfaceid", "inventory_link", "jmx_endpoint", "master_itemid", "timeout", "url", "query_fields", "posts", "status_codes", "follow_redirects", "post_type", "http_proxy", "headers", "retrieve_mode", "request_method", "output_format", "ssl_cert_file", "ssl_key_file", "ssl_key_password", "verify_peer", "verify_host", "allow_traps"], "data": [ [44161, 7, "", 10084, "agent.hostmetadata", "10s", "90d", 0, 1, "", "", "", "", 0, "", "", "", "", 0, null, 0, "", null, "3s", "", "", "", "200", 1, 0, "", "", 0, 0, 0, "", "", "", 0, 0, 0], [44162, 0, "", 10084, "agent.ping", "10s", "90d", 0, 3, "", "", "", "", 0, "", "", "", "", 0, 1, 0, "", null, "3s", "", "", "", "200", 1, 0, "", "", 0, 0, 0, "", "", "", 0, 0, 0] ] }, "item_rtdata": { "fields": ["itemid", "lastlogsize", "mtime"], "data": [ [44161, 0, 0], [44162, 0, 0] ] }, "item_preproc": { "fields": ["item_preprocid", "itemid", "step", "type", "params", "error_handler", "error_handler_params"], "data": [] }, "item_parameter": { "fields": ["item_parameterid", "itemid", "name", "value"], "data": [] }, "globalmacro": { "fields": ["globalmacroid", "macro", "value", "type"], "data": [ [2, "{$SNMP_COMMUNITY}", "public", 0] ] }, "hosts_templates": { "fields": ["hosttemplateid", "hostid", "templateid", "link_type"], "data": [] }, "hostmacro": { "fields": ["hostmacroid", "hostid", "macro", "value", "type", "automatic"], "data": [ [5676, 10084, "{$M}", "AppID=zabbix_server&Query=Safe=passwordSafe;Object=zabbix:Content", 2, 0] ] }, "drules": { "fields": ["druleid", "name", "iprange", "delay"], "data": [ [2, "Local network", "127.0.0.1", "10s"] ] }, "dchecks": { "fields": ["dcheckid", "druleid", "type", "key_", "snmp_community", "ports", "snmpv3_securityname", "snmpv3_securitylevel", "snmpv3_authpassphrase", "snmpv3_privpassphrase", "uniq", "snmpv3_authprotocol", "snmpv3_privprotocol", "snmpv3_contextname", "host_source", "name_source"], "data": [ [2, 2, 9, "system.uname", "", "10052", "", 0, "", "", 0, 0, 0, "", 1, 0] ] }, "regexps": { "fields": ["regexpid", "name"], "data": [ [1, "File systems for discovery"], [2, "Network interfaces for discovery"], [3, "Storage devices for SNMP discovery"], [4, "Windows service names for discovery"], [5, "Windows service startup states for discovery"] ] }, "expressions": { "fields": ["expressionid", "regexpid", "expression", "expression_type", "exp_delimiter", "case_sensitive"], "data": [ [1, 1, "^(btrfs|ext2|ext3|ext4|reiser|xfs|ffs|ufs|jfs|jfs2|vxfs|hfs|apfs|refs|ntfs|fat32|zfs)$", 3, ",", 0], [3, 3, "^(Physical memory|Virtual memory|Memory buffers|Cached memory|Swap space)$", 4, ",", 1], [5, 4, "^(MMCSS|gupdate|SysmonLog|clr_optimization_v2.0.50727_32|clr_optimization_v4.0.30319_32)$", 4, ",", 1], [6, 5, "^(automatic|automatic delayed)$", 3, ",", 1], [7, 2, "^Software Loopback Interface", 4, ",", 1], [8, 2, "^(In)?[Ll]oop[Bb]ack[0-9._]*$", 4, ",", 1], [9, 2, "^NULL[0-9.]*$", 4, ",", 1], [10, 2, "^[Ll]o[0-9.]*$", 4, ",", 1], [11, 2, "^[Ss]ystem$", 4, ",", 1], [12, 2, "^Nu[0-9.]*$", 4, ",", 1] ] }, "config": { "fields": ["configid", "snmptrap_logging", "hk_history_global", "hk_history", "autoreg_tls_accept"], "data": [ [1, 1, 0, "90d", 1] ] }, "httptest": { "fields": ["httptestid", "name", "delay", "agent", "authentication", "http_user", "http_password", "hostid", "http_proxy", "retries", "ssl_cert_file", "ssl_key_file", "ssl_key_password", "verify_peer", "verify_host"], "data": [] }, "httptestitem": { "fields": ["httptestitemid", "httptestid", "itemid", "type"], "data": [] }, "httptest_field": { "fields": ["httptest_fieldid", "httptestid", "type", "name", "value"], "data": [] }, "httpstep": { "fields": ["httpstepid", "httptestid", "name", "no", "url", "timeout", "posts", "required", "status_codes", "follow_redirects", "retrieve_mode", "post_type"], "data": [] }, "httpstepitem": { "fields": ["httpstepitemid", "httpstepid", "itemid", "type"], "data": [] }, "httpstep_field": { "fields": ["httpstep_fieldid", "httpstepid", "type", "name", "value"], "data": [] }, "config_autoreg_tls": { "fields": ["autoreg_tlsid", "tls_psk_identity", "tls_psk"], "data": [ [1, "", ""] ] } }, "macro.secrets": { "AppID=zabbix_server&Query=Safe=passwordSafe;Object=zabbix": { "Content": "738" } }, "config_revision": 2 } ``` ##### Configuration request The server will first send an empty `proxy config` request. This request is sent every `ProxyConfigFrequency` (server configuration parameter) seconds. The proxy responds with the current proxy version, session token and configuration revision. The server responds with the configuration data that need to be updated. | name | < | < | < | < | value type | description | |-|-|-|-|----------|----------|----------------------------------------| | server→proxy: | < | < | < | < | < | < | | **request** | < | < | < | < | *string* | 'proxy config' | | |<|<|<|<|<|<| | proxy→server: | < | < | < | < | < | < | | **version** | < | < | < | < | *string* | Proxy version (\<major>.\<minor>.\<build>). | | **session** | < | < | < | < | *string* | Proxy configuration session token. | | **config_revision** | < | < | < | < | *number* | Proxy configuration revision. | | |<|<|<|<|<|<| | server→proxy: | < | < | < | < | < | < | | **full_sync** | < | < | < | < | *number* | 1 - if full configuration data is sent; absent - otherwise (optional). | | **data** | < | < | < | < | *array* | Object of table data. Absent if configuration has not been changed (optional). | | | **\<table>** | < | < | < | *object* | One or more objects with \<table> data (optional, depending on changes). | | ^ | | **fields** | < | < | *array* | Array of field names. | | ^ | ^ | | - | < | *string* | Field name. | | ^ | ^ | **data** | < | < | *array* | Array of rows. | | ^ | ^ | | - | < | *array* | Array of columns. | | ^ | ^ | ^ | | - | *string*,*number* | Column value with type depending on column type in database schema. | | | < | < | < | < | < | < | | **macro.secrets** | < | < | < | < | *object* | Secret macro information, absent if there are no changes in vault macros (optional). | | **config_revision** | < | < | < | < | *number* | Configuration cache revision - sent with configuration data (optional). | | **del_hostids** | < | < | < | < | *array* | Array of removed hostids (optional). | | | - | < | < | < | *number* | Host identifier. | | **del_macro_hostids** | < | < | < | < | *array* | Array of hostids with all macros removed (optional). | | | - | < | < | < | *number* | Host identifier. | | | < | < | < | < | < | < | | proxy→server: | < | < | < | < | < | < | | **response** | < | < | < | < | *string* | Request success information ('success' or 'failed'). | | **version** | < | < | < | < | *string* | Proxy version (\<major>.\<minor>.\<build>). | Example: server→proxy: ```{.javascript} { "request":"proxy config" } ``` proxy→server: ```{.javascript} { "version": "7.0.0", "session": "0033124949800811e5686dbfd9bcea98", "config_revision": 0 } ``` server→proxy: ```{.javascript} { "full_sync": 1, "data": { "hosts": { "fields": ["hostid", "host", "status", "ipmi_authtype", "ipmi_privilege", "ipmi_username", "ipmi_password", "name", "tls_connect", "tls_accept", "tls_issuer", "tls_subject", "tls_psk_identity", "tls_psk"], "data": [ [10084, "Zabbix server", 0, -1, 2, "", "", "Zabbix server", 1, 1, "", "", "", ""] ] }, "interface": { "fields": ["interfaceid", "hostid", "main", "type", "useip", "ip", "dns", "port", "available"], "data": [ [1, 10084, 1, 1, 1, "127.0.0.1", "", "10053", 1] ] }, "interface_snmp": { "fields": ["interfaceid", "version", "bulk", "community", "securityname", "securitylevel", "authpassphrase", "privpassphrase", "authprotocol", "privprotocol", "contextname"], "data": [] }, "host_inventory": { "fields": ["hostid", "type", "type_full", "name", "alias", "os", "os_full", "os_short", "serialno_a", "serialno_b", "tag", "asset_tag", "macaddress_a", "macaddress_b", "hardware", "hardware_full", "software", "software_full", "software_app_a", "software_app_b", "software_app_c", "software_app_d", "software_app_e", "contact", "location", "location_lat", "location_lon", "notes", "chassis", "model", "hw_arch", "vendor", "contract_number", "installer_name", "deployment_status", "url_a", "url_b", "url_c", "host_networks", "host_netmask", "host_router", "oob_ip", "oob_netmask", "oob_router", "date_hw_purchase", "date_hw_install", "date_hw_expiry", "date_hw_decomm", "site_address_a", "site_address_b", "site_address_c", "site_city", "site_state", "site_country", "site_zip", "site_rack", "site_notes", "poc_1_name", "poc_1_email", "poc_1_phone_a", "poc_1_phone_b", "poc_1_cell", "poc_1_screen", "poc_1_notes", "poc_2_name", "poc_2_email", "poc_2_phone_a", "poc_2_phone_b", "poc_2_cell", "poc_2_screen", "poc_2_notes"], "data": [ [10084, "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "56.95387", "24.22067", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", ""] ] }, "items": { "fields": ["itemid", "type", "snmp_oid", "hostid", "key_", "delay", "history", "status", "value_type", "trapper_hosts", "logtimefmt", "params", "ipmi_sensor", "authtype", "username", "password", "publickey", "privatekey", "flags", "interfaceid", "inventory_link", "jmx_endpoint", "master_itemid", "timeout", "url", "query_fields", "posts", "status_codes", "follow_redirects", "post_type", "http_proxy", "headers", "retrieve_mode", "request_method", "output_format", "ssl_cert_file", "ssl_key_file", "ssl_key_password", "verify_peer", "verify_host", "allow_traps"], "data": [ [44161, 7, "", 10084, "agent.hostmetadata", "10s", "90d", 0, 1, "", "", "", "", 0, "", "", "", "", 0, null, 0, "", null, "3s", "", "", "", "200", 1, 0, "", "", 0, 0, 0, "", "", "", 0, 0, 0], [44162, 0, "", 10084, "agent.ping", "10s", "90d", 0, 3, "", "", "", "", 0, "", "", "", "", 0, 1, 0, "", null, "3s", "", "", "", "200", 1, 0, "", "", 0, 0, 0, "", "", "", 0, 0, 0] ] }, "item_rtdata": { "fields": ["itemid", "lastlogsize", "mtime"], "data": [ [44161, 0, 0], [44162, 0, 0] ] }, "item_preproc": { "fields": ["item_preprocid", "itemid", "step", "type", "params", "error_handler", "error_handler_params"], "data": [] }, "item_parameter": { "fields": ["item_parameterid", "itemid", "name", "value"], "data": [] }, "globalmacro": { "fields": ["globalmacroid", "macro", "value", "type"], "data": [ [2, "{$SNMP_COMMUNITY}", "public", 0] ] }, "hosts_templates": { "fields": ["hosttemplateid", "hostid", "templateid", "link_type"], "data": [] }, "hostmacro": { "fields": ["hostmacroid", "hostid", "macro", "value", "type", "automatic"], "data": [ [5676, 10084, "{$M}", "AppID=zabbix_server&Query=Safe=passwordSafe;Object=zabbix:Content", 2, 0] ] }, "drules": { "fields": ["druleid", "name", "iprange", "delay"], "data": [ [2, "Local network", "127.0.0.1", "10s"] ] }, "dchecks": { "fields": ["dcheckid", "druleid", "type", "key_", "snmp_community", "ports", "snmpv3_securityname", "snmpv3_securitylevel", "snmpv3_authpassphrase", "snmpv3_privpassphrase", "uniq", "snmpv3_authprotocol", "snmpv3_privprotocol", "snmpv3_contextname", "host_source", "name_source"], "data": [ [2, 2, 9, "system.uname", "", "10052", "", 0, "", "", 0, 0, 0, "", 1, 0] ] }, "regexps": { "fields": ["regexpid", "name"], "data": [ [1, "File systems for discovery"], [2, "Network interfaces for discovery"], [3, "Storage devices for SNMP discovery"], [4, "Windows service names for discovery"], [5, "Windows service startup states for discovery"] ] }, "expressions": { "fields": ["expressionid", "regexpid", "expression", "expression_type", "exp_delimiter", "case_sensitive"], "data": [ [1, 1, "^(btrfs|ext2|ext3|ext4|reiser|xfs|ffs|ufs|jfs|jfs2|vxfs|hfs|apfs|refs|ntfs|fat32|zfs)$", 3, ",", 0], [3, 3, "^(Physical memory|Virtual memory|Memory buffers|Cached memory|Swap space)$", 4, ",", 1], [5, 4, "^(MMCSS|gupdate|SysmonLog|clr_optimization_v2.0.50727_32|clr_optimization_v4.0.30319_32)$", 4, ",", 1], [6, 5, "^(automatic|automatic delayed)$", 3, ",", 1], [7, 2, "^Software Loopback Interface", 4, ",", 1], [8, 2, "^(In)?[Ll]oop[Bb]ack[0-9._]*$", 4, ",", 1], [9, 2, "^NULL[0-9.]*$", 4, ",", 1], [10, 2, "^[Ll]o[0-9.]*$", 4, ",", 1], [11, 2, "^[Ss]ystem$", 4, ",", 1], [12, 2, "^Nu[0-9.]*$", 4, ",", 1] ] }, "config": { "fields": ["configid", "snmptrap_logging", "hk_history_global", "hk_history", "autoreg_tls_accept"], "data": [ [1, 1, 0, "90d", 1] ] }, "httptest": { "fields": ["httptestid", "name", "delay", "agent", "authentication", "http_user", "http_password", "hostid", "http_proxy", "retries", "ssl_cert_file", "ssl_key_file", "ssl_key_password", "verify_peer", "verify_host"], "data": [] }, "httptestitem": { "fields": ["httptestitemid", "httptestid", "itemid", "type"], "data": [] }, "httptest_field": { "fields": ["httptest_fieldid", "httptestid", "type", "name", "value"], "data": [] }, "httpstep": { "fields": ["httpstepid", "httptestid", "name", "no", "url", "timeout", "posts", "required", "status_codes", "follow_redirects", "retrieve_mode", "post_type"], "data": [] }, "httpstepitem": { "fields": ["httpstepitemid", "httpstepid", "itemid", "type"], "data": [] }, "httpstep_field": { "fields": ["httpstep_fieldid", "httpstepid", "type", "name", "value"], "data": [] }, "config_autoreg_tls": { "fields": ["autoreg_tlsid", "tls_psk_identity", "tls_psk"], "data": [ [1, "", ""] ] } }, "macro.secrets": { "AppID=zabbix_server&Query=Safe=passwordSafe;Object=zabbix": { "Content": "738" } }, "config_revision": 2 } ``` proxy→server: ```{.javascript} { "response": "success", "version": "7.0.0" } ``` ##### Konfigurācijas pieprasījums Serveris vispirms nosūtīs tukšu `proxy config` pieprasījumu. Šis pieprasījums tiek nosūtīts ik pēc `ProxyConfigFrequency` (servera konfigurācijas parametra) sekundēm. Starpniekserveris atbild ar pašreizējo starpniekservera versiju, sesijas marķieri un konfigurācijas revīziju. Serveris atbild ar konfigurācijas datiem, kas ir jāatjaunina. | name | < | < | < | < | value type | description | |-|-|-|-|----------|----------|----------------------------------------| | server→proxy: | < | < | < | < | < | < | | **request** | < | < | < | < | *string* | 'proxy config' | | |<|<|<|<|<|<| | proxy→server: | < | < | < | < | < | < | | **version** | < | < | < | < | *string* | Starpniekservera versija (\<major>.\<minor>.\<build>). | | **session** | < | < | < | < | *string* | Starpniekservera konfigurācijas sesijas marķieris. | | **config_revision** | < | < | < | < | *number* | Starpniekservera konfigurācijas revīzija. | | |<|<|<|<|<|<| | server→proxy: | < | < | < | < | < | < | | **full_sync** | < | < | < | < | *number* | 1 - ja tiek nosūtīti pilni konfigurācijas dati; citādi nav norādīts (neobligāti). | | **data** | < | < | < | < | *array* | Tabulas datu objekts. Nav norādīts, ja konfigurācija nav mainīta (neobligāti). | | | **\<table>** | < | < | < | *object* | Viens vai vairāki objekti ar \<table> datiem (neobligāti, atkarībā no izmaiņām). | | ^ | | **fields** | < | < | *array* | Lauku nosaukumu masīvs. | | ^ | ^ | | - | < | *string* | Lauka nosaukums. | | ^ | ^ | **data** | < | < | *array* | Rindu masīvs. | | ^ | ^ | | - | < | *array* | Kolonnu masīvs. | | ^ | ^ | ^ | | - | *string*,*number* | Kolonnas vērtība ar tipu, kas atkarīgs no kolonnas tipa datubāzes shēmā. | | | < | < | < | < | < | < | | **macro.secrets** | < | < | < | < | *object* | Slepeno makro informācija, nav norādīts, ja vault makro nav izmaiņu (neobligāti). | | **config_revision** | < | < | < | < | *number* | Konfigurācijas kešatmiņas revīzija - tiek nosūtīta kopā ar konfigurācijas datiem (neobligāti). | | **del_hostids** | < | < | < | < | *array* | Noņemto hostid masīvs (neobligāti). | | | - | < | < | < | *number* | Host identifikators. | | **del_macro_hostids** | < | < | < | < | *array* | Hostid masīvs, kuriem ir noņemti visi makro (neobligāti). | | | - | < | < | < | *number* | Host identifikators. | | | < | < | < | < | < | < | | proxy→server: | < | < | < | < | < | < | | **response** | < | < | < | < | *string* | Pieprasījuma izpildes informācija ('success' vai 'failed'). | | **version** | < | < | < | < | *string* | Starpniekservera versija (\<major>.\<minor>.\<build>). | Piemērs: server→proxy: ```{.javascript} { "request":"proxy config" } ``` proxy→server: ```{.javascript} { "version": "7.0.0", "session": "0033124949800811e5686dbfd9bcea98", "config_revision": 0 } ``` server→proxy: ```{.javascript} { "full_sync": 1, "data": { "hosts": { "fields": ["hostid", "host", "status", "ipmi_authtype", "ipmi_privilege", "ipmi_username", "ipmi_password", "name", "tls_connect", "tls_accept", "tls_issuer", "tls_subject", "tls_psk_identity", "tls_psk"], "data": [ [10084, "Zabbix server", 0, -1, 2, "", "", "Zabbix server", 1, 1, "", "", "", ""] ] }, "interface": { "fields": ["interfaceid", "hostid", "main", "type", "useip", "ip", "dns", "port", "available"], "data": [ [1, 10084, 1, 1, 1, "127.0.0.1", "", "10053", 1] ] }, "interface_snmp": { "fields": ["interfaceid", "version", "bulk", "community", "securityname", "securitylevel", "authpassphrase", "privpassphrase", "authprotocol", "privprotocol", "contextname"], "data": [] }, "host_inventory": { "fields": ["hostid", "type", "type_full", "name", "alias", "os", "os_full", "os_short", "serialno_a", "serialno_b", "tag", "asset_tag", "macaddress_a", "macaddress_b", "hardware", "hardware_full", "software", "software_full", "software_app_a", "software_app_b", "software_app_c", "software_app_d", "software_app_e", "contact", "location", "location_lat", "location_lon", "notes", "chassis", "model", "hw_arch", "vendor", "contract_number", "installer_name", "deployment_status", "url_a", "url_b", "url_c", "host_networks", "host_netmask", "host_router", "oob_ip", "oob_netmask", "oob_router", "date_hw_purchase", "date_hw_install", "date_hw_expiry", "date_hw_decomm", "site_address_a", "site_address_b", "site_address_c", "site_city", "site_state", "site_country", "site_zip", "site_rack", "site_notes", "poc_1_name", "poc_1_email", "poc_1_phone_a", "poc_1_phone_b", "poc_1_cell", "poc_1_screen", "poc_1_notes", "poc_2_name", "poc_2_email", "poc_2_phone_a", "poc_2_phone_b", "poc_2_cell", "poc_2_screen", "poc_2_notes"], "data": [ [10084, "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "56.95387", "24.22067", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", ""] ] }, "items": { "fields": ["itemid", "type", "snmp_oid", "hostid", "key_", "delay", "history", "status", "value_type", "trapper_hosts", "logtimefmt", "params", "ipmi_sensor", "authtype", "username", "password", "publickey", "privatekey", "flags", "interfaceid", "inventory_link", "jmx_endpoint", "master_itemid", "timeout", "url", "query_fields", "posts", "status_codes", "follow_redirects", "post_type", "http_proxy", "headers", "retrieve_mode", "request_method", "output_format", "ssl_cert_file", "ssl_key_file", "ssl_key_password", "verify_peer", "verify_host", "allow_traps"], "data": [ [44161, 7, "", 10084, "agent.hostmetadata", "10s", "90d", 0, 1, "", "", "", "", 0, "", "", "", "", 0, null, 0, "", null, "3s", "", "", "", "200", 1, 0, "", "", 0, 0, 0, "", "", "", 0, 0, 0], [44162, 0, "", 10084, "agent.ping", "10s", "90d", 0, 3, "", "", "", "", 0, "", "", "", "", 0, 1, 0, "", null, "3s", "", "", "", "200", 1, 0, "", "", 0, 0, 0, "", "", "", 0, 0, 0] ] }, "item_rtdata": { "fields": ["itemid", "lastlogsize", "mtime"], "data": [ [44161, 0, 0], [44162, 0, 0] ] }, "item_preproc": { "fields": ["item_preprocid", "itemid", "step", "type", "params", "error_handler", "error_handler_params"], "data": [] }, "item_parameter": { "fields": ["item_parameterid", "itemid", "name", "value"], "data": [] }, "globalmacro": { "fields": ["globalmacroid", "macro", "value", "type"], "data": [ [2, "{$SNMP_COMMUNITY}", "public", 0] ] }, "hosts_templates": { "fields": ["hosttemplateid", "hostid", "templateid", "link_type"], "data": [] }, "hostmacro": { "fields": ["hostmacroid", "hostid", "macro", "value", "type", "automatic"], "data": [ [5676, 10084, "{$M}", "AppID=zabbix_server&Query=Safe=passwordSafe;Object=zabbix:Content", 2, 0] ] }, "drules": { "fields": ["druleid", "name", "iprange", "delay"], "data": [ [2, "Local network", "127.0.0.1", "10s"] ] }, "dchecks": { "fields": ["dcheckid", "druleid", "type", "key_", "snmp_community", "ports", "snmpv3_securityname", "snmpv3_securitylevel", "snmpv3_authpassphrase", "snmpv3_privpassphrase", "uniq", "snmpv3_authprotocol", "snmpv3_privprotocol", "snmpv3_contextname", "host_source", "name_source"], "data": [ [2, 2, 9, "system.uname", "", "10052", "", 0, "", "", 0, 0, 0, "", 1, 0] ] }, "regexps": { "fields": ["regexpid", "name"], "data": [ [1, "File systems for discovery"], [2, "Network interfaces for discovery"], [3, "Storage devices for SNMP discovery"], [4, "Windows service names for discovery"], [5, "Windows service startup states for discovery"] ] }, "expressions": { "fields": ["expressionid", "regexpid", "expression", "expression_type", "exp_delimiter", "case_sensitive"], "data": [ [1, 1, "^(btrfs|ext2|ext3|ext4|reiser|xfs|ffs|ufs|jfs|jfs2|vxfs|hfs|apfs|refs|ntfs|fat32|zfs)$", 3, ",", 0], [3, 3, "^(Physical memory|Virtual memory|Memory buffers|Cached memory|Swap space)$", 4, ",", 1], [5, 4, "^(MMCSS|gupdate|SysmonLog|clr_optimization_v2.0.50727_32|clr_optimization_v4.0.30319_32)$", 4, ",", 1], [6, 5, "^(automatic|automatic delayed)$", 3, ",", 1], [7, 2, "^Software Loopback Interface", 4, ",", 1], [8, 2, "^(In)?[Ll]oop[Bb]ack[0-9._]*$", 4, ",", 1], [9, 2, "^NULL[0-9.]*$", 4, ",", 1], [10, 2, "^[Ll]o[0-9.]*$", 4, ",", 1], [11, 2, "^[Ss]ystem$", 4, ",", 1], [12, 2, "^Nu[0-9.]*$", 4, ",", 1] ] }, "config": { "fields": ["configid", "snmptrap_logging", "hk_history_global", "hk_history", "autoreg_tls_accept"], "data": [ [1, 1, 0, "90d", 1] ] }, "httptest": { "fields": ["httptestid", "name", "delay", "agent", "authentication", "http_user", "http_password", "hostid", "http_proxy", "retries", "ssl_cert_file", "ssl_key_file", "ssl_key_password", "verify_peer", "verify_host"], "data": [] }, "httptestitem": { "fields": ["httptestitemid", "httptestid", "itemid", "type"], "data": [] }, "httptest_field": { "fields": ["httptest_fieldid", "httptestid", "type", "name", "value"], "data": [] }, "httpstep": { "fields": ["httpstepid", "httptestid", "name", "no", "url", "timeout", "posts", "required", "status_codes", "follow_redirects", "retrieve_mode", "post_type"], "data": [] }, "httpstepitem": { "fields": ["httpstepitemid", "httpstepid", "itemid", "type"], "data": [] }, "httpstep_field": { "fields": ["httpstep_fieldid", "httpstepid", "type", "name", "value"], "data": [] }, "config_autoreg_tls": { "fields": ["autoreg_tlsid", "tls_psk_identity", "tls_psk"], "data": [ [1, "", ""] ] } }, "macro.secrets": { "AppID=zabbix_server&Query=Safe=passwordSafe;Object=zabbix": { "Content": "738" } }, "config_revision": 2 } ``` proxy→server: ```{.javascript} { "response": "success", "version": "7.0.0" } ``` ##### Configuration Specify fping location in the *[FpingLocation](/manual/appendix/config/zabbix_server#fpinglocation)* parameter of Zabbix server/proxy configuration file (or *[Fping6Location](/manual/appendix/config/zabbix_server#fping6location)* parameter for using IPv6 addresses). fping should be executable by the user Zabbix server/proxy run as and this user should have sufficient rights. See also: [Known issues](/manual/installation/known_issues#simple-checks) for processing simple checks with fping versions below 3.10. ##### Konfigurācija Norādiet fping atrašanās vietu Zabbix servera/starpniekservera konfigurācijas faila *[FpingLocation](/manual/appendix/config/zabbix_server#fpinglocation)* parametrā (vai *[Fping6Location](/manual/appendix/config/zabbix_server#fping6location)* parametrā, ja tiek izmantotas IPv6 adreses). fping jābūt izpildāmam lietotājam, ar kuru darbojas Zabbix serveris/starpniekserveris, un šim lietotājam jābūt pietiekamām tiesībām. Skatiet arī: [Known issues](/manual/installation/known_issues#simple-checks) par vienkāršo pārbaužu apstrādi ar fping versijām, kas ir zemākas par 3.10. #### Configuration Tags can be defined in a dedicated tab, for example, in [trigger configuration](/manual/config/triggers/trigger#configuration): {width="600"} #### Konfigurācija Tagus var definēt īpašā cilnē, piemēram, [trigera konfigurācijā](/manual/config/triggers/trigger#configuration): {width="600"} #### Configuration The *Authentication* tab allows to set the default authentication method, specify a group for deprovisioned users and set password complexity requirements for Zabbix users.  Configuration parameters: |Parameter|Description| |--|--------| |*Default authentication*|Select the default authentication method for Zabbix - *Internal* or *LDAP*.| |*Deprovisioned users group*|Specify a user group for deprovisioned users. This setting is required only for JIT provisioning, regarding users that were created in Zabbix from LDAP or SAML systems, but no longer need to be provisioned.<br>A disabled user group must be specified.| |*Minimum password length*|By default, the minimum password length is set to 8. Supported range: 1-70. Note that passwords longer than 72 characters will be truncated.| |*Password must contain*|Mark one or several checkboxes to require usage of specified characters in a password:<br>- an uppercase and a lowercase Latin letter<br>- a digit<br>- a special character<br><br>Hover over the question mark to see a hint with the list of characters for each option.| |*Avoid easy-to-guess passwords*|If marked, a password will be checked against the following requirements:<br>- must not contain user's name, surname, or username<br>- must not be one of the common or context-specific passwords.<br><br>The list of common and context-specific passwords is generated automatically from the list of NCSC "Top 100k passwords", the list of SecLists "Top 1M passwords" and the list of Zabbix context-specific passwords. Internal users will not be allowed to set passwords included in this list as such passwords are considered weak due to their common use.| Changes in password complexity requirements will not affect existing user passwords, but if an existing user chooses to change a password, the new password will have to meet current requirements. A hint with the list of requirements will be displayed next to the *Password* field in the [user profile](/manual/web_interface/user_profile) and in the [user configuration form](/manual/config/users_and_usergroups/user) accessible from the *Users → Users* menu. #### Konfigurācija Cilne *Autentifikācija* ļauj iestatīt noklusējuma autentifikācijas metodi, norādīt grupu deprovisionētiem lietotājiem un iestatīt paroles sarežģītības prasības Zabbix lietotājiem.  Konfigurācijas parametri: |Parametrs|Apraksts| |--|--------| |*Noklusējuma autentifikācija*|Izvēlieties noklusējuma autentifikācijas metodi Zabbix sistēmā — *Iekšējā* vai *LDAP*.| |*Deprovisionēto lietotāju grupa*|Norādiet lietotāju grupu deprovisionētiem lietotājiem. Šis iestatījums ir nepieciešams tikai JIT provisionēšanai attiecībā uz lietotājiem, kas tika izveidoti Zabbix no LDAP vai SAML sistēmām, bet kuri vairs nav jāprovisionē.<br>Jānorāda atspējota lietotāju grupa.| |*Minimālais paroles garums*|Pēc noklusējuma minimālais paroles garums ir iestatīts uz 8. Atbalstītais diapazons: 1-70. Ņemiet vērā, ka paroles, kas garākas par 72 rakstzīmēm, tiks saīsinātas.| |*Parolei jāsatur*|Atzīmējiet vienu vai vairākas izvēles rūtiņas, lai pieprasītu noteiktu rakstzīmju izmantošanu parolē:<br>- lielais un mazais latīņu alfabēta burts<br>- cipars<br>- speciālā rakstzīme<br><br>Novietojiet kursoru virs jautājuma zīmes, lai redzētu paskaidrojumu ar katras opcijas rakstzīmju sarakstu.| |*Izvairīties no viegli uzminamām parolēm*|Ja atzīmēts, parole tiks pārbaudīta atbilstoši šādām prasībām:<br>- tā nedrīkst saturēt lietotāja vārdu, uzvārdu vai lietotājvārdu<br>- tā nedrīkst būt viena no bieži lietotajām vai kontekstam specifiskajām parolēm.<br><br>Bieži lietoto un kontekstam specifisko paroļu saraksts tiek ģenerēts automātiski no NCSC "Top 100k passwords" saraksta, SecLists "Top 1M passwords" saraksta un Zabbix kontekstam specifisko paroļu saraksta. Iekšējiem lietotājiem nebūs atļauts iestatīt paroles, kas ir iekļautas šajā sarakstā, jo šādas paroles tiek uzskatītas par vājām to plašās lietošanas dēļ.| Izmaiņas paroles sarežģītības prasībās neietekmēs esošās lietotāju paroles, taču, ja esošs lietotājs izvēlēsies mainīt paroli, jaunajai parolei būs jāatbilst pašreizējām prasībām. Paskaidrojums ar prasību sarakstu tiks parādīts blakus laukam *Parole* [user profile](/manual/web_interface/user_profile) un [lietotāja konfigurācijas veidlapā](/manual/config/users_and_usergroups/user), kas pieejama izvēlnē *Users → Users*. #### Configuration The following steps are required to configure data streaming to an external system: 1\. Have a remote system set up for receiving data from Zabbix. For this purpose, the following tools are available: - An example of a simple [receiver](https://git.zabbix.com/projects/ZT/repos/receiver/browse) that logs the received information in `events.ndjson` and `history.ndjson` files. - [Kafka connector for Zabbix server](https://git.zabbix.com/projects/ZT/repos/kafka-connector/browse) - a lightweight server written in Go, designed to forward item values and events from a Zabbix server to a Kafka broker. 2\. Set the required number of connector workers in Zabbix by adjusting the [`StartConnectors`](/manual/appendix/config/zabbix_server#startconnectors) parameter in `zabbix_server.conf`. The number of connector workers should match (or exceed if concurrent sessions are more than 1) the configured connector count in Zabbix frontend. Then, restart Zabbix server. 3\. Configure a new connector in Zabbix frontend (*Administration* > *General* > *Connectors*) and reload the server cache with the `zabbix_server -R config_cache_reload` command. {width="600"} Mandatory fields are marked by an asterisk. |Parameter|Description| |--|--------| |*Name*|Enter the connector name.| |*Data type*|Select the data type to stream:<br>**Item values** - stream item values from Zabbix to external systems;<br>**Events** - stream events from Zabbix to external systems.| |*URL*|Enter the receiver URL. User macros are supported.| |*Tag filter*|Export only item values or events matching the tag filter. If not set, then export everything.<br>It is possible to include as well as exclude specific tags and tag values. Several conditions can be set. Tag name matching is always case-sensitive.<br><br>There are several operators available for each condition:<br>**Exists** - include the specified tag names;<br>**Equals** - include the specified tag names and values (case-sensitive);<br>**Contains** - include the specified tag names where the tag values contain the entered string (substring match, case-insensitive);<br>**Does not exist** - exclude the specified tag names;<br>**Does not equal** - exclude the specified tag names and values (case-sensitive);<br>**Does not contain** - exclude the specified tag names where the tag values contain the entered string (substring match, case-insensitive).<br><br>There are two calculation types for conditions:<br>**And/Or** - all conditions must be met, conditions having the same tag name will be grouped by the Or condition;<br>**Or** - enough if one condition is met.| |*Type of information*|Select the type of information (numeric (unsigned), numeric (float), character, etc.), by which to filter the item values that the connector should stream.<br>This field is available if *Data type* is set to "Item values".| |*HTTP authentication*|Select the authentication option:<br>**None** - no authentication used;<br>**Basic** - basic authentication is used;<br>**NTLM** - NTLM ([Windows NT LAN Manager](http://en.wikipedia.org/wiki/NTLM)) authentication is used;<br>**Kerberos** - Kerberos authentication is used (see also: [Configuring Kerberos with Zabbix](/manual/appendix/items/kerberos));<br>**Digest** - Digest authentication is used;<br>**Bearer** - Bearer authentication is used.| |*Username*|Enter the user name (up to 255 characters). User macros are supported.<br>This field is available if *HTTP authentication* is set to "Basic", "NTLM", "Kerberos", or "Digest".| |*Password*|Enter the user password (up to 255 characters). User macros are supported.<br>This field is available if *HTTP authentication* is set to "Basic", "NTLM", "Kerberos", or "Digest".| |*Bearer token*|Enter the Bearer token. User macros are supported.<br>This field is available and required if *HTTP authentication* is set to "Bearer".| |*Advanced configuration*|Click the *Advanced configuration* header to display advanced configuration options (see below).| |*Max records per message*|Specify the maximum number of values or events that can be streamed within one message.| |*Concurrent sessions*|Select the number of sender processes to run for this connector. Up to 100 sessions can be specified; the default value is "1".| |*Attempts*|Number of attempts for streaming data. Up to 5 attempts can be specified; the default value is "1".| |*Attempt interval*|Specify how long the connector should wait after an unsuccessful attempt to stream data. Up to 10s can be specified; the default value is "5s".<br>This field is available if *Attempts* is set to "2" or more.<br>Unsuccessful attempts are those where establishing a connection has failed, or where the HTTP response code is not 200, 201, 202, 203, 204. Retries are **triggered** in case of communication errors or when the HTTP response code is not 200, 201, 202, 203, 204, 400, 401, 403, 404, 405, 415, 422. Redirects are followed, so 302 -> 200 is a positive response; whereas 302 -> 503 will trigger a retry.| |*Timeout*|Specify the message timeout (1-60 seconds, default - 5 seconds).<br>Time suffixes are supported, e.g., 30s, 1m. User macros are supported.| |*HTTP proxy*|You can specify an HTTP proxy to use in the following format:<br>`[protocol://][username[:password]@]proxy.example.com[:port]`<br>User macros are supported.<br><br>The optional `protocol://` prefix may be used to specify alternative proxy protocols (the protocol prefix support was added in cURL 7.21.7). With no protocol specified, the proxy will be treated as an HTTP proxy. By default, 1080 port will be used.<br><br>If *HTTP proxy* is specified, the proxy will overwrite proxy related environment variables like `http_proxy`, `HTTPS_PROXY`. If not specified, the proxy will not overwrite proxy-related environment variables. The entered value is passed on as is, no sanity checking takes place.<br>You may also enter a SOCKS proxy address. If you specify the wrong protocol, the connector will fail to stream item values or events from Zabbix.<br><br>Note that only simple authentication is supported with HTTP proxy.| |*SSL verify peer*|Mark the checkbox to verify the SSL certificate of the web server.<br>The server certificate will be automatically taken from system-wide certificate authority (CA) location. You can override the location of CA files using Zabbix server or proxy configuration parameter [`SSLCALocation`](/manual/appendix/config/zabbix_server#sslcalocation).| |*SSL verify host*|Mark the checkbox to verify that the *Common Name* field or the *Subject Alternate Name* field of the web server certificate matches.<br>This sets the [`CURLOPT_SSL_VERIFYHOST`](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYHOST.html) cURL option.| |*SSL certificate file*|Name of the SSL certificate file used for client authentication. The certificate file must be in PEM^1^ format. User macros are supported.<br>If the certificate file also contains the private key, leave the *SSL key file* field empty. If the key is encrypted, specify the password in the *SSL key password* field. The directory containing this file is specified by Zabbix server or proxy configuration parameter [`SSLCertLocation`](/manual/appendix/config/zabbix_server#sslcertlocation).| |*SSL key file*|Name of the SSL private key file used for client authentication. The private key file must be in PEM^1^ format. User macros are supported.<br>The directory containing this file is specified by Zabbix server or proxy configuration parameter [`SSLKeyLocation`](/manual/appendix/config/zabbix_server#sslkeylocation).| |*SSL key password*|SSL private key file password. User macros are supported.| |*Description*|Enter the connector description.| |*Enabled*|Mark the checkbox to enable the connector.| When the Kafka connector is configured with a comma-separated list of bootstrap broker addresses (for example `Kafka.URL=kafka1.example.com:9093,kafka2.example.com:9093`), the Kafka client connects to the broker(s) that respond first and uses their cluster metadata. If the list contains addresses from different Kafka clusters, only the fastest-responding cluster will be used and other addresses will be logged as unavailable; as a result, startup warnings such as the following may appear even though the connector is connected: ```default kafka cluster connected, but broker(s) "kafka1.example.com:9093, kafka2.example.com:9093" unavailable; will retry on message send if active brokers fail ``` In some environments (private networks, container networks or non-standard DNS/hosts setups) hostnames or IPs may resolve to loopback addresses (for example `127.0.0.1`/`localhost`) or be normalized by the client, which can make such warnings misleading. To reduce confusion, ensure all `Kafka.URL` addresses belong to the same Kafka cluster, verify DNS resolution from the connector host and the brokers' `advertised.listeners`, and prefer addresses that resolve to the broker's advertised address. #### Konfigurācija Lai konfigurētu datu straumēšanu uz ārējo sistēmu, ir jāveic šādas darbības: 1\. Sagatavojiet attālo sistēmu datu saņemšanai no Zabbix. Šim nolūkam ir pieejami šādi rīki: - Vienkārša [saņēmēja](https://git.zabbix.com/projects/ZT/repos/receiver/browse) piemērs, kas saņemto informāciju reģistrē `events.ndjson` un `history.ndjson` failos. - [Kafka savienotājs Zabbix serverim](https://git.zabbix.com/projects/ZT/repos/kafka-connector/browse) - viegls Go valodā rakstīts serveris, kas paredzēts vienums vērtību un notikumu pārsūtīšanai no Zabbix serveris uz Kafka brokeri. 2\. Iestatiet nepieciešamo savienotāja darba procesu skaitu Zabbix, pielāgojot [`StartConnectors`](/manual/appendix/config/zabbix_server#startconnectors) parametru failā `zabbix_server.conf`. Savienotāja darba procesu skaitam jāatbilst (vai jābūt lielākam, ja vienlaicīgo sesiju skaits ir lielāks par 1) Zabbix lietotāja saskarne konfigurētajam savienotāju skaitam. Pēc tam restartējiet Zabbix serveris. 3\. Zabbix lietotāja saskarne konfigurējiet jaunu savienotāju (*Administration* > *General* > *Connectors*) un pārlādējiet servera kešatmiņu ar komandu `zabbix_server -R config_cache_reload`. {width="600"} Obligātie lauki ir atzīmēti ar zvaigznīti. |Parameter|Description| |--|--------| |*Name*|Ievadiet savienotāja nosaukumu.| |*Data type*|Atlasiet straumējamo datu tipu:<br>**Item values** - straumēt vienums vērtības no Zabbix uz ārējām sistēmām;<br>**Events** - straumēt notikumus no Zabbix uz ārējām sistēmām.| |*URL*|Ievadiet saņēmēja URL. Tiek atbalstīti lietotāja makrosi.| |*Tag filter*|Eksportēt tikai vienums vērtības vai notikumus, kas atbilst tagu filtram. Ja tas nav iestatīts, tiks eksportēts viss.<br>Iespējams gan iekļaut, gan izslēgt konkrētus tagus un tagu vērtības. Var iestatīt vairākus nosacījumus. Tagu nosaukumu salīdzināšana vienmēr ir reģistrjutīga.<br><br>Katram nosacījumam ir pieejami vairāki operatori:<br>**Exists** - iekļaut norādītos tagu nosaukumus;<br>**Equals** - iekļaut norādītos tagu nosaukumus un vērtības (reģistrjutīgi);<br>**Contains** - iekļaut norādītos tagu nosaukumus, kuru tagu vērtības satur ievadīto virkni (apakšvirknes atbilstība, nereģistrjutīgi);<br>**Does not exist** - izslēgt norādītos tagu nosaukumus;<br>**Does not equal** - izslēgt norādītos tagu nosaukumus un vērtības (reģistrjutīgi);<br>**Does not contain** - izslēgt norādītos tagu nosaukumus, kuru tagu vērtības satur ievadīto virkni (apakšvirknes atbilstība, nereģistrjutīgi).<br><br>Nosacījumiem ir pieejami divi aprēķina tipi:<br>**And/Or** - jāizpildās visiem nosacījumiem, nosacījumi ar vienādu taga nosaukumu tiks grupēti pēc Or nosacījuma;<br>**Or** - pietiek, ja izpildās viens nosacījums.| |*Type of information*|Atlasiet informācijas tipu (numeric (unsigned), numeric (float), character u. c.), pēc kura filtrēt vienums vērtības, kuras savienotājam jāstraumē.<br>Šis lauks ir pieejams, ja *Data type* ir iestatīts uz "Item values".| |*HTTP authentication*|Atlasiet autentifikācijas opciju:<br>**None** - autentifikācija netiek izmantota;<br>**Basic** - tiek izmantota pamata autentifikācija;<br>**NTLM** - tiek izmantota NTLM ([Windows NT LAN Manager](http://en.wikipedia.org/wiki/NTLM)) autentifikācija;<br>**Kerberos** - tiek izmantota Kerberos autentifikācija (skatiet arī: [Kerberos konfigurēšana ar Zabbix](/manual/appendix/items/kerberos));<br>**Digest** - tiek izmantota Digest autentifikācija;<br>**Bearer** - tiek izmantota Bearer autentifikācija.| |*Username*|Ievadiet lietotājvārdu (līdz 255 rakstzīmēm). Tiek atbalstīti lietotāja makrosi.<br>Šis lauks ir pieejams, ja *HTTP authentication* ir iestatīts uz "Basic", "NTLM", "Kerberos" vai "Digest".| |*Password*|Ievadiet lietotāja paroli (līdz 255 rakstzīmēm). Tiek atbalstīti lietotāja makrosi.<br>Šis lauks ir pieejams, ja *HTTP authentication* ir iestatīts uz "Basic", "NTLM", "Kerberos" vai "Digest".| |*Bearer token*|Ievadiet Bearer tokenu. Tiek atbalstīti lietotāja makrosi.<br>Šis lauks ir pieejams un obligāts, ja *HTTP authentication* ir iestatīts uz "Bearer".| |*Advanced configuration*|Noklikšķiniet uz virsraksta *Advanced configuration*, lai parādītu papildu konfigurācijas opcijas (skatiet tālāk).| |*Max records per message*|Norādiet maksimālo vērtību vai notikumu skaitu, ko var straumēt vienā ziņojumā.| |*Concurrent sessions*|Atlasiet sūtītāja procesu skaitu, kas jāpalaiž šim savienotājam. Var norādīt līdz 100 sesijām; noklusējuma vērtība ir "1".| |*Attempts*|Datu straumēšanas mēģinājumu skaits. Var norādīt līdz 5 mēģinājumiem; noklusējuma vērtība ir "1".| |*Attempt interval*|Norādiet, cik ilgi savienotājam jāgaida pēc neveiksmīga datu straumēšanas mēģinājuma. Var norādīt līdz 10 s; noklusējuma vērtība ir "5s".<br>Šis lauks ir pieejams, ja *Attempts* ir iestatīts uz "2" vai vairāk.<br>Neveiksmīgi mēģinājumi ir tie, kuros neizdevās izveidot savienojumu vai HTTP atbildes kods nav 200, 201, 202, 203, 204. Atkārtoti mēģinājumi tiek **aktivizēti** saziņas kļūdu gadījumā vai tad, ja HTTP atbildes kods nav 200, 201, 202, 203, 204, 400, 401, 403, 404, 405, 415, 422. Pāradresācijas tiek sekotas, tāpēc 302 -> 200 ir pozitīva atbilde; savukārt 302 -> 503 aktivizēs atkārtotu mēģinājumu.| |*Timeout*|Norādiet ziņojuma noildzi (1-60 sekundes, noklusējums - 5 sekundes).<br>Tiek atbalstīti laika sufiksi, piemēram, 30s, 1m. Tiek atbalstīti lietotāja makrosi.| |*HTTP proxy*|Varat norādīt HTTP starpniekserveri šādā formātā:<br>`[protocol://][username[:password]@]proxy.example.com[:port]`<br>Tiek atbalstīti lietotāja makrosi.<br><br>Neobligāto prefiksu `protocol://` var izmantot, lai norādītu alternatīvus starpniekservera protokolus (protokola prefiksa atbalsts tika pievienots cURL 7.21.7). Ja protokols nav norādīts, starpniekserveris tiks uzskatīts par HTTP starpniekserveri. Pēc noklusējuma tiks izmantots 1080 ports.<br><br>Ja *HTTP proxy* ir norādīts, starpniekserveris pārrakstīs ar starpniekserveri saistītās vides mainīgās, piemēram, `http_proxy`, `HTTPS_PROXY`. Ja tas nav norādīts, starpniekserveris nepārrakstīs ar starpniekserveri saistītās vides mainīgās. Ievadītā vērtība tiek nodota tālāk bez izmaiņām, netiek veikta nekāda pārbaude.<br>Varat arī ievadīt SOCKS starpniekservera adresi. Ja norādīsiet nepareizu protokolu, savienotājs nespēs straumēt vienums vērtības vai notikumus no Zabbix.<br><br>Ņemiet vērā, ka ar HTTP starpniekserveri tiek atbalstīta tikai vienkāršā autentifikācija.| |*SSL verify peer*|Atzīmējiet izvēles rūtiņu, lai pārbaudītu tīmekļa servera SSL sertifikātu.<br>Servera sertifikāts tiks automātiski ņemts no sistēmas mēroga sertifikātu autoritātes (CA) atrašanās vietas. CA failu atrašanās vietu var pārrakstīt, izmantojot Zabbix serveris vai starpniekserveris konfigurācijas parametru [`SSLCALocation`](/manual/appendix/config/zabbix_server#sslcalocation).| |*SSL verify host*|Atzīmējiet izvēles rūtiņu, lai pārbaudītu, vai tīmekļa servera sertifikāta lauks *Common Name* vai *Subject Alternate Name* atbilst.<br>Tas iestata cURL opciju [`CURLOPT_SSL_VERIFYHOST`](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYHOST.html).| |*SSL certificate file*|SSL sertifikāta faila nosaukums, ko izmanto klienta autentifikācijai. Sertifikāta failam jābūt PEM^1^ formātā. Tiek atbalstīti lietotāja makrosi.<br>Ja sertifikāta fails satur arī privāto atslēgu, atstājiet lauku *SSL key file* tukšu. Ja atslēga ir šifrēta, norādiet paroli laukā *SSL key password*. Mapes, kurā atrodas šis fails, atrašanās vietu norāda Zabbix serveris vai starpniekserveris konfigurācijas parametrs [`SSLCertLocation`](/manual/appendix/config/zabbix_server#sslcertlocation).| |*SSL key file*|SSL privātās atslēgas faila nosaukums, ko izmanto klienta autentifikācijai. Privātās atslēgas failam jābūt PEM^1^ formātā. Tiek atbalstīti lietotāja makrosi.<br>Mapes, kurā atrodas šis fails, atrašanās vietu norāda Zabbix serveris vai starpniekserveris konfigurācijas parametrs [`SSLKeyLocation`](/manual/appendix/config/zabbix_server#sslkeylocation).| |*SSL key password*|SSL privātās atslēgas faila parole. Tiek atbalstīti lietotāja makrosi.| |*Description*|Ievadiet savienotāja aprakstu.| |*Enabled*|Atzīmējiet izvēles rūtiņu, lai iespējotu savienotāju.| Ja Kafka savienotājs ir konfigurēts ar ar komatiem atdalītu bootstrap brokeru adrešu sarakstu (piemēram, `Kafka.URL=kafka1.example.com:9093,kafka2.example.com:9093`), Kafka klients izveido savienojumu ar brokeri(-iem), kas atbild vispirms, un izmanto to klastera metadatus. Ja sarakstā ir adreses no dažādiem Kafka klasteriem, tiks izmantots tikai ātrāk atbildējušais klasteris, bet pārējās adreses tiks reģistrētas kā nepieejamas; tā rezultātā var parādīties tādi startēšanas brīdinājumi kā šis, pat ja savienotājs ir pieslēgts: ```default kafka cluster connected, but broker(s) "kafka1.example.com:9093, kafka2.example.com:9093" unavailable; will retry on message send if active brokers fail ``` Dažās vidēs (privātos tīklos, konteineru tīklos vai nestandarta DNS/hosts iestatījumos) hostu nosaukumi vai IP adreses var tikt atrisinātas uz loopback adresēm (piemēram, `127.0.0.1`/`localhost`) vai arī klients tās var normalizēt, kas var padarīt šādus brīdinājumus maldinošus. Lai mazinātu neskaidrības, pārliecinieties, ka visas `Kafka.URL` adreses pieder vienam un tam pašam Kafka klasterim, pārbaudiet DNS atrisināšanu no savienotāja hosta un brokeru `advertised.listeners`, kā arī dodiet priekšroku adresēm, kas atrisinās uz brokera reklamēto adresi. #### Configuration The global time zone: - can be set manually when [installing](/manual/installation/frontend) the frontend - can be modified in *Administration* → *General* → *[GUI](/manual/web_interface/frontend_sections/administration/general#gui)* User-level time zone: - can be set when [configuring/updating](/manual/config/users_and_usergroups/user#general-attributes) a user - can be set by each user in their [user profile](/manual/web_interface/user_profile#user-profile) **See also:** Aligning time zones when using [scheduling intervals](/manual/config/items/item/custom_intervals#aligning-time-zones-for-proxies-and-agent). #### Konfigurācija Globālā laika josla: - var tikt iestatīta manuāli, [instalējot](/manual/installation/frontend) lietotāja saskarni - var tikt mainīta sadaļā *Administrēšana* → *Vispārīgi* → *[GUI](/manual/web_interface/frontend_sections/administration/general#gui)* Lietotāja līmeņa laika josla: - var tikt iestatīta, [konfigurējot/atjauninot](/manual/config/users_and_usergroups/user#general-attributes) lietotāju - katrs lietotājs to var iestatīt savā [lietotāja profilā](/manual/web_interface/user_profile#user-profile) **Skatiet arī:** Laika joslu saskaņošana, izmantojot [plānošanas intervālus](/manual/config/items/item/custom_intervals#aligning-time-zones-for-proxies-and-agent). #### Configuration The **Host** tab contains general host attributes:  All mandatory input fields are marked with a red asterisk. |Parameter|<|Description| |-|----------|----------------------------------------| |*Host name*|<|Enter a unique host name. Alphanumerics, spaces, dots, dashes and underscores are allowed. However, leading and trailing spaces are disallowed.<br>*Note:* With Zabbix agent running on the host you are configuring, the agent [configuration file](/manual/appendix/config/zabbix_agentd) parameter *Hostname* must have the same value as the host name entered here. The name in the parameter is needed in the processing of [active checks](/manual/appendix/items/activepassive).| |*Visible name*|<|Enter a unique visible name for the host. If you set this name, it will be the one visible in lists, maps, etc instead of the technical host name. This attribute has UTF-8 support.| |*Templates*|<|Link [templates](/manual/config/templates) to the host. All entities (items, triggers, [etc.](/manual/config/templates/linking)) will be inherited from the template.<br>To link a new template, start typing the template name in the text input field. A list of matching templates will appear; scroll down to select. Alternatively, you may click on *Select* next to the field and select templates from the list in a popup window. All selected templates will be linked to the host when the host configuration form is saved or updated.<br>To unlink a template, use one of the two options in the *Linked templates* block:<br>*Unlink* - unlink the template, but preserve its entities (items, triggers, [etc.](/manual/config/templates/linking));<br>*Unlink and clear* - unlink the template and remove all its entities (items, triggers, [etc.](/manual/config/templates/linking)).<br>Listed template names are clickable links leading to the template configuration form.| |*Host groups*|<|Select [host groups](/manual/config/hosts/host_groups) the host belongs to. A host must belong to at least one host group. A new group can be created and linked to the host by adding a non-existing group name.| |*Interfaces*|<|Several host interface types are supported for a host: *Agent*, *SNMP*, *JMX* and *IPMI*.<br>No interfaces are defined by default. To add a new interface, click on *Add* in the *Interfaces* block, select the interface type and enter *IP/DNS*, *Connect to* and *Port* info.<br>*Note:* Interfaces that are used in any items cannot be removed and link *Remove* is grayed out for them.<br>The "IP" or "DNS" from an SNMP interface is also used for [SNMP traps](/manual/config/items/itemtypes/snmptrap).<br>During matching, only the selected "IP" or "DNS" in the host interface is used.<br>See [Configuring SNMP monitoring](/manual/config/items/itemtypes/snmp#configuring-snmp-monitoring) for additional details on configuring an SNMP interface (v1, v2 and v3).| | |*IP address*|Host IP address (optional).| |^|*DNS name*|Host DNS name (optional).| |^|*Connect to*|Clicking the respective button will tell Zabbix server what to use to retrieve data from agents:<br>**IP** - Connect to the host IP address (recommended)<br>**DNS** - Connect to the host DNS name| |^|*Port*|TCP/UDP port number. Default values are: 10050 for Zabbix agent, 161 for SNMP agent, 12345 for JMX and 623 for IPMI.| |^|*Default*|Check the radio button to set the default interface.| |*Description*|<|Enter the host description.| |*Monitored by*|<|Select if the host is monitored by:<br>**Server** - host is monitored by Zabbix server;<br>**Proxy** - host is monitored by standalone proxy;<br>**Proxy group** - host is monitored by proxy group.| |*Proxy*|<|The assigned proxy name is displayed (only if Zabbix server has assigned one from the selected proxy group).<br>This field is displayed only if the host is monitored by a proxy group.| |*Enabled*|<|When the checkbox is checked, the host is enabled - ready for monitoring.<br><br>When the checkbox is unchecked, the host is disabled - not monitored:<br>For passive data requests initiated by Zabbix server/proxy (for example, [Zabbix agent](/manual/appendix/items/activepassive#passive-checks), [SNMP agent](/manual/config/items/itemtypes/snmp), [simple checks](/manual/config/items/itemtypes/simple_checks)), monitoring is disabled after configuration synchronization. Triggers and actions linked to the host are also disabled only after the configuration is reloaded.<br>For Zabbix agent [active checks](/manual/appendix/items/activepassive#active-checks), monitoring stops within the time frame (approx. 5 seconds) that Zabbix agent receives information about the host having been disabled. During this brief interval, the host will continue to locally collect data for the active checks and try sending it to the server/proxy; however, since the host is marked as *Disabled*, the server/proxy will reject the data.| The **IPMI** tab contains IPMI management attributes. |Parameter|Description| |--|--------| |*Authentication algorithm*|Select the authentication algorithm.| |*Privilege level*|Select the privilege level.| |*Username*|User name for authentication. User macros may be used.| |*Password*|Password for authentication. User macros may be used.| The **Tags** tab allows you to define host-level [tags](/manual/config/tagging). All problems of this host will be tagged with the values entered here.  User macros, {INVENTORY.\*} macros, {HOST.HOST}, {HOST.NAME}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {HOST.PORT} and {HOST.ID} macros are supported in tags. The **Macros** tab allows you to define host-level [user macros](/manual/config/macros/user_macros) as a name-value pairs. Note that macro values can be kept as plain text, secret text or Vault secret. Adding a description is also supported.  You may also view here template-level and global user macros if you select the *Inherited and host macros* option. That is where all defined user macros for the host are displayed with the value they resolve to as well as their origin. {width="600"} For convenience, links to respective templates and global macro configuration are provided. It is also possible to edit a template/global macro on the host level, effectively creating a copy of the macro on the host. The **Inventory** tab allows you to manually enter [inventory](inventory) information for the host. You can also select to enable *Automatic* inventory population, or disable inventory population for this host.  If inventory is enabled (manual or automatic), a green dot is displayed with the tab name. #### Konfigurācija Cilne **Hosts** satur vispārējos hosta atribūtus:  Visi obligātie ievades lauki ir atzīmēti ar sarkanu zvaigznīti. |Parameter|<|Description| |-|----------|----------------------------------------| |*Host name*|<|Ievadiet unikālu hosta nosaukumu. Ir atļauti burti un cipari, atstarpes, punkti, domuzīmes un pasvītras. Tomēr sākuma un beigu atstarpes nav atļautas.<br>*Piezīme:* Ja konfigurējamajā hostā darbojas Zabbix aģents, aģenta [konfigurācijas faila](/manual/appendix/config/zabbix_agentd) parametram *Hostname* jābūt ar tādu pašu vērtību kā šeit ievadītajam hosta nosaukumam. Parametra nosaukums ir nepieciešams [aktīvo pārbaužu](/manual/appendix/items/activepassive) apstrādē.| |*Visible name*|<|Ievadiet unikālu hosta redzamo nosaukumu. Ja iestatīsiet šo nosaukumu, tas būs redzams sarakstos, kartēs u. c. tehniskā hosta nosaukuma vietā. Šis atribūts atbalsta UTF-8.| |*Templates*|<|Piesaistiet hostam [veidnes](/manual/config/templates). No veidnes tiks mantotas visas entītijas (vienumi, trigeri, [utt.](/manual/config/templates/linking)).<br>Lai piesaistītu jaunu veidni, teksta ievades laukā sāciet rakstīt veidnes nosaukumu. Tiks parādīts atbilstošo veidņu saraksts; ritiniet uz leju, lai atlasītu. Vai arī varat noklikšķināt uz *Select* blakus laukam un uznirstošajā logā atlasīt veidnes no saraksta. Visas atlasītās veidnes tiks piesaistītas hostam, kad hosta konfigurācijas forma tiks saglabāta vai atjaunināta.<br>Lai atsaistītu veidni, izmantojiet vienu no divām opcijām blokā *Linked templates*:<br>*Unlink* - atsaistīt veidni, bet saglabāt tās entītijas (vienumus, trigerus, [utt.](/manual/config/templates/linking));<br>*Unlink and clear* - atsaistīt veidni un noņemt visas tās entītijas (vienumus, trigerus, [utt.](/manual/config/templates/linking)).<br>Uzskaitītie veidņu nosaukumi ir klikšķināmas saites, kas ved uz veidnes konfigurācijas formu.| |*Host groups*|<|Atlasiet [hostu grupas](/manual/config/hosts/host_groups), kurām hosts pieder. Hostam jāpieder vismaz vienai hostu grupai. Jaunu grupu var izveidot un piesaistīt hostam, pievienojot neeksistējošu grupas nosaukumu.| |*Interfaces*|<|Hostam tiek atbalstīti vairāki interfeisu tipi: *Agent*, *SNMP*, *JMX* un *IPMI*.<br>Pēc noklusējuma interfeisi nav definēti. Lai pievienotu jaunu interfeisu, blokā *Interfaces* noklikšķiniet uz *Add*, atlasiet interfeisa tipu un ievadiet informāciju *IP/DNS*, *Connect to* un *Port*.<br>*Piezīme:* Interfeisi, kas tiek izmantoti jebkuros vienumos, nevar tikt noņemti, un tiem saite *Remove* ir pelēkota.<br>SNMP interfeisa "IP" vai "DNS" tiek izmantots arī [SNMP trapiem](/manual/config/items/itemtypes/snmptrap).<br>Saskaņošanas laikā tiek izmantots tikai atlasītais "IP" vai "DNS" hosta interfeisā.<br>Skatiet [SNMP monitoringa konfigurēšana](/manual/config/items/itemtypes/snmp#configuring-snmp-monitoring), lai iegūtu papildu informāciju par SNMP interfeisa konfigurēšanu (v1, v2 un v3).| | |*IP address*|Hosta IP adrese (neobligāti).| |^|*DNS name*|Hosta DNS nosaukums (neobligāti).| |^|*Connect to*|Noklikšķinot uz attiecīgās pogas, Zabbix serverim tiks norādīts, ko izmantot datu izgūšanai no aģentiem:<br>**IP** - savienoties ar hosta IP adresi (ieteicams)<br>**DNS** - savienoties ar hosta DNS nosaukumu| |^|*Port*|TCP/UDP porta numurs. Noklusējuma vērtības ir: 10050 Zabbix aģentam, 161 SNMP aģentam, 12345 JMX un 623 IPMI.| |^|*Default*|Atzīmējiet radio pogu, lai iestatītu noklusējuma interfeisu.| |*Description*|<|Ievadiet hosta aprakstu.| |*Monitored by*|<|Atlasiet, kas uzrauga hostu:<br>**Server** - hostu uzrauga Zabbix serveris;<br>**Proxy** - hostu uzrauga atsevišķs starpniekserveris;<br>**Proxy group** - hostu uzrauga starpniekserveru grupa.| |*Proxy*|<|Tiek parādīts piešķirtā starpniekservera nosaukums (tikai tad, ja Zabbix serveris ir piešķīris vienu no atlasītās starpniekserveru grupas).<br>Šis lauks tiek rādīts tikai tad, ja hostu uzrauga starpniekserveru grupa.| |*Enabled*|<|Ja izvēles rūtiņa ir atzīmēta, hosts ir iespējots - gatavs uzraudzībai.<br><br>Ja izvēles rūtiņa nav atzīmēta, hosts ir atspējots - netiek uzraudzīts:<br>Pasīvajiem datu pieprasījumiem, ko iniciē Zabbix serveris/starpniekserveris (piemēram, [Zabbix aģents](/manual/appendix/items/activepassive#passive-checks), [SNMP aģents](/manual/config/items/itemtypes/snmp), [vienkāršās pārbaudes](/manual/config/items/itemtypes/simple_checks)), uzraudzība tiek atspējota pēc konfigurācijas sinhronizācijas. Trigeri un darbības, kas saistītas ar hostu, tiek atspējotas tikai pēc konfigurācijas pārlādēšanas.<br>Zabbix aģenta [aktīvajām pārbaudēm](/manual/appendix/items/activepassive#active-checks) uzraudzība tiek pārtraukta laika intervālā (aptuveni 5 sekundes), kurā Zabbix aģents saņem informāciju par to, ka hosts ir atspējots. Šajā īsajā intervālā hosts turpinās lokāli vākt datus aktīvajām pārbaudēm un mēģinās tos nosūtīt serverim/starpniekserverim; tomēr, tā kā hosts ir atzīmēts kā *Disabled*, serveris/starpniekserveris šos datus noraidīs.| Cilne **IPMI** satur IPMI pārvaldības atribūtus. |Parameter|Description| |--|--------| |*Authentication algorithm*|Atlasiet autentifikācijas algoritmu.| |*Privilege level*|Atlasiet privilēģiju līmeni.| |*Username*|Lietotājvārds autentifikācijai. Var izmantot lietotāja makro.| |*Password*|Parole autentifikācijai. Var izmantot lietotāja makro.| Cilne **Tags** ļauj definēt hosta līmeņa [tagus](/manual/config/tagging). Visas šī hosta problēmas tiks marķētas ar šeit ievadītajām vērtībām.  Tagos tiek atbalstīti lietotāja makro, {INVENTORY.\*} makro, {HOST.HOST}, {HOST.NAME}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {HOST.PORT} un {HOST.ID} makro. Cilne **Macros** ļauj definēt hosta līmeņa [lietotāja makro](/manual/config/macros/user_macros) kā nosaukuma un vērtības pārus. Ņemiet vērā, ka makro vērtības var glabāt kā vienkāršu tekstu, slepenu tekstu vai Vault slepenu vērtību. Tiek atbalstīta arī apraksta pievienošana.  Šeit varat arī skatīt veidnes līmeņa un globālos lietotāja makro, ja atlasāt opciju *Inherited and host macros*. Šeit tiek parādīti visi hostam definētie lietotāja makro ar to atrisinātajām vērtībām, kā arī to izcelsmi. {width="600"} Ērtībai ir pieejamas saites uz attiecīgajām veidnēm un globālo makro konfigurāciju. Ir iespējams arī rediģēt veidnes/globālo makro hosta līmenī, faktiski izveidojot makro kopiju hostā. Cilne **Inventory** ļauj manuāli ievadīt hosta [inventāra](inventory) informāciju. Varat arī izvēlēties iespējot *Automatic* inventāra aizpildīšanu vai atspējot inventāra aizpildīšanu šim hostam.  Ja inventārs ir iespējots (manuāli vai automātiski), blakus cilnes nosaukumam tiek parādīts zaļš punkts. #### Configuration The **Item** tab contains general item attributes. {width="600"} All mandatory input fields are marked with a red asterisk. |Parameter|Description| |--|--------| |*Name*|Item name.<br>[User macros](/manual/config/macros/user_macros) are supported.| |*Type*|Item type. See individual [item type](/manual/config/items/itemtypes) sections.| |*Key*|Item key (up to 2048 characters).<br>The supported [item keys](/manual/config/items/itemtypes) can be found in individual item type sections.<br>The key must be unique within a single host.<br>If key type is 'Zabbix agent', 'Zabbix agent (active)' or 'Simple check', the key value must be supported by Zabbix agent or Zabbix server.<br>See also: the correct [key format](/manual/config/items/item/key).| |*Type of information*|Type of data as stored in the database after performing conversions, if any.<br>**Numeric (unsigned)** - 64-bit unsigned integer.<br>Note that a floating point value, if received for an integer item, will be trimmed from its decimal part.<br>**Numeric (float)** - 64-bit floating point number.<br>This type will allow precision of approximately 15 digits and range from approximately -1.79E+308 to 1.79E+308 (with exception of [PostgreSQL 11 and earlier versions](/manual/installation/known_issues#numeric-float-data-type-range-with-postgresql-11-and-earlier)).<br>Receiving values in scientific notation is also supported. E.g. 1.23E+7, 1e308, 1.1E-4.<br>**Character** - short text data.<br>**Log** - long text data with optional log related properties (timestamp, source, severity, logeventid).<br>**Text** - long text data. See also [text data limits](#text-data-limits).<br>**Binary** - binary number (supported only for dependent items).<br>Items returning values with the binary data type are not supported in calculated item formulas or trigger expressions.<br>For item keys that return data only in one specific format, matching type of information is selected automatically.| |*Host interface*|Select the host interface. This field is available when editing an item on the host level.| |*Units*|If a unit symbol is set, Zabbix applies postprocessing to the received item value and displays it with the specified unit postfix.<br>Supported unit symbols with special formatting (and examples of received item value → displayed value):<br>**B** - bytes (1024 → 1 KB)<br>**Bps** - bytes per second (1024 → 1 KBps)<br>**s** - seconds, displayed using up to three largest non-zero time units (881764 → 10d 4h 56m)<br>**uptime** - elapsed time in hh:mm:ss or N days, hh:mm:ss (881764 → 10 days, 04:56:04)<br>**unixtime** - Unix timestamp, formatted as yyyy.mm.dd hh:mm:ss (881764 → 1970-01-11 04:56:04 AM); for correct formatting, the received item value must be *Numeric (unsigned)*.<br>For other units (such as Hz, W, etc.), if the received value exceeds 1000, it is divided by 1000 and displayed with a corresponding prefix (5000 → 5 KHz, 881764 → 881.76 KW).<br>If the unit symbol is prefixed with `!`, unit conversion and prefixing are disabled (1024 !B → 1024 B, 61 !s → 61 s).<br>For more examples and details on unit symbols and unit conversion, see [Item value suffixes](/manual/appendix/suffixes#item-value-suffixes).| |*Update interval*|Retrieve a new value for this item every N seconds. Maximum allowed update interval is 86400 seconds (1 day).<br>[Time suffixes](/manual/appendix/suffixes) are supported, e.g., 30s, 1m, 2h, 1d.<br>[User macros](/manual/config/macros/user_macros) are supported.<br>A single macro has to fill the whole field. Multiple macros in a field or macros mixed with text are not supported.<br>*Note*: The update interval can only be set to '0' if custom intervals exist with a non-zero value. If set to '0', and a custom interval (flexible or scheduled) exists with a non-zero value, the item will be polled during the custom interval duration.<br>*Note* that the first item poll after the item became active or after update interval change might occur earlier than the configured value. <br> New items will be checked within 60 seconds of their creation, unless they have Scheduling or Flexible update interval and the *Update interval* is set to 0. <br>An existing passive item can be polled for value immediately by pushing the *Execute now* [button](#form-buttons).| |*Custom intervals*|You can create custom rules for checking the item:<br>**Flexible** - create an exception to the *Update interval* (interval with different frequency).<br>**Scheduling** - create a custom polling schedule.<br>For detailed information see [Custom intervals](/manual/config/items/item/custom_intervals).<br>[Time suffixes](/manual/appendix/suffixes) are supported in the *Interval* field, e.g., 30s, 1m, 2h, 1d.<br>[User macros](/manual/config/macros/user_macros) are supported.<br>A single macro has to fill the whole field. Multiple macros in a field or macros mixed with text are not supported. | |*Timeout*|Set the item check timeout (available for [supported](/manual/web_interface/frontend_sections/administration/general#timeouts) item types). Select the timeout option:<br>**Global** - proxy/global timeout is used (displayed in the grayed out *Timeout* field).<br>**Override** - custom timeout is used (set in the *Timeout* field; allowed range: 1 - 600s). [Time suffixes](/manual/appendix/suffixes#time-suffixes), e.g. 30s, 1m, and [user macros](/manual/config/macros/user_macros) are supported.<br>Clicking the *Timeouts* link allows you to configure [proxy](/manual/distributed_monitoring/proxies#configuration) timeouts or [global](/manual/web_interface/frontend_sections/administration/general#timeouts) timeouts (if a proxy is not used). Note that the *Timeouts* link is visible only to users of *Super admin* type with permissions to *Administration* > [*General*](/manual/web_interface/frontend_sections/administration/general) or *Administration* > [*Proxies*](/manual/web_interface/frontend_sections/administration/proxies) frontend sections.| |*History*|Select either:<br>**Do not store** - item history is not stored. Useful for master items if only dependent items need to keep history.<br>This setting cannot be overridden by global housekeeper [settings](/manual/web_interface/frontend_sections/administration/housekeeping).<br>**Store up to** - specify the duration of keeping detailed history in the database (1 hour to 25 years). Older data will be removed by the housekeeper. Stored in seconds.<br>[Time suffixes](/manual/appendix/suffixes) are supported, e.g., 2h, 1d. [User macros](/manual/config/macros/user_macros) are supported.<br>The *Store up to* value can be overridden globally in *Administration > [Housekeeping](/manual/web_interface/frontend_sections/administration/housekeeping)*.<br>If a global overriding setting exists, an orange {class="nozoom"} info icon is displayed. If you position your mouse on it, a warning message is displayed, e.g., *Overridden by global housekeeper settings (1d)*.<br>It is recommended to keep the recorded values for the smallest possible time to reduce the size of value history in the database. Instead of storing a long history of values, you can store longer data of trends.<br>See also [History and trends](/manual/config/items/history_and_trends).| |*Trends*|Select either:<br>**Do not store** - trends are not stored.<br>This setting cannot be overridden by global housekeeper [settings](/manual/web_interface/frontend_sections/administration/housekeeping).<br>**Store up to** - specify the duration of keeping aggregated (hourly min, max, avg, count) history in the database (1 day to 25 years). Older data will be removed by the housekeeper. Stored in seconds.<br>[Time suffixes](/manual/appendix/suffixes) are supported, e.g., 24h, 1d. [User macros](/manual/config/macros/user_macros) are supported.<br>The *Store up to* value can be overridden globally in *Administration > [Housekeeping](/manual/web_interface/frontend_sections/administration/housekeeping)*.<br>If a global overriding setting exists, an orange  info icon is displayed. If you position your mouse on it, a warning message is displayed, e.g., *Overridden by global housekeeper settings (7d)*.<br>*Note:* Keeping trends is not available for non-numeric data - character, log and text.<br>See also [History and trends](/manual/config/items/history_and_trends).| |*Value mapping*|Apply value mapping to this item. [Value mapping](/manual/config/items/mapping) does not change received values, it is for displaying data only.<br>It works with *Numeric(unsigned)*, *Numeric(float)* and *Character* items.<br>For example, "Windows service states".| |*Log time format*|Available for items of type **Log** only. Supported placeholders:<br> **y**: *Year (1970-2038)*.<br> **M**: *Month (01-12)*.<br> **d**: *Day (01-31)*.<br> **h**: *Hour (00-23)*.<br> **m**: *Minute (00-59)*.<br> **s**: *Second (00-59)*.<br>If left blank, the timestamp will be set to 0 in Unix time, representing January 1, 1970.<br>For example, consider the following line from the Zabbix agent log file:<br>" 23480:20100328:154718.045 Zabbix agent started. Zabbix 1.8.2 (revision 11211)."<br>It begins with six character positions for PID, followed by date, time, and the rest of the message.<br>The log time format for this line would be "pppppp:yyyyMMdd:hhmmss".<br>Note that "p" and ":" characters are placeholders and can be any characters except "yMdhms".| |*Populates host inventory field*|You can select a host inventory field that the value of item will populate. This will work if automatic [inventory](/manual/config/hosts/inventory) population is enabled for the host.<br>This field is not available if *Type of information* is set to 'Log'.| |*Description*|Enter an item description. [User macros](/manual/config/macros/user_macros) are supported.| |*Enabled*|Mark the checkbox to enable the item so it will be processed.| |*Latest data*|Click on the link to view the latest data for the item.<br>This link is only available when editing an already existing item.| ::: noteclassic Item type specific fields are described on [corresponding pages](/manual/config/items/itemtypes). ::: ::: noteclassic When editing an existing [template](/manual/config/templates) level item on a host level, a number of fields are read-only. You can use the link in the form header and go to the template level and edit them there, keeping in mind that the changes on a template level will change the item for all hosts that the template is linked to. ::: The **Tags** tab allows to define item-level [tags](/manual/config/tagging).  #### Konfigurācija Cilne **Item** satur vispārīgos vienuma atribūtus. {width="600"} Visi obligātie ievades lauki ir atzīmēti ar sarkanu zvaigznīti. |Parameter|Description| |--|--------| |*Name*|Vienuma nosaukums.<br>Tiek atbalstīti [lietotāja makrosi](/manual/config/macros/user_macros).| |*Type*|Vienuma tips. Skatiet atsevišķas [vienuma tipa](/manual/config/items/itemtypes) sadaļas.| |*Key*|Vienuma atslēga (līdz 2048 rakstzīmēm).<br>Atbalstītās [vienuma atslēgas](/manual/config/items/itemtypes) ir atrodamas atsevišķās vienuma tipa sadaļās.<br>Atslēgai vienā hostā jābūt unikālai.<br>Ja atslēgas tips ir 'Zabbix agent', 'Zabbix agent (active)' vai 'Simple check', atslēgas vērtībai jābūt atbalstītai Zabbix aģents vai Zabbix serveris.<br>Skatiet arī: pareizais [atslēgas formāts](/manual/config/items/item/key).| |*Type of information*|Datu tips, kāds tiek saglabāts datubāzē pēc konvertēšanas, ja tāda tiek veikta.<br>**Numeric (unsigned)** - 64 bitu neparakstīts vesels skaitlis.<br>Ņemiet vērā, ka peldošā komata vērtība, ja tā tiek saņemta vesela skaitļa vienumam, tiks saīsināta, noņemot decimāldaļu.<br>**Numeric (float)** - 64 bitu peldošā komata skaitlis.<br>Šis tips nodrošina aptuveni 15 ciparu precizitāti un diapazonu no aptuveni -1.79E+308 līdz 1.79E+308 (izņemot [PostgreSQL 11 un vecākas versijas](/manual/installation/known_issues#numeric-float-data-type-range-with-postgresql-11-and-earlier)).<br>Tiek atbalstīta arī vērtību saņemšana zinātniskajā pierakstā, piem., 1.23E+7, 1e308, 1.1E-4.<br>**Character** - īsi teksta dati.<br>**Log** - gari teksta dati ar izvēles žurnāla saistītām īpašībām (timestamp, source, severity, logeventid).<br>**Text** - gari teksta dati. Skatiet arī [teksta datu ierobežojumus](#text-data-limits).<br>**Binary** - binārs skaitlis (atbalstīts tikai atkarīgajiem vienumiem).<br>Vienumi, kas atgriež vērtības bināro datu tipā, netiek atbalstīti aprēķināto vienumu formulās vai trigeris izteiksmēs.<br>Vienumiem, kuru atslēgas atgriež datus tikai vienā noteiktā formātā, atbilstošais informācijas tips tiek izvēlēts automātiski.| |*Host interface*|Atlasiet hosta saskarni. Šis lauks ir pieejams, rediģējot vienumu hosta līmenī.| |*Units*|Ja ir iestatīts vienības simbols, Zabbix veic saņemto vienuma vērtību pēcapstrādi un parāda to ar norādīto vienības sufiksu.<br>Atbalstītie vienības simboli ar īpašu formatējumu (un saņemtās vienuma vērtības → parādītās vērtības piemēri):<br>**B** - baiti (1024 → 1 KB)<br>**Bps** - baiti sekundē (1024 → 1 KBps)<br>**s** - sekundes, tiek attēlotas, izmantojot līdz trim lielākajām nenulles laika vienībām (881764 → 10d 4h 56m)<br>**uptime** - pagājušais laiks formātā hh:mm:ss vai N days, hh:mm:ss (881764 → 10 days, 04:56:04)<br>**unixtime** - Unix laika zīmogs, formatēts kā yyyy.mm.dd hh:mm:ss (881764 → 1970-01-11 04:56:04 AM); pareizam formatējumam saņemtajai vienuma vērtībai jābūt *Numeric (unsigned)*.<br>Citiem vienību simboliem (piemēram, Hz, W u. c.), ja saņemtā vērtība pārsniedz 1000, tā tiek dalīta ar 1000 un parādīta ar atbilstošu prefiksu (5000 → 5 KHz, 881764 → 881.76 KW).<br>Ja vienības simbolam priekšā ir `!`, vienību konvertēšana un prefiksu pievienošana ir atspējota (1024 !B → 1024 B, 61 !s → 61 s).<br>Vairāk piemēru un informāciju par vienību simboliem un vienību konvertēšanu skatiet [Item value suffixes](/manual/appendix/suffixes#item-value-suffixes).| |*Update interval*|Iegūt jaunu šī vienuma vērtību ik pēc N sekundēm. Maksimāli atļautais atjaunināšanas intervāls ir 86400 sekundes (1 diena).<br>Tiek atbalstīti [laika sufiksi](/manual/appendix/suffixes), piem., 30s, 1m, 2h, 1d.<br>Tiek atbalstīti [lietotāja makrosi](/manual/config/macros/user_macros).<br>Vienam makro jāaizpilda viss lauks. Vairāki makrosi vienā laukā vai makrosi kopā ar tekstu netiek atbalstīti.<br>*Piezīme*: atjaunināšanas intervālu var iestatīt uz '0' tikai tad, ja pastāv pielāgoti intervāli ar nenulles vērtību. Ja tas ir iestatīts uz '0' un pastāv pielāgots intervāls (elastīgais vai plānotais) ar nenulles vērtību, vienums tiks aptaujāts pielāgotā intervāla laikā.<br>*Piezīme*, ka pirmā vienuma aptauja pēc tam, kad vienums kļūst aktīvs vai pēc atjaunināšanas intervāla maiņas, var notikt agrāk nekā konfigurētā vērtība. <br> Jauni vienumi tiks pārbaudīti 60 sekunžu laikā pēc to izveides, ja vien tiem nav Scheduling vai Flexible update interval un *Update interval* nav iestatīts uz 0. <br>Esošu pasīvu vienumu var nekavējoties aptaujāt, nospiežot *Execute now* [pogu](#form-buttons).| |*Custom intervals*|Varat izveidot pielāgotus vienuma pārbaudes noteikumus:<br>**Flexible** - izveido izņēmumu *Update interval* (intervāls ar citu biežumu).<br>**Scheduling** - izveido pielāgotu aptaujas grafiku.<br>Detalizētu informāciju skatiet [Custom intervals](/manual/config/items/item/custom_intervals).<br>Laukā *Interval* tiek atbalstīti [laika sufiksi](/manual/appendix/suffixes), piem., 30s, 1m, 2h, 1d.<br>Tiek atbalstīti [lietotāja makrosi](/manual/config/macros/user_macros).<br>Vienam makro jāaizpilda viss lauks. Vairāki makrosi vienā laukā vai makrosi kopā ar tekstu netiek atbalstīti. | |*Timeout*|Iestatiet vienuma pārbaudes noildzi (pieejams [atbalstītajiem](/manual/web_interface/frontend_sections/administration/general#timeouts) vienuma tipiem). Atlasiet noildzes opciju:<br>**Global** - tiek izmantota starpniekservera/globalā noildze (tiek parādīta pelēkajā laukā *Timeout*).<br>**Override** - tiek izmantota pielāgota noildze (iestatīta laukā *Timeout*; atļautais diapazons: 1 - 600s). Tiek atbalstīti [laika sufiksi](/manual/appendix/suffixes#time-suffixes), piem., 30s, 1m, un [lietotāja makrosi](/manual/config/macros/user_macros).<br>Noklikšķinot uz saites *Timeouts*, varat konfigurēt [starpniekservera](/manual/distributed_monitoring/proxies#configuration) noildzes vai [globālās](/manual/web_interface/frontend_sections/administration/general#timeouts) noildzes (ja starpniekserveris netiek izmantots). Ņemiet vērā, ka saite *Timeouts* ir redzama tikai lietotājiem ar *Super admin* tipu un tiesībām uz *Administration* > [*General*](/manual/web_interface/frontend_sections/administration/general) vai *Administration* > [*Proxies*](/manual/web_interface/frontend_sections/administration/proxies) lietotāja saskarne sadaļām.| |*History*|Atlasiet vienu no šiem:<br>**Do not store** - vienuma vēsture netiek saglabāta. Noder galvenajiem vienumiem, ja vēsture jāsaglabā tikai atkarīgajiem vienumiem.<br>Šo iestatījumu nevar pārrakstīt globālie housekeeper [iestatījumi](/manual/web_interface/frontend_sections/administration/housekeeping).<br>**Store up to** - norādiet detalizētās vēstures glabāšanas ilgumu datubāzē (no 1 stundas līdz 25 gadiem). Vecākie dati tiks dzēsti ar housekeeper. Tiek glabāts sekundēs.<br>Tiek atbalstīti [laika sufiksi](/manual/appendix/suffixes), piem., 2h, 1d. Tiek atbalstīti [lietotāja makrosi](/manual/config/macros/user_macros).<br>Vērtību *Store up to* globāli var pārrakstīt sadaļā *Administration > [Housekeeping](/manual/web_interface/frontend_sections/administration/housekeeping)*.<br>Ja pastāv globāls pārrakstīšanas iestatījums, tiek parādīta oranža informācijas ikona {class="nozoom"}. Novietojot uz tās peli, tiek parādīts brīdinājuma ziņojums, piem., *Overridden by global housekeeper settings (1d)*.<br>Ieteicams saglabāt ierakstītās vērtības pēc iespējas īsāku laiku, lai samazinātu vērtību vēstures apjomu datubāzē. Garas vērtību vēstures vietā var saglabāt ilgākus trendu datus.<br>Skatiet arī [History and trends](/manual/config/items/history_and_trends).| |*Trends*|Atlasiet vienu no šiem:<br>**Do not store** - trendi netiek saglabāti.<br>Šo iestatījumu nevar pārrakstīt globālie housekeeper [iestatījumi](/manual/web_interface/frontend_sections/administration/housekeeping).<br>**Store up to** - norādiet agregētās (stundu min, max, avg, count) vēstures glabāšanas ilgumu datubāzē (no 1 dienas līdz 25 gadiem). Vecākie dati tiks dzēsti ar housekeeper. Tiek glabāts sekundēs.<br>Tiek atbalstīti [laika sufiksi](/manual/appendix/suffixes), piem., 24h, 1d. Tiek atbalstīti [lietotāja makrosi](/manual/config/macros/user_macros).<br>Vērtību *Store up to* globāli var pārrakstīt sadaļā *Administration > [Housekeeping](/manual/web_interface/frontend_sections/administration/housekeeping)*.<br>Ja pastāv globāls pārrakstīšanas iestatījums, tiek parādīta oranža informācijas ikona . Novietojot uz tās peli, tiek parādīts brīdinājuma ziņojums, piem., *Overridden by global housekeeper settings (7d)*.<br>*Piezīme:* trendu saglabāšana nav pieejama nenumeriskiem datiem - character, log un text.<br>Skatiet arī [History and trends](/manual/config/items/history_and_trends).| |*Value mapping*|Piemērojiet šim vienumam vērtību kartēšanu. [Value mapping](/manual/config/items/mapping) nemaina saņemtās vērtības, tā ir paredzēta tikai datu attēlošanai.<br>Tā darbojas ar *Numeric(unsigned)*, *Numeric(float)* un *Character* vienumiem.<br>Piemēram, "Windows service states".| |*Log time format*|Pieejams tikai tipa **Log** vienumiem. Atbalstītie vietturi:<br> **y**: *Gads (1970-2038)*.<br> **M**: *Mēnesis (01-12)*.<br> **d**: *Diena (01-31)*.<br> **h**: *Stunda (00-23)*.<br> **m**: *Minūte (00-59)*.<br> **s**: *Sekunde (00-59)*.<br>Ja atstāts tukšs, laikspiedols tiks iestatīts uz 0 Unix laikā, kas apzīmē 1970. gada 1. janvāri.<br>Piemēram, aplūkojiet šādu rindu no Zabbix aģents žurnālfaila:<br>" 23480:20100328:154718.045 Zabbix agent started. Zabbix 1.8.2 (revision 11211)."<br>Tā sākas ar sešām rakstzīmju pozīcijām PID, kam seko datums, laiks un pārējais ziņojums.<br>Šīs rindas žurnāla laika formāts būtu "pppppp:yyyyMMdd:hhmmss".<br>Ņemiet vērā, ka rakstzīmes "p" un ":" ir vietturi un var būt jebkuras rakstzīmes, izņemot "yMdhms".| |*Populates host inventory field*|Varat atlasīt hosta inventāra lauku, kuru aizpildīs vienuma vērtība. Tas darbosies, ja hostam ir iespējota automātiska [inventāra](/manual/config/hosts/inventory) aizpildīšana.<br>Šis lauks nav pieejams, ja *Type of information* ir iestatīts uz 'Log'.| |*Description*|Ievadiet vienuma aprakstu. Tiek atbalstīti [lietotāja makrosi](/manual/config/macros/user_macros).| |*Enabled*|Atzīmējiet izvēles rūtiņu, lai iespējotu vienumu un tas tiktu apstrādāts.| |*Latest data*|Noklikšķiniet uz saites, lai skatītu jaunākos vienuma datus.<br>Šī saite ir pieejama tikai, rediģējot jau esošu vienumu.| ::: noteclassic Vienuma tipam specifiskie lauki ir aprakstīti [attiecīgajās lapās](/manual/config/items/itemtypes). ::: ::: noteclassic Rediģējot esošu [veidne] līmeņa vienumu hosta līmenī, vairāki lauki ir tikai lasāmi. Varat izmantot saiti formas galvenē un pāriet uz veidne līmeni, lai tos rediģētu tur, paturot prātā, ka izmaiņas veidne līmenī mainīs vienumu visiem hostiem, ar kuriem veidne ir saistīta. ::: Cilne **Tags** ļauj definēt vienuma līmeņa [tagus](/manual/config/tagging).  #### Configuration The low-level discovery rule should be created as a [dependent item](/manual/config/items/itemtypes/dependent_items) to the HTTP master item that collects Prometheus data. #### Konfigurācija Zema līmeņa atklāšanas kārtula jāizveido kā [atkarīgais vienums](/manual/config/items/itemtypes/dependent_items) HTTP galvenajam vienumam, kas apkopo Prometheus datus. #### Configuration The *Scheduled reports* tab contains general report attributes. {width="600"} All mandatory input fields are marked with a red asterisk. |Parameter|Description| |--|--------| |*Owner*|User that creates a report. *Super admin* level users are allowed to change the owner. For *Admin* level users, this field is read-only.| |*Name*|Name of the report; must be unique.| |*Dashboard*|Dashboard on which the report is based; only one dashboard can be selected at a time. To select a dashboard, start typing the name - a list of matching dashboards will appear; scroll down to select. Alternatively, you may click *Select* next to the field and select a dashboard from the displayed list.| |*Period*|Time period for which the report will be prepared. Select the previous day, week, month, or year.| |*Cycle*|Report generation frequency. The reports can be sent daily, weekly, monthly, or yearly. "Weekly" mode allows to select days of the week when the report will be sent.| |*Start time*|Time of the day in the format hh:mm when the report will be prepared. Note that Zabbix server time zone will be used.| |*Repeat on*|Days of the week when the report will be sent. This field is available only if *Cycle* is set to "Weekly".| |*Start date*|Date when regular report generation should be started.| |*End date*|Date when regular report generation should be stopped.| |*Subject*|Subject of the report email. Supports {TIME} macro.| |*Message*|Body of the report email. Supports {TIME} macro.| |*Subscriptions*|List of report recipients. By default, includes only the report owner. Any Zabbix user with configured email media may be specified as a report recipient.<br>Click *Add user* or *Add user group* to add more recipients.<br>Click the username to edit settings:<br>*Generate report by* - whether the report data should be generated based on the dashboard permissions of the current user or the recipient.<br>*Status* - select "Include" to send the report to the user or "Exclude" to prevent sending the report to this user. At least one user must have the "Include" status. The "Exclude" status can be used to exclude specific users from a user group that is included.<br><br>Note that users with insufficient permissions (that is, users with a role based on the *Admin* user type who are not members of the same user group as the recipient or report owner) will see "Inaccessible user" or "Inaccessible user group" instead of the actual names in the fields *Recipient* and *Generate report by*; the fields *Status* and *Action* will be displayed as read-only.| |*Enabled*|Report status. Clearing this checkbox will disable the report.| |*Description*|An optional description of the report. This description is for internal use and will not be sent to report recipients.| #### Konfigurācija Cilnē *Scheduled reports* ir ietverti vispārīgie pārskata atribūti. {width="600"} Visi obligātie ievades lauki ir atzīmēti ar sarkanu zvaigznīti. |Parameter|Description| |--|--------| |*Owner*|Lietotājs, kas izveido pārskatu. *Super admin* līmeņa lietotāji drīkst mainīt īpašnieku. *Admin* līmeņa lietotājiem šis lauks ir tikai lasāms.| |*Name*|Pārskata nosaukums; tam jābūt unikālam.| |*Dashboard*|Informācijas panelis, uz kura balstās pārskats; vienlaikus var atlasīt tikai vienu informācijas paneli. Lai atlasītu informācijas paneli, sāciet rakstīt nosaukumu - tiks parādīts atbilstošo informācijas paneļu saraksts; ritiniet uz leju, lai atlasītu. Alternatīvi varat noklikšķināt *Select* blakus laukam un atlasīt informācijas paneli no parādītā saraksta.| |*Period*|Laika periods, par kuru tiks sagatavots pārskats. Atlasiet iepriekšējo dienu, nedēļu, mēnesi vai gadu.| |*Cycle*|Pārskata ģenerēšanas biežums. Pārskatus var sūtīt katru dienu, katru nedēļu, katru mēnesi vai katru gadu. Režīms "Weekly" ļauj atlasīt nedēļas dienas, kad pārskats tiks sūtīts.| |*Start time*|Diennakts laiks formātā hh:mm, kad pārskats tiks sagatavots. Ņemiet vērā, ka tiks izmantota Zabbix serveris laika josla.| |*Repeat on*|Nedēļas dienas, kad pārskats tiks sūtīts. Šis lauks ir pieejams tikai tad, ja *Cycle* ir iestatīts uz "Weekly".| |*Start date*|Datums, kad jāsāk regulāra pārskata ģenerēšana.| |*End date*|Datums, kad jāpārtrauc regulāra pārskata ģenerēšana.| |*Subject*|Pārskata e-pasta temats. Atbalsta {TIME} makro.| |*Message*|Pārskata e-pasta saturs. Atbalsta {TIME} makro.| |*Subscriptions*|Pārskata saņēmēju saraksts. Pēc noklusējuma tajā ir tikai pārskata īpašnieks. Par pārskata saņēmēju var norādīt jebkuru Zabbix lietotāju, kuram ir konfigurēts e-pasta medijs.<br>Noklikšķiniet *Add user* vai *Add user group*, lai pievienotu vairāk saņēmēju.<br>Noklikšķiniet uz lietotājvārda, lai rediģētu iestatījumus:<br>*Generate report by* - vai pārskata dati jāģenerē, pamatojoties uz pašreizējā lietotāja vai saņēmēja informācijas paneļa atļaujām.<br>*Status* - atlasiet "Include", lai nosūtītu pārskatu lietotājam, vai "Exclude", lai novērstu pārskata nosūtīšanu šim lietotājam. Vismaz vienam lietotājam jābūt statusam "Include". Statusu "Exclude" var izmantot, lai izslēgtu konkrētus lietotājus no lietotāju grupas, kas ir iekļauta.<br><br>Ņemiet vērā, ka lietotāji ar nepietiekamām atļaujām (tas ir, lietotāji ar lomu, kuras pamatā ir *Admin* lietotāja tips un kuri nav tās pašas lietotāju grupas dalībnieki kā saņēmējs vai pārskata īpašnieks) laukos *Recipient* un *Generate report by* redzēs "Inaccessible user" vai "Inaccessible user group" faktiskā nosaukuma vietā; lauki *Status* un *Action* tiks parādīti tikai lasīšanas režīmā.| |*Enabled*|Pārskata statuss. Notīrot šo izvēles rūtiņu, pārskats tiks atspējots.| |*Description*|Neobligāts pārskata apraksts. Šis apraksts ir paredzēts iekšējai lietošanai un netiks nosūtīts pārskata saņēmējiem.| #### Configuration The **Trigger** tab contains all the essential trigger attributes. {width="600"} All mandatory input fields are marked with a red asterisk. |Parameter|Description| |--|--------| |*Name*|Trigger name.<br>Supported [macros](/manual/appendix/macros/supported_by_location) are: {HOST.HOST}, {HOST.NAME}, {HOST.PORT}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {ITEM.VALUE}, {ITEM.LASTVALUE}, {ITEM.LOG.\*}, and {$MACRO} user macros.<br>**$1, $2...$9** macros can be used to refer to the first, second...ninth constant of the expression.<br>*Note*: $1-$9 macros will resolve correctly if referring to constants in relatively simple, straightforward expressions. For example, the name "Processor load above $1 on {HOST.NAME}" will automatically change to "Processor load above 5 on New host" if the expression is last(/New host/system.cpu.load\[percpu,avg1\])>5.| |*Event name*|When defined, this name will be used to create the problem event name. By default, the event name is the same as the trigger name.<br>The event name may be used to build meaningful alerts containing problem data (see [example](/manual/config/triggers/expression#example-18)).<br>The same set of macros is supported as in the trigger name, plus {TIME} and {?EXPRESSION} expression macros.| |*Operational data*|Enter some string with macros to display dynamic, real-time data in *Monitoring* > *[Problems](/manual/web_interface/frontend_sections/monitoring/problems)*. Alternatively, leave this field empty to display the latest values of all items from the trigger expression.<br>The same set of macros is supported as in the trigger name, with the ability to resolve dynamically. For example:<br>{ITEM.VALUE<1-9>} resolves to the item values at the moment the trigger state is changed (problem created, resolved, closed manually, or closed by correlation).<br>{ITEM.LASTVALUE<1-9>} resolves to the latest item values.<br>Note that closing a problem manually does not produce a new value, so both macros will still show the value from the problem time. Also note that both macros resolve to *UNKNOWN* if the latest value is older than *Max history display period* (see *[Administration > General](/manual/web_interface/frontend_sections/administration/general#gui)*).| |*Severity*|Set the required trigger [severity](severity) by clicking the buttons.| |*Expression*|Logical [expression](expression) used to define the conditions of a problem.<br>[Time suffixes](/manual/appendix/suffixes#time-suffixes) and [memory size suffixes](/manual/appendix/suffixes#memory-size-suffixes) are supported.<br>A problem is created after all the conditions included in the expression are met, i.e. the expression evaluates to TRUE. The problem will be resolved as soon as the expression evaluates to FALSE, unless additional recovery conditions are specified in *Recovery expression*.| |*OK event generation*|OK event generation options:<br>**Expression** - OK events are generated based on the same expression as problem events;<br>**Recovery expression** - OK events are generated if the problem expression evaluates to FALSE and the recovery expression evaluates to TRUE;<br>**None** - in this case the trigger will never return to an OK state on its own.| |*Recovery expression*|Logical [expression](expression) (optional) defining additional conditions that have to be met before the problem is resolved, after the original problem expression has already been evaluated as FALSE.<br>Recovery expression is useful for trigger [hysteresis](/manual/config/triggers/expression#hysteresis). It is **not** possible to resolve a problem by recovery expression alone if the problem expression is still TRUE.<br>This field is only available if 'Recovery expression' is selected for *OK event generation*.| |*PROBLEM event generation mode*|Mode for generating problem events:<br>**Single** - a single event is generated when a trigger goes into the 'Problem' state for the first time;<br>**Multiple** - an event is generated upon *every* 'Problem' evaluation of the trigger.| |*OK event closes*|Select if OK event closes:<br>**All problems** - all problems of this trigger;<br>**All problems if tag values match** - only those trigger problems with matching event tag values.| |*Tag for matching*|Enter event tag name to use for event correlation.<br>This field is displayed if 'All problems if tag values match' is selected for the *OK event closes* property and is mandatory in this case.| |*Allow manual close*|Check to allow [manual closing](/manual/config/events/manual_close) of problem events generated by this trigger. Manual closing is possible when acknowledging problem events.| |*Menu entry name*|If not empty, the name entered here (up to 64 characters) is used in several frontend locations as a label for the trigger URL specified in the *Menu entry URL* parameter. If empty, the default name *Trigger URL* is used.<br>The same set of macros is supported as in the trigger name, plus {EVENT.ID}, {HOST.ID}, and {TRIGGER.ID}.| |*Menu entry URL*|If not empty, the URL entered here (up to 2048 characters) is available as a link in the [event menu](/manual/web_interface/menu/event_menu) in several frontend locations, for example, when clicking on the problem name in *Monitoring > [Problems](/manual/web_interface/frontend_sections/monitoring/problems)* or *[Problems](/manual/web_interface/frontend_sections/dashboards/widgets/problems#using-the-widget)* dashboard widget.<br>The same set of macros is supported as in the trigger name, plus {EVENT.ID}, {HOST.ID}, and {TRIGGER.ID}. Note: user macros with secret values will not be resolved in the URL.| |*Description*|Text field used to provide more information about this trigger. May contain instructions for fixing specific problem, contact detail of responsible staff, etc.<br>The same set of macros is supported as in the trigger name.| |*Enabled*|Unchecking this box will disable the trigger if required.<br>Problems of a disabled trigger are no longer displayed in the frontend, but are not deleted.| The **Tags** tab allows you to define trigger-level [tags](/manual/config/tagging). All problems of this trigger will be tagged with the values entered here. {width="600"} In addition, the *Inherited and trigger tags* option allows you to view tags defined on the template level if the trigger comes from that template. If there are multiple templates with the same tag, these tags are displayed once and template names are separated by commas. A trigger does not "inherit" and display host-level tags. |Parameter|Description| |--|--------| |*Name/Value*|Set custom tags to mark trigger events.<br>Tags are a pair of tag name and value. You can use only the name or pair it with a value. A trigger may have several tags with the same name, but different values.<br>User macros, user macros with context, low-level discovery macros, and macro [functions](/manual/config/macros/macro_functions) with `{{ITEM.VALUE}}`, `{{ITEM.LASTVALUE}}` are supported in event tags. Low-level discovery macros can be used inside macro context.<br>{TRIGGER.ID} macro is supported in trigger tag values. It may be useful for identifying triggers created from trigger prototypes and, for example, suppressing problems from these triggers during maintenance.<br>If the total length of expanded value exceeds 255, it will be cut to 255 characters.<br>See all [macros](/manual/config/tagging#macro-support) supported for event tags.<br>[Event tags](/manual/config/tagging) can be used for event correlation, in action conditions and will also be seen in *Monitoring* > *Problems* or the *Problems* widget.| The **Dependencies** tab contains all the [dependencies](dependencies) of the trigger. Click on *Add* to add a new dependency. ::: noteclassic You can also configure a trigger by opening an existing one, pressing the *Clone* button and then saving under a different name. ::: #### Konfigurācija Cilnē **Trigeris** ir visi būtiskie trigeris atribūti. {width="600"} Visi obligātie ievades lauki ir atzīmēti ar sarkanu zvaigznīti. |Parameter|Description| |--|--------| |*Name*|Trigeris nosaukums.<br>Atbalstītie [makro](/manual/appendix/macros/supported_by_location) ir: {HOST.HOST}, {HOST.NAME}, {HOST.PORT}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {ITEM.VALUE}, {ITEM.LASTVALUE}, {ITEM.LOG.\*} un {$MACRO} lietotāja makro.<br>Makro **$1, $2...$9** var izmantot, lai atsauktos uz izteiksmes pirmo, otro...devīto konstanti.<br>*Piezīme*: $1-$9 makro tiks pareizi atrisināti, ja tie attieksies uz konstantēm salīdzinoši vienkāršās, tiešās izteiksmēs. Piemēram, nosaukums "Processor load above $1 on {HOST.NAME}" automātiski mainīsies uz "Processor load above 5 on New host", ja izteiksme ir last(/New host/system.cpu.load\[percpu,avg1\])>5.| |*Event name*|Ja norādīts, šis nosaukums tiks izmantots problēmas notikuma nosaukuma izveidei. Pēc noklusējuma notikuma nosaukums ir tāds pats kā trigeris nosaukums.<br>Notikuma nosaukumu var izmantot, lai izveidotu jēgpilnus brīdinājumus, kas satur problēmas datus (skatiet [piemēru](/manual/config/triggers/expression#example-18)).<br>Ir atbalstīts tas pats makro kopums kā trigeris nosaukumā, kā arī {TIME} un {?EXPRESSION} izteiksmes makro.| |*Operational data*|Ievadiet kādu virkni ar makro, lai *Monitoring* > *[Problems](/manual/web_interface/frontend_sections/monitoring/problems)* attēlotu dinamiskus, reāllaika datus. Alternatīvi atstājiet šo lauku tukšu, lai attēlotu visu vienums jaunākās vērtības no trigeris izteiksmes.<br>Ir atbalstīts tas pats makro kopums kā trigeris nosaukumā, ar iespēju tos atrisināt dinamiski. Piemēram:<br>{ITEM.VALUE<1-9>} tiek atrisināts uz vienums vērtībām brīdī, kad tiek mainīts trigeris stāvoklis (problēma izveidota, atrisināta, aizvērta manuāli vai aizvērta korelācijas rezultātā).<br>{ITEM.LASTVALUE<1-9>} tiek atrisināts uz jaunākajām vienums vērtībām.<br>Ņemiet vērā, ka problēmas manuāla aizvēršana nerada jaunu vērtību, tāpēc abi makro joprojām rādīs vērtību no problēmas rašanās brīža. Tāpat ņemiet vērā, ka abi makro tiek atrisināti kā *UNKNOWN*, ja jaunākā vērtība ir vecāka par *Max history display period* (skatiet *[Administration > General](/manual/web_interface/frontend_sections/administration/general#gui)*).| |*Severity*|Iestatiet nepieciešamo trigeris [smagumu](severity), noklikšķinot uz pogām.| |*Expression*|Loģiska [izteiksme](expression), ko izmanto, lai definētu problēmas nosacījumus.<br>Tiek atbalstīti [laika sufiksi](/manual/appendix/suffixes#time-suffixes) un [atmiņas apjoma sufiksi](/manual/appendix/suffixes#memory-size-suffixes).<br>Problēma tiek izveidota pēc tam, kad ir izpildīti visi izteiksmē iekļautie nosacījumi, t. i., izteiksme novērtējas kā TRUE. Problēma tiks atrisināta, tiklīdz izteiksme novērtēsies kā FALSE, ja vien papildu atjaunošanās nosacījumi nav norādīti sadaļā *Recovery expression*.| |*OK event generation*|OK notikumu ģenerēšanas opcijas:<br>**Expression** - OK notikumi tiek ģenerēti, pamatojoties uz to pašu izteiksmi kā problēmas notikumi;<br>**Recovery expression** - OK notikumi tiek ģenerēti, ja problēmas izteiksme novērtējas kā FALSE un atjaunošanās izteiksme novērtējas kā TRUE;<br>**None** - šajā gadījumā trigeris nekad pats neatgriezīsies OK stāvoklī.| |*Recovery expression*|Loģiska [izteiksme](expression) (neobligāta), kas definē papildu nosacījumus, kuriem jābūt izpildītiem, pirms problēma tiek atrisināta, pēc tam, kad sākotnējā problēmas izteiksme jau ir novērtēta kā FALSE.<br>Atjaunošanās izteiksme ir noderīga trigeris [histerēzei](/manual/config/triggers/expression#hysteresis). Nav **iespējams** atrisināt problēmu tikai ar atjaunošanās izteiksmi, ja problēmas izteiksme joprojām ir TRUE.<br>Šis lauks ir pieejams tikai tad, ja *OK event generation* ir atlasīts 'Recovery expression'.| |*PROBLEM event generation mode*|Problēmas notikumu ģenerēšanas režīms:<br>**Single** - viens notikums tiek ģenerēts, kad trigeris pirmo reizi nonāk 'Problem' stāvoklī;<br>**Multiple** - notikums tiek ģenerēts pie *katras* trigeris 'Problem' novērtēšanas.| |*OK event closes*|Atlasiet, vai OK notikums aizver:<br>**All problems** - visas šī trigeris problēmas;<br>**All problems if tag values match** - tikai tās trigeris problēmas, kuru notikumu tagu vērtības sakrīt.| |*Tag for matching*|Ievadiet notikuma taga nosaukumu, ko izmantot notikumu korelācijai.<br>Šis lauks tiek parādīts, ja *OK event closes* īpašībai ir atlasīts 'All problems if tag values match', un šajā gadījumā tas ir obligāts.| |*Allow manual close*|Atzīmējiet, lai atļautu šī trigeris ģenerēto problēmu notikumu [manuālu aizvēršanu](/manual/config/events/manual_close). Manuāla aizvēršana ir iespējama, apstiprinot problēmu notikumus.| |*Menu entry name*|Ja nav tukšs, šeit ievadītais nosaukums (līdz 64 rakstzīmēm) tiek izmantots vairākās lietotāja saskarne vietās kā etiķete trigeris URL, kas norādīts parametrā *Menu entry URL*. Ja lauks ir tukšs, tiek izmantots noklusējuma nosaukums *Trigger URL*.<br>Ir atbalstīts tas pats makro kopums kā trigeris nosaukumā, kā arī {EVENT.ID}, {HOST.ID} un {TRIGGER.ID}.| |*Menu entry URL*|Ja nav tukšs, šeit ievadītais URL (līdz 2048 rakstzīmēm) ir pieejams kā saite [notikumu izvēlnē](/manual/web_interface/menu/event_menu) vairākās lietotāja saskarne vietās, piemēram, noklikšķinot uz problēmas nosaukuma *Monitoring > [Problems](/manual/web_interface/frontend_sections/monitoring/problems)* vai *[Problems](/manual/web_interface/frontend_sections/dashboards/widgets/problems#using-the-widget)* paneļa logrīkā.<br>Ir atbalstīts tas pats makro kopums kā trigeris nosaukumā, kā arī {EVENT.ID}, {HOST.ID} un {TRIGGER.ID}. Piezīme: lietotāja makro ar slepenām vērtībām URL netiks atrisināti.| |*Description*|Teksta lauks, ko izmanto, lai sniegtu vairāk informācijas par šo trigeris. Var saturēt norādījumus konkrētas problēmas novēršanai, atbildīgo darbinieku kontaktinformāciju utt.<br>Ir atbalstīts tas pats makro kopums kā trigeris nosaukumā.| |*Enabled*|Noņemot atzīmi šajā izvēles rūtiņā, trigeris tiks atspējots, ja nepieciešams.<br>Atspējota trigeris problēmas vairs netiek rādītas lietotāja saskarne, taču netiek dzēstas.| Cilne **Tags** ļauj definēt trigeris līmeņa [tagus](/manual/config/tagging). Visas šī trigeris problēmas tiks atzīmētas ar šeit ievadītajām vērtībām. {width="600"} Turklāt opcija *Inherited and trigger tags* ļauj skatīt veidne līmenī definētos tagus, ja trigeris nāk no šīs veidne. Ja ir vairākas veidnes ar vienu un to pašu tagu, šie tagi tiek parādīti vienu reizi, un veidņu nosaukumi tiek atdalīti ar komatiem. Trigeris nepārmanto un nerāda hosts līmeņa tagus. |Parameter|Description| |--|--------| |*Name/Value*|Iestatiet pielāgotus tagus, lai atzīmētu trigeris notikumus.<br>Tagi ir taga nosaukuma un vērtības pāris. Varat izmantot tikai nosaukumu vai arī pievienot tam vērtību. Trigeris var būt vairāki tagi ar vienu un to pašu nosaukumu, bet atšķirīgām vērtībām.<br>Notikumu tagos tiek atbalstīti lietotāja makro, lietotāja makro ar kontekstu, zema līmeņa atklāšanas makro un makro [funkcijas](/manual/config/macros/macro_functions) ar `{{ITEM.VALUE}}`, `{{ITEM.LASTVALUE}}`.<br>Zema līmeņa atklāšanas makro var izmantot makro kontekstā.<br>{TRIGGER.ID} makro tiek atbalstīts trigeris taga vērtībās. Tas var būt noderīgs, lai identificētu trigeris, kas izveidoti no trigeris prototipiem, un, piemēram, apkopes laikā slāpētu šo trigeris problēmas.<br>Ja izvērstās vērtības kopējais garums pārsniedz 255, tas tiks saīsināts līdz 255 rakstzīmēm.<br>Skatiet visus [makro](/manual/config/tagging#macro-support), kas atbalstīti notikumu tagiem.<br>[Notikumu tagus](/manual/config/tagging) var izmantot notikumu korelācijai, darbību nosacījumos, un tie būs redzami arī *Monitoring* > *Problems* vai *Problems* logrīkā.| Cilnē **Dependencies** ir iekļautas visas šī trigeris [atkarības](dependencies). Noklikšķiniet uz *Add*, lai pievienotu jaunu atkarību. ::: noteclassic Varat arī konfigurēt trigeris, atverot jau esošu, nospiežot pogu *Clone* un pēc tam saglabājot to ar citu nosaukumu. ::: # Configuration This class is designed to export and import Zabbix configuration data. Available methods: - [configuration.export](/manual/api/reference/configuration/export) - export configuration data - [configuration.import](/manual/api/reference/configuration/import) - import configuration data - [configuration.importcompare](/manual/api/reference/configuration/importcompare) - compare import file with current system elements # Konfigurācija Šī klase ir paredzēta Zabbix konfigurācijas datu eksportēšanai un importēšanai. Pieejamās metodes: - [configuration.export](/manual/api/reference/configuration/export) - eksportēt konfigurācijas datus - [configuration.import](/manual/api/reference/configuration/import) - importēt konfigurācijas datus - [configuration.importcompare](/manual/api/reference/configuration/importcompare) - salīdzināt importēšanas failu ar pašreizējiem sistēmas elementiem # Configuration This page describes classes that can be used to create a widget configuration view with custom configuration fields. The widget configuration view is the part of the widget that allows the user to configure widget parameters for [presentation](/presentation). # Konfigurācija Šajā lapā ir aprakstītas klases, kuras var izmantot, lai izveidotu logrīka konfigurācijas skatu ar pielāgotiem konfigurācijas laukiem. Logrīka konfigurācijas skats ir logrīka daļa, kas ļauj lietotājam konfigurēt logrīka parametrus [attēlošanai](/presentation). #### Configuration Those remote commands that are executed on Zabbix agent (custom scripts) must be first enabled in the agent [configuration](/manual/appendix/config/zabbix_agentd). Make sure that the AllowKey=system.run[<command>,\*] parameter is added for each allowed command in agent configuration to allow specific command with nowait mode. Restart agent daemon if changing this parameter. Then, when configuring a new action in *Alerts → Actions → Trigger actions*: 1. Define the appropriate conditions, for example, set that the action is activated upon any disaster problems with one of Apache applications. {width="600"} 2. In the [*Operations*](/manual/config/notifications/action/operation#configuring-an-operation) tab, click on *Add* in the *Operations*, *Recovery operations*, or *Update operations* block. {width="600"} 3. Select one of the [predefined scripts](/manual/config/notifications/action/operation/remote_command#predefined-scripts) from the *Operation* dropdown list and set the *Target list* for the script. {width="600"} #### Konfigurācija Tās attālās komandas, kas tiek izpildītas uz Zabbix aģenta (pielāgoti skripti), vispirms ir jāiespējo aģenta [konfigurācijā](/manual/appendix/config/zabbix_agentd). Pārliecinieties, ka aģenta konfigurācijā katrai atļautajai komandai ir pievienots parametrs `AllowKey=system.run[<command>,\*]`, lai atļautu konkrētu komandu `nowait` režīmā. Ja maināt šo parametru, restartējiet aģenta dēmonu. Pēc tam, konfigurējot jaunu darbību sadaļā *Alerts → Actions → Trigger actions*: 1. Definējiet atbilstošos nosacījumus, piemēram, iestatiet, ka darbība tiek aktivizēta, ja rodas jebkuras kritiskas problēmas ar vienu no Apache lietojumprogrammām. {width="600"} 2. Cilnē [*Operations*](/manual/config/notifications/action/operation#configuring-an-operation) noklikšķiniet uz *Add* blokā *Operations*, *Recovery operations* vai *Update operations*. {width="600"} 3. Nolaižamajā sarakstā *Operation* atlasiet vienu no [iepriekš definētajiem skriptiem](/manual/config/notifications/action/operation/remote_command#predefined-scripts) un iestatiet skripta *Target list*. {width="600"} #### Configuration To add the widget, select *Geomap* as type.  #### Konfigurācija Lai pievienotu logrīku, atlasiet *Geomap* kā tipu.  #### Configuration To assign triggers as link indicators, do the following: - select a map element - click on *Edit* in the *Links* section for the appropriate link - click on *Add* in the *Link indicators* block and select one or more triggers {width="600"} All mandatory input fields are marked with a red asterisk. Added triggers can be seen in the *Link indicators* list. You can set the link type and color for each trigger directly from the list. When done, click on *Apply*, close the form and click on *Update* to save the map changes. #### Konfigurācija Lai piešķirtu trigerus kā saites indikatorus, rīkojieties šādi: - atlasiet kartes elementu - noklikšķiniet uz *Edit* sadaļā *Links* attiecīgajai saitei - noklikšķiniet uz *Add* blokā *Link indicators* un atlasiet vienu vai vairākus trigerus {width="600"} Visi obligātie ievades lauki ir atzīmēti ar sarkanu zvaigznīti. Pievienotie trigeri ir redzami sarakstā *Link indicators*. Katram trigerim varat tieši no saraksta iestatīt saites tipu un krāsu. Kad esat pabeidzis, noklikšķiniet uz *Apply*, aizveriet formu un noklikšķiniet uz *Update*, lai saglabātu kartes izmaiņas. #### Configuration To be able to send and receive notifications from Zabbix you have to: - [define the media](/manual/config/notifications/media) to send a message to If the operation takes place outside of the [When active](/manual/config/notifications/media#user-media) time period defined for the selected media in the user configuration, the message will not be sent. The default trigger severity ('Not classified') **must be** checked in user media [configuration](/manual/config/notifications/media/email#user-media) if you want to receive notifications for non-trigger events such as discovery, active agent autoregistration or internal events. - [configure an action operation](/manual/config/notifications/action/operation) that sends a message to one of the defined media ::: noteimportant Zabbix sends notifications only to those users that have at least 'read' permissions to the host that generated the event. At least one host of a trigger expression must be accessible. ::: You can configure custom scenarios for sending messages using [escalations](/manual/config/notifications/action/escalations). To successfully receive and read emails from Zabbix, email servers/clients must support standard 'SMTP/MIME email' format since Zabbix sends UTF-8 data (If the subject contains ASCII characters only, it is not UTF-8 encoded.). The subject and the body of the message are base64-encoded to follow 'SMTP/MIME email' format standard. Message limit after all macros expansion is the same as message limit for [Remote commands](/manual/config/notifications/action/operation/remote_command). #### Konfigurācija Lai varētu sūtīt un saņemt paziņojumus no Zabbix, jums ir: - [jādefinē datu nesējs](/manual/config/notifications/media), uz kuru sūtīt ziņojumu Ja darbība notiek ārpus laika perioda [When active](/manual/config/notifications/media#user-media), kas noteikts atlasītajam datu nesējam lietotāja konfigurācijā, ziņojums netiks nosūtīts. Noklusējuma trigera nopietnības līmenim ('Not classified') **jābūt** atzīmētam lietotāja datu nesēja [konfigurācijā](/manual/config/notifications/media/email#user-media), ja vēlaties saņemt paziņojumus par notikumiem, kas nav trigeru notikumi, piemēram, atklāšanu, aktīva aģenta automātisko reģistrāciju vai iekšējiem notikumiem. - [jākonfigurē darbības operācija](/manual/config/notifications/action/operation), kas sūta ziņojumu uz vienu no definētajiem datu nesējiem ::: noteimportant Zabbix sūta paziņojumus tikai tiem lietotājiem, kuriem ir vismaz 'read' atļaujas uz hostu, kas ģenerēja notikumu. Jābūt pieejamam vismaz vienam trigera izteiksmes hostam. ::: Varat konfigurēt pielāgotus ziņojumu sūtīšanas scenārijus, izmantojot [eskalācijas](/manual/config/notifications/action/escalations). Lai veiksmīgi saņemtu un lasītu e-pastus no Zabbix, e-pasta serveriem/klientiem jāatbalsta standarta 'SMTP/MIME email' formāts, jo Zabbix sūta UTF-8 datus (ja tēmā ir tikai ASCII rakstzīmes, tā netiek kodēta UTF-8 formātā). Ziņojuma tēma un pamatteksts tiek kodēti base64 formātā, lai atbilstu 'SMTP/MIME email' formāta standartam. Ziņojuma ierobežojums pēc visu makrosu izvēršanas ir tāds pats kā ziņojuma ierobežojums [attālinātajām komandām](/manual/config/notifications/action/operation/remote_command). #### Configuration To configure a CSV to JSON preprocessing step: - Go to the Preprocessing tab in [item](/manual/config/items/preprocessing)/[discovery rule](/manual/discovery/low_level_discovery#preprocessing) configuration - Click on *Add* - Select the *CSV to JSON* option {width="600"} The first parameter allows to set a custom delimiter. Note that if the first line of CSV input starts with "Sep=" and is followed by a single UTF-8 character then that character will be used as the delimiter in case the first parameter is not set. If the first parameter is not set and a delimiter is not retrieved from the "Sep=" line, then a comma is used as a separator. The second optional parameter allows to set a quotation symbol. If the *With header row* checkbox is marked, the header line values will be interpreted as column names (see [Header processing](#csv-header-processing) for more information). If the *Custom on fail* checkbox is marked, the item will not become unsupported in case of a failed preprocessing step. Additionally, custom error handling options may be set: discard the value, set a specified value or set a specified error message. #### Konfigurācija Lai konfigurētu CSV uz JSON pirmapstrādes soli: - Dodieties uz cilni Pirmapstrāde [vienums](/manual/config/items/preprocessing)/[atklāšanas noteikums](/manual/discovery/low_level_discovery#preprocessing) konfigurācijā - Noklikšķiniet uz *Add* - Atlasiet opciju *CSV to JSON* {width="600"} Pirmais parametrs ļauj iestatīt pielāgotu atdalītāju. Ņemiet vērā, ka, ja CSV ievades pirmā rinda sākas ar "Sep=" un tai seko viena UTF-8 rakstzīme, tad šī rakstzīme tiks izmantota kā atdalītājs, ja pirmais parametrs nav iestatīts. Ja pirmais parametrs nav iestatīts un no rindas "Sep=" netiek iegūts atdalītājs, tad kā atdalītājs tiek izmantots komats. Otrais neobligātais parametrs ļauj iestatīt pēdiņu simbolu. Ja ir atzīmēta izvēles rūtiņa *With header row*, galvenes rindas vērtības tiks interpretētas kā kolonnu nosaukumi (plašākai informācijai skatiet [Galvenes apstrāde](#csv-header-processing)). Ja ir atzīmēta izvēles rūtiņa *Custom on fail*, vienums nekļūs neatbalstīts neveiksmīga pirmapstrādes soļa gadījumā. Papildus var iestatīt pielāgotas kļūdu apstrādes opcijas: atmest vērtību, iestatīt norādītu vērtību vai iestatīt norādītu kļūdas ziņojumu. #### Configuration To configure a maintenance period: 1. Go to: *Data collection > Maintenance*. 2. Click on *Create maintenance period* (or on the name of an existing maintenance period). 3. Enter maintenance parameters in the form. {width="600"} All mandatory input fields are marked with a red asterisk. |Parameter|Description| |--|--------| |*Name*|Name of the maintenance period.| |*Maintenance type*|Two types of maintenance can be set:<br>**With data collection** - data is collected by the server during maintenance, and triggers are processed;<br>**No data collection** - data may still be collected, but it is not saved to the database during maintenance, and triggers (including the `nodata()` function) do not fire.<br>See [Effect of maintenance periods](/manual/web_interface/frontend_sections/reports/availability#effect-of-maintenance-periods) for how each type affects the availability report.| |*Active since*|The date and time when executing maintenance periods becomes active.<br>*Note:* Setting this time alone does not activate a maintenance period; maintenance periods must be configured in *Periods* (see below).| |*Active till*|The date and time when executing maintenance periods stops being active.| |*Periods*|This block allows you to define the exact days and hours when the maintenance takes place. Clicking on  opens a popup window with a flexible *Maintenance period* form where you can define maintenance schedule. See [Maintenance periods](#maintenance-periods) for a detailed description.| |*Host groups*|Select host groups that the maintenance will be activated for. The maintenance will be activated for all hosts from the specified host group(s). This field is auto-complete, so starting to type in it will display a dropdown of all available host groups.<br>Specifying a parent host group implicitly selects all nested host groups. Thus the maintenance will also be activated on hosts from nested groups.| |*Hosts*|Select hosts that the maintenance will be activated for. This field is auto-complete, so starting to type in it will display a dropdown of all available hosts.<br>| |*Tags*|Specify tags to [suppress problems](/manual/acknowledgment/suppression) with matching tags on hosts in maintenance.<br>Several conditions can be set. Tag name matching is always case-sensitive.<br><br>There are two operators available for each condition:<br>**Contains** - include the specified tag names where the tag values contain the entered string (substring match, case-sensitive);<br>**Equals** - include the specified tag names and values (case-sensitive).<br><br>There are two calculation types for conditions:<br>**And/Or** - all conditions must be met, conditions having the same tag name will be grouped by the Or condition;<br>**Or** - enough if one condition is met.<br><br>Tags can be specified only if the *With data collection* maintenance type is selected.| |*Description*|Description of maintenance period.| #### Konfigurācija Lai konfigurētu apkopes periodu: 1. Dodieties uz: *Datu vākšana > Apkope*. 2. Noklikšķiniet uz *Izveidot apkopes periodu* (vai uz esoša apkopes perioda nosaukuma). 3. Ievadiet apkopes parametrus formā. {width="600"} Visi obligātie ievades lauki ir atzīmēti ar sarkanu zvaigznīti. |Parameter|Description| |--|--------| |*Name*|Apkopes perioda nosaukums.| |*Maintenance type*|Var iestatīt divus apkopes veidus:<br>**Ar datu vākšanu** - apkopes laikā serveris vāc datus, un trigeri tiek apstrādāti;<br>**Bez datu vākšanas** - dati joprojām var tikt vākti, taču apkopes laikā tie netiek saglabāti datubāzē, un trigeri (tostarp funkcija `nodata()`) netiek aktivizēti.<br>Skatiet [Apkopes periodu ietekme](/manual/web_interface/frontend_sections/reports/availability#effect-of-maintenance-periods), lai uzzinātu, kā katrs veids ietekmē pieejamības pārskatu.| |*Active since*|Datums un laiks, kad apkopes periodu izpilde kļūst aktīva.<br>*Piezīme:* Šī laika iestatīšana vien pati par sevi neaktivizē apkopes periodu; apkopes periodi ir jākonfigurē sadaļā *Periods* (skatiet tālāk).| |*Active till*|Datums un laiks, kad apkopes periodu izpilde pārstāj būt aktīva.| |*Periods*|Šis bloks ļauj definēt precīzas dienas un stundas, kad notiek apkope. Noklikšķinot uz , tiek atvērts uznirstošais logs ar elastīgu *Maintenance period* formu, kurā var definēt apkopes grafiku. Detalizētu aprakstu skatiet sadaļā [Maintenance periods](#maintenance-periods).| |*Host groups*|Atlasiet hostu grupas, kurām apkope tiks aktivizēta. Apkope tiks aktivizēta visiem hostiem no norādītās hostu grupas(-ām). Šis lauks ir ar automātisko pabeigšanu, tāpēc, sākot rakstīt, tiks parādīts nolaižamais saraksts ar visām pieejamajām hostu grupām.<br>Norādot vecāko hostu grupu, netieši tiek atlasītas arī visas ligzdotās hostu grupas. Tādējādi apkope tiks aktivizēta arī hostiem no ligzdotajām grupām.| |*Hosts*|Atlasiet hostus, kuriem apkope tiks aktivizēta. Šis lauks ir ar automātisko pabeigšanu, tāpēc, sākot rakstīt, tiks parādīts nolaižamais saraksts ar visiem pieejamajiem hostiem.<br>| |*Tags*|Norādiet tagus, lai [slāpētu problēmas](/manual/acknowledgment/suppression) ar atbilstošiem tagiem hostos apkopes laikā.<br>Var iestatīt vairākus nosacījumus. Tagu nosaukumu salīdzināšana vienmēr ir reģistrjutīga.<br><br>Katrai nosacījuma rindai ir pieejami divi operatori:<br>**Contains** - iekļaut norādītos tagu nosaukumus, ja tagu vērtības satur ievadīto virkni (apakšvirknes atbilstība, reģistrjutīga);<br>**Equals** - iekļaut norādītos tagu nosaukumus un vērtības (reģistrjutīgi).<br><br>Nosacījumiem ir pieejami divi aprēķina veidi:<br>**And/Or** - jāizpildās visiem nosacījumiem, nosacījumi ar vienādu tagu nosaukumu tiks grupēti pēc Or nosacījuma;<br>**Or** - pietiek, ja izpildās viens nosacījums.<br><br>Tagus var norādīt tikai tad, ja ir atlasīts apkopes veids *Ar datu vākšanu*.| |*Description*|Apkopes perioda apraksts.| #### Configuration To configure an HTTP item: 1. Go to *Data collection* > *Hosts*. 2. Click *Items* in the row of the host. 3. Click *Create item*. 4. Enter parameters of the item in the form. {width="600"} All mandatory input fields are marked with a red asterisk. The fields that require specific information for HTTP items are: |Parameter|Description| |--|--------| |*Type*|Select **HTTP agent** here.| |*Key*|Enter a unique item key.| |*URL*|URL to connect to and retrieve data. For example:<br>https://www.example.com<br>http://www.example.com/download<br>Domain names can be specified in Unicode characters. They are automatically punycode-converted to ASCII when executing the HTTP check.<br>The *Parse* button can be used to separate optional query fields (like ?name=Admin&password=mypassword) from the URL, moving the attributes and values into *Query fields* for automatic URL-encoding.<br>Limited to 2048 characters.<br>Supported macros: {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}, {ITEM.KEY.ORIG}, user macros, low-level discovery macros.<br>This sets the [CURLOPT\_URL](https://curl.haxx.se/libcurl/c/CURLOPT_URL.html) cURL option.| |*Query fields*|Variables for the URL (see above).<br>Specified as attribute and value pairs.<br>Values are URL-encoded automatically. Values from macros are resolved and then URL-encoded automatically.<br>Supported macros: {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}, {ITEM.KEY.ORIG}, user macros, low-level discovery macros.<br>This sets the [CURLOPT\_URL](https://curl.haxx.se/libcurl/c/CURLOPT_URL.html) cURL option.| |*Request type*|Select request method type: *GET*, *POST*, *PUT* or *HEAD*| |*Request body type*|Select the request body type:<br>**Raw data** - custom HTTP request body, macros are substituted but no encoding is performed<br>**JSON data** - HTTP request body in JSON format. Macros can be used as string, number, true and false; macros used as strings must be enclosed in double quotes. Values from macros are resolved and then escaped automatically. If "Content-Type" is not specified in headers then it will default to "Content-Type: application/json"<br>**XML data** - HTTP request body in XML format. Macros can be used as a text node, attribute or CDATA section. Values from macros are resolved and then escaped automatically in a text node and attribute. If "Content-Type" is not specified in headers then it will default to "Content-Type: application/xml"<br>*Note* that selecting *XML data* requires libxml2.| |*Request body*|Enter the request body.<br>Supported macros: {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}, {ITEM.KEY.ORIG}, user macros, low-level discovery macros.| |*Headers*|Custom HTTP headers that will be sent when performing a request.<br>Specified as attribute and value pairs.<br>Supported macros: {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}, {ITEM.KEY.ORIG}, user macros, low-level discovery macros.<br>This sets the [CURLOPT\_HTTPHEADER](https://curl.haxx.se/libcurl/c/CURLOPT_HTTPHEADER.html) cURL option.| |*Required status codes*|List of expected HTTP status codes. If Zabbix gets a code which is not in the list, the item will become unsupported. If empty, no check is performed.<br>For example: 200,201,210-299<br>Supported macros in the list: user macros, low-level discovery macros.<br>This uses the [CURLINFO\_RESPONSE\_CODE](https://curl.haxx.se/libcurl/c/CURLINFO_RESPONSE_CODE.html) cURL option.| |*Follow redirects*|Mark the checkbox to follow HTTP redirects.<br>This sets the [CURLOPT\_FOLLOWLOCATION](https://curl.haxx.se/libcurl/c/CURLOPT_FOLLOWLOCATION.html) cURL option.| |*Retrieve mode*|Select the part of response that must be retrieved:<br>**Body** - body only<br>**Headers** - headers only<br>**Body and headers** - body and headers| |*Convert to JSON*|Headers are saved as attribute and value pairs under the "header" key if *Retrieve mode* is not set to *Body*.<br>If 'Content-Type: application/json' is encountered then body is saved as an object, otherwise it is stored as string, for example:<br>| |*HTTP proxy*|You can specify an HTTP proxy to use, using the format `[protocol://][username[:password]@]proxy.example.com[:port]`.<br>The optional `protocol://` prefix may be used to specify alternative proxy protocols (e.g. https, socks4, socks5; see [documentation](https://curl.haxx.se/libcurl/c/CURLOPT_PROXY.html); the protocol prefix support was added in cURL 7.21.7). With no protocol specified, the proxy will be treated as an HTTP proxy. If you specify the wrong protocol, the connection will fail and the item will become unsupported.<br>By default, 1080 port will be used.<br>If specified, the proxy will overwrite proxy related environment variables like http\_proxy, HTTPS\_PROXY. If not specified, the proxy will not overwrite proxy-related environment variables. The entered value is passed on "as is", no sanity checking takes place.<br>*Note* that only simple authentication is supported with HTTP proxy.<br>Supported macros: {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}, {ITEM.KEY.ORIG}, user macros, low-level discovery macros.<br>This sets the [CURLOPT\_PROXY](https://curl.haxx.se/libcurl/c/CURLOPT_PROXY.html) cURL option.| |*HTTP authentication*|Select the authentication option:<br>**None** - no authentication used;<br>**Basic** - basic authentication is used;<br>**NTLM** - NTLM ([Windows NT LAN Manager](http://en.wikipedia.org/wiki/NTLM)) authentication is used;<br>**Kerberos** - Kerberos authentication is used (see also: [Configuring Kerberos with Zabbix](/manual/appendix/items/kerberos));<br>**Digest** - Digest authentication is used.<br>This sets the [CURLOPT\_HTTPAUTH](https://curl.haxx.se/libcurl/c/CURLOPT_HTTPAUTH.html) cURL option.| |*User name*|Enter the user name (up to 255 characters).<br>This field is available if *HTTP authentication* is set to Basic, NTLM, Kerberos, or Digest. User macros and low-level discovery macros are supported. | |*Password*|Enter the user password (up to 255 characters).<br>This field is available if *HTTP authentication* is set to Basic, NTLM, Kerberos, or Digest. User macros and low-level discovery macros are supported. | |*SSL verify peer*|Mark the checkbox to verify the SSL certificate of the web server. The server certificate will be automatically taken from system-wide certificate authority (CA) location. You can override the location of CA files using Zabbix server or proxy configuration parameter SSLCALocation.<br>This sets the [CURLOPT\_SSL\_VERIFYPEER](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYPEER.html) cURL option.| |*SSL verify host*|Mark the checkbox to verify that the Common Name field or the Subject Alternate Name field of the web server certificate matches.<br>This sets the [CURLOPT\_SSL\_VERIFYHOST](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYHOST.html) cURL option.| |*SSL certificate file*|Name of the SSL certificate file used for client authentication. The certificate file must be in PEM^1^ format. If the certificate file contains also the private key, leave the SSL key file field empty. If the key is encrypted, specify the password in SSL key password field. The directory containing this file is specified by Zabbix server or proxy configuration parameter SSLCertLocation.<br>Supported macros: {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}, {ITEM.KEY.ORIG}, user macros, low-level discovery macros.<br>This sets the [CURLOPT\_SSLCERT](http://curl.haxx.se/libcurl/c/CURLOPT_SSLCERT.html) cURL option.| |*SSL key file*|Name of the SSL private key file used for client authentication. The private key file must be in PEM^1^ format. The directory containing this file is specified by Zabbix server or proxy configuration parameter SSLKeyLocation.<br>Supported macros: {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}, {ITEM.KEY.ORIG}, user macros, low-level discovery macros.<br>This sets the [CURLOPT\_SSLKEY](http://curl.haxx.se/libcurl/c/CURLOPT_SSLKEY.html) cURL option.| |*SSL key password*|SSL private key file password.<br>Supported macros: user macros, low-level discovery macros.<br>This sets the [CURLOPT\_KEYPASSWD](http://curl.haxx.se/libcurl/c/CURLOPT_KEYPASSWD.html) cURL option.| |*Timeout*|Zabbix will not spend more than the set amount of time on processing the URL (1-600 seconds). Actually this parameter defines the maximum time for making a connection to the URL and maximum time for performing an HTTP request. Therefore, Zabbix will not spend more than 2 x *Timeout* seconds on one check.<br>This sets the [CURLOPT\_TIMEOUT](https://curl.haxx.se/libcurl/c/CURLOPT_TIMEOUT.html) cURL option.<br>For more information on the *Timeout* parameter, see [general item attributes](/manual/config/items/item#configuration).| |*Enable trapping*|With this checkbox marked, the item will also function as a trapper item and will accept data sent to Zabbix server or proxy using the [Zabbix sender](/manual/concepts/sender) utility or Zabbix sender [protocol](/manual/appendix/protocols/zabbix_sender), or will accept data sent to Zabbix server using the [`history.push`](/manual/api/reference/history/push) API method. For more information about sending data, see: [Trapper items](/manual/config/items/itemtypes/trapper#sending-data).| |*Allowed hosts*|Visible only if *Enable trapping* checkbox is marked.<br>List of comma delimited IP addresses, optionally in CIDR notation, or DNS names.<br>If specified, incoming connections will be accepted only from the hosts listed here.<br>If IPv6 support is enabled then '127.0.0.1', '::127.0.0.1', '::ffff:127.0.0.1' are treated equally and '::/0' will allow any IPv4 or IPv6 address.<br>'0.0.0.0/0' can be used to allow any IPv4 address.<br>Note that "IPv4-compatible IPv6 addresses" (0000::/96 prefix) are supported but deprecated by [RFC4291](https://tools.ietf.org/html/rfc4291#section-2.5.5).<br>Example: 127.0.0.1, 192.168.1.0/24, 192.168.3.1-255, 192.168.1-10.1-255, ::1,2001:db8::/32, mysqlserver1, zabbix.example.com, {HOST.HOST}<br>Spaces and [user macros](/manual/config/macros/user_macros) are allowed in this field.<br>Host macros: {HOST.HOST}, {HOST.NAME}, {HOST.IP}, {HOST.DNS}, {HOST.CONN} are allowed in this field.| ::: notetip If the *HTTP proxy* field is left empty, another way for using an HTTP proxy is to set proxy-related environment variables. For HTTP - set the `http_proxy` environment variable for the Zabbix server user. For example:<br> `http_proxy=http://proxy_ip:proxy_port`. For HTTPS - set the `HTTPS_PROXY` environment variable. For example:<br> `HTTPS_PROXY=http://proxy_ip:proxy_port`. More details are available by running a shell command: *\# man curl*. ::: ::: noteimportant \[1\] Zabbix supports certificate and private key files in PEM format only. In case you have your certificate and private key data in PKCS \#12 format file (usually with extension \*.p12 or \*.pfx) you may generate the PEM file from it using the following commands: openssl pkcs12 -in ssl-cert.p12 -clcerts -nokeys -out ssl-cert.pem openssl pkcs12 -in ssl-cert.p12 -nocerts -nodes -out ssl-cert.key ::: #### Konfigurācija Lai konfigurētu HTTP vienumu: 1. Dodieties uz *Data collection* > *Hosts*. 2. Hosta rindā noklikšķiniet uz *Items*. 3. Noklikšķiniet uz *Create item*. 4. Formā ievadiet vienuma parametrus. {width="600"} Visi obligātie ievades lauki ir atzīmēti ar sarkanu zvaigznīti. Lauki, kuriem HTTP vienumiem nepieciešama specifiska informācija, ir: |Parameter|Description| |--|--------| |*Type*|Šeit izvēlieties **HTTP agent**.| |*Key*|Ievadiet unikālu vienuma atslēgu.| |*URL*|URL, ar kuru izveidot savienojumu un iegūt datus. Piemēram:<br>https://www.example.com<br>http://www.example.com/download<br>Domēna nosaukumus var norādīt Unicode rakstzīmēs. HTTP pārbaudes izpildes laikā tie automātiski tiek pārveidoti no punycode uz ASCII.<br>Pogu *Parse* var izmantot, lai atdalītu izvēles vaicājuma laukus (piemēram, ?name=Admin&password=mypassword) no URL, pārvietojot atribūtus un vērtības uz *Query fields* automātiskai URL kodēšanai.<br>Atļauts līdz 2048 rakstzīmēm.<br>Atbalstītie makrosi: {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}, {ITEM.KEY.ORIG}, lietotāja makrosi, zema līmeņa atklāšanas makrosi.<br>Tas iestata cURL opciju [CURLOPT\_URL](https://curl.haxx.se/libcurl/c/CURLOPT_URL.html).| |*Query fields*|URL mainīgie (skatiet iepriekš).<br>Norādāmi kā atribūtu un vērtību pāri.<br>Vērtības tiek automātiski URL kodētas. Vērtības no makro tiek aizstātas un pēc tam automātiski URL kodētas.<br>Atbalstītie makrosi: {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}, {ITEM.KEY.ORIG}, lietotāja makrosi, zema līmeņa atklāšanas makrosi.<br>Tas iestata cURL opciju [CURLOPT\_URL](https://curl.haxx.se/libcurl/c/CURLOPT_URL.html).| |*Request type*|Izvēlieties pieprasījuma metodi: *GET*, *POST*, *PUT* vai *HEAD*| |*Request body type*|Izvēlieties pieprasījuma ķermeņa tipu:<br>**Raw data** - pielāgots HTTP pieprasījuma ķermenis, makrosi tiek aizstāti, bet kodēšana netiek veikta<br>**JSON data** - HTTP pieprasījuma ķermenis JSON formātā. Makrosus var izmantot kā virkni, skaitli, true un false; makrosi, kas tiek izmantoti kā virknes, jāievieto dubultpēdiņās. Vērtības no makro tiek aizstātas un pēc tam automātiski ekrānētas. Ja galvenēs nav norādīts "Content-Type", pēc noklusējuma tiks izmantots "Content-Type: application/json"<br>**XML data** - HTTP pieprasījuma ķermenis XML formātā. Makrosus var izmantot kā teksta mezglu, atribūtu vai CDATA sadaļu. Vērtības no makro tiek aizstātas un pēc tam automātiski ekrānētas teksta mezglā un atribūtā. Ja galvenēs nav norādīts "Content-Type", pēc noklusējuma tiks izmantots "Content-Type: application/xml"<br>*Piezīme*: izvēloties *XML data*, ir nepieciešams libxml2.| |*Request body*|Ievadiet pieprasījuma ķermeni.<br>Atbalstītie makrosi: {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}, {ITEM.KEY.ORIG}, lietotāja makrosi, zema līmeņa atklāšanas makrosi.| |*Headers*|Pielāgotas HTTP galvenes, kas tiks nosūtītas, veicot pieprasījumu.<br>Norādāmas kā atribūtu un vērtību pāri.<br>Atbalstītie makrosi: {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}, {ITEM.KEY.ORIG}, lietotāja makrosi, zema līmeņa atklāšanas makrosi.<br>Tas iestata cURL opciju [CURLOPT\_HTTPHEADER](https://curl.haxx.se/libcurl/c/CURLOPT_HTTPHEADER.html).| |*Required status codes*|Sagaidāmo HTTP statusa kodu saraksts. Ja Zabbix saņem kodu, kas nav sarakstā, vienums kļūs neatbalstīts. Ja lauks ir tukšs, pārbaude netiek veikta.<br>Piemēram: 200,201,210-299<br>Sarakstā atbalstītie makrosi: lietotāja makrosi, zema līmeņa atklāšanas makrosi.<br>Tiek izmantota cURL opcija [CURLINFO\_RESPONSE\_CODE](https://curl.haxx.se/libcurl/c/CURLINFO_RESPONSE_CODE.html).| |*Follow redirects*|Atzīmējiet izvēles rūtiņu, lai sekotu HTTP pāradresācijām.<br>Tas iestata cURL opciju [CURLOPT\_FOLLOWLOCATION](https://curl.haxx.se/libcurl/c/CURLOPT_FOLLOWLOCATION.html).| |*Retrieve mode*|Izvēlieties to atbildes daļu, kas jāiegūst:<br>**Body** - tikai ķermenis<br>**Headers** - tikai galvenes<br>**Body and headers** - ķermenis un galvenes| |*Convert to JSON*|Ja *Retrieve mode* nav iestatīts uz *Body*, galvenes tiek saglabātas kā atribūtu un vērtību pāri zem atslēgas "header".<br>Ja tiek atrasts 'Content-Type: application/json', ķermenis tiek saglabāts kā objekts, pretējā gadījumā tas tiek glabāts kā virkne, piemēram:<br>| |*HTTP proxy*|Varat norādīt izmantojamo HTTP starpniekserveri, izmantojot formātu `[protocol://][username[:password]@]proxy.example.com[:port]`.<br>Neobligāto prefiksu `protocol://` var izmantot, lai norādītu alternatīvus starpniekservera protokolus (piemēram, https, socks4, socks5; skatiet [dokumentāciju](https://curl.haxx.se/libcurl/c/CURLOPT_PROXY.html); protokola prefiksa atbalsts tika pievienots cURL 7.21.7). Ja protokols nav norādīts, starpniekserveris tiks uzskatīts par HTTP starpniekserveri. Ja norādīsiet nepareizu protokolu, savienojums neizdosies un vienums kļūs neatbalstīts.<br>Pēc noklusējuma tiks izmantots 1080 ports.<br>Ja norādīts, starpniekserveris pārrakstīs ar starpniekserveri saistītos vides mainīgos, piemēram, http\_proxy, HTTPS\_PROXY. Ja nav norādīts, starpniekserveris nepārrakstīs ar starpniekserveri saistītos vides mainīgos. Ievadītā vērtība tiek nodota "tā, kā ir", bez jebkādas pārbaudes.<br>*Piezīme*: ar HTTP starpniekserveri tiek atbalstīta tikai vienkārša autentifikācija.<br>Atbalstītie makrosi: {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}, {ITEM.KEY.ORIG}, lietotāja makrosi, zema līmeņa atklāšanas makrosi.<br>Tas iestata cURL opciju [CURLOPT\_PROXY](https://curl.haxx.se/libcurl/c/CURLOPT_PROXY.html).| |*HTTP authentication*|Izvēlieties autentifikācijas opciju:<br>**None** - autentifikācija netiek izmantota;<br>**Basic** - tiek izmantota pamata autentifikācija;<br>**NTLM** - tiek izmantota NTLM ([Windows NT LAN Manager](http://en.wikipedia.org/wiki/NTLM)) autentifikācija;<br>**Kerberos** - tiek izmantota Kerberos autentifikācija (skatiet arī: [Kerberos konfigurēšana ar Zabbix](/manual/appendix/items/kerberos));<br>**Digest** - tiek izmantota Digest autentifikācija.<br>Tas iestata cURL opciju [CURLOPT\_HTTPAUTH](https://curl.haxx.se/libcurl/c/CURLOPT_HTTPAUTH.html).| |*User name*|Ievadiet lietotājvārdu (līdz 255 rakstzīmēm).<br>Šis lauks ir pieejams, ja *HTTP authentication* ir iestatīts uz Basic, NTLM, Kerberos vai Digest. Tiek atbalstīti lietotāja makrosi un zema līmeņa atklāšanas makrosi. | |*Password*|Ievadiet lietotāja paroli (līdz 255 rakstzīmēm).<br>Šis lauks ir pieejams, ja *HTTP authentication* ir iestatīts uz Basic, NTLM, Kerberos vai Digest. Tiek atbalstīti lietotāja makrosi un zema līmeņa atklāšanas makrosi. | |*SSL verify peer*|Atzīmējiet izvēles rūtiņu, lai pārbaudītu tīmekļa servera SSL sertifikātu. Servera sertifikāts tiks automātiski ņemts no sistēmas mēroga sertifikātu autoritātes (CA) atrašanās vietas. CA failu atrašanās vietu var pārrakstīt, izmantojot Zabbix servera vai starpniekservera konfigurācijas parametru SSLCALocation.<br>Tas iestata cURL opciju [CURLOPT\_SSL\_VERIFYPEER](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYPEER.html).| |*SSL verify host*|Atzīmējiet izvēles rūtiņu, lai pārbaudītu, vai tīmekļa servera sertifikāta Common Name lauks vai Subject Alternate Name lauks atbilst.<br>Tas iestata cURL opciju [CURLOPT\_SSL\_VERIFYHOST](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYHOST.html).| |*SSL certificate file*|SSL sertifikāta faila nosaukums, ko izmanto klienta autentifikācijai. Sertifikāta failam jābūt PEM^1^ formātā. Ja sertifikāta failā ir arī privātā atslēga, atstājiet SSL atslēgas faila lauku tukšu. Ja atslēga ir šifrēta, norādiet paroli SSL atslēgas paroles laukā. Katalogs, kurā atrodas šis fails, ir norādīts Zabbix servera vai starpniekservera konfigurācijas parametrā SSLCertLocation.<br>Atbalstītie makrosi: {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}, {ITEM.KEY.ORIG}, lietotāja makrosi, zema līmeņa atklāšanas makrosi.<br>Tas iestata cURL opciju [CURLOPT\_SSLCERT](http://curl.haxx.se/libcurl/c/CURLOPT_SSLCERT.html).| |*SSL key file*|SSL privātās atslēgas faila nosaukums, ko izmanto klienta autentifikācijai. Privātās atslēgas failam jābūt PEM^1^ formātā. Katalogs, kurā atrodas šis fails, ir norādīts Zabbix servera vai starpniekservera konfigurācijas parametrā SSLKeyLocation.<br>Atbalstītie makrosi: {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}, {ITEM.KEY.ORIG}, lietotāja makrosi, zema līmeņa atklāšanas makrosi.<br>Tas iestata cURL opciju [CURLOPT\_SSLKEY](http://curl.haxx.se/libcurl/c/CURLOPT_SSLKEY.html).| |*SSL key password*|SSL privātās atslēgas faila parole.<br>Atbalstītie makrosi: lietotāja makrosi, zema līmeņa atklāšanas makrosi.<br>Tas iestata cURL opciju [CURLOPT\_KEYPASSWD](http://curl.haxx.se/libcurl/c/CURLOPT_KEYPASSWD.html).| |*Timeout*|Zabbix nepavadīs vairāk par iestatīto laiku URL apstrādei (1-600 sekundes). Faktiski šis parametrs nosaka maksimālo laiku savienojuma izveidei ar URL un maksimālo laiku HTTP pieprasījuma veikšanai. Tāpēc Zabbix vienā pārbaudē nepavadīs vairāk par 2 x *Timeout* sekundēm.<br>Tas iestata cURL opciju [CURLOPT\_TIMEOUT](https://curl.haxx.se/libcurl/c/CURLOPT_TIMEOUT.html).<br>Lai iegūtu vairāk informācijas par *Timeout* parametru, skatiet [vispārīgos vienuma atribūtus](/manual/config/items/item#configuration).| |*Enable trapping*|Ja šī izvēles rūtiņa ir atzīmēta, vienums darbosies arī kā traperis vienums un pieņems datus, kas nosūtīti uz Zabbix serveri vai starpniekserveri, izmantojot utilītu [Zabbix sender](/manual/concepts/sender) vai Zabbix sender [protokolu](/manual/appendix/protocols/zabbix_sender), vai arī pieņems datus, kas nosūtīti uz Zabbix serveri, izmantojot [`history.push`](/manual/api/reference/history/push) API metodi. Plašāku informāciju par datu nosūtīšanu skatiet: [Traperis vienumi](/manual/config/items/itemtypes/trapper#sending-data).| |*Allowed hosts*|Redzams tikai tad, ja ir atzīmēta izvēles rūtiņa *Enable trapping*.<br>Ar komatiem atdalīts IP adrešu saraksts, pēc izvēles CIDR notācijā, vai DNS nosaukumi.<br>Ja norādīts, ienākošie savienojumi tiks pieņemti tikai no šeit uzskaitītajiem hostiem.<br>Ja ir iespējots IPv6 atbalsts, tad '127.0.0.1', '::127.0.0.1', '::ffff:127.0.0.1' tiek uzskatīti par ekvivalentiem, un '::/0' ļaus jebkuru IPv4 vai IPv6 adresi.<br>'0.0.0.0/0' var izmantot, lai atļautu jebkuru IPv4 adresi.<br>Ņemiet vērā, ka "IPv4-compatible IPv6 addresses" (0000::/96 prefikss) tiek atbalstītas, bet ir novecojušas saskaņā ar [RFC4291](https://tools.ietf.org/html/rfc4291#section-2.5.5).<br>Piemērs: 127.0.0.1, 192.168.1.0/24, 192.168.3.1-255, 192.168.1-10.1-255, ::1,2001:db8::/32, mysqlserver1, zabbix.example.com, {HOST.HOST}<br>Šajā laukā ir atļautas atstarpes un [lietotāja makrosi](/manual/config/macros/user_macros).<br>Šajā laukā ir atļauti hosta makrosi: {HOST.HOST}, {HOST.NAME}, {HOST.IP}, {HOST.DNS}, {HOST.CONN}.| ::: notetip Ja lauks *HTTP proxy* ir atstāts tukšs, cits veids, kā izmantot HTTP starpniekserveri, ir iestatīt ar starpniekserveri saistītos vides mainīgos. HTTP gadījumā iestatiet `http_proxy` vides mainīgo Zabbix servera lietotājam. Piemēram:<br> `http_proxy=http://proxy_ip:proxy_port`. HTTPS gadījumā iestatiet `HTTPS_PROXY` vides mainīgo. Piemēram:<br> `HTTPS_PROXY=http://proxy_ip:proxy_port`. Papildu informācija pieejama, izpildot čaulas komandu: *\# man curl*. ::: ::: noteimportant \[1\] Zabbix atbalsta tikai PEM formāta sertifikātu un privātās atslēgas failus. Ja sertifikāta un privātās atslēgas dati ir PKCS \#12 formāta failā (parasti ar paplašinājumu \*.p12 vai \*.pfx), no tā varat izveidot PEM failu, izmantojot šādas komandas: openssl pkcs12 -in ssl-cert.p12 -clcerts -nokeys -out ssl-cert.pem openssl pkcs12 -in ssl-cert.p12 -nocerts -nodes -out ssl-cert.key #### Configuration To configure a trapper item: 1. Go to *Data collection* → *Hosts*. 2. Click *Items* in the row of the host. 3. Click *Create item*. 4. Enter item parameters in the configuration form. {width="600"} All mandatory input fields are marked with a red asterisk. The fields that require specific information for trapper items are: | | | |--|--------| |*Type*|Select "Zabbix trapper".| |*Key*|Enter a key that will be used to recognize the item when sending data to Zabbix server.| |*Type of information*|Select the type of information that will correspond to the format of data that will be sent.| |*Allowed hosts*|List of comma-delimited IP addresses (optionally in CIDR notation) or DNS names.<br><br>If specified, incoming connections will be accepted only from the hosts listed here.<br>If IPv6 support is enabled then '127.0.0.1', '::127.0.0.1', '::ffff:127.0.0.1' are treated equally and '::/0' will allow any IPv4 or IPv6 address. '0.0.0.0/0' can be used to allow any IPv4 address.<br><br>Note that "IPv4-compatible IPv6 addresses" (0000::/96 prefix) are supported but deprecated by [RFC4291](https://tools.ietf.org/html/rfc4291#section-2.5.5).<br><br>Example: 127.0.0.1, 192.168.1.0/24, 192.168.3.1-255, 192.168.1-10.1-255, ::1,2001:db8::/32, mysqlserver1, zabbix.example.com, {HOST.HOST}<br><br>Spaces, [user macros](/manual/config/macros/user_macros), and host macros {HOST.HOST}, {HOST.NAME}, {HOST.IP}, {HOST.DNS}, {HOST.CONN} are supported.| ::: noteclassic Before sending values, you may have to wait up to 60 seconds after saving the item until Zabbix server picks up the changes from a configuration cache update. ::: #### Konfigurācija Lai konfigurētu trapper vienumu: 1. Dodieties uz *Datu vākšana* → *Hosts*. 2. Hosta rindā noklikšķiniet uz *Vienumi*. 3. Noklikšķiniet uz *Izveidot vienumu*. 4. Konfigurācijas formā ievadiet vienuma parametrus. {width="600"} Visi obligātie ievades lauki ir atzīmēti ar sarkanu zvaigznīti. Lauki, kuriem trapper vienumiem ir nepieciešama specifiska informācija, ir šādi: | | | |--|--------| |*Type*|Atlasiet "Zabbix trapper".| |*Key*|Ievadiet atslēgu, kas tiks izmantota vienuma atpazīšanai, sūtot datus uz Zabbix serveris.| |*Type of information*|Atlasiet informācijas tipu, kas atbildīs sūtāmo datu formātam.| |*Allowed hosts*|Ar komatiem atdalītu IP adrešu saraksts (pēc izvēles CIDR notācijā) vai DNS nosaukumi.<br><br>Ja norādīts, ienākošie savienojumi tiks pieņemti tikai no šeit uzskaitītajiem hosts.<br><br>Ja ir iespējots IPv6 atbalsts, tad '127.0.0.1', '::127.0.0.1', '::ffff:127.0.0.1' tiek uzskatīti par ekvivalentiem, un '::/0' ļaus jebkuru IPv4 vai IPv6 adresi. '0.0.0.0/0' var izmantot, lai atļautu jebkuru IPv4 adresi.<br><br>Ņemiet vērā, ka "IPv4-compatible IPv6 addresses" (0000::/96 prefikss) tiek atbalstītas, taču tās ir novecojušas saskaņā ar [RFC4291](https://tools.ietf.org/html/rfc4291#section-2.5.5).<br><br>Piemērs: 127.0.0.1, 192.168.1.0/24, 192.168.3.1-255, 192.168.1-10.1-255, ::1,2001:db8::/32, mysqlserver1, zabbix.example.com, {HOST.HOST}<br><br>Tiek atbalstītas atstarpes, [lietotāja makro](/manual/config/macros/user_macros) un host makro {HOST.HOST}, {HOST.NAME}, {HOST.IP}, {HOST.DNS}, {HOST.CONN}.| ::: noteclassic Pirms vērtību nosūtīšanas pēc vienuma saglabāšanas var būt jāgaida līdz pat 60 sekundēm, līdz Zabbix serveris no konfigurācijas kešatmiņas atjauninājuma paņems izmaiņas. ::: #### Configuration To configure a user group: 1. Go to *Users* > *User groups*. 2. Click *Create user group* (or the group name to edit an existing group). 3. Edit group attributes in the form. The **User group** tab contains general group attributes: {width=600} All mandatory input fields are marked with a red asterisk. |Parameter|Description| |--|--------| |*Group name*|Unique group name.| |*Users*|To add users to the group start typing the name of an existing user. When the dropdown with matching user names appears, scroll down to select.<br>Alternatively you may click the *Select* button to select users in a popup.| |*Frontend access*|How the users of the group are authenticated.<br>**System default** - use default authentication method (set [globally](/manual/web_interface/frontend_sections/users/authentication))<br>**Internal** - use Zabbix internal authentication (even if LDAP authentication is used globally).<br>Ignored if HTTP authentication is the global default.<br>**LDAP** - use LDAP authentication (even if internal authentication is used globally).<br>Ignored if HTTP authentication is the global default.<br>**Disabled** - access to Zabbix frontend is forbidden for this group| |*LDAP server*|Select which [LDAP server](/manual/web_interface/frontend_sections/users/authentication/ldap#configuration) to use to authenticate the user.<br>This field is enabled only if *Frontend access* is set to LDAP or System default.| |*Multi-factor authentication*|Select which multi-factor authentication [method](/manual/web_interface/frontend_sections/users/authentication/mfa#method-configuration) to use to authenticate the user:<br>**Default** - use the method set as default in MFA configuration; this option is selected by default for new user groups if MFA is enabled;<br>**\<Method name\>** - use selected method (for example, "Zabbix TOTP");<br>**Disabled** - MFA is disabled for this group; this option is selected by default for new user groups if MFA is disabled.<br>Note that if a user belongs to multiple user groups with MFA enabled (or at least one group has MFA enabled), the following authentication rules apply: if any group uses the "Default" MFA method, it will authenticate the user; otherwise, the first method (ordered alphabetically) will be used for authentication.| |*Enabled*|Status of user group and group members.<br>*Checked* - user group and users are enabled<br>*Unchecked* - user group and users are disabled| |*Debug mode*|Mark this checkbox to activate [debug mode](/manual/web_interface/debug_mode) for the users.| The **Template permissions** tab allows specifying user group access to template group (and thereby template) data: {width="600"} The **Host permissions** tab allows specifying user group access to host group (and thereby host) data: {width="600"} Click {class="nozoom"} to choose the template/host groups (be it a parent or a nested group) and assign permissions to those. Start typing the group name (a dropdown of matching groups will appear) or click *Select* for a popup window listing all groups to be opened. Then use the option buttons to assign permissions to the chosen groups. Possible permissions are the following: - **Read-write** - read-write access to a group; - **Read** - read-only access to a group; - **Deny** - access to a group denied. If the same template/host group is added in several rows with different permissions set, the strictest permission will be applied. Note that a *Super admin* user can enforce nested groups to have the same level of permissions as the parent group; this can be done in the [host](/manual/config/hosts/host_groups)/[template](/manual/config/templates/template_groups) group configuration form. **Template permissions** and **Host permissions** tabs support the same set of parameters. Current permissions to groups are displayed in the *Permissions* block, and those can be modified or removed. :::noteclassic If a user group has **Read-write** permissions to a host and **Deny** or no permissions to a template linked to this host, the users of such group will not be able to edit templated items on the host, and template name will be displayed as *Inaccessible template*. ::: The **Problem tag filter** tab allows setting tag-based permissions for user groups to see problems filtered by tag name and value: {width=600} Click {class="nozoom"} to choose the host groups. To select a host group to apply a tag filter for, click *Select* to get the complete list of existing host groups or start typing the name of a host group to get a dropdown of matching groups. Only host groups will be displayed, because problem tag filter cannot be applied to template groups. Then it is possible to switch from *All tags* to *Tag list* in order to set particular tags and their values for filtering. Tag names without values can be added, but values without names cannot. Only the first three tags (with values, if any) are displayed in the *Permissions* block; if there are more, those can be seen by clicking or hovering over the {class="nozoom"} icon. Tag filter allows separating the access to host group from the possibility to see problems. For example, if a database administrator needs to see only "MySQL" database problems, it is required to create a user group for database administrators first, then specify "target" tag name and "mysql" value. {width=600} If "target" tag name is specified and value field is left blank, the user group will see all problems with tag name "target" for the selected host group. If *All tags* is selected, the user group will see all problems for the specified host group. Make sure tag name and tag value are correctly specified, otherwise, the user group will not see any problems. Let's review an example when a user is a member of several user groups selected. Filtering in this case will use OR condition for tags. | | | | | | | | |---|---|---|---|---|---|---| |**User group A**|<|<|**User group B**|<|<|**Visible result for a user (member) of both groups**| |*Tag filter*|<|<|<|<|<|^| |*Host group*|*Tag name*|*Tag value*|*Host group*|*Tag name*|*Tag value*|^| |Databases|target|mysql|Databases|target|oracle|target:mysql or target:oracle problems visible| |Databases|set to: *All tags*|<|Databases|target|oracle|All problems visible| |Not configured in the **Problem tag filter**|<|<|Databases|target|oracle|target:oracle problems visible| ::: noteimportant Adding a filter (for example, all tags in a certain host group "Databases") results in not being able to see the problems of other host groups. ::: #### Konfigurācija Lai konfigurētu lietotāju grupu: 1. Dodieties uz *Users* > *User groups*. 2. Noklikšķiniet *Create user group* (vai grupas nosaukumu, lai rediģētu esošu grupu). 3. Veidlapā rediģējiet grupas atribūtus. Cilnē **User group** ir ietverti vispārīgie grupas atribūti: {width=600} Visi obligātie ievades lauki ir atzīmēti ar sarkanu zvaigznīti. |Parameter|Description| |--|--------| |*Group name*|Unikāls grupas nosaukums.| |*Users*|Lai pievienotu lietotājus grupai, sāciet rakstīt esoša lietotāja vārdu. Kad parādās nolaižamais saraksts ar atbilstošajiem lietotāju vārdiem, ritiniet uz leju, lai atlasītu.<br>Alternatīvi varat noklikšķināt uz pogas *Select*, lai lietotājus atlasītu uznirstošajā logā.| |*Frontend access*|Kā grupas lietotāji tiek autentificēti.<br>**System default** - izmantot noklusējuma autentifikācijas metodi (iestatīta [globāli](/manual/web_interface/frontend_sections/users/authentication))<br>**Internal** - izmantot Zabbix iekšējo autentifikāciju (pat ja LDAP autentifikācija tiek izmantota globāli).<br>Tiek ignorēts, ja HTTP autentifikācija ir globālais noklusējums.<br>**LDAP** - izmantot LDAP autentifikāciju (pat ja iekšējā autentifikācija tiek izmantota globāli).<br>Tiek ignorēts, ja HTTP autentifikācija ir globālais noklusējums.<br>**Disabled** - piekļuve Zabbix lietotāja saskarnei šai grupai ir aizliegta| |*LDAP server*|Atlasiet, kuru [LDAP serveri](/manual/web_interface/frontend_sections/users/authentication/ldap#configuration) izmantot lietotāja autentificēšanai.<br>Šis lauks ir iespējots tikai tad, ja *Frontend access* ir iestatīts uz LDAP vai System default.| |*Multi-factor authentication*|Atlasiet, kuru daudzfaktoru autentifikācijas [metodi](/manual/web_interface/frontend_sections/users/authentication/mfa#method-configuration) izmantot lietotāja autentificēšanai:<br>**Default** - izmantot MFA konfigurācijā kā noklusējumu iestatīto metodi; šī opcija pēc noklusējuma ir atlasīta jaunām lietotāju grupām, ja MFA ir iespējota;<br>**\<Method name\>** - izmantot atlasīto metodi (piemēram, "Zabbix TOTP");<br>**Disabled** - MFA šai grupai ir atspējota; šī opcija pēc noklusējuma ir atlasīta jaunām lietotāju grupām, ja MFA ir atspējota.<br>Ņemiet vērā: ja lietotājs pieder vairākām lietotāju grupām ar iespējotu MFA (vai vismaz vienai grupai MFA ir iespējota), tiek piemēroti šādi autentifikācijas noteikumi: ja kādā grupā tiek izmantota MFA metode "Default", tā autentificēs lietotāju; pretējā gadījumā autentifikācijai tiks izmantota pirmā metode (sakārtota alfabētiskā secībā).| |*Enabled*|Lietotāju grupas un grupas dalībnieku statuss.<br>*Checked* - lietotāju grupa un lietotāji ir iespējoti<br>*Unchecked* - lietotāju grupa un lietotāji ir atspējoti| |*Debug mode*|Atzīmējiet šo izvēles rūtiņu, lai lietotājiem aktivizētu [atkļūdošanas režīmu](/manual/web_interface/debug_mode).| Cilne **Template permissions** ļauj norādīt lietotāju grupas piekļuvi veidņu grupas (un līdz ar to arī veidnes) datiem: {width="600"} Cilne **Host permissions** ļauj norādīt lietotāju grupas piekļuvi hostu grupas (un līdz ar to arī hostu) datiem: {width="600"} Noklikšķiniet uz {class="nozoom"}, lai izvēlētos veidņu/hostu grupas (gan vecākgrupu, gan ligzdotu grupu) un piešķirtu tām atļaujas. Sāciet rakstīt grupas nosaukumu (tiks parādīts atbilstošo grupu nolaižamais saraksts) vai noklikšķiniet uz *Select*, lai atvērtu uznirstošo logu ar visu grupu sarakstu. Pēc tam izmantojiet opciju pogas, lai piešķirtu atļaujas izvēlētajām grupām. Iespējamās atļaujas ir šādas: - **Read-write** - lasīšanas un rakstīšanas piekļuve grupai; - **Read** - tikai lasīšanas piekļuve grupai; - **Deny** - piekļuve grupai liegta. Ja viena un tā pati veidņu/hostu grupa tiek pievienota vairākās rindās ar atšķirīgi iestatītām atļaujām, tiks piemērota stingrākā atļauja. Ņemiet vērā, ka *Super admin* lietotājs var piespiest ligzdotajām grupām izmantot tādu pašu atļauju līmeni kā vecākgrupai; to var izdarīt [hostu](/manual/config/hosts/host_groups)/[veidņu](/manual/config/templates/template_groups) grupas konfigurācijas formā. Cilnes **Template permissions** un **Host permissions** atbalsta vienu un to pašu parametru kopu. Pašreizējās atļaujas grupām tiek parādītas blokā *Permissions*, un tās var modificēt vai noņemt. :::noteclassic Ja lietotāju grupai ir **Read-write** atļaujas hostam un **Deny** vai nav atļauju veidnei, kas ir saistīta ar šo hostu, šādas grupas lietotāji nevarēs rediģēt no veidnes atvasinātos vienumus hostā, un veidnes nosaukums tiks parādīts kā *Inaccessible template*. ::: Cilne **Problem tag filter** ļauj iestatīt uz tagiem balstītas atļaujas lietotāju grupām, lai skatītu problēmas, kas filtrētas pēc taga nosaukuma un vērtības: {width=600} Noklikšķiniet uz {class="nozoom"}, lai izvēlētos hostu grupas. Lai atlasītu hostu grupu, kurai piemērot taga filtru, noklikšķiniet uz *Select*, lai iegūtu pilnu esošo hostu grupu sarakstu, vai sāciet rakstīt hostu grupas nosaukumu, lai parādītos atbilstošo grupu nolaižamais saraksts. Tiks parādītas tikai hostu grupas, jo problēmu taga filtru nevar piemērot veidņu grupām. Pēc tam ir iespējams pārslēgties no *All tags* uz *Tag list*, lai iestatītu konkrētus tagus un to vērtības filtrēšanai. Tagu nosaukumus bez vērtībām var pievienot, bet vērtības bez nosaukumiem nevar. Tikai pirmie trīs tagi (ar vērtībām, ja tādas ir) tiek parādīti blokā *Permissions*; ja to ir vairāk, tos var redzēt, noklikšķinot uz {class="nozoom"} ikonas vai uzvedot virs tās kursoru. Taga filtrs ļauj nošķirt piekļuvi hostu grupai no iespējas skatīt problēmas. Piemēram, ja datubāzes administratoram ir jāredz tikai "MySQL" datubāzes problēmas, vispirms ir jāizveido lietotāju grupa datubāzes administratoriem, pēc tam jānorāda taga nosaukums "target" un vērtība "mysql". {width=600} Ja ir norādīts taga nosaukums "target", bet vērtības lauks ir atstāts tukšs, lietotāju grupa redzēs visas problēmas ar taga nosaukumu "target" izvēlētajai hostu grupai. Ja ir atlasīts *All tags*, lietotāju grupa redzēs visas problēmas norādītajai hostu grupai. Pārliecinieties, ka taga nosaukums un taga vērtība ir norādīti pareizi, pretējā gadījumā lietotāju grupa neredzēs nevienu problēmu. Apskatīsim piemēru, kad lietotājs ir vairāku atlasītu lietotāju grupu dalībnieks. Filtrēšana šajā gadījumā izmantos OR nosacījumu tagiem. | | | | | | | | |---|---|---|---|---|---|---| |**User group A**|<|<|**User group B**|<|<|**Visible result for a user (member) of both groups**| |*Tag filter*|<|<|<|<|<|^| |*Host group*|*Tag name*|*Tag value*|*Host group*|*Tag name*|*Tag value*|^| |Databases|target|mysql|Databases|target|oracle|target:mysql or target:oracle problems visible| |Databases|set to: *All tags*|<|Databases|target|oracle|All problems visible| |Not configured in the **Problem tag filter**|<|<|Databases|target|oracle|target:oracle problems visible| ::: noteimportant Filtra pievienošana (piemēram, visi tagi noteiktā hostu grupā "Databases") nozīmē, ka nebūs iespējams skatīt citu hostu grupu problēmas. ::: #### Configuration To configure a value mapping, follow these steps: 1\. Open the host or template configuration form. 2\. In the *Value mapping* tab, click *Add* to add a new value mapping, or click on the name of an existing mapping to edit it.  Parameters of a value mapping: |Parameter|<|Description| |-|----------|----------------------------------------| |*Name*|<|Unique name for the set of value mappings.| |*Mappings*|<|Individual rules for mapping numeric/string values to string representations.<br><br>Mapping is applied in the order of the rules that can be reordered by dragging.| | |*Type*|Mapping type:<br>**equals** - equal values will be mapped;<br>**is greater than or equals** - equal or greater values will be mapped;<br>**is less than or equals** - equal or smaller values will be mapped;<br>**in range** - values in range will be mapped; the range is expressed as <number1>-<number2> or <number>; multiple ranges are supported (for example, 1-10,101-110,201);<br>**regexp** - values corresponding to the [regular expression](/manual/regular_expressions) will be mapped (global regular expressions are not supported);<br>**default** - all outstanding values will be mapped, other than those with specific mappings.<br><br>For mapping ranges, only numeric value types (*is greater than or equals*, *is less than or equals*, *in range*) are supported.| |^|*Value*|Incoming value (may contain a range or regular expression, depending on the mapping type).| |^|*Mapped to*|String representation (up to 64 characters) for the incoming value.| All mandatory input fields are marked with a red asterisk. When viewing the value mapping in the list, only the first three mappings are visible, with three dots indicating that more mappings exist.  #### Konfigurācija Lai konfigurētu vērtību kartējumu, veiciet šīs darbības: 1\. Atveriet hosts vai veidnes konfigurācijas formu. 2\. Cilnē *Value mapping* noklikšķiniet uz *Add*, lai pievienotu jaunu vērtību kartējumu, vai noklikšķiniet uz esoša kartējuma nosaukuma, lai to rediģētu.  Vērtību kartējuma parametri: |Parameter|<|Description| |-|----------|----------------------------------------| |*Name*|<|Unikāls nosaukums vērtību kartējumu kopai.| |*Mappings*|<|Atsevišķi noteikumi skaitlisku/teksta vērtību kartēšanai uz teksta attēlojumu.<br><br>Kartējums tiek piemērots noteikumu secībā, ko var pārkārtot, velkot.| | |*Type*|Kartējuma tips:<br>**equals** - vienādas vērtības tiks kartētas;<br>**is greater than or equals** - vienādas vai lielākas vērtības tiks kartētas;<br>**is less than or equals** - vienādas vai mazākas vērtības tiks kartētas;<br>**in range** - tiks kartētas vērtības diapazonā; diapazons tiek norādīts kā <number1>-<number2> vai <number>; tiek atbalstīti vairāki diapazoni (piemēram, 1-10,101-110,201);<br>**regexp** - tiks kartētas vērtības, kas atbilst [regulārajai izteiksmei](/manual/regular_expressions) (globālās regulārās izteiksmes netiek atbalstītas);<br>**default** - tiks kartētas visas pārējās vērtības, kurām nav specifiska kartējuma.<br><br>Diapazonu kartēšanai tiek atbalstīti tikai skaitlisku vērtību tipi (*is greater than or equals*, *is less than or equals*, *in range*).| |^|*Value*|Ienākošā vērtība (atkarībā no kartējuma tipa var saturēt diapazonu vai regulāro izteiksmi).| |^|*Mapped to*|Teksta attēlojums (līdz 64 rakstzīmēm) ienākošajai vērtībai.| Visi obligātie ievades lauki ir atzīmēti ar sarkanu zvaigznīti. Skatot vērtību kartējumu sarakstā, ir redzami tikai pirmie trīs kartējumi, bet trīs punkti norāda, ka ir pieejami vēl citi kartējumi.  ### Configuration To configure custom alert scripts as a media type: 1. Go to *Alerts → Media types*. 2. Click on *Create media type*. The **Media type** tab contains general media type attributes: {width="600"} All mandatory input fields are marked with a red asterisk. The following parameters are specific for the script media type: |Parameter|Description| |--|--------| |*Script name*|Enter the name of the script file (e.g., notification.sh) that is located in the directory specified in the [AlertScriptsPath](/manual/appendix/config/zabbix_server#alertscriptspath) server configuration parameter.| |*Script parameters*|Add optional script parameters that will be passed to the script as command-line arguments in the order in which they are defined.<br><br>Script parameters support {ALERT.SENDTO}, {ALERT.SUBJECT}, {ALERT.MESSAGE} macros, and all [macros](/manual/appendix/macros/supported_by_location) that are supported in notifications, as well as [user macros](/manual/appendix/macros/supported_by_location_user).| See [common media type parameters](/manual/config/notifications/media#common-parameters) for details on how to configure default messages and alert processing options. ::: notewarning Even if an alert script does not use default messages, the message templates for operation types used by this media type must still be defined. Otherwise, a notification will not be sent. ::: ::: noteimportant If more than one script media type is configured, these scripts may be processed in parallel by the alerter processes. The total number of alerter processes is limited by the server configuration file [`StartAlerters`](/manual/appendix/config/zabbix_server#startalerters) parameter. ::: ### Konfigurācija Lai konfigurētu pielāgotus brīdinājumu skriptus kā medija tipu: 1. Dodieties uz *Brīdinājumi → Medija tipi*. 2. Noklikšķiniet uz *Izveidot medija tipu*. Cilnē **Medija tips** ir ietverti vispārīgie medija tipa atribūti: {width="600"} Visi obligātie ievades lauki ir atzīmēti ar sarkanu zvaigznīti. Tālāk norādītie parametri ir specifiski skripta medija tipam: |Parameter|Description| |--|--------| |*Script name*|Ievadiet skripta faila nosaukumu (piem., notification.sh), kas atrodas direktorijā, kura norādīta servera konfigurācijas parametram [AlertScriptsPath](/manual/appendix/config/zabbix_server#alertscriptspath).| |*Script parameters*|Pievienojiet izvēles skripta parametrus, kas tiks nodoti skriptam kā komandrindas argumenti tādā secībā, kādā tie ir definēti.<br><br>Skripta parametri atbalsta {ALERT.SENDTO}, {ALERT.SUBJECT}, {ALERT.MESSAGE} makro un visus [makro](/manual/appendix/macros/supported_by_location), kas tiek atbalstīti paziņojumos, kā arī [lietotāja makro](/manual/appendix/macros/supported_by_location_user).| Skatiet [kopīgos medija tipa parametrus](/manual/config/notifications/media#common-parameters), lai iegūtu informāciju par to, kā konfigurēt noklusējuma ziņojumus un brīdinājumu apstrādes opcijas. ::: notewarning Pat ja brīdinājumu skripts neizmanto noklusējuma ziņojumus, šim medija tipam izmantoto darbību tipu ziņojumu veidnēm joprojām ir jābūt definētām. Pretējā gadījumā paziņojums netiks nosūtīts. ::: ::: noteimportant Ja ir konfigurēts vairāk nekā viens skripta medija tips, šos skriptus brīdinātāja procesos var apstrādāt paralēli. Brīdinātāja procesu kopskaitu ierobežo servera konfigurācijas faila parametrs [`StartAlerters`](/manual/appendix/config/zabbix_server#startalerters). ::: #### Configuration To configure email as the media type: 1. Go to *Alerts > Media types*. 2. Click on *Create media type* (or click on *Email* in the list of pre-defined media types). The **Media type** tab contains general media type attributes: {width="600"} All mandatory input fields are marked with a red asterisk. :::notewarning Password is exported in clear text when exporting email media type configuration. ::: The following parameters are specific for the email media type: |Parameter|Description| |--|--------| |*Email provider*|Select the email provider: *Generic SMTP*, *Gmail*, *Gmail relay*, *Office365*, or *Office365 relay*.<br>If you select the Gmail/Office365-related options, you will only need to supply the sender email address and password; such options as *SMTP server*, *SMTP server port*, *SMTP helo*, and *Connection security* will be automatically filled by Zabbix. See also: [Automated Gmail/Office365 media types](/manual/config/notifications/media#automated-gmailoffice365-media-types). | |*SMTP server*|Set an SMTP server to handle outgoing messages.<br>This field is available if *Generic SMTP* is selected as the email provider.| |*SMTP server port*|Set the SMTP server port to handle outgoing messages.<br>This field is available if *Generic SMTP* is selected as the email provider.| |*Email*|The address entered here will be used as the **From** address for the messages sent.<br>Adding a sender display name (like "Zabbix\_info" in *Zabbix\_info <zabbix\@company.com>* in the screenshot above) with the actual email address is supported.<br>There are some restrictions on display names in Zabbix emails in comparison to what is allowed by RFC 5322, as illustrated by examples:<br>Valid examples:<br>*zabbix\@company.com* (only email address, no need to use angle brackets)<br>*Zabbix\_info <zabbix\@company.com>* (display name and email address in angle brackets)<br>*∑Ω-monitoring <zabbix\@company.com>* (UTF-8 characters in display name)<br>Invalid examples:<br>*Zabbix HQ zabbix\@company.com* (display name present but no angle brackets around email address)<br>*"Zabbix\\@\\<H(comment)Q\\>" <zabbix\@company.com>* (although valid by RFC 5322, quoted pairs and comments are not supported in Zabbix emails)| |*SMTP helo*|Set a correct SMTP helo value, normally a domain name.<br>If empty, the domain name of the email will be sent (i.e., what comes after `@` in the *Email* field). If it is impossible to fetch the domain name, a debug-level warning will be logged and the server hostname will be sent as the domain for HELO command.<br>This field is available if *Generic SMTP* is selected as the email provider.| |*Connection security*|Select the level of connection security:<br>**None** - do not use the [CURLOPT\_USE\_SSL](http://curl.haxx.se/libcurl/c/CURLOPT_USE_SSL.html) option<br>**STARTTLS** - use the CURLOPT\_USE\_SSL option with CURLUSESSL\_ALL value<br>**SSL/TLS** - use of CURLOPT\_USE\_SSL is optional| |*SSL verify peer*|Mark the checkbox to verify the SSL certificate of the SMTP server.<br>The value of "SSLCALocation" server configuration directive should be put into [CURLOPT\_CAPATH](http://curl.haxx.se/libcurl/c/CURLOPT_CAPATH.html) for certificate validation.<br>This sets cURL option [CURLOPT\_SSL\_VERIFYPEER](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYPEER.html).| |*SSL verify host*|Mark the checkbox to verify that the *Common Name* field or the *Subject Alternate Name* field of the SMTP server certificate matches.<br>This sets cURL option [CURLOPT\_SSL\_VERIFYHOST](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYHOST.html).| |*Authentication*|Select the level of authentication:<br>**None** - no cURL options are set<br>**Username and password** - implies "AUTH=\*" leaving the choice of authentication mechanism to cURL| |*Username*|User name to use in authentication.<br>This sets the value of [CURLOPT\_USERNAME](http://curl.haxx.se/libcurl/c/CURLOPT_USERNAME.html).<br>[User macros](/manual/appendix/macros/supported_by_location_user#other-locations) supported.| |*Password*|Password to use in authentication.<br>This sets the value of [CURLOPT\_PASSWORD](http://curl.haxx.se/libcurl/c/CURLOPT_PASSWORD.html).<br>[User macros](/manual/appendix/macros/supported_by_location_user#other-locations) supported.<br>The value entered here is exported as is when media type configuration is exported. To avoid exposing sensitive credentials in exported files, use a user macro (for example, `{$EMAIL_SMTP_PASSWORD}`) instead of a literal password — the macro reference will be exported while the secret value should be (re)configured on the destination system.| |*Message format*|Select message format:<br>**HTML** - send as HTML<br>**Plain text** - send as plain text| ::: noteimportant To enable SMTP authentication, Zabbix server must be compiled with the `--with-libcurl` [compilation](/manual/installation/install#4-configure-the-sources) option, which requires libcurl (see [server](/manual/installation/requirements#serverproxy) requirements for version details). ::: See also [common media type parameters](/manual/config/notifications/media#common-parameters) for details on how to configure default messages and alert processing options. #### Konfigurācija Lai konfigurētu e-pastu kā medija tipu: 1. Dodieties uz *Alerts > Media types*. 2. Noklikšķiniet uz *Create media type* (vai noklikšķiniet uz *Email* iepriekš definēto medija tipu sarakstā). Cilnē **Media type** ir ietverti vispārīgie medija tipa atribūti: {width="600"} Visi obligātie ievades lauki ir atzīmēti ar sarkanu zvaigznīti. :::notewarning Eksportējot e-pasta medija tipa konfigurāciju, parole tiek eksportēta atklātā tekstā. ::: Tālāk norādītie parametri ir specifiski e-pasta medija tipam: |Parameter|Description| |--|--------| |*Email provider*|Atlasiet e-pasta pakalpojumu sniedzēju: *Generic SMTP*, *Gmail*, *Gmail relay*, *Office365* vai *Office365 relay*.<br>Ja atlasāt ar Gmail/Office365 saistītās opcijas, būs jānorāda tikai sūtītāja e-pasta adrese un parole; tādi lauki kā *SMTP server*, *SMTP server port*, *SMTP helo* un *Connection security* tiks automātiski aizpildīti ar Zabbix. Skatiet arī: [Automated Gmail/Office365 media types](/manual/config/notifications/media#automated-gmailoffice365-media-types). | |*SMTP server*|Norādiet SMTP serveri izejošo ziņojumu apstrādei.<br>Šis lauks ir pieejams, ja kā e-pasta pakalpojumu sniedzējs ir atlasīts *Generic SMTP*.| |*SMTP server port*|Norādiet SMTP servera portu izejošo ziņojumu apstrādei.<br>Šis lauks ir pieejams, ja kā e-pasta pakalpojumu sniedzējs ir atlasīts *Generic SMTP*.| |*Email*|Šeit ievadītā adrese tiks izmantota kā nosūtīto ziņojumu **From** adrese.<br>Tiek atbalstīta sūtītāja parādāmā vārda pievienošana kopā ar faktisko e-pasta adresi (piemēram, "Zabbix\_info" formā *Zabbix\_info <zabbix\@company.com>* iepriekš redzamajā ekrānattēlā).<br>Zabbix e-pastos parādāmajiem vārdiem ir noteikti daži ierobežojumi salīdzinājumā ar RFC 5322 atļauto, kā parādīts piemēros:<br>Derīgi piemēri:<br>*zabbix\@company.com* (tikai e-pasta adrese, nav jāizmanto leņķiekavas)<br>*Zabbix\_info <zabbix\@company.com>* (parādāmais vārds un e-pasta adrese leņķiekavās)<br>*∑Ω-monitoring <zabbix\@company.com>* (UTF-8 rakstzīmes parādāmajā vārdā)<br>Nederīgi piemēri:<br>*Zabbix HQ zabbix\@company.com* (ir parādāmais vārds, bet e-pasta adrese nav ietverta leņķiekavās)<br>*"Zabbix\\@\\<H(comment)Q\\>" <zabbix\@company.com>* (lai gan tas ir derīgs saskaņā ar RFC 5322, Zabbix e-pastos pēdiņās ietverti pāri un komentāri netiek atbalstīti)| |*SMTP helo*|Norādiet pareizu SMTP helo vērtību, parasti domēna nosaukumu.<br>Ja lauks ir tukšs, tiks nosūtīts e-pasta domēna nosaukums (t. i., tas, kas atrodas aiz `@` laukā *Email*). Ja domēna nosaukumu nav iespējams iegūt, tiks reģistrēts brīdinājums atkļūdošanas līmenī, un kā HELO komandas domēns tiks nosūtīts servera resursdatora nosaukums.<br>Šis lauks ir pieejams, ja kā e-pasta pakalpojumu sniedzējs ir atlasīts *Generic SMTP*.| |*Connection security*|Atlasiet savienojuma drošības līmeni:<br>**None** - neizmantojiet opciju [CURLOPT\_USE\_SSL](http://curl.haxx.se/libcurl/c/CURLOPT_USE_SSL.html)<br>**STARTTLS** - izmantojiet opciju CURLOPT\_USE\_SSL ar vērtību CURLUSESSL\_ALL<br>**SSL/TLS** - CURLOPT\_USE\_SSL izmantošana ir izvēles| |*SSL verify peer*|Atzīmējiet izvēles rūtiņu, lai pārbaudītu SMTP servera SSL sertifikātu.<br>Vērtība no servera konfigurācijas direktīvas "SSLCALocation" jāievieto [CURLOPT\_CAPATH](http://curl.haxx.se/libcurl/c/CURLOPT_CAPATH.html) sertifikāta validācijai.<br>Tas iestata cURL opciju [CURLOPT\_SSL\_VERIFYPEER](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYPEER.html).| |*SSL verify host*|Atzīmējiet izvēles rūtiņu, lai pārbaudītu, vai SMTP servera sertifikāta lauks *Common Name* vai *Subject Alternate Name* atbilst.<br>Tas iestata cURL opciju [CURLOPT\_SSL\_VERIFYHOST](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYHOST.html).| |*Authentication*|Atlasiet autentifikācijas līmeni:<br>**None** - netiek iestatītas cURL opcijas<br>**Username and password** - nozīmē "AUTH=\*", atstājot autentifikācijas mehānisma izvēli cURL ziņā| |*Username*|Lietotājvārds, ko izmantot autentifikācijai.<br>Tas iestata [CURLOPT\_USERNAME](http://curl.haxx.se/libcurl/c/CURLOPT_USERNAME.html) vērtību.<br>Tiek atbalstīti [lietotāja makrosi](/manual/appendix/macros/supported_by_location_user#other-locations).| |*Password*|Parole, ko izmantot autentifikācijai.<br>Tas iestata [CURLOPT\_PASSWORD](http://curl.haxx.se/libcurl/c/CURLOPT_PASSWORD.html) vērtību.<br>Tiek atbalstīti [lietotāja makrosi](/manual/appendix/macros/supported_by_location_user#other-locations).<br>Šeit ievadītā vērtība tiek eksportēta tāda, kāda tā ir, eksportējot medija tipa konfigurāciju. Lai eksportētajos failos neizpaustu sensitīvus akreditācijas datus, izmantojiet lietotāja makro (piemēram, `{$EMAIL_SMTP_PASSWORD}`) literālas paroles vietā — makro atsauce tiks eksportēta, bet slepenā vērtība būs jāpārkonfigurē mērķa sistēmā.| |*Message format*|Atlasiet ziņojuma formātu:<br>**HTML** - sūtīt kā HTML<br>**Plain text** - sūtīt kā vienkāršu tekstu| ::: noteimportant Lai iespējotu SMTP autentifikāciju, Zabbix serverim jābūt kompilētam ar `--with-libcurl` [kompilēšanas](/manual/installation/install#4-configure-the-sources) opciju, kurai nepieciešams libcurl (skatiet [serveris](/manual/installation/requirements#serverproxy) prasības versijas informācijai). ::: Skatiet arī [common media type parameters](/manual/config/notifications/media#common-parameters), lai iegūtu informāciju par noklusējuma ziņojumu un brīdinājumu apstrādes opciju konfigurēšanu. #### Configuration To configure event correlation rules globally: - Go to *Data collection* > *Event correlation* - Click on *Create event correlation* to the right (or on the correlation name to edit an existing rule) - Enter parameters of the correlation rule in the form  All mandatory input fields are marked with a red asterisk. |Parameter|Description| |--|--------| |*Name*|Unique correlation rule name.| |*Type of calculation*|The following options of calculating conditions are available:<br>**And** - all conditions must be met<br>**Or** - enough if one condition is met<br>**And/Or** - AND with different condition types and OR with the same condition type<br>**Custom expression** - a user-defined calculation formula for evaluating action conditions. It must include all conditions (represented as uppercase letters A, B, C, ...) and may include spaces, tabs, brackets ( ), **and** (case sensitive), **or** (case sensitive), **not** (case sensitive).| |*Conditions*|List of conditions. See below for details on configuring a condition.| |*Description*|Correlation rule description.| |*Operations*|Mark the checkbox of the operation to perform when event is correlated. The following operations are available:<br>**Close old events** - close old events when a new event happens. Always add a condition based on the old event when using the *Close old events* operation or all existing problems could be closed.<br>**Close new event** - close the new event when it happens.<br><br>**Warning!**<br>Do not leave old/new event conditions empty when using *Close old events*/*Close new event*.If you select the *Close old events* operation without adding a condition that matches the old event, Zabbix may match all existing old events and close them.Always add an explicit old event condition (for example, *Old event tag name* or *Event tag pair*) when using *Close old events*. For example, a rule that uses only a *New event condition* and the *Close old events operation* will match all old events that meet the (missing) old-event criteria - effectively closing old problems.| |*Enabled*|If you mark this checkbox, the correlation rule will be enabled.| To configure details of a new condition, click on  in the Conditions block. A popup window will open where you can edit the condition details.  |Parameter|Description| |--|--------| |*New condition*|Select a condition for correlating events.<br>*Note* that if no old event condition is specified, all old events may be matched and closed. Similarly if no new event condition is specified, all new events may be matched and closed.<br>The following conditions are available:<br>**Old event tag name** - specify the old event tag name for matching.<br>**New event tag name** - specify the new event tag name for matching.<br>**New event host group** - specify the new event host group for matching.<br>**Event tag pair** - specify new event tag name and old event tag name for matching. In this case there will be a match if the **values** of the tags in both events match. Tag *names* need not match.<br>This option is useful for matching runtime values, which may not be known at the time of configuration (see also [Example](/manual/config/event_correlation/global#example)).<br>**Old event tag value** - specify the old event tag name and value for matching, using the following operators:<br>*equals* - has the old event tag value<br>*does not equal* - does not have the old event tag value<br>*contains* - has the string in the old event tag value<br>*does not contain* - does not have the string in the old event tag value<br>**New event tag value** - specify the new event tag name and value for matching, using the following operators:<br>*equals* - has the new event tag value<br>*does not equal* - does not have the new event tag value<br>*contains* - has the string in the new event tag value<br>*does not contain* - does not have the string in the new event tag value| ::: notewarning Because misconfiguration is possible, when similar event tags may be created for **unrelated** problems, please review the cases outlined below! ::: - Actual tags and tag values only become visible when a trigger fires. If the regular expression used is invalid, it is silently replaced with an \*UNKNOWN\* string. If the initial problem event with an \*UNKNOWN\* tag value is missed, there may appear subsequent OK events with the same \*UNKNOWN\* tag value that may close problem events which they shouldn't have closed. - If a user uses the {ITEM.VALUE} macro without macro functions as the tag value, the 255-character limitation applies. When log messages are long and the first 255 characters are non-specific, this may also result in similar event tags for unrelated problems. #### Konfigurācija Lai globāli konfigurētu notikumu korelācijas noteikumus: - Dodieties uz *Data collection* > *Event correlation* - Noklikšķiniet uz *Create event correlation* labajā pusē (vai uz korelācijas nosaukuma, lai rediģētu esošu noteikumu) - Formā ievadiet korelācijas noteikuma parametrus  Visi obligātie ievades lauki ir atzīmēti ar sarkanu zvaigznīti. |Parameter|Description| |--|--------| |*Name*|Unikāls korelācijas noteikuma nosaukums.| |*Type of calculation*|Pieejamas šādas nosacījumu aprēķināšanas opcijas:<br>**And** - jāizpildās visiem nosacījumiem<br>**Or** - pietiek, ja izpildās viens nosacījums<br>**And/Or** - AND ar dažādiem nosacījumu tipiem un OR ar vienādiem nosacījumu tipiem<br>**Custom expression** - lietotāja definēta aprēķina formula darbību nosacījumu izvērtēšanai. Tai jāietver visi nosacījumi (attēloti ar lielajiem burtiem A, B, C, ...) un var ietvert atstarpes, tabulācijas, iekavas ( ), **and** (reģistrjutīgs), **or** (reģistrjutīgs), **not** (reģistrjutīgs).| |*Conditions*|Nosacījumu saraksts. Skatiet tālāk, lai uzzinātu vairāk par nosacījuma konfigurēšanu.| |*Description*|Korelācijas noteikuma apraksts.| |*Operations*|Atzīmējiet tās darbības izvēles rūtiņu, kas jāveic, kad notikums tiek korelēts. Pieejamas šādas darbības:<br>**Close old events** - aizver vecos notikumus, kad notiek jauns notikums. Izmantojot darbību *Close old events*, vienmēr pievienojiet nosacījumu, kas balstīts uz veco notikumu, pretējā gadījumā var tikt aizvērti visi esošie problēmu notikumi.<br>**Close new event** - aizver jauno notikumu, kad tas notiek.<br><br>**Brīdinājums!**<br>Neatstājiet vecā/jaunā notikuma nosacījumus tukšus, izmantojot *Close old events*/*Close new event*. Ja izvēlaties darbību *Close old events* bez nosacījuma, kas atbilst vecajam notikumam, Zabbix var saskaņot visus esošos vecos notikumus un tos aizvērt. Vienmēr pievienojiet skaidri definētu vecā notikuma nosacījumu (piemēram, *Old event tag name* vai *Event tag pair*), izmantojot *Close old events*. Piemēram, noteikums, kas izmanto tikai *New event condition* un darbību *Close old events*, saskaņos visus vecos notikumus, kas atbilst (trūkstošajiem) vecā notikuma kritērijiem - faktiski aizverot vecās problēmas.| |*Enabled*|Ja atzīmēsiet šo izvēles rūtiņu, korelācijas noteikums būs iespējots.| Lai konfigurētu jauna nosacījuma detaļas, noklikšķiniet uz  blokā Conditions. Tiks atvērts uznirstošais logs, kurā varēsiet rediģēt nosacījuma detaļas.  |Parameter|Description| |--|--------| |*New condition*|Atlasiet nosacījumu notikumu korelācijai.<br>*Piezīme*: ja nav norādīts vecā notikuma nosacījums, var tikt saskaņoti un aizvērti visi vecie notikumi. Līdzīgi, ja nav norādīts jaunā notikuma nosacījums, var tikt saskaņoti visi jaunie notikumi.<br>Pieejami šādi nosacījumi:<br>**Old event tag name** - norādiet vecā notikuma taga nosaukumu saskaņošanai.<br>**New event tag name** - norādiet jaunā notikuma taga nosaukumu saskaņošanai.<br>**New event host group** - norādiet jaunā notikuma hostu grupu saskaņošanai.<br>**Event tag pair** - norādiet jaunā notikuma taga nosaukumu un vecā notikuma taga nosaukumu saskaņošanai. Šajā gadījumā atbilstība būs tad, ja sakritīs abu notikumu tagu **vērtības**. Tagu *nosaukumiem* nav obligāti jāsakrīt.<br>Šī opcija ir noderīga izpildlaika vērtību saskaņošanai, kuras konfigurēšanas brīdī var nebūt zināmas (skatiet arī [Example](/manual/config/event_correlation/global#example)).<br>**Old event tag value** - norādiet vecā notikuma taga nosaukumu un vērtību saskaņošanai, izmantojot šādus operatorus:<br>*equals* - ir vecā notikuma taga vērtība<br>*does not equal* - nav vecā notikuma taga vērtība<br>*contains* - satur virkni vecā notikuma taga vērtībā<br>*does not contain* - nesatur virkni vecā notikuma taga vērtībā<br>**New event tag value** - norādiet jaunā notikuma taga nosaukumu un vērtību saskaņošanai, izmantojot šādus operatorus:<br>*equals* - ir jaunā notikuma taga vērtība<br>*does not equal* - nav jaunā notikuma taga vērtība<br>*contains* - satur virkni jaunā notikuma taga vērtībā<br>*does not contain* - nesatur virkni jaunā notikuma taga vērtībā| ::: notewarning Tā kā ir iespējama nepareiza konfigurācija, ja līdzīgi notikumu tagi var tikt izveidoti **nesaistītām** problēmām, lūdzu, pārskatiet tālāk aprakstītos gadījumus! ::: - Faktiskie tagi un tagu vērtības kļūst redzami tikai tad, kad tiek aktivizēts trigeris. Ja izmantotā regulārā izteiksme ir nederīga, tā klusi tiek aizstāta ar virkni \*UNKNOWN\*. Ja sākotnējais problēmas notikums ar \*UNKNOWN\* taga vērtību tiek palaists garām, vēlāk var parādīties OK notikumi ar to pašu \*UNKNOWN\* taga vērtību, kas var aizvērt problēmu notikumus, kurus tiem nevajadzētu aizvērt. - Ja lietotājs kā taga vērtību izmanto {ITEM.VALUE} makro bez makro funkcijām, tiek piemērots 255 rakstzīmju ierobežojums. Ja žurnāla ziņojumi ir gari un pirmās 255 rakstzīmes nav specifiskas, tas var arī radīt līdzīgus notikumu tagus nesaistītām problēmām. #### Configuration To configure, select *Action log* as type: {width="600"} In addition to the parameters that are [common](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters) for all widgets, you may set the following specific options: | | | |--|--------| |*Recipients*|Filter entries by recipients. This field is auto-complete, so starting to type the name of a recipient will offer a dropdown of matching recipients. If no recipients are selected, details of action operations for all recipients will be displayed.| |*Actions*|Filter entries by actions. This field is auto-complete, so starting to type the name of an action will offer a dropdown of matching actions. If no actions are selected, details of action operations for all actions will be displayed.| |*Media types*|Filter entries by media types. This field is auto-complete, so starting to type the name of a media type will offer a dropdown of matching media types. If no media types are selected, details of action operations for all media types will be displayed.| |*Status*|Mark the checkbox to filter entries by the respective status:<br>**In progress** - action operations that are in progress are displayed;<br>**Sent/Executed** - action operations that have sent a notification or have been executed are displayed;<br>**Failed** - action operations that have failed are displayed.| |*Search string*|Filter entries by the content of the message/remote command. If you enter a string here, only those action operations whose message/remote command contains the entered string will be displayed. Macros are not resolved.| |*Time period*|Filter entries by time period. Select the [data source](/manual/web_interface/frontend_sections/dashboards/widgets#dynamic-parameters) for the time period:<br>**Dashboard** - set the *Time period* selector as the data source;<br>**Widget** - set a compatible widget specified in the *Widget* parameter as the data source;<br>**Custom** - set the time period specified in the *From* and *To* parameters as the data source; if set, a clock icon will be displayed in the top right corner of the widget, indicating the set time on mouseover.| |*Widget*|Enter or select a compatible widget as the data source for the time period.<br>This parameter is available if *Time period* is set to "Widget".| |*From*|Enter or select the start of the time period.<br>[Relative time syntax](/manual/web_interface/time_period_selector) (`now`, `now/d`, `now/w-1w`, etc.) is supported.<br>This parameter is available if *Time period* is set to "Custom".| |*To*|Enter or select the end of the time period.<br>[Relative time syntax](/manual/web_interface/time_period_selector) (`now`, `now/d`, `now/w-1w`, etc.) is supported.<br>This parameter is available if *Time period* is set to "Custom".| |*Sort entries by*|Sort entries by:<br>**Time** (descending or ascending);<br>**Type** (descending or ascending);<br>**Status** (descending or ascending);<br>**Recipient** (descending or ascending).| |*Show lines*|Set how many action log lines will be displayed in the widget.| #### Konfigurācija Lai konfigurētu, izvēlieties *Action log* kā tipu: {width="600"} Papildus parametriem, kas ir [kopīgi](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters) visiem logrīkiem, varat iestatīt šādas specifiskās opcijas: | | | |--|--------| |*Recipients*|Filtrēt ierakstus pēc saņēmējiem. Šis lauks atbalsta automātisko pabeigšanu, tāpēc, sākot rakstīt saņēmēja vārdu, tiks piedāvāts nolaižamais saraksts ar atbilstošajiem saņēmējiem. Ja nav atlasīts neviens saņēmējs, tiks parādīta visu saņēmēju darbību informācija.| |*Actions*|Filtrēt ierakstus pēc darbībām. Šis lauks atbalsta automātisko pabeigšanu, tāpēc, sākot rakstīt darbības nosaukumu, tiks piedāvāts nolaižamais saraksts ar atbilstošajām darbībām. Ja nav atlasīta neviena darbība, tiks parādīta visu darbību informācija.| |*Media types*|Filtrēt ierakstus pēc multivides tipiem. Šis lauks atbalsta automātisko pabeigšanu, tāpēc, sākot rakstīt multivides tipa nosaukumu, tiks piedāvāts nolaižamais saraksts ar atbilstošajiem multivides tipiem. Ja nav atlasīts neviens multivides tips, tiks parādīta visu multivides tipu darbību informācija.| |*Status*|Atzīmējiet izvēles rūtiņu, lai filtrētu ierakstus pēc attiecīgā statusa:<br>**In progress** - tiek parādītas darbības, kas ir procesā;<br>**Sent/Executed** - tiek parādītas darbības, kas ir nosūtījušas paziņojumu vai ir izpildītas;<br>**Failed** - tiek parādītas darbības, kas ir neizdevušās.| |*Search string*|Filtrēt ierakstus pēc ziņojuma/attālā komandas satura. Ja šeit ievadāt virkni, tiks parādītas tikai tās darbības, kuru ziņojums/attālā komanda satur ievadīto virkni. Makro netiek aizstāti.| |*Time period*|Filtrēt ierakstus pēc laika perioda. Atlasiet [datu avotu](/manual/web_interface/frontend_sections/dashboards/widgets#dynamic-parameters) laika periodam:<br>**Dashboard** - iestatiet *Time period* atlasītāju kā datu avotu;<br>**Widget** - iestatiet saderīgu logrīku, kas norādīts parametrā *Widget*, kā datu avotu;<br>**Custom** - iestatiet laika periodu, kas norādīts parametros *From* un *To*, kā datu avotu; ja tas ir iestatīts, logrīka augšējā labajā stūrī tiks parādīta pulksteņa ikona, kas, uzvedot peli, norāda iestatīto laiku.| |*Widget*|Ievadiet vai atlasiet saderīgu logrīku kā laika perioda datu avotu.<br>Šis parametrs ir pieejams, ja *Time period* ir iestatīts uz "Widget".| |*From*|Ievadiet vai atlasiet laika perioda sākumu.<br>Tiek atbalstīta [relatīvā laika sintakse](/manual/web_interface/time_period_selector) (`now`, `now/d`, `now/w-1w` u.c.).<br>Šis parametrs ir pieejams, ja *Time period* ir iestatīts uz "Custom".| |*To*|Ievadiet vai atlasiet laika perioda beigas.<br>Tiek atbalstīta [relatīvā laika sintakse](/manual/web_interface/time_period_selector) (`now`, `now/d`, `now/w-1w` u.c.).<br>Šis parametrs ir pieejams, ja *Time period* ir iestatīts uz "Custom".| |*Sort entries by*|Kārtot ierakstus pēc:<br>**Time** (augošā vai dilstošā secībā);<br>**Type** (augošā vai dilstošā secībā);<br>**Status** (augošā vai dilstošā secībā);<br>**Recipient** (augošā vai dilstošā secībā).| |*Show lines*|Iestatiet, cik daudz darbību žurnāla rindu tiks parādīts logrīkā.| #### Configuration To configure, select *Clock* as type: {width=600} In addition to the parameters that are [common](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters) for all widgets, you may set the following specific options: | | | |--|--------| |*Time type*|Select local, server, or specified host time.<br>Server time will be identical to the time zone set globally or for the Zabbix user.| |*Item*|Select the item with the [`system.localtime[local]`](/manual/config/items/itemtypes/zabbix_agent#system.localtime) item key to display the host time.<br>This parameter is available if *Time type* is set to "Host time".| |*Clock type*|Select clock type:<br>**Analog** - analog clock<br>**Digital** - digital clock| |*Show*|Select information units (date, time, time zone) to display in the digital clock.<br>Unit size is dynamic, filling all available widget space based on displayed units, widget size, and display scaling.<br>This field is available only if "Digital" is selected in the *Clock type* field; at least one information unit type must be selected.| |*Advanced configuration*|Click on the *Advanced configuration* header to display [advanced configuration](#advanced-configuration) options for the digital clock.<br>This section is available only if "Digital" is selected in the *Clock type* field.| #### Konfigurācija Lai konfigurētu, atlasiet *Clock* kā tipu: {width=600} Papildus parametriem, kas ir [kopīgi](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters) visiem logrīkiem, varat iestatīt šādas specifiskās opcijas: | | | |--|--------| |*Time type*|Atlasiet vietējo, servera vai norādītā hosta laiku.<br>Servera laiks būs identisks laika joslai, kas iestatīta globāli vai Zabbix lietotājam.| |*Item*|Atlasiet vienumu ar [`system.localtime[local]`](/manual/config/items/itemtypes/zabbix_agent#system.localtime) vienuma atslēgu, lai parādītu hosta laiku.<br>Šis parametrs ir pieejams, ja *Time type* ir iestatīts uz "Host time".| |*Clock type*|Atlasiet pulksteņa tipu:<br>**Analog** - analogais pulkstenis<br>**Digital** - digitālais pulkstenis| |*Show*|Atlasiet informācijas vienības (datumu, laiku, laika joslu), ko rādīt digitālajā pulkstenī.<br>Vienuma izmērs ir dinamisks un aizpilda visu pieejamo logrīka vietu, pamatojoties uz parādītajām vienībām, logrīka izmēru un attēlojuma mērogošanu.<br>Šis lauks ir pieejams tikai tad, ja *Clock type* laukā ir atlasīts "Digital"; jābūt atlasītam vismaz vienam informācijas vienības tipam.| |*Advanced configuration*|Noklikšķiniet uz *Advanced configuration* virsraksta, lai parādītu digitālā pulksteņa [papildu konfigurācijas](#advanced-configuration) opcijas.<br>Šī sadaļa ir pieejama tikai tad, ja *Clock type* laukā ir atlasīts "Digital".| #### Configuration To configure, select *Data overview* as type: {width="600"} In addition to the parameters that are [common](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters) for all widgets, you may set the following specific options: | | | |--|--------| |*Host groups*|Select host groups.<br>Alternatively, select a compatible widget as the [data source](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) for host groups.<br>This field is auto-complete so starting to type the name of a group will offer a dropdown of matching groups.<br>This parameter is not available when configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards).| |*Hosts*|Select hosts.<br>Alternatively, select a compatible widget or the dashboard as the [data source](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) for hosts.<br>This field is auto-complete so starting to type the name of a host will offer a dropdown of matching hosts.<br>This parameter is not available when configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards).| |*Item tags*|Specify tags to limit the number of item data displayed in the widget.<br>It is possible to include as well as exclude specific tags and tag values. Several conditions can be set. Tag name matching is always case-sensitive.<br><br>There are several operators available for each condition:<br>**Exists** - include the specified tag names;<br>**Equals** - include the specified tag names and values (case-sensitive);<br>**Contains** - include the specified tag names where the tag values contain the entered string (substring match, case-insensitive);<br>**Does not exist** - exclude the specified tag names;<br>**Does not equal** - exclude the specified tag names and values (case-sensitive);<br>**Does not contain** - exclude the specified tag names where the tag values contain the entered string (substring match, case-insensitive).<br><br>There are two calculation types for conditions:<br>**And/Or** - all conditions must be met, conditions having the same tag name will be grouped by the *Or* condition;<br>**Or** - enough if one condition is met.| |*Show suppressed problems*|Mark the checkbox to display problems that would otherwise be suppressed (not shown) because of host maintenance.| |*Hosts location*|Select hosts location - left or top.<br>This parameter is labeled *Host location* when configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards).| #### Konfigurācija Lai konfigurētu, kā tipu atlasiet *Data overview*: {width="600"} Papildus parametriem, kas ir [kopīgi](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters) visiem logrīkiem, varat iestatīt šādas specifiskas opcijas: | | | |--|--------| |*Host groups*|Atlasiet hostu grupas.<br>Vai arī atlasiet saderīgu logrīku kā [datu avotu](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) hostu grupām.<br>Šis lauks atbalsta automātisko pabeigšanu, tāpēc, sākot rakstīt grupas nosaukumu, tiks piedāvāts nolaižamais saraksts ar atbilstošajām grupām.<br>Šis parametrs nav pieejams, konfigurējot logrīku [veidnes informācijas panelī](/manual/config/templates/template#adding-dashboards).| |*Hosts*|Atlasiet hosts.<br>Vai arī atlasiet saderīgu logrīku vai informācijas paneli kā [datu avotu](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) hosts.<br>Šis lauks atbalsta automātisko pabeigšanu, tāpēc, sākot rakstīt hosta nosaukumu, tiks piedāvāts nolaižamais saraksts ar atbilstošajiem hostiem.<br>Šis parametrs nav pieejams, konfigurējot logrīku [veidnes informācijas panelī](/manual/config/templates/template#adding-dashboards).| |*Item tags*|Norādiet tagus, lai ierobežotu logrīkā attēloto vienumu datu skaitu.<br>Var iekļaut, kā arī izslēgt konkrētus tagus un tagu vērtības. Var iestatīt vairākus nosacījumus. Tagu nosaukumu atbilstība vienmēr ir reģistrjutīga.<br><br>Katram nosacījumam ir pieejami vairāki operatori:<br>**Exists** - iekļaut norādītos tagu nosaukumus;<br>**Equals** - iekļaut norādītos tagu nosaukumus un vērtības (reģistrjutīgi);<br>**Contains** - iekļaut norādītos tagu nosaukumus, kuru tagu vērtības satur ievadīto virkni (apakšvirknes atbilstība, nav reģistrjutīga);<br>**Does not exist** - izslēgt norādītos tagu nosaukumus;<br>**Does not equal** - izslēgt norādītos tagu nosaukumus un vērtības (reģistrjutīgi);<br>**Does not contain** - izslēgt norādītos tagu nosaukumus, kuru tagu vērtības satur ievadīto virkni (apakšvirknes atbilstība, nav reģistrjutīga).<br><br>Nosacījumiem ir divi aprēķina tipi:<br>**And/Or** - jāizpildās visiem nosacījumiem, nosacījumi ar vienādu taga nosaukumu tiks grupēti pēc *Or* nosacījuma;<br>**Or** - pietiek, ja izpildās viens nosacījums.| |*Show suppressed problems*|Atzīmējiet izvēles rūtiņu, lai parādītu problēmas, kas citādi tiktu slāpētas (nerādītas) hosta uzturēšanas dēļ.| |*Hosts location*|Atlasiet hostu atrašanās vietu - pa kreisi vai augšā.<br>Konfigurējot logrīku [veidnes informācijas panelī](/manual/config/templates/template#adding-dashboards), šis parametrs ir apzīmēts kā *Host location*.| #### Configuration To configure, select *Gauge* as type: {width="600"} In addition to the parameters that are [common](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters) for all widgets, you may set the following specific options: | | | |--|--------| |*Item*|Select the item.<br>Alternatively, select a compatible widget as the [data source](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) for items.<br>This field is auto-complete, so starting to type the name of an item will offer a dropdown of matching items.<br>Note that you can select only items that return [numeric](/manual/config/items/item#configuration) data.| |*Min*|Enter the minimum value of the gauge.<br>[Suffixes](/manual/appendix/suffixes) (for example, "1d", "2w", "4K", "8G") are supported. [Value mappings](/manual/config/items/mapping) are supported.| |*Max*|Enter the maximum value of the gauge.<br>[Suffixes](/manual/appendix/suffixes) (for example, "1d", "2w", "4K", "8G") are supported. [Value mappings](/manual/config/items/mapping) are supported.| |*Colors*|Select the color from the color picker:<br>**Value arc** - select the gauge value arc color;<br>**Arc background** - select the gauge value arc and gauge thresholds arc background color;<br>**Background** - select the widget background color.<br><br>"D" stands for the default color, which depends on the frontend theme. If [*Thresholds*](#advanced-configuration) are set, the default color for **Value arc** depends on the threshold color. To return to the default color, click the *Use default* button in the color picker.| |*Show*|Mark the checkbox to display the respective gauge element - description, value, value arc, needle, scale (the minimum and maximum value of the gauge at the beginning and end of the gauge arc). Unmark to hide. At least one element must be selected.<br><br>Note that the gauge needle and scale can be displayed if the gauge value arc or gauge thresholds arc (see [advanced configuration](#advanced-configuration) options) is displayed. Also note that if the gauge needle is displayed, the value is placed under the needle; if the needle is hidden, the value is aligned with the bottom of the gauge arc.| |*Override host*|Select a compatible widget or the dashboard as the [data source](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) for hosts.<br>This parameter is not available when configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards).| |*Advanced configuration*|Click the *Advanced configuration* header to display [advanced configuration](#advanced-configuration) options. This is also where you'll be able to adjust the gauge elements selected in the *Show* field.| #### Konfigurācija Lai konfigurētu, atlasiet *Gauge* kā tipu: {width="600"} Papildus parametriem, kas ir [kopīgi](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters) visiem logrīkiem, varat iestatīt šādas specifiskas opcijas: | | | |--|--------| |*Item*|Atlasiet vienumu.<br>Vai arī atlasiet saderīgu logrīku kā [datu avotu](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) vienumiem.<br>Šis lauks atbalsta automātisko pabeigšanu, tāpēc, sākot rakstīt vienuma nosaukumu, tiks piedāvāts atbilstošo vienumu nolaižamais saraksts.<br>Ņemiet vērā, ka varat atlasīt tikai vienumus, kas atgriež [skaitliskus](/manual/config/items/item#configuration) datus.| |*Min*|Ievadiet mēraparāta minimālo vērtību.<br>Tiek atbalstīti [piedēkļi](/manual/appendix/suffixes) (piemēram, "1d", "2w", "4K", "8G"). Tiek atbalstītas [vērtību kartes](/manual/config/items/mapping).| |*Max*|Ievadiet mēraparāta maksimālo vērtību.<br>Tiek atbalstīti [piedēkļi](/manual/appendix/suffixes) (piemēram, "1d", "2w", "4K", "8G"). Tiek atbalstītas [vērtību kartes](/manual/config/items/mapping).| |*Colors*|Atlasiet krāsu, izmantojot krāsu izvēlni:<br>**Value arc** - atlasiet mēraparāta vērtības loka krāsu;<br>**Arc background** - atlasiet mēraparāta vērtības loka un mēraparāta sliekšņu loka fona krāsu;<br>**Background** - atlasiet logrīka fona krāsu.<br><br>"D" apzīmē noklusējuma krāsu, kas ir atkarīga no lietotāja saskarnes motīva. Ja ir iestatīti [*Thresholds*](#advanced-configuration), noklusējuma krāsa **Value arc** elementam ir atkarīga no sliekšņa krāsas. Lai atgrieztos pie noklusējuma krāsas, krāsu izvēlnē noklikšķiniet uz pogas *Use default*.| |*Show*|Atzīmējiet izvēles rūtiņu, lai parādītu attiecīgo mēraparāta elementu - aprakstu, vērtību, vērtības loku, adatu, skalu (mēraparāta minimālo un maksimālo vērtību loka sākumā un beigās). Noņemiet atzīmi, lai paslēptu. Jābūt atlasītam vismaz vienam elementam.<br><br>Ņemiet vērā, ka mēraparāta adatu un skalu var parādīt, ja ir redzams mēraparāta vērtības loks vai mēraparāta sliekšņu loks (skatiet [papildu konfigurācijas](#advanced-configuration) opcijas). Ņemiet vērā arī to, ka, ja ir redzama mēraparāta adata, vērtība tiek novietota zem adatas; ja adata ir paslēpta, vērtība tiek līdzināta ar mēraparāta loka apakšdaļu.| |*Override host*|Atlasiet saderīgu logrīku vai paneli kā [datu avotu](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) hosts.<br>Šis parametrs nav pieejams, konfigurējot logrīku [veidnes panelī](/manual/config/templates/template#adding-dashboards).| |*Advanced configuration*|Noklikšķiniet uz virsraksta *Advanced configuration*, lai parādītu [papildu konfigurācijas](#advanced-configuration) opcijas. Šeit arī varēsiet pielāgot laukā *Show* atlasītos mēraparāta elementus.| #### Configuration To configure, select *Graph* as type: {width="600"} #### Konfigurācija Lai konfigurētu, atlasiet *Graph* kā tipu: {width="600"} #### Configuration To configure, select *Graph (classic)* as type: {width="600"} In addition to the parameters that are [common](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters) for all widgets, you may set the following specific options: | | | |--|--------| |*Source*|Select the graph type:<br>**Graph** - [custom graph](/manual/config/visualization/graphs/custom);<br>**Simple graph** - [simple graph](/manual/config/visualization/graphs/simple).| |*Graph*|Select the custom graph to display.<br>Alternatively, select a compatible widget as the [data source](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) for graphs.<br>This parameter is available if *Source* is set to "Graph".| |*Item*|Select the item to display in a simple graph.<br>Alternatively, select a compatible widget as the [data source](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) for items.<br>This parameter is available if *Source* is set to "Simple graph".| |*Time period*|Set a time period for which to display data in the graph. Select the [data source](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) for the time period:<br>**Dashboard** - set the *Time period* selector as the data source;<br>**Widget** - set a compatible widget specified in the *Widget* parameter as the data source;<br>**Custom** - set the time period specified in the *From* and *To* parameters as the data source; if set, a clock icon will be displayed in the top right corner of the widget, indicating the set time on mouseover.| |*Widget*|Enter or select a compatible widget as the data source for the time period.<br>This parameter is available if *Time period* is set to "Widget".| |*From*|Enter or select the start of the time period.<br>[Relative time syntax](/manual/web_interface/time_period_selector) (`now`, `now/d`, `now/w-1w`, etc.) is supported.<br>This parameter is available if *Time period* is set to "Custom".| |*To*|Enter or select the end of the time period.<br>[Relative time syntax](/manual/web_interface/time_period_selector) (`now`, `now/d`, `now/w-1w`, etc.) is supported.<br>This parameter is available if *Time period* is set to "Custom".| |*Show legend*|Unmark this checkbox to hide the legend on the graph (marked by default).| |*Override host*|Select a compatible widget or the dashboard as the [data source](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) for hosts.<br>This parameter is not available when configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards).| The legend of the graph consists of three sections: - Items and their aggregated values - Percentiles (if configured) - Triggers (if any are associated with the displayed items) If the height of the graph within the widget is insufficient, the legend may not be displayed or may be displayed only partially. Triggers and percentiles are hidden first, followed by the item legend. To display the full legend, increase the widget's vertical size. ::: noteclassic No more than 3 trigger lines can be displayed. If there are more triggers then the triggers with lower severity are prioritized for display. ::: Information displayed by the classic graph widget can be downloaded as *.png* image using the [widget menu](/manual/web_interface/frontend_sections/dashboards#widget-menu):  A screenshot of the widget will be saved to the *Downloads* folder. #### Konfigurācija Lai konfigurētu, izvēlieties *Graph (classic)* kā tipu: {width="600"} Papildus parametriem, kas ir [kopīgi](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters) visiem vienumiem, varat iestatīt šādas specifiskas opcijas: | | | |--|--------| |*Source*|Izvēlieties grafika tipu:<br>**Graph** - [pielāgots grafiks](/manual/config/visualization/graphs/custom);<br>**Simple graph** - [vienkāršs grafiks](/manual/config/visualization/graphs/simple).| |*Graph*|Izvēlieties attēlojamo pielāgoto grafiku.<br>Alternatīvi izvēlieties saderīgu vienumu kā [datu avotu](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) grafikiem.<br>Šis parametrs ir pieejams, ja *Source* ir iestatīts uz "Graph".| |*Item*|Izvēlieties vienumu, ko attēlot vienkāršā grafikā.<br>Alternatīvi izvēlieties saderīgu vienumu kā [datu avotu](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) vienumiem.<br>Šis parametrs ir pieejams, ja *Source* ir iestatīts uz "Simple graph".| |*Time period*|Iestatiet laika periodu, par kuru attēlot datus grafikā. Izvēlieties [datu avotu](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) laika periodam:<br>**Dashboard** - iestatiet *Time period* atlasītāju kā datu avotu;<br>**Widget** - iestatiet saderīgu vienumu, kas norādīts parametrā *Widget*, kā datu avotu;<br>**Custom** - iestatiet laika periodu, kas norādīts parametros *From* un *To*, kā datu avotu; ja tas ir iestatīts, logrīka augšējā labajā stūrī tiks parādīta pulksteņa ikona, norādot iestatīto laiku, kad uz tās uzvedina peli.| |*Widget*|Ievadiet vai izvēlieties saderīgu vienumu kā datu avotu laika periodam.<br>Šis parametrs ir pieejams, ja *Time period* ir iestatīts uz "Widget".| |*From*|Ievadiet vai izvēlieties laika perioda sākumu.<br>Tiek atbalstīta [relatīvā laika sintakse](/manual/web_interface/time_period_selector) (`now`, `now/d`, `now/w-1w` u. c.).<br>Šis parametrs ir pieejams, ja *Time period* ir iestatīts uz "Custom".| |*To*|Ievadiet vai izvēlieties laika perioda beigas.<br>Tiek atbalstīta [relatīvā laika sintakse](/manual/web_interface/time_period_selector) (`now`, `now/d`, `now/w-1w` u. c.).<br>Šis parametrs ir pieejams, ja *Time period* ir iestatīts uz "Custom".| |*Show legend*|Noņemiet atzīmi šai izvēles rūtiņai, lai paslēptu grafika leģendu (pēc noklusējuma tā ir atzīmēta).| |*Override host*|Izvēlieties saderīgu vienumu vai dashboard kā [datu avotu](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) hosts.<br>Šis parametrs nav pieejams, konfigurējot logrīku [veidnes dashboard](/manual/config/templates/template#adding-dashboards).| Grafika leģenda sastāv no trim sadaļām: - Vienumi un to apkopotās vērtības - Procentiles (ja konfigurētas) - Trigeri (ja tādi ir saistīti ar attēlotajiem vienumiem) Ja grafika augstums logrīkā ir nepietiekams, leģenda var netikt parādīta vai var tikt parādīta tikai daļēji. Vispirms tiek paslēpti trigeri un procentiles, pēc tam vienumu leģenda. Lai parādītu pilnu leģendu, palieliniet logrīka vertikālo izmēru. ::: noteclassic Var tikt parādītas ne vairāk kā 3 trigeru līnijas. Ja trigeru ir vairāk, tad attēlošanai tiek prioritizēti trigeri ar zemāku nopietnību. ::: Informāciju, kas tiek parādīta klasiskā grafika logrīkā, var lejupielādēt kā *.png* attēlu, izmantojot [logrīka izvēlni](/manual/web_interface/frontend_sections/dashboards#widget-menu):  Logrīka ekrānuzņēmums tiks saglabāts mapē *Downloads*. #### Configuration To configure, select *Graph prototype* as widget type: {width="600"} In addition to the parameters that are [common](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters) for all widgets, you may set the following specific options: | | | |--|--------| |*Source*|Select the source of the graphs: **Graph prototype** or **Simple graph prototype**.| |*Graph prototype*|Select a graph prototype to display graphs discovered by the graph prototype.<br>This parameter is available if *Source* is set to "Graph prototype".| |*Item prototype*|Select an item prototype to display simple graphs for items discovered by the item prototype.<br>This parameter is available if *Source* is set to "Simple graph prototype".| |*Time period*|Set a time period for which to display data in the graphs. Select the [data source](/manual/web_interface/frontend_sections/dashboards/widgets#dynamic-parameters) for the time period:<br>**Dashboard** - set the *Time period* selector as the data source;<br>**Widget** - set a compatible widget specified in the *Widget* parameter as the data source;<br>**Custom** - set the time period specified in the *From* and *To* parameters as the data source; if set, a clock icon will be displayed in the top right corner of the widget, indicating the set time on mouseover.| |*Widget*|Enter or select a compatible widget as the data source for the time period.<br>This parameter is available if *Time period* is set to "Widget".| |*From*|Enter or select the start of the time period.<br>[Relative time syntax](/manual/web_interface/time_period_selector) (`now`, `now/d`, `now/w-1w`, etc.) is supported.<br>This parameter is available if *Time period* is set to "Custom".| |*To*|Enter or select the end of the time period.<br>[Relative time syntax](/manual/web_interface/time_period_selector) (`now`, `now/d`, `now/w-1w`, etc.) is supported.<br>This parameter is available if *Time period* is set to "Custom".| |*Show legend*|Unmark this checkbox to hide the legend on the graphs (marked by default).| |*Override host*|Select a compatible widget or the dashboard as the [data source](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) for hosts.<br>This parameter is not available when configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards).| |*Columns*|Enter the number of columns of graphs to display within a graph prototype widget.| |*Rows*|Enter the number of rows of graphs to display within a graph prototype widget.| The legend of the graph consists of three sections: - Items and their aggregated values - Percentiles (if configured) - Triggers (if any are associated with the displayed items) If the height of the graph within the widget is insufficient, the legend may not be displayed or may be displayed only partially. Triggers and percentiles are hidden first, followed by the item legend. To display the full legend, increase the widget's vertical size. ::: noteclassic No more than 3 trigger lines can be displayed. If there are more triggers then the triggers with lower severity are prioritized for display. ::: While the *Columns* and *Rows* parameters allow fitting more than one graph in the widget, there still may be more discovered graphs than there are columns/rows in the widget. In this case, paging becomes available in the widget, and a slide-up header allows to switch between pages using the left and right arrows:  #### Konfigurācija Lai konfigurētu, kā logrīka tipu atlasiet *Graph prototype*: {width="600"} Papildus parametriem, kas ir [kopīgi](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters) visiem logrīkiem, varat iestatīt šādas specifiskās opcijas: | | | |--|--------| |*Source*|Atlasiet grafiku avotu: **Graph prototype** vai **Simple graph prototype**.| |*Graph prototype*|Atlasiet grafika prototipu, lai parādītu grafikus, kas atklāti ar grafika prototipu.<br>Šis parametrs ir pieejams, ja *Source* ir iestatīts uz "Graph prototype".| |*Item prototype*|Atlasiet vienuma prototipu, lai parādītu vienkāršos grafikus vienumiem, kas atklāti ar vienuma prototipu.<br>Šis parametrs ir pieejams, ja *Source* ir iestatīts uz "Simple graph prototype".| |*Time period*|Iestatiet laika periodu, kuram grafikos rādīt datus. Atlasiet laika perioda [datu avotu](/manual/web_interface/frontend_sections/dashboards/widgets#dynamic-parameters):<br>**Dashboard** - iestatiet *Time period* atlasītāju kā datu avotu;<br>**Widget** - iestatiet saderīgu logrīku, kas norādīts parametrā *Widget*, kā datu avotu;<br>**Custom** - iestatiet parametrā *From* un *To* norādīto laika periodu kā datu avotu; ja tas ir iestatīts, logrīka augšējā labajā stūrī tiks parādīta pulksteņa ikona, kas, uzvedot peli, norāda iestatīto laiku.| |*Widget*|Ievadiet vai atlasiet saderīgu logrīku kā laika perioda datu avotu.<br>Šis parametrs ir pieejams, ja *Time period* ir iestatīts uz "Widget".| |*From*|Ievadiet vai atlasiet laika perioda sākumu.<br>Tiek atbalstīta [relatīvā laika sintakse](/manual/web_interface/time_period_selector) (`now`, `now/d`, `now/w-1w` u. c.).<br>Šis parametrs ir pieejams, ja *Time period* ir iestatīts uz "Custom".| |*To*|Ievadiet vai atlasiet laika perioda beigas.<br>Tiek atbalstīta [relatīvā laika sintakse](/manual/web_interface/time_period_selector) (`now`, `now/d`, `now/w-1w` u. c.).<br>Šis parametrs ir pieejams, ja *Time period* ir iestatīts uz "Custom".| |*Show legend*|Noņemiet atzīmi šai izvēles rūtiņai, lai grafikos paslēptu leģendu (pēc noklusējuma tā ir atzīmēta).| |*Override host*|Atlasiet saderīgu logrīku vai paneli kā [datu avotu](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) hosts.<br>Šis parametrs nav pieejams, konfigurējot logrīku [veidnes panelī](/manual/config/templates/template#adding-dashboards).| |*Columns*|Ievadiet grafiku kolonnu skaitu, kas jāparāda grafika prototipa logrīkā.| |*Rows*|Ievadiet grafiku rindu skaitu, kas jāparāda grafika prototipa logrīkā.| Grafika leģenda sastāv no trim sadaļām: - Vienumi un to apkopotās vērtības - Procentiles (ja konfigurētas) - Trigeri (ja tādi ir saistīti ar parādītajiem vienumiem) Ja grafika augstums logrīkā ir nepietiekams, leģenda var netikt parādīta vai var tikt parādīta tikai daļēji. Vispirms tiek paslēpti trigeri un procentiles, pēc tam vienumu leģenda. Lai parādītu pilnu leģendu, palieliniet logrīka vertikālo izmēru. ::: noteclassic Var parādīt ne vairāk kā 3 trigeru līnijas. Ja trigeru ir vairāk, parādīšanai tiek prioritizēti trigeri ar zemāku smaguma pakāpi. ::: Lai gan parametri *Columns* un *Rows* ļauj logrīkā ievietot vairāk nekā vienu grafiku, joprojām var būt vairāk atklātu grafiku nekā logrīkā ir kolonnu/rindu. Šādā gadījumā logrīkā kļūst pieejama lappušu pārslēgšana, un izbīdāma galvene ļauj pārslēgties starp lapām, izmantojot kreiso un labo bultiņu:  #### Configuration To configure, select *Honeycomb* as type: {width="600"} In addition to the parameters that are [common](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters) for all widgets, you may set the following specific options: | | | |--|--------| |*Host groups*|Select host groups.<br>Alternatively, select a compatible widget as the [data source](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) for host groups.<br>This field is auto-complete, so starting to type the name of a group will offer a dropdown of matching groups.<br>Selecting a parent host group implicitly selects all nested host groups; if no host groups are selected, the widget will display all host groups containing hosts with items matching the selected *Item pattern* (see below).<br>This parameter is not available when configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards).| |*Hosts*|Select hosts.<br>Alternatively, select a compatible widget or the dashboard as the [data source](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) for hosts.<br>This field is auto-complete, so starting to type the name of a host will offer a dropdown of matching hosts.<br>If no hosts are selected, the widget will display all hosts with items matching the selected *Item pattern* (see below).<br>This parameter is not available when configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards).| |*Host tags*|Specify tags to limit the number of hosts displayed in the widget.<br>It is possible to include as well as exclude specific tags and tag values. Several conditions can be set.<br>Tag name matching is always case-sensitive.<br><br>There are several operators available for each condition:<br>**Exists** - include the specified tag names;<br>**Equals** - include the specified tag names and values (case-sensitive);<br>**Contains** - include the specified tag names where the tag values contain the entered string (substring match, case-insensitive);<br>**Does not exist** - exclude the specified tag names;<br>**Does not equal** - exclude the specified tag names and values (case-sensitive);<br>**Does not contain** - exclude the specified tag names where the tag values contain the entered string (substring match, case-insensitive).<br><br>There are two calculation types for conditions:<br>**And/Or** - all conditions must be met, conditions having the same tag name will be grouped by the Or condition;<br>**Or** - enough if one condition is met.<br><br>This parameter is not available when configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards).| |*Item patterns*|Enter item patterns or select existing items as item patterns. Data of items that match the entered or selected patterns will be displayed on the honeycomb. The *Item patterns* parameter is mandatory.<br><br>Wildcard patterns may be used for selection (for example, `*` will return items that match zero or more characters; `Zabbix*` will return items that start with "Zabbix").<br>To specify a wildcard pattern, enter the string manually and press *Enter*. When you start typing, a dropdown list will show matching items limited to those belonging to selected *Hosts* or hosts within selected *Host groups*, if any. The wildcard symbol is always interpreted, therefore, it is not possible to add, for example, an item named *item\** individually, if there are other matching items (e.g., item2, item3).<br><br>When configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards), this parameter allows selecting only [items configured on the template](/manual/config/templates/template#adding-items-triggers-graphs).| |*Item tags*|Specify tags to limit the number of items displayed in the widget. For more information, see *Host tags* above.| |*Show hosts in maintenance*|Mark this checkbox to display hosts in maintenance (in this case, maintenance icon will be shown next to the host name).<br>This parameter is labeled *Show data in maintenance* when configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards).| |*Show*|Mark this checkbox to display the respective honeycomb cell element - primary label, secondary label.<br>At least one element must be selected.| |*Advanced configuration*|Click the *Advanced configuration* header to display [advanced configuration](#advanced-configuration) options.| #### Konfigurācija Lai konfigurētu, kā tipu atlasiet *Honeycomb*: {width="600"} Papildus parametriem, kas ir [kopīgi](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters) visiem logrīkiem, varat iestatīt šādas specifiskas opcijas: | | | |--|--------| |*Host grupas*|Atlasiet host grupas.<br>Vai arī atlasiet saderīgu logrīku kā [datu avotu](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) host grupām.<br>Šis lauks ir ar automātisko pabeigšanu, tāpēc, sākot rakstīt grupas nosaukumu, tiks piedāvāts nolaižamais saraksts ar atbilstošajām grupām.<br>Atlasot vecāko host grupu, netieši tiek atlasītas visas ligzdotās host grupas; ja neviena host grupa nav atlasīta, logrīks parādīs visas host grupas, kurās ir hosts ar vienumiem, kas atbilst atlasītajam *Item pattern* (skatiet tālāk).<br>Šis parametrs nav pieejams, konfigurējot logrīku [veidnes informācijas panelī](/manual/config/templates/template#adding-dashboards).| |*Hosts*|Atlasiet hosts.<br>Vai arī atlasiet saderīgu logrīku vai informācijas paneli kā [datu avotu](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) hosts.<br>Šis lauks ir ar automātisko pabeigšanu, tāpēc, sākot rakstīt hosta nosaukumu, tiks piedāvāts nolaižamais saraksts ar atbilstošajiem hosts.<br>Ja neviens hosts nav atlasīts, logrīks parādīs visus hosts ar vienumiem, kas atbilst atlasītajam *Item pattern* (skatiet tālāk).<br>Šis parametrs nav pieejams, konfigurējot logrīku [veidnes informācijas panelī](/manual/config/templates/template#adding-dashboards).| |*Host tagi*|Norādiet tagus, lai ierobežotu logrīkā parādīto hosts skaitu.<br>Ir iespējams iekļaut, kā arī izslēgt konkrētus tagus un tagu vērtības. Var iestatīt vairākus nosacījumus.<br>Tagu nosaukumu atbilstība vienmēr ir reģistrjutīga.<br><br>Katram nosacījumam ir pieejami vairāki operatori:<br>**Exists** - iekļaut norādītos tagu nosaukumus;<br>**Equals** - iekļaut norādītos tagu nosaukumus un vērtības (reģistrjutīgi);<br>**Contains** - iekļaut norādītos tagu nosaukumus, kuru tagu vērtības satur ievadīto virkni (apakšvirknes atbilstība, nav reģistrjutīga);<br>**Does not exist** - izslēgt norādītos tagu nosaukumus;<br>**Does not equal** - izslēgt norādītos tagu nosaukumus un vērtības (reģistrjutīgi);<br>**Does not contain** - izslēgt norādītos tagu nosaukumus, kuru tagu vērtības satur ievadīto virkni (apakšvirknes atbilstība, nav reģistrjutīga).<br><br>Nosacījumiem ir pieejami divi aprēķina veidi:<br>**And/Or** - jāizpildās visiem nosacījumiem, nosacījumi ar vienādu taga nosaukumu tiks grupēti pēc Or nosacījuma;<br>**Or** - pietiek, ja izpildās viens nosacījums.<br><br>Šis parametrs nav pieejams, konfigurējot logrīku [veidnes informācijas panelī](/manual/config/templates/template#adding-dashboards).| |*Item patterns*|Ievadiet vienumu modeļus vai atlasiet esošus vienumus kā vienumu modeļus. Honeycomb tiks parādīti to vienumu dati, kas atbilst ievadītajiem vai atlasītajiem modeļiem. Parametrs *Item patterns* ir obligāts.<br><br>Atlasei var izmantot aizstājējzīmju modeļus (piemēram, `*` atgriezīs vienumus, kas atbilst nullei vai vairāk rakstzīmēm; `Zabbix*` atgriezīs vienumus, kas sākas ar "Zabbix").<br>Lai norādītu aizstājējzīmes modeli, ievadiet virkni manuāli un nospiediet *Enter*. Sākot rakstīt, nolaižamajā sarakstā tiks parādīti atbilstošie vienumi, kas ierobežoti ar tiem, kuri pieder atlasītajiem *Hosts* vai hosts atlasītajās *Host grupas*, ja tādas ir. Aizstājējzīmes simbols vienmēr tiek interpretēts, tāpēc nav iespējams, piemēram, atsevišķi pievienot vienumu ar nosaukumu *item\** , ja ir citi atbilstoši vienumi (piem., item2, item3).<br><br>Konfigurējot logrīku [veidnes informācijas panelī](/manual/config/templates/template#adding-dashboards), šis parametrs ļauj atlasīt tikai [veidnē konfigurētos vienumus](/manual/config/templates/template#adding-items-triggers-graphs).| |*Item tagi*|Norādiet tagus, lai ierobežotu logrīkā parādīto vienumu skaitu. Plašāku informāciju skatiet iepriekš sadaļā *Host tags*.| |*Rādīt hosts uzturēšanā*|Atzīmējiet šo izvēles rūtiņu, lai parādītu hosts uzturēšanā (šajā gadījumā blakus hosta nosaukumam tiks rādīta uzturēšanas ikona).<br>Konfigurējot logrīku [veidnes informācijas panelī](/manual/config/templates/template#adding-dashboards), šis parametrs ir apzīmēts kā *Show data in maintenance*.| |*Rādīt*|Atzīmējiet šo izvēles rūtiņu, lai parādītu attiecīgo Honeycomb šūnas elementu - primāro etiķeti, sekundāro etiķeti.<br>Jābūt atlasītam vismaz vienam elementam.| |*Papildu konfigurācija*|Noklikšķiniet uz virsraksta *Advanced configuration*, lai parādītu [papildu konfigurācijas](#advanced-configuration) opcijas.| #### Configuration To configure, select *Host availability* as type: {width="600"} In addition to the parameters that are [common](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters) for all widgets, you may set the following specific options: | | | |--|--------| |*Host groups*|Select host groups.<br>Alternatively, select a compatible widget as the [data source](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) for host groups.<br>This field is auto-complete, so starting to type the name of a group will offer a dropdown of matching groups.<br>This parameter is not available when configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards).| |*Interface type*|Select which host interfaces you want to see availability data for.<br>Availability of all interfaces is displayed by default if nothing is selected.| |*Layout*|Select horizontal display (columns) or vertical display (lines).| |*Include hosts in maintenance*|Include hosts that are in maintenance in the statistics.<br>This parameter is labeled *Show data in maintenance* when configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards).| |*Show only totals*|If checked, the total of hosts, without breakdown by interfaces, is displayed. This option is disabled if only one interface is selected.| #### Konfigurācija Lai konfigurētu, atlasiet *Host availability* kā tipu: {width="600"} Papildus parametriem, kas ir [kopīgi](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters) visiem logrīkiem, varat iestatīt šādas specifiskās opcijas: | | | |--|--------| |*Host groups*|Atlasiet hostu grupas.<br>Vai arī atlasiet saderīgu logrīku kā [datu avotu](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) hostu grupām.<br>Šis lauks atbalsta automātisko pabeigšanu, tāpēc, sākot rakstīt grupas nosaukumu, tiks piedāvāts nolaižamais saraksts ar atbilstošajām grupām.<br>Šis parametrs nav pieejams, konfigurējot logrīku [veidnes informācijas panelī](/manual/config/templates/template#adding-dashboards).| |*Interface type*|Atlasiet, kurām hostu saskarnēm vēlaties redzēt pieejamības datus.<br>Ja nekas nav atlasīts, pēc noklusējuma tiek rādīta visu saskarņu pieejamība.| |*Layout*|Atlasiet horizontālu attēlojumu (kolonnas) vai vertikālu attēlojumu (rindas).| |*Include hosts in maintenance*|Iekļaut statistikā hostus, kas ir apkopē.<br>Konfigurējot logrīku [veidnes informācijas panelī](/manual/config/templates/template#adding-dashboards), šis parametrs ir apzīmēts kā *Show data in maintenance*.| |*Show only totals*|Ja atzīmēts, tiek rādīts tikai hostu kopskaits bez sadalījuma pēc saskarnēm. Šī opcija ir atspējota, ja ir atlasīta tikai viena saskarne.| #### Configuration To configure, select *Host navigator* as type: {width="600"} In addition to the parameters that are [common](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters) for all widgets, you may set the following specific options: | | | |--|--------| |*Host groups*|Select host groups.<br>Alternatively, select a compatible widget as the [data source](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) for host groups.<br>This field is auto-complete, so starting to type the name of a group will offer a dropdown of matching groups.<br>Selecting a parent host group implicitly selects all nested host groups; if no host groups are selected, the widget will display all hosts from all host groups.<br><br>This parameter is not available when configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards).| |*Host patterns*|Enter host patterns or select existing hosts as host patterns. Hosts that match the specified patterns will be displayed on the host navigator.<br>This field is auto-complete, so starting to type the name of a host will offer a dropdown of matching hosts.<br>If no hosts are selected, the widget will display all hosts.<br><br>Wildcard patterns may be used for selection (for example, `*` will return hosts that match zero or more characters; `Zabbix*` will return hosts that start with "Zabbix").<br>To specify a wildcard pattern, enter the string manually and press *Enter*. When you start typing, a dropdown list will show matching hosts limited to those belonging to hosts within selected *Host groups*, if any.<br><br>This parameter is not available when configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards).| |*Host status*|Filter which hosts to display based on their status (any, enabled, disabled).<br><br>This parameter is not available when configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards).| |*Host tags*|Specify tags to filter the hosts displayed in the widget.<br>It is possible to include as well as exclude specific tags and tag values. Several conditions can be set.<br>Tag name matching is always case-sensitive.<br><br>There are several operators available for each condition:<br>**Exists** - include the specified tag names;<br>**Equals** - include the specified tag names and values (case-sensitive);<br>**Contains** - include the specified tag names where the tag values contain the entered string (substring match, case-insensitive);<br>**Does not exist** - exclude the specified tag names;<br>**Does not equal** - exclude the specified tag names and values (case-sensitive);<br>**Does not contain** - exclude the specified tag names where the tag values contain the entered string (substring match, case-insensitive).<br><br>There are two calculation types for conditions:<br>**And/Or** - all conditions must be met, conditions having the same tag name will be grouped by the Or condition;<br>**Or** - enough if one condition is met.<br><br>This parameter is not available when configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards).| |*Severity*|Mark problem severities to filter hosts with problems to be displayed in the widget.<br>If no severities are marked, all hosts with all problems will be displayed.| |*Show hosts in maintenance*|Mark this checkbox to display hosts in maintenance (in this case, maintenance icon will be shown next to the host name).<br><br>This parameter is labeled *Show data in maintenance* when configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards).| |*Show problems*|Filter which problems to display with the hosts in the widget based on their status (all, unsuppressed, none).| |*Group by*|Add a grouping attribute by which to group the selected hosts:<br>**Host group** - group hosts by their host group;<br>**Tag value** - enter a tag name to group hosts by the values of this tag (for example, enter "city" to group hosts by values "Riga", "Tokyo", etc.);<br>**Severity** - group hosts by their problem severities.<br><br>If *Show problems* is configured to display problems, they are displayed as follows:<br>- for each severity group, only the corresponding problem count is displayed;<br>- for each host, all its problem counts are displayed.<br>Note that hosts will be grouped only by those severities marked in the *Severity* parameter; if no severities are marked, all hosts will be grouped by all severities.<br><br>Grouping attributes can be reordered by dragging up or down by the handle before the group name. Note that grouping attribute order determines group nesting order. For example, specifying multiple tag names (1: color, 2: city) will result in hosts being grouped by color (red, blue, etc.) and then by city (Riga, Tokyo, etc.).<br><br>A host may be displayed in multiple groups depending on the configured grouping attributes (for example, when grouping by host group and the host belongs to multiple host groups). Clicking such hosts selects and highlights them in all groups.<br>Hosts that do not match the configured grouping attributes are displayed in the *Uncategorized* group.<br><br>Up to 10 grouping attributes can be specified, and all must be unique.<br>If no grouping attributes are specified, hosts will not be grouped.| |*Host limit*|Enter the maximum number of hosts to be displayed. Possible values range from 1-9999.<br><br>When more hosts are available for displaying than the set limit, a corresponding message is shown below the displayed hosts (for example, "100 of 100+ hosts are shown").<br>Note that the configured host limit also affects the display of configured groups; for example, if host limit is set to 100 and hosts are grouped by tag values (more than 200), only the first 100 tag values with the corresponding hosts will be displayed in the widget.<br><br>This parameter is not affected by the *Limit for search and filter results* parameter in *Administration* → *General* → [*GUI*](/manual/web_interface/frontend_sections/administration/general#gui).<br><br>This parameter is not available when configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards).| #### Konfigurācija Lai konfigurētu, kā tipu atlasiet *Host navigator*: {width="600"} Papildus parametriem, kas ir [kopīgi](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters) visiem logrīkiem, varat iestatīt šādas specifiskas opcijas: | | | |--|--------| |*Host groups*|Atlasiet hostu grupas.<br>Alternatīvi atlasiet saderīgu logrīku kā [datu avotu](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) hostu grupām.<br>Šis lauks atbalsta automātisko pabeigšanu, tāpēc, sākot rakstīt grupas nosaukumu, tiks piedāvāts nolaižamais saraksts ar atbilstošām grupām.<br>Atlasot vecāka hostu grupu, netieši tiek atlasītas visas ligzdotās hostu grupas; ja neviena hostu grupa nav atlasīta, logrīks parādīs visus hostus no visām hostu grupām.<br><br>Šis parametrs nav pieejams, konfigurējot logrīku [veidnes informācijas panelī](/manual/config/templates/template#adding-dashboards).| |*Host patterns*|Ievadiet hostu modeļus vai atlasiet esošos hostus kā hostu modeļus. Hosti, kas atbilst norādītajiem modeļiem, tiks parādīti host navigator.<br>Šis lauks atbalsta automātisko pabeigšanu, tāpēc, sākot rakstīt hosta nosaukumu, tiks piedāvāts nolaižamais saraksts ar atbilstošajiem hostiem.<br>Ja neviens hosts nav atlasīts, logrīks parādīs visus hostus.<br><br>Atlasei var izmantot aizstājējzīmju modeļus (piemēram, `*` atgriezīs hostus, kas atbilst nulles vai vairākiem simboliem; `Zabbix*` atgriezīs hostus, kas sākas ar "Zabbix").<br>Lai norādītu aizstājējzīmes modeli, ievadiet virkni manuāli un nospiediet *Enter*. Sākot rakstīt, nolaižamajā sarakstā tiks parādīti atbilstošie hosti, kas aprobežoti ar tiem, kas pieder atlasītajām *Host groups*, ja tādas ir.<br><br>Šis parametrs nav pieejams, konfigurējot logrīku [veidnes informācijas panelī](/manual/config/templates/template#adding-dashboards).| |*Host status*|Filtrējiet, kurus hostus rādīt, pamatojoties uz to statusu (any, enabled, disabled).<br><br>Šis parametrs nav pieejams, konfigurējot logrīku [veidnes informācijas panelī](/manual/config/templates/template#adding-dashboards).| |*Host tags*|Norādiet tagus, lai filtrētu logrīkā parādītos hostus.<br>Iespējams iekļaut, kā arī izslēgt konkrētus tagus un tagu vērtības. Var iestatīt vairākus nosacījumus.<br>Tagu nosaukumu atbilstība vienmēr ir reģistrjutīga.<br><br>Katram nosacījumam ir pieejami vairāki operatori:<br>**Exists** - iekļaut norādītos tagu nosaukumus;<br>**Equals** - iekļaut norādītos tagu nosaukumus un vērtības (reģistrjutīgi);<br>**Contains** - iekļaut norādītos tagu nosaukumus, kuru tagu vērtības satur ievadīto virkni (apakšvirknes atbilstība, nereģistrjutīgi);<br>**Does not exist** - izslēgt norādītos tagu nosaukumus;<br>**Does not equal** - izslēgt norādītos tagu nosaukumus un vērtības (reģistrjutīgi);<br>**Does not contain** - izslēgt norādītos tagu nosaukumus, kuru tagu vērtības satur ievadīto virkni (apakšvirknes atbilstība, nereģistrjutīgi).<br><br>Nosacījumiem ir divi aprēķina tipi:<br>**And/Or** - jāizpildās visiem nosacījumiem, nosacījumi ar vienādu taga nosaukumu tiks grupēti pēc Or nosacījuma;<br>**Or** - pietiek, ja izpildās viens nosacījums.<br><br>Šis parametrs nav pieejams, konfigurējot logrīku [veidnes informācijas panelī](/manual/config/templates/template#adding-dashboards).| |*Severity*|Atzīmējiet problēmu smaguma līmeņus, lai filtrētu hostus ar problēmām, kas tiks parādīti logrīkā.<br>Ja nav atzīmēts neviens smaguma līmenis, tiks parādīti visi hosti ar visām problēmām.| |*Show hosts in maintenance*|Atzīmējiet šo izvēles rūtiņu, lai parādītu hostus tehniskajā apkopē (šajā gadījumā blakus hosta nosaukumam tiks rādīta apkopes ikona).<br><br>Konfigurējot logrīku [veidnes informācijas panelī](/manual/config/templates/template#adding-dashboards), šim parametram ir etiķete *Show data in maintenance*.| |*Show problems*|Filtrējiet, kuras problēmas rādīt kopā ar hostiem logrīkā, pamatojoties uz to statusu (all, unsuppressed, none).| |*Group by*|Pievienojiet grupēšanas atribūtu, pēc kura grupēt atlasītos hostus:<br>**Host group** - grupēt hostus pēc to hostu grupas;<br>**Tag value** - ievadiet taga nosaukumu, lai grupētu hostus pēc šī taga vērtībām (piemēram, ievadiet "city", lai grupētu hostus pēc vērtībām "Riga", "Tokyo" u. c.);<br>**Severity** - grupēt hostus pēc to problēmu smaguma līmeņiem.<br><br>Ja *Show problems* ir konfigurēts tā, lai rādītu problēmas, tās tiek parādītas šādi:<br>- katrai smaguma līmeņa grupai tiek rādīts tikai attiecīgais problēmu skaits;<br>- katram hostam tiek rādīti visi tā problēmu skaiti.<br>Ņemiet vērā, ka hosti tiks grupēti tikai pēc tiem smaguma līmeņiem, kas atzīmēti parametrā *Severity*; ja nav atzīmēts neviens smaguma līmenis, visi hosti tiks grupēti pēc visiem smaguma līmeņiem.<br><br>Grupēšanas atribūtus var pārkārtot, velkot tos uz augšu vai uz leju aiz roktura pirms grupas nosaukuma. Ņemiet vērā, ka grupēšanas atribūtu secība nosaka grupu ligzdošanas secību. Piemēram, norādot vairākus tagu nosaukumus (1: color, 2: city), hosti tiks grupēti pēc krāsas (red, blue u. c.) un pēc tam pēc pilsētas (Riga, Tokyo u. c.).<br><br>Hosts var tikt parādīts vairākās grupās atkarībā no konfigurētajiem grupēšanas atribūtiem (piemēram, grupējot pēc hostu grupas un hosts pieder vairākām hostu grupām). Noklikšķinot uz šādiem hostiem, tie tiek atlasīti un izcelti visās grupās.<br>Hosti, kas neatbilst konfigurētajiem grupēšanas atribūtiem, tiek parādīti grupā *Uncategorized*.<br><br>Var norādīt līdz 10 grupēšanas atribūtiem, un visiem tiem jābūt unikāliem.<br>Ja nav norādīts neviens grupēšanas atribūts, hosti netiks grupēti.| |*Host limit*|Ievadiet maksimālo parādāmo hostu skaitu. Iespējamās vērtības ir no 1 līdz 9999.<br><br>Ja parādīšanai pieejamo hostu skaits pārsniedz iestatīto limitu, zem parādītajiem hostiem tiek rādīts attiecīgs paziņojums (piemēram, "100 of 100+ hosts are shown").<br>Ņemiet vērā, ka konfigurētais hostu limits ietekmē arī konfigurēto grupu attēlošanu; piemēram, ja hostu limits ir iestatīts uz 100 un hosti tiek grupēti pēc tagu vērtībām (vairāk nekā 200), logrīkā tiks parādītas tikai pirmās 100 tagu vērtības ar attiecīgajiem hostiem.<br><br>Šo parametru neietekmē parametrs *Limit for search and filter results* sadaļā *Administration* → *General* → [*GUI*](/manual/web_interface/frontend_sections/administration/general#gui).<br><br>Šis parametrs nav pieejams, konfigurējot logrīku [veidnes informācijas panelī](/manual/config/templates/template#adding-dashboards).| #### Configuration To configure, select *Item history* as type: {width="600"} In addition to the parameters that are [common](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters) for all widgets, you may set the following specific options: | | | |--|--------| |*Layout*|Select the layout option for item columns:<br>**Horizontal** - items will be displayed horizontally, values vertically;<br>**Vertical** - items will be displayed vertically, values horizontally.| |*Columns*|Add data [columns](#column-configuration) to display.<br>The order of columns determines their display order.<br>Columns can be reordered by dragging them up or down by the handle before the column name.| |*Show lines*|Specify the number of item value lines to display.| |*Override host*|Select a compatible widget or the dashboard as the [data source](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) for hosts.<br>This parameter is not available when configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards).| |*Advanced configuration*|Click the *Advanced configuration* header to display [advanced configuration](#advanced-configuration) options.| #### Konfigurācija Lai konfigurētu, kā tipu atlasiet *Item history*: {width="600"} Papildus parametriem, kas ir [kopīgi](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters) visiem logrīkiem, varat iestatīt šādas specifiskās opcijas: | | | |--|--------| |*Layout*|Atlasiet vienuma kolonnu izkārtojuma opciju:<br>**Horizontal** - vienumi tiks attēloti horizontāli, vērtības vertikāli;<br>**Vertical** - vienumi tiks attēloti vertikāli, vērtības horizontāli.| |*Columns*|Pievienojiet datu [kolonnas](#column-configuration) attēlošanai.<br>Kolonnu secība nosaka to attēlošanas secību.<br>Kolonnas var pārkārtot, velkot tās uz augšu vai uz leju aiz roktura pirms kolonnas nosaukuma.| |*Show lines*|Norādiet attēlojamo vienuma vērtību rindu skaitu.| |*Override host*|Atlasiet saderīgu logrīku vai informācijas paneli kā [datu avotu](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) hosts.<br>Šis parametrs nav pieejams, konfigurējot logrīku [veidnes informācijas panelī](/manual/config/templates/template#adding-dashboards).| |*Advanced configuration*|Noklikšķiniet uz *Advanced configuration* virsraksta, lai parādītu [papildu konfigurācijas](#advanced-configuration) opcijas.| #### Configuration To configure, select *Item navigator* as type: {width="600"} In addition to the parameters that are [common](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters) for all widgets, you may set the following specific options: | | | |--|--------| |*Host groups*|Select host groups.<br>Alternatively, select a compatible widget as the [data source](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) for host groups.<br>This field is auto-complete, so starting to type the name of a group will offer a dropdown of matching groups.<br>Selecting a parent host group implicitly selects all nested host groups; if no host groups are selected, the widget will display items belonging to all hosts from all host groups.<br><br>This parameter is not available when configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards).| |*Hosts*|Select hosts.<br>Alternatively, select a compatible widget or the dashboard as the [data source](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) for hosts.<br>This field is auto-complete, so starting to type the name of a host will offer a dropdown of matching hosts.<br>If no hosts are selected, the widget will display items belonging to all hosts.<br><br>This parameter is not available when configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards).| |*Host tags*|Specify host tags to filter the items displayed in the widget.<br>It is possible to include as well as exclude specific tags and tag values. Several conditions can be set.<br>Tag name matching is always case-sensitive.<br><br>There are several operators available for each condition:<br>**Exists** - include the specified tag names;<br>**Equals** - include the specified tag names and values (case-sensitive);<br>**Contains** - include the specified tag names where the tag values contain the entered string (substring match, case-insensitive);<br>**Does not exist** - exclude the specified tag names;<br>**Does not equal** - exclude the specified tag names and values (case-sensitive);<br>**Does not contain** - exclude the specified tag names where the tag values contain the entered string (substring match, case-insensitive).<br><br>There are two calculation types for conditions:<br>**And/Or** - all conditions must be met, conditions having the same tag name will be grouped by the Or condition;<br>**Or** - enough if one condition is met.<br><br>This parameter is not available when configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards).| |*Item patterns*|Enter item patterns or select existing items as item patterns. Items that match the specified patterns will be displayed on the item navigator.<br><br>Wildcard patterns may be used for selection (for example, `*` will return items that match zero or more characters; `Zabbix*` will return items that start with "Zabbix").<br>To specify a wildcard pattern, enter the string manually and press *Enter*. When you start typing, a dropdown list will show matching items limited to those belonging to selected *Hosts* or hosts within selected *Host groups*, if any. The wildcard symbol is always interpreted, therefore, it is not possible to add, for example, an item named *item\** individually, if there are other matching items (e.g., item2, item3).<br><br>When configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards), this parameter allows selecting only [items configured on the template](/manual/config/templates/template#adding-items-triggers-graphs).| |*Item tags*|Specify item tags to filter the items displayed in the widget.<br>It is possible to include as well as exclude specific tags and tag values. Several conditions can be set.<br>Tag name matching is always case-sensitive.<br><br>There are several operators available for each condition:<br>**Exists** - include the specified tag names;<br>**Equals** - include the specified tag names and values (case-sensitive);<br>**Contains** - include the specified tag names where the tag values contain the entered string (substring match, case-insensitive);<br>**Does not exist** - exclude the specified tag names;<br>**Does not equal** - exclude the specified tag names and values (case-sensitive);<br>**Does not contain** - exclude the specified tag names where the tag values contain the entered string (substring match, case-insensitive).<br><br>There are two calculation types for conditions:<br>**And/Or** - all conditions must be met, conditions having the same tag name will be grouped by the Or condition;<br>**Or** - enough if one condition is met.| |*State*|Filter which items to display based on their state (all, normal, not supported).| |*Show problems*|Filter which problems to display with items based on their status (all, unsuppressed, none).| |*Group by*|Add a grouping attribute by which to group items:<br>**Host group** - group items by host groups of their hosts;<br>**Host name** - group items by their hosts;<br>**Host tag value** - enter a tag name to group items by the values of this host tag (for example, enter "city" to group items by values "Riga", "Tokyo", etc.);<br>**Item tag value** - enter a tag name to group items by the values of this item tag (for example, enter "component" to group items by values "cpu", "memory", etc.).<br><br>Grouping attributes can be reordered by dragging up or down by the handle before the group name. Note that grouping attribute order determines group nesting order. For example, specifying multiple host tag names (1: color, 2: city) will result in items being grouped by color (red, blue, etc.) and then by city (Riga, Tokyo, etc.).<br><br>An item may be displayed in multiple groups depending on the configured grouping attributes (for example, when grouping by host group and the item's host belongs to multiple host groups). Clicking such items selects and highlights them in all groups.<br>Items that do not match the configured grouping attributes are displayed in the *Uncategorized* group.<br><br>If *Show problems* is configured to display problems, they are displayed as follows:<br>- for each group, all subordinate item problem count is displayed;<br>- for each item, only its problem count is displayed.<br><br>Up to 10 grouping attributes can be specified, and all must be unique.<br>If no grouping attributes are specified, items will not be grouped.| |*Item limit*|Enter the maximum number of items to be displayed. Possible values range from 1-9999.<br><br>When more items are available for displaying than the set limit, a corresponding message is shown below the displayed items (for example, "100 of 100+ items are shown").<br>Note that the configured item limit also affects the display of configured groups; for example, if item limit is set to 100 and items are grouped by their hosts (each containing 200 items), only the first host with its 100 items will be displayed in the widget.<br><br>This parameter is not affected by the *Limit for search and filter results* parameter in *Administration* > *General* > [*GUI*](/manual/web_interface/frontend_sections/administration/general#gui).| #### Konfigurācija Lai konfigurētu, kā tipu atlasiet *Item navigator*: {width="600"} Papildus parametriem, kas ir [kopīgi](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters) visiem logrīkiem, varat iestatīt šādas specifiskās opcijas: | | | |--|--------| |*Host groups*|Atlasiet hostu grupas.<br>Vai arī atlasiet saderīgu logrīku kā hostu [datu avotu](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters).<br>Šis lauks atbalsta automātisko pabeigšanu, tāpēc, sākot rakstīt grupas nosaukumu, tiks piedāvāts nolaižamais saraksts ar atbilstošajām grupām.<br>Atlasot vecāka hostu grupu, netieši tiek atlasītas visas ligzdotās hostu grupas; ja nav atlasīta neviena hostu grupa, logrīks parādīs vienumus, kas pieder visiem hostiem no visām hostu grupām.<br><br>Šis parametrs nav pieejams, konfigurējot logrīku [veidnes informācijas panelī](/manual/config/templates/template#adding-dashboards).| |*Hosts*|Atlasiet hostus.<br>Vai arī atlasiet saderīgu logrīku vai informācijas paneli kā hostu [datu avotu](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters).<br>Šis lauks atbalsta automātisko pabeigšanu, tāpēc, sākot rakstīt hosta nosaukumu, tiks piedāvāts nolaižamais saraksts ar atbilstošajiem hostiem.<br>Ja nav atlasīts neviens hosts, logrīks parādīs vienumus, kas pieder visiem hostiem.<br><br>Šis parametrs nav pieejams, konfigurējot logrīku [veidnes informācijas panelī](/manual/config/templates/template#adding-dashboards).| |*Host tags*|Norādiet hostu tagus, lai filtrētu logrīkā parādītos vienumus.<br>Ir iespējams iekļaut, kā arī izslēgt konkrētus tagus un tagu vērtības. Var iestatīt vairākus nosacījumus.<br>Tagu nosaukumu atbilstība vienmēr ir reģistrjutīga.<br><br>Katrai nosacījumam ir pieejami vairāki operatori:<br>**Exists** - iekļaut norādītos tagu nosaukumus;<br>**Equals** - iekļaut norādītos tagu nosaukumus un vērtības (reģistrjutīgi);<br>**Contains** - iekļaut norādītos tagu nosaukumus, kuru tagu vērtības satur ievadīto virkni (apakšvirknes atbilstība, nereģistrjutīgi);<br>**Does not exist** - izslēgt norādītos tagu nosaukumus;<br>**Does not equal** - izslēgt norādītos tagu nosaukumus un vērtības (reģistrjutīgi);<br>**Does not contain** - izslēgt norādītos tagu nosaukumus, kuru tagu vērtības satur ievadīto virkni (apakšvirknes atbilstība, nereģistrjutīgi).<br><br>Nosacījumiem ir pieejami divi aprēķina tipi:<br>**And/Or** - jāizpildās visiem nosacījumiem, nosacījumi ar vienādu taga nosaukumu tiks grupēti pēc Or nosacījuma;<br>**Or** - pietiek, ja izpildās viens nosacījums.<br><br>Šis parametrs nav pieejams, konfigurējot logrīku [veidnes informācijas panelī](/manual/config/templates/template#adding-dashboards).| |*Item patterns*|Ievadiet vienumu modeļus vai atlasiet esošus vienumus kā vienumu modeļus. Vienumi, kas atbilst norādītajiem modeļiem, tiks parādīti vienumu navigatorā.<br><br>Atlasei var izmantot aizstājējzīmju modeļus (piemēram, `*` atgriezīs vienumus, kas atbilst nullei vai vairāk rakstzīmēm; `Zabbix*` atgriezīs vienumus, kas sākas ar "Zabbix").<br>Lai norādītu aizstājējzīmes modeli, ievadiet virkni manuāli un nospiediet *Enter*. Sākot rakstīt, nolaižamajā sarakstā tiks parādīti atbilstošie vienumi, kas ierobežoti ar tiem, kuri pieder atlasītajiem *Hosts* vai hostiem atlasītajās *Host groups*, ja tādas ir. Aizstājējzīmes simbols vienmēr tiek interpretēts, tāpēc nav iespējams, piemēram, atsevišķi pievienot vienumu ar nosaukumu *item\** , ja pastāv citi atbilstoši vienumi (piem., item2, item3).<br><br>Konfigurējot logrīku [veidnes informācijas panelī](/manual/config/templates/template#adding-dashboards), šis parametrs ļauj atlasīt tikai [vienumus, kas konfigurēti veidnē](/manual/config/templates/template#adding-items-triggers-graphs).| |*Item tags*|Norādiet vienumu tagus, lai filtrētu logrīkā parādītos vienumus.<br>Ir iespējams iekļaut, kā arī izslēgt konkrētus tagus un tagu vērtības. Var iestatīt vairākus nosacījumus.<br>Tagu nosaukumu atbilstība vienmēr ir reģistrjutīga.<br><br>Katrai nosacījumam ir pieejami vairāki operatori:<br>**Exists** - iekļaut norādītos tagu nosaukumus;<br>**Equals** - iekļaut norādītos tagu nosaukumus un vērtības (reģistrjutīgi);<br>**Contains** - iekļaut norādītos tagu nosaukumus, kuru tagu vērtības satur ievadīto virkni (apakšvirknes atbilstība, nereģistrjutīgi);<br>**Does not exist** - izslēgt norādītos tagu nosaukumus;<br>**Does not equal** - izslēgt norādītos tagu nosaukumus un vērtības (reģistrjutīgi);<br>**Does not contain** - izslēgt norādītos tagu nosaukumus, kuru tagu vērtības satur ievadīto virkni (apakšvirknes atbilstība, nereģistrjutīgi).<br><br>Nosacījumiem ir pieejami divi aprēķina tipi:<br>**And/Or** - jāizpildās visiem nosacījumiem, nosacījumi ar vienādu taga nosaukumu tiks grupēti pēc Or nosacījuma;<br>**Or** - pietiek, ja izpildās viens nosacījums.| |*State*|Filtrējiet, kurus vienumus rādīt, pamatojoties uz to stāvokli (all, normal, not supported).| |*Show problems*|Filtrējiet, kuras problēmas rādīt kopā ar vienumiem, pamatojoties uz to statusu (all, unsuppressed, none).| |*Group by*|Pievienojiet grupēšanas atribūtu, pēc kura grupēt vienumus:<br>**Host group** - grupējiet vienumus pēc to hostu hostu grupām;<br>**Host name** - grupējiet vienumus pēc to hostiem;<br>**Host tag value** - ievadiet taga nosaukumu, lai grupētu vienumus pēc šī hosta taga vērtībām (piemēram, ievadiet "city", lai grupētu pēc vērtībām "Riga", "Tokyo" u. c.);<br>**Item tag value** - ievadiet taga nosaukumu, lai grupētu vienumus pēc šī vienuma taga vērtībām (piemēram, ievadiet "component", lai grupētu pēc vērtībām "cpu", "memory" u. c.).<br><br>Grupēšanas atribūtus var pārkārtot, velkot tos uz augšu vai uz leju aiz roktura pirms grupas nosaukuma. Ņemiet vērā, ka grupēšanas atribūtu secība nosaka grupu ligzdošanas secību. Piemēram, norādot vairākus hostu tagu nosaukumus (1: color, 2: city), vienumi tiks grupēti pēc color (red, blue u. c.) un pēc tam pēc city (Riga, Tokyo u. c.).<br><br>Vienums var tikt parādīts vairākās grupās atkarībā no konfigurētajiem grupēšanas atribūtiem (piemēram, grupējot pēc hostu grupas un ja vienuma hosts pieder vairākām hostu grupām). Noklikšķinot uz šādiem vienumiem, tie tiek atlasīti un izcelti visās grupās.<br>Vienumi, kas neatbilst konfigurētajiem grupēšanas atribūtiem, tiek parādīti grupā *Uncategorized*.<br><br>Ja *Show problems* ir konfigurēts problēmu attēlošanai, tās tiek parādītas šādi:<br>- katrai grupai tiek parādīts visu pakārtoto vienumu problēmu skaits;<br>- katram vienumam tiek parādīts tikai tā problēmu skaits.<br><br>Var norādīt līdz 10 grupēšanas atribūtiem, un visiem tiem jābūt unikāliem.<br>Ja grupēšanas atribūti nav norādīti, vienumi netiks grupēti.| |*Item limit*|Ievadiet maksimālo parādāmo vienumu skaitu. Iespējamās vērtības ir no 1 līdz 9999.<br><br>Ja parādīšanai ir pieejams vairāk vienumu nekā iestatītais limits, zem parādītajiem vienumiem tiek parādīts atbilstošs ziņojums (piemēram, "Tiek parādīti 100 no 100+ vienumiem").<br>Ņemiet vērā, ka konfigurētais vienumu limits ietekmē arī konfigurēto grupu attēlošanu; piemēram, ja vienumu limits ir iestatīts uz 100 un vienumi ir grupēti pēc to hostiem (katram ir 200 vienumi), logrīkā tiks parādīts tikai pirmais hosts ar tā 100 vienumiem.<br><br>Šo parametru neietekmē parametrs *Limit for search and filter results* sadaļā *Administration* > *General* > [*GUI*](/manual/web_interface/frontend_sections/administration/general#gui).| #### Configuration To configure, select *Item value* as the widget type: {width="600"} In addition to the parameters that are [common](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters) for all widgets, you may set the following specific options: | | | |--|--------| |*Item*|Select the item.<br>Alternatively, select a compatible widget as the [data source](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) for the item.| |*Show*|Mark the checkbox to display the respective element (description, value, time, change indicator). Unmark to hide. At least one element must be selected.| |*Override host*|Select a compatible widget or the dashboard as the [data source](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) for hosts.<br>This parameter is not available when configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards).| |*Advanced configuration*|Click the *Advanced configuration* header to display [advanced configuration](#advanced-configuration) options.| #### Konfigurācija Lai konfigurētu, kā logrīka tipu atlasiet *Item value*: {width="600"} Papildus parametriem, kas ir [kopīgi](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters) visiem logrīkiem, varat iestatīt šādas specifiskās opcijas: | | | |--|--------| |*Item*|Atlasiet vienumu.<br>Vai arī atlasiet saderīgu logrīku kā [datu avotu](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) vienumam.| |*Show*|Atzīmējiet izvēles rūtiņu, lai parādītu attiecīgo elementu (aprakstu, vērtību, laiku, izmaiņu indikatoru). Noņemiet atzīmi, lai paslēptu. Jābūt atlasītam vismaz vienam elementam.| |*Override host*|Atlasiet saderīgu logrīku vai paneli kā [datu avotu](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) hosts.<br>Šis parametrs nav pieejams, konfigurējot logrīku [veidnes panelī](/manual/config/templates/template#adding-dashboards).| |*Advanced configuration*|Noklikšķiniet uz *Advanced configuration* virsraksta, lai parādītu [papildu konfigurācijas](#advanced-configuration) opcijas.| #### Configuration To configure, select *Map* as type: {width="600"} In addition to the parameters that are [common](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters) for all widgets, you may set the following specific options: | | | |--|--------| |*Map*|Set a map to display.<br>Alternatively, select a compatible widget as the [data source](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) for the map to display.<br>This field is auto-complete, so starting to type the name of the map or widget will offer a dropdown of matching maps or widgets.| #### Konfigurācija Lai konfigurētu, atlasiet *Map* kā tipu: {width="600"} Papildus parametriem, kas ir [kopīgi](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters) visiem logrīkiem, varat iestatīt šādas specifiskas opcijas: | | | |--|--------| |*Map*|Iestatiet karti attēlošanai.<br>Alternatīvi atlasiet saderīgu logrīku kā kartes [datu avotu](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters).<br>Šis lauks atbalsta automātisko pabeigšanu, tāpēc, sākot rakstīt kartes vai logrīka nosaukumu, tiks piedāvāts atbilstošu karšu vai logrīku nolaižamais saraksts.| #### Configuration To configure, select *Map navigation tree* as type:  In addition to the parameters that are [common](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters) for all widgets, you may set the following specific options: | | | |--|--------| |*Show unavailable maps*|Mark this checkbox to display maps that the user does not have read permission to.<br>Unavailable maps in the navigation tree will be displayed with a grayed-out icon.<br>Note that if this checkbox is marked, available [submaps](/manual/config/visualization/maps/map#adding-elements) are displayed even if the parent level map is unavailable. If unmarked, available submaps to an unavailable parent map will not be displayed at all.<br>Problem count is calculated based on available maps and available map elements.| #### Konfigurācija Lai konfigurētu, atlasiet *Kartes navigācijas koks* kā tipu:  Papildus parametriem, kas ir [kopīgi](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters) visiem logrīkiem, varat iestatīt šādas specifiskas opcijas: | | | |--|--------| |*Rādīt nepieejamās kartes*|Atzīmējiet šo izvēles rūtiņu, lai parādītu kartes, kurām lietotājam nav lasīšanas atļaujas.<br>Nepieejamās kartes navigācijas kokā tiks attēlotas ar pelēkotu ikonu.<br>Ņemiet vērā, ka, ja šī izvēles rūtiņa ir atzīmēta, pieejamās [apakškartes](/manual/config/visualization/maps/map#adding-elements) tiek parādītas pat tad, ja vecākā līmeņa karte nav pieejama. Ja tā nav atzīmēta, pieejamās apakškartes nepieejamai vecākajai kartei vispār netiks parādītas.<br>Problēmu skaits tiek aprēķināts, pamatojoties uz pieejamajām kartēm un pieejamajiem karšu elementiem.| #### Configuration To configure, select *Pie chart* as type: {width="600"} #### Konfigurācija Lai konfigurētu, atlasiet *Pie chart* kā tipu: {width="600"} #### Configuration To configure, select *Problem hosts* as type: {width="600"} In addition to the parameters that are [common](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters) for all widgets, you may set the following specific options: | | | |--|--------| |*Host groups*|Select host groups to display in the widget.<br>Alternatively, select a compatible widget as the [data source](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) for host groups.<br>This field is auto-complete, so starting to type the name of a group will offer a dropdown of matching groups.<br>Specifying a parent host group implicitly selects all nested host groups.<br>Host data from these host groups will be displayed in the widget; if no host groups are entered, all host groups will be displayed.<br>This parameter is not available when configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards).| |*Exclude host groups*|Select host groups to hide from the widget.<br>This field is auto-complete, so starting to type the name of a group will offer a dropdown of matching groups.<br>Specifying a parent host group implicitly selects all nested host groups.<br>Host data from these host groups will not be displayed in the widget. For example, hosts 001, 002, 003 may be in Group A and hosts 002, 003 in Group B as well. If we select to *show* Group A and *exclude* Group B at the same time, only data from host 001 will be displayed in the dashboard.<br>This parameter is not available when configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards).| |*Hosts*|Select hosts to display in the widget.<br>Alternatively, select a compatible widget or the dashboard as the [data source](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) for hosts.<br>This field is auto-complete, so starting to type the name of a host will offer a dropdown of matching hosts.<br>If no hosts are entered, all hosts will be displayed.<br>This parameter is not available when configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards).| |*Problem*|You can limit the number of problem hosts displayed by the problem name.<br>If you enter a string here, only those hosts with problems whose name contains the entered string will be displayed.<br>Macros are not expanded.| |*Severity*|Mark problem severities to filter problems to be displayed in the widget.<br>If no severities are marked, all problems will be displayed.| |*Problem tags*|Specify problem tags to limit the number of problems displayed in the widget.<br>It is possible to include as well as exclude specific tags and tag values. Several conditions can be set. Tag name matching is always case-sensitive.<br><br>There are several operators available for each condition:<br>**Exists** - include the specified tag names;<br>**Equals** - include the specified tag names and values (case-sensitive);<br>**Contains** - include the specified tag names where the tag values contain the entered string (substring match, case-insensitive);<br>**Does not exist** - exclude the specified tag names;<br>**Does not equal** - exclude the specified tag names and values (case-sensitive);<br>**Does not contain** - exclude the specified tag names where the tag values contain the entered string (substring match, case-insensitive).<br><br>There are two calculation types for conditions:<br>**And/Or** - all conditions must be met, conditions having the same tag name will be grouped by the *Or* condition;<br>**Or** - enough if one condition is met.| |*Show suppressed problems*|Mark the checkbox to display problems that would otherwise be suppressed (not shown) because of host maintenance.| |*Hide groups without problems*|Mark the *Hide groups without problems* option to hide data from host groups without problems in the widget.<br>This parameter is not available when configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards).| |*Problem display*|Display problem count as:<br>**All** - full problem count will be displayed;<br>**Separated** - unacknowledged problem count will be displayed separated as a number of the total problem count;<br>**Unacknowledged only** - only the unacknowledged problem count will be displayed.| #### Konfigurācija Lai konfigurētu, kā tipu atlasiet *Problem hosts*: {width="600"} Papildus parametriem, kas ir [kopīgi](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters) visiem logrīkiem, varat iestatīt šādas specifiskas opcijas: | | | |--|--------| |*Hostu grupas*|Atlasiet hostu grupas, ko attēlot logrīkā.<br>Alternatīvi atlasiet saderīgu logrīku kā hostu grupu [datu avotu](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters).<br>Šis lauks atbalsta automātisko pabeigšanu, tāpēc, sākot rakstīt grupas nosaukumu, tiks piedāvāts atbilstošo grupu nolaižamais saraksts.<br>Norādot vecākgrupas hostu grupu, tiek netieši atlasītas arī visas tajā ietvertās apakšgrupas.<br>Logrīkā tiks attēloti hostu dati no šīm hostu grupām; ja netiek ievadīta neviena hostu grupa, tiks attēlotas visas hostu grupas.<br>Šis parametrs nav pieejams, konfigurējot logrīku [veidnes panelī](/manual/config/templates/template#adding-dashboards).| |*Izslēgt hostu grupas*|Atlasiet hostu grupas, kuras paslēpt logrīkā.<br>Šis lauks atbalsta automātisko pabeigšanu, tāpēc, sākot rakstīt grupas nosaukumu, tiks piedāvāts atbilstošo grupu nolaižamais saraksts.<br>Norādot vecākgrupas hostu grupu, tiek netieši atlasītas arī visas tajā ietvertās apakšgrupas.<br>Hostu dati no šīm hostu grupām logrīkā netiks attēloti. Piemēram, hosti 001, 002, 003 var būt Grupā A, bet hosti 002, 003 arī Grupā B. Ja vienlaikus atlasām *rādīt* Grupu A un *izslēgt* Grupu B, panelī tiks attēloti tikai hosta 001 dati.<br>Šis parametrs nav pieejams, konfigurējot logrīku [veidnes panelī](/manual/config/templates/template#adding-dashboards).| |*Hosti*|Atlasiet hostus, ko attēlot logrīkā.<br>Alternatīvi atlasiet saderīgu logrīku vai paneli kā hostu [datu avotu](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters).<br>Šis lauks atbalsta automātisko pabeigšanu, tāpēc, sākot rakstīt hosta nosaukumu, tiks piedāvāts atbilstošo hostu nolaižamais saraksts.<br>Ja netiek ievadīts neviens hosts, tiks attēloti visi hosti.<br>Šis parametrs nav pieejams, konfigurējot logrīku [veidnes panelī](/manual/config/templates/template#adding-dashboards).| |*Problēma*|Varat ierobežot attēloto problemātisko hostu skaitu pēc problēmas nosaukuma.<br>Ja šeit ievadīsiet virkni, tiks attēloti tikai tie hosti, kuru problēmu nosaukums satur ievadīto virkni.<br>Makrosi netiek izvērsti.| |*Svarīgums*|Atzīmējiet problēmu svarīguma līmeņus, lai filtrētu logrīkā attēlojamās problēmas.<br>Ja nav atzīmēts neviens svarīguma līmenis, tiks attēlotas visas problēmas.| |*Problēmu birkas*|Norādiet problēmu birkas, lai ierobežotu logrīkā attēloto problēmu skaitu.<br>Ir iespējams gan iekļaut, gan izslēgt noteiktas birkas un birku vērtības. Var iestatīt vairākus nosacījumus. Birku nosaukumu atbilstība vienmēr ir reģistrjutīga.<br><br>Katrai nosacījuma rindai ir pieejami vairāki operatori:<br>**Eksistē** — iekļaut norādītos birku nosaukumus;<br>**Vienāds ar** — iekļaut norādītos birku nosaukumus un vērtības (reģistrjutīgi);<br>**Satur** — iekļaut norādītos birku nosaukumus, kuru birku vērtības satur ievadīto virkni (apakšvirknes atbilstība, nereģistrjutīga);<br>**Neeksistē** — izslēgt norādītos birku nosaukumus;<br>**Nav vienāds ar** — izslēgt norādītos birku nosaukumus un vērtības (reģistrjutīgi);<br>**Nesatur** — izslēgt norādītos birku nosaukumus, kuru birku vērtības satur ievadīto virkni (apakšvirknes atbilstība, nereģistrjutīga).<br><br>Nosacījumiem ir divi aprēķina veidi:<br>**And/Or** — visiem nosacījumiem jābūt izpildītiem, bet nosacījumi ar vienādu birkas nosaukumu tiks grupēti pēc *Or* nosacījuma;<br>**Or** — pietiek, ja ir izpildīts viens nosacījums.| |*Rādīt apspiestās problēmas*|Atzīmējiet izvēles rūtiņu, lai attēlotu problēmas, kas citādi tiktu apspiestas (netiktu rādītas) hosta uzturēšanas dēļ.| |*Paslēpt grupas bez problēmām*|Atzīmējiet opciju *Paslēpt grupas bez problēmām*, lai logrīkā paslēptu datus no hostu grupām bez problēmām.<br>Šis parametrs nav pieejams, konfigurējot logrīku [veidnes panelī](/manual/config/templates/template#adding-dashboards).| |*Problēmu attēlošana*|Attēlot problēmu skaitu šādi:<br>**Visas** — tiks attēlots pilns problēmu skaits;<br>**Atdalīti** — neapstiprināto problēmu skaits tiks attēlots atsevišķi kā skaitlis no kopējā problēmu skaita;<br>**Tikai neapstiprinātās** — tiks attēlots tikai neapstiprināto problēmu skaits.| #### Configuration To configure, select *Problems* as type: {width="600"} You can limit how many problems are displayed in the widget in various ways - by problem status, problem name, severity, host group, host, event tag, acknowledgment status, etc. In addition to the parameters that are [common](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters) for all widgets, you may set the following specific options: | | | |--|--------| |*Show*|Filter by problem status:<br>**Recent problems** - unresolved and recently resolved problems are displayed (default);<br>**Problems** - unresolved problems are displayed;<br>**History** - history of all events is displayed.| |*Host groups*|Select host groups to display problems of in the widget.<br>Alternatively, select a compatible widget as the [data source](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) for host groups.<br>This field is auto-complete, so starting to type the name of a group will offer a dropdown of matching groups.<br>Specifying a parent host group implicitly selects all nested host groups.<br>Problems from these host groups will be displayed in the widget; if no host groups are entered, problems from all host groups will be displayed.<br>This parameter is not available when configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards).| |*Exclude host groups*|Select host groups to hide problems of from the widget.<br>This field is auto-complete, so starting to type the name of a group will offer a dropdown of matching groups.<br>Specifying a parent host group implicitly selects all nested host groups.<br>Problems from these host groups will not be displayed in the widget. For example, hosts 001, 002, 003 may be in Group A and hosts 002, 003 in Group B as well. If we select to *show* Group A and *exclude* Group B at the same time, only problems from host 001 will be displayed in the widget.<br>This parameter is not available when configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards).| |*Hosts*|Select hosts to display problems of in the widget.<br>Alternatively, select a compatible widget or the dashboard as the [data source](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) for hosts.<br>This field is auto-complete, so starting to type the name of a host will offer a dropdown of matching hosts.<br>If no hosts are entered, problems of all hosts will be displayed.<br>This parameter is not available when configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards).| |*Problem*|You can limit the number of problems displayed by their name.<br>If you enter a string here, only those problems whose name contains the entered string will be displayed.<br>Macros are not expanded.| |*Severity*|Mark problem severities to filter problems to be displayed in the widget.<br>If no severities are marked, all problems will be displayed.| |*Problem tags*|Specify problem tags to limit the number of problems displayed in the widget.<br>It is possible to include as well as exclude specific tags and tag values. Several conditions can be set. Tag name matching is always case-sensitive.<br><br>There are several operators available for each condition:<br>**Exists** - include the specified tag names;<br>**Equals** - include the specified tag names and values (case-sensitive);<br>**Contains** - include the specified tag names where the tag values contain the entered string (substring match, case-insensitive);<br>**Does not exist** - exclude the specified tag names;<br>**Does not equal** - exclude the specified tag names and values (case-sensitive);<br>**Does not contain** - exclude the specified tag names where the tag values contain the entered string (substring match, case-insensitive).<br><br>There are two calculation types for conditions:<br>**And/Or** - all conditions must be met, conditions having the same tag name will be grouped by the *Or* condition;<br>**Or** - enough if one condition is met.<br><br>When filtered, the tags specified here will be displayed first with the problem, unless overridden by the *Tag display priority* (see below) list.| |*Show tags*|Select the number of displayed tags:<br>**None** - no *Tags* column;<br>**1** - *Tags* column contains one tag;<br>**2** - *Tags* column contains two tags;<br>**3** - *Tags* column contains three tags.<br>To see all tags for the problem roll your mouse over the three dots icon.| |*Tag name*|Select tag name display mode:<br>**Full** - tag names and values are displayed in full;<br>**Shortened** - tag names are shortened to 3 symbols, but tag values are displayed in full;<br>**None** - only tag values are displayed; no names.| |*Tag display priority*|Enter tag display priority for a problem, as a comma-separated list of tags.<br>Only tag names should be used, no values.<br>Example: `Services,Applications,Application`<br>The tags of this list will always be displayed first, overriding the natural ordering by alphabet.| |*Show operational data*|Select the mode for displaying operational data:<br>**None** - no operational data is displayed;<br>**Separately** - operational data is displayed in a separate column;<br>**With problem name** - append operational data to the problem name, using parentheses for the operational data.<br>For details, see the description of the *Operational data* field in [trigger configuration](/manual/config/triggers/trigger#configuration).| |*Show symptoms*|Mark the checkbox to display in its own line problems classified as symptoms.| |*Show suppressed problems*|Mark the checkbox to display problems that would otherwise be suppressed (not shown) because of host maintenance or single [problem suppression](/manual/acknowledgment/suppression).| |*Acknowledgement status*|Filter to display all problems, unacknowledged problems only, or acknowledged problems only. Mark the additional checkbox to filter out those problems ever acknowledged by you.| |*Sort entries by*|Sort entries by:<br>**Time** (descending or ascending);<br>**Severity** (descending or ascending);<br>**Problem name** (descending or ascending);<br>**Host** (descending or ascending).<br><br>Sorting entries by **Host** (descending or ascending) is not available when configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards).| |*Show timeline*|Mark the checkbox to display a visual timeline.| |*Highlight whole row*|Mark the checkbox to highlight the full line for unresolved problems. The problem severity color is used for highlighting.<br>*Highlight whole row* is not available in the high-contrast themes.<br>This option is supported since Zabbix 7.0.19.| |*Show lines*|Specify the number of problem lines to display.| #### Konfigurācija Lai konfigurētu, kā tipu atlasiet *Problems*: {width="600"} Varat dažādos veidos ierobežot, cik daudz problēmu tiek rādīts logrīkā - pēc problēmas statusa, problēmas nosaukuma, smaguma pakāpes, hostu grupas, hosta, notikuma taga, apstiprinājuma statusa utt. Papildus parametriem, kas ir [kopīgi](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters) visiem logrīkiem, varat iestatīt šādas specifiskās opcijas: | | | |--|--------| |*Show*|Filtrēt pēc problēmas statusa:<br>**Recent problems** - tiek rādītas neatrisinātas un nesen atrisinātas problēmas (noklusējums);<br>**Problems** - tiek rādītas neatrisinātas problēmas;<br>**History** - tiek rādīta visu notikumu vēsture.| |*Host groups*|Atlasiet hostu grupas, kuru problēmas rādīt logrīkā.<br>Alternatīvi atlasiet saderīgu logrīku kā [datu avotu](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) hostu grupām.<br>Šis lauks atbalsta automātisko pabeigšanu, tāpēc, sākot rakstīt grupas nosaukumu, tiks piedāvāts nolaižamais saraksts ar atbilstošajām grupām.<br>Norādot vecāko hostu grupu, netieši tiek atlasītas arī visas ligzdotās hostu grupas.<br>Šo hostu grupu problēmas tiks rādītas logrīkā; ja hostu grupas nav norādītas, tiks rādītas visu hostu grupu problēmas.<br>Šis parametrs nav pieejams, konfigurējot logrīku [veidnes informācijas panelī](/manual/config/templates/template#adding-dashboards).| |*Exclude host groups*|Atlasiet hostu grupas, kuru problēmas slēpt logrīkā.<br>Šis lauks atbalsta automātisko pabeigšanu, tāpēc, sākot rakstīt grupas nosaukumu, tiks piedāvāts nolaižamais saraksts ar atbilstošajām grupām.<br>Norādot vecāko hostu grupu, netieši tiek atlasītas arī visas ligzdotās hostu grupas.<br>Šo hostu grupu problēmas netiks rādītas logrīkā. Piemēram, hosts 001, 002, 003 var būt Group A, bet hosts 002, 003 arī Group B. Ja vienlaikus izvēlamies *show* Group A un *exclude* Group B, logrīkā tiks rādītas tikai hosta 001 problēmas.<br>Šis parametrs nav pieejams, konfigurējot logrīku [veidnes informācijas panelī](/manual/config/templates/template#adding-dashboards).| |*Hosts*|Atlasiet hostus, kuru problēmas rādīt logrīkā.<br>Alternatīvi atlasiet saderīgu logrīku vai informācijas paneli kā [datu avotu](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) hostiem.<br>Šis lauks atbalsta automātisko pabeigšanu, tāpēc, sākot rakstīt hosta nosaukumu, tiks piedāvāts nolaižamais saraksts ar atbilstošajiem hostiem.<br>Ja hosti nav norādīti, tiks rādītas visu hostu problēmas.<br>Šis parametrs nav pieejams, konfigurējot logrīku [veidnes informācijas panelī](/manual/config/templates/template#adding-dashboards).| |*Problem*|Varat ierobežot rādīto problēmu skaitu pēc to nosaukuma.<br>Ja šeit ievadāt virkni, tiks rādītas tikai tās problēmas, kuru nosaukumā ir ietverta ievadītā virkne.<br>Makro netiek izvērsti.| |*Severity*|Atzīmējiet problēmu smaguma pakāpes, lai filtrētu logrīkā rādāmās problēmas.<br>Ja neviena smaguma pakāpe nav atzīmēta, tiks rādītas visas problēmas.| |*Problem tags*|Norādiet problēmu tagus, lai ierobežotu logrīkā rādīto problēmu skaitu.<br>Ir iespējams iekļaut, kā arī izslēgt konkrētus tagus un tagu vērtības. Var iestatīt vairākus nosacījumus. Tagu nosaukumu salīdzināšana vienmēr ir reģistrjutīga.<br><br>Katrai nosacījuma rindai ir pieejami vairāki operatori:<br>**Exists** - iekļaut norādītos tagu nosaukumus;<br>**Equals** - iekļaut norādītos tagu nosaukumus un vērtības (reģistrjutīgi);<br>**Contains** - iekļaut norādītos tagu nosaukumus, kuru tagu vērtības satur ievadīto virkni (apakšvirknes atbilstība, nav reģistrjutīga);<br>**Does not exist** - izslēgt norādītos tagu nosaukumus;<br>**Does not equal** - izslēgt norādītos tagu nosaukumus un vērtības (reģistrjutīgi);<br>**Does not contain** - izslēgt norādītos tagu nosaukumus, kuru tagu vērtības satur ievadīto virkni (apakšvirknes atbilstība, nav reģistrjutīga).<br><br>Nosacījumiem ir divi aprēķina tipi:<br>**And/Or** - jāizpildās visiem nosacījumiem, nosacījumi ar vienādu taga nosaukumu tiks grupēti ar *Or* nosacījumu;<br>**Or** - pietiek, ja izpildās viens nosacījums.<br><br>Filtrēšanas gadījumā šeit norādītie tagi tiks rādīti vispirms kopā ar problēmu, ja vien to nepārraksta tālāk norādītais *Tag display priority* saraksts.| |*Show tags*|Atlasiet rādāmo tagu skaitu:<br>**None** - nav kolonnas *Tags*;<br>**1** - kolonna *Tags* satur vienu tagu;<br>**2** - kolonna *Tags* satur divus tagus;<br>**3** - kolonna *Tags* satur trīs tagus.<br>Lai redzētu visus problēmas tagus, novietojiet peli virs trīs punktu ikonas.| |*Tag name*|Atlasiet taga nosaukuma attēlošanas režīmu:<br>**Full** - tagu nosaukumi un vērtības tiek rādītas pilnībā;<br>**Shortened** - tagu nosaukumi tiek saīsināti līdz 3 simboliem, bet tagu vērtības tiek rādītas pilnībā;<br>**None** - tiek rādītas tikai tagu vērtības; nosaukumi netiek rādīti.| |*Tag display priority*|Ievadiet problēmas tagu attēlošanas prioritāti kā ar komatiem atdalītu tagu sarakstu.<br>Jāizmanto tikai tagu nosaukumi, nevis vērtības.<br>Piemērs: `Services,Applications,Application`<br>Šī saraksta tagi vienmēr tiks rādīti vispirms, pārrakstot dabisko alfabētisko kārtojumu.| |*Show operational data*|Atlasiet operatīvo datu attēlošanas režīmu:<br>**None** - operatīvie dati netiek rādīti;<br>**Separately** - operatīvie dati tiek rādīti atsevišķā kolonnā;<br>**With problem name** - operatīvie dati tiek pievienoti problēmas nosaukumam, izmantojot iekavas operatīvajiem datiem.<br>Sīkāku informāciju skatiet lauka *Operational data* aprakstā [trigeru konfigurācijā](/manual/config/triggers/trigger#configuration).| |*Show symptoms*|Atzīmējiet izvēles rūtiņu, lai savā rindā rādītu problēmas, kas klasificētas kā simptomi.| |*Show suppressed problems*|Atzīmējiet izvēles rūtiņu, lai rādītu problēmas, kas citādi tiktu slāpētas (nerādītas) hosta apkopes vai atsevišķas [problēmu slāpēšanas](/manual/acknowledgment/suppression) dēļ.| |*Acknowledgement status*|Filtrējiet, lai rādītu visas problēmas, tikai neapstiprinātās problēmas vai tikai apstiprinātās problēmas. Atzīmējiet papildu izvēles rūtiņu, lai izfiltrētu tās problēmas, kuras jebkad esat apstiprinājis jūs.| |*Sort entries by*|Kārtot ierakstus pēc:<br>**Time** (dilstoši vai augoši);<br>**Severity** (dilstoši vai augoši);<br>**Problem name** (dilstoši vai augoši);<br>**Host** (dilstoši vai augoši).<br><br>Ierakstu kārtošana pēc **Host** (dilstoši vai augoši) nav pieejama, konfigurējot logrīku [veidnes informācijas panelī](/manual/config/templates/template#adding-dashboards).| |*Show timeline*|Atzīmējiet izvēles rūtiņu, lai rādītu vizuālu laika skalu.| |*Highlight whole row*|Atzīmējiet izvēles rūtiņu, lai izceltu visu rindu neatrisinātām problēmām. Izcelšanai tiek izmantota problēmas smaguma pakāpes krāsa.<br>*Highlight whole row* nav pieejams augsta kontrasta tēmās.<br>Šī opcija ir atbalstīta kopš Zabbix 7.0.19.| |*Show lines*|Norādiet rādāmo problēmu rindu skaitu.| #### Configuration To configure, select *Problems by severity* as type: {width="600"} In addition to the parameters that are [common](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters) for all widgets, you may set the following specific options: | | | |--|--------| |*Host groups*|Select host groups to display in the widget.<br>Alternatively, select a compatible widget as the [data source](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) for host groups.<br>This field is auto-complete, so starting to type the name of a group will offer a dropdown of matching groups.<br>Specifying a parent host group implicitly selects all nested host groups.<br>Host data from these host groups will be displayed in the widget; if no host groups are entered, all host groups will be displayed.<br>This parameter is not available when configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards).| |*Exclude host groups*|Select host groups to hide from the widget.<br>This field is auto-complete, so starting to type the name of a group will offer a dropdown of matching groups.<br>Specifying a parent host group implicitly selects all nested host groups.<br>Host data from these host groups will not be displayed in the widget. For example, hosts 001, 002, 003 may be in Group A and hosts 002, 003 in Group B as well. If we select to *show* Group A and *exclude* Group B at the same time, only data from host 001 will be displayed in the dashboard.<br>This parameter is not available when configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards).| |*Hosts*|Select hosts to display in the widget.<br>Alternatively, select a compatible widget or the dashboard as the [data source](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) for hosts.<br>This field is auto-complete, so starting to type the name of a host will offer a dropdown of matching hosts.<br>If no hosts are entered, all hosts will be displayed.<br>This parameter is not available when configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards).| |*Problem*|You can limit the number of problem hosts displayed by the problem name.<br>If you enter a string here, only those hosts with problems whose name contains the entered string will be displayed.<br>Macros are not expanded.| |*Severity*|Mark problem severities to filter problems to be displayed in the widget.<br>If no severities are marked, all problems will be displayed.| |*Problem tags*|Specify problem tags to limit the number of problems displayed in the widget.<br>It is possible to include as well as exclude specific tags and tag values. Several conditions can be set. Tag name matching is always case-sensitive.<br><br>There are several operators available for each condition:<br>**Exists** - include the specified tag names;<br>**Equals** - include the specified tag names and values (case-sensitive);<br>**Contains** - include the specified tag names where the tag values contain the entered string (substring match, case-insensitive);<br>**Does not exist** - exclude the specified tag names;<br>**Does not equal** - exclude the specified tag names and values (case-sensitive);<br>**Does not contain** - exclude the specified tag names where the tag values contain the entered string (substring match, case-insensitive).<br><br>There are two calculation types for conditions:<br>**And/Or** - all conditions must be met, conditions having the same tag name will be grouped by the *Or* condition;<br>**Or** - enough if one condition is met.| |*Show*|Select the show option:<br>**Host groups** - display problems per host group;<br>**Totals** - display a problem total for all selected host groups in colored blocks corresponding to the problem severity.<br>This parameter is not available when configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards), and only a problem total will be displayed.| |*Layout*|Select the layout option:<br>**Horizontal** - colored blocks of totals will be displayed horizontally;<br>**Vertical** - colored blocks of totals will be displayed vertically.<br>This parameter is available if *Show* is set to "Totals".| |*Show operational data*|Display operational data as:<br>**None** - operational data will not be displayed<br>**Separately** - operational data will be displayed as a separate line<br>**With problem name** - operational data will be displayed together with the problem name.<br>For details, see the description of the *Operational data* field in [trigger configuration](/manual/config/triggers/trigger#configuration).| |*Show suppressed problems*|Mark the checkbox to display problems that would otherwise be suppressed (not shown) because of host maintenance.| |*Hide groups without problems*|Mark the *Hide groups without problems* option to hide data from host groups without problems in the widget.<br>This parameter is not available when configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards).| |*Problem display*|Display problem count as:<br>**All** - full problem count will be displayed;<br>**Separated** - unacknowledged problem count will be displayed separated as a number of the total problem count;<br>**Unacknowledged only** - only the unacknowledged problem count will be displayed.| |*Show timeline*|Mark the checkbox to display a visual timeline.| #### Konfigurācija Lai konfigurētu, atlasiet *Problems by severity* kā tipu: {width="600"} Papildus parametriem, kas ir [kopīgi](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters) visiem logrīkiem, varat iestatīt šādas specifiskās opcijas: | | | |--|--------| |*Host groups*|Atlasiet hostu grupas, ko rādīt logrīkā.<br>Alternatīvi atlasiet saderīgu logrīku kā [datu avotu](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) hostu grupām.<br>Šis lauks atbalsta automātisko pabeigšanu, tāpēc, sākot rakstīt grupas nosaukumu, tiks piedāvāts nolaižamais saraksts ar atbilstošajām grupām.<br>Norādot vecāko hostu grupu, netieši tiek atlasītas visas ligzdotās hostu grupas.<br>Šo hostu grupu hostu dati tiks rādīti logrīkā; ja hostu grupas netiks ievadītas, tiks rādītas visas hostu grupas.<br>Šis parametrs nav pieejams, konfigurējot logrīku [veidnes informācijas panelī](/manual/config/templates/template#adding-dashboards).| |*Exclude host groups*|Atlasiet hostu grupas, ko paslēpt no logrīka.<br>Šis lauks atbalsta automātisko pabeigšanu, tāpēc, sākot rakstīt grupas nosaukumu, tiks piedāvāts nolaižamais saraksts ar atbilstošajām grupām.<br>Norādot vecāko hostu grupu, netieši tiek atlasītas visas ligzdotās hostu grupas.<br>Šo hostu grupu hostu dati netiks rādīti logrīkā. Piemēram, hosti 001, 002, 003 var būt grupā A, bet hosti 002, 003 - arī grupā B. Ja vienlaikus izvēlamies *rādīt* grupu A un *izslēgt* grupu B, informācijas panelī tiks rādīti tikai hosta 001 dati.<br>Šis parametrs nav pieejams, konfigurējot logrīku [veidnes informācijas panelī](/manual/config/templates/template#adding-dashboards).| |*Hosts*|Atlasiet hostus, ko rādīt logrīkā.<br>Alternatīvi atlasiet saderīgu logrīku vai informācijas paneli kā [datu avotu](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) hostiem.<br>Šis lauks atbalsta automātisko pabeigšanu, tāpēc, sākot rakstīt hosta nosaukumu, tiks piedāvāts nolaižamais saraksts ar atbilstošajiem hostiem.<br>Ja hosti netiek ievadīti, tiks rādīti visi hosti.<br>Šis parametrs nav pieejams, konfigurējot logrīku [veidnes informācijas panelī](/manual/config/templates/template#adding-dashboards).| |*Problem*|Varat ierobežot rādīto problēmu hostu skaitu pēc problēmas nosaukuma.<br>Ja šeit ievadāt virkni, tiks rādīti tikai tie hosti, kuru problēmu nosaukumos ir ietverta ievadītā virkne.<br>Makro netiek izvērsti.| |*Severity*|Atzīmējiet problēmu smaguma pakāpes, lai filtrētu logrīkā rādāmās problēmas.<br>Ja neviena smaguma pakāpe nav atzīmēta, tiks rādītas visas problēmas.| |*Problem tags*|Norādiet problēmu tagus, lai ierobežotu logrīkā rādīto problēmu skaitu.<br>Iespējams gan iekļaut, gan izslēgt konkrētus tagus un tagu vērtības. Var iestatīt vairākus nosacījumus. Tagu nosaukumu atbilstība vienmēr ir reģistrjutīga.<br><br>Katram nosacījumam ir pieejami vairāki operatori:<br>**Exists** - iekļaut norādītos tagu nosaukumus;<br>**Equals** - iekļaut norādītos tagu nosaukumus un vērtības (reģistrjutīgi);<br>**Contains** - iekļaut norādītos tagu nosaukumus, kuru tagu vērtības satur ievadīto virkni (apakšvirknes atbilstība, nav reģistrjutīga);<br>**Does not exist** - izslēgt norādītos tagu nosaukumus;<br>**Does not equal** - izslēgt norādītos tagu nosaukumus un vērtības (reģistrjutīgi);<br>**Does not contain** - izslēgt norādītos tagu nosaukumus, kuru tagu vērtības satur ievadīto virkni (apakšvirknes atbilstība, nav reģistrjutīga).<br><br>Nosacījumiem ir divi aprēķina tipi:<br>**And/Or** - jāizpildās visiem nosacījumiem, nosacījumi ar vienādu taga nosaukumu tiks grupēti pēc *Or* nosacījuma;<br>**Or** - pietiek, ja izpildās viens nosacījums.| |*Show*|Atlasiet rādīšanas opciju:<br>**Host groups** - rādīt problēmas pa hostu grupām;<br>**Totals** - rādīt kopējo problēmu skaitu visām atlasītajām hostu grupām krāsainos blokos, kas atbilst problēmas smaguma pakāpei.<br>Šis parametrs nav pieejams, konfigurējot logrīku [veidnes informācijas panelī](/manual/config/templates/template#adding-dashboards), un tiks rādīts tikai kopējais problēmu skaits.| |*Layout*|Atlasiet izkārtojuma opciju:<br>**Horizontal** - kopējo skaitu krāsainie bloki tiks rādīti horizontāli;<br>**Vertical** - kopējo skaitu krāsainie bloki tiks rādīti vertikāli.<br>Šis parametrs ir pieejams, ja *Show* ir iestatīts uz "Totals".| |*Show operational data*|Rādīt operatīvos datus kā:<br>**None** - operatīvie dati netiks rādīti<br>**Separately** - operatīvie dati tiks rādīti kā atsevišķa rinda<br>**With problem name** - operatīvie dati tiks rādīti kopā ar problēmas nosaukumu.<br>Sīkāku informāciju skatiet lauka *Operational data* aprakstā [trigera konfigurācijā](/manual/config/triggers/trigger#configuration).| |*Show suppressed problems*|Atzīmējiet izvēles rūtiņu, lai rādītu problēmas, kas citādi tiktu slāpētas (nerādītas) hosta apkopes dēļ.| |*Hide groups without problems*|Atzīmējiet opciju *Hide groups without problems*, lai logrīkā paslēptu datus no hostu grupām bez problēmām.<br>Šis parametrs nav pieejams, konfigurējot logrīku [veidnes informācijas panelī](/manual/config/templates/template#adding-dashboards).| |*Problem display*|Rādīt problēmu skaitu kā:<br>**All** - tiks rādīts pilns problēmu skaits;<br>**Separated** - tiks rādīts neapstiprināto problēmu skaits, atsevišķi norādot to kā daļu no kopējā problēmu skaita;<br>**Unacknowledged only** - tiks rādīts tikai neapstiprināto problēmu skaits.| |*Show timeline*|Atzīmējiet izvēles rūtiņu, lai rādītu vizuālu laika skalu.| #### Configuration To configure, select *SLA report* as type:  In addition to the parameters that are [common](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters) for all widgets, you may set the following specific options: | | | |--|--------| |*SLA*|Select the SLA for the report.| |*Service*|Select the service for the report.| |*Show periods*|Set how many periods will be displayed in the widget (20 by default, 100 maximum).| |*From*|Select the beginning date for the report.<br>[Relative dates](/manual/web_interface/time_period_selector) are supported: `now`, `now/d`, `now/w-1w` etc; supported date modifiers: d, w, M, y.| |*To*|Select the end date for the report.<br>[Relative dates](/manual/web_interface/time_period_selector) are supported: `now`, `now/d`, `now/w-1w` etc; supported date modifiers: d, w, M, y.| #### Konfigurācija Lai konfigurētu, atlasiet *SLA report* kā tipu:  Papildus parametriem, kas ir [kopīgi](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters) visiem logrīkiem, varat iestatīt šādas specifiskās opcijas: | | | |--|--------| |*SLA*|Atlasiet SLA pārskatam.| |*Service*|Atlasiet pakalpojumu pārskatam.| |*Show periods*|Iestatiet, cik periodi tiks parādīti logrīkā (pēc noklusējuma 20, maksimums 100).| |*From*|Atlasiet pārskata sākuma datumu.<br>Tiek atbalstīti [relatīvie datumi](/manual/web_interface/time_period_selector): `now`, `now/d`, `now/w-1w` u. c.; atbalstītie datuma modifikatori: d, w, M, y.| |*To*|Atlasiet pārskata beigu datumu.<br>Tiek atbalstīti [relatīvie datumi](/manual/web_interface/time_period_selector): `now`, `now/d`, `now/w-1w` u. c.; atbalstītie datuma modifikatori: d, w, M, y.| #### Configuration To configure, select *System information* as type:  In addition to the parameters that are [common](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters) for all widgets, you may set the following specific options: | | | |--|--------| |*Show*|Select what to display:<br>**System stats** - display a summary of key Zabbix server and system data;<br>**High availability nodes** - display the status of high availability nodes (if [high availability cluster](/manual/concepts/server/ha) is enabled).| |*Show software update check details*|Mark the checkbox to display Zabbix software update check details.<br>This option is only available if software update check is enabled in Zabbix server [configuration](/manual/appendix/config/zabbix_server#allowsoftwareupdatecheck) and "System stats" is selected in the *Show* field.| #### Konfigurācija Lai konfigurētu, kā tipu atlasiet *System information*:  Papildus parametriem, kas ir [kopīgi](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters) visiem logrīkiem, varat iestatīt šādas specifiskās opcijas: | | | |--|--------| |*Show*|Atlasiet, ko rādīt:<br>**System stats** - rādīt Zabbix servera un sistēmas galveno datu kopsavilkumu;<br>**High availability nodes** - rādīt augstas pieejamības mezglu statusu (ja ir iespējots [augstas pieejamības klasteris](/manual/concepts/server/ha)).| |*Show software update check details*|Atzīmējiet izvēles rūtiņu, lai rādītu Zabbix programmatūras atjauninājumu pārbaudes informāciju.<br>Šī opcija ir pieejama tikai tad, ja programmatūras atjauninājumu pārbaude ir iespējota Zabbix servera [konfigurācijā](/manual/appendix/config/zabbix_server#allowsoftwareupdatecheck) un laukā *Show* ir atlasīts "System stats".| #### Configuration To configure, select *Top hosts* as type: {width="600"} #### Konfigurācija Lai konfigurētu, atlasiet *Top hosts* kā tipu: {width="600"} #### Configuration To configure, select *Top triggers* as widget type: {width="600"} In addition to the parameters that are [common](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters) for all widgets, you may set the following specific options: | | | |--|--------| |*Host groups*|Select host groups to display problems of in the widget.<br>This field is auto-complete, so starting to type the name of a group will offer a dropdown of matching groups.<br>Specifying a parent host group implicitly selects all nested host groups.<br>Problems from these host groups will be displayed in the widget; if no host groups are entered, problems from all host groups will be displayed.<br>This parameter is not available when configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards).| |*Hosts*|Select hosts to display problems of in the widget.<br>This field is auto-complete, so starting to type the name of a host will offer a dropdown of matching hosts.<br>If no hosts are entered, problems of all hosts will be displayed.<br>This parameter is not available when configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards).| |*Problem*|You can view the triggers for particular problems only. For this, enter the string to be matched in the problem name.<br>Macros are not expanded.| |*Severity*|Mark trigger severities to filter triggers to be displayed in the widget.<br>If no severities are marked, all triggers will be displayed.| |*Problem tags*|Specify the tags of the problems to be displayed in the widget.<br>It is possible to include as well as exclude specific tags and tag values. Several conditions can be set. Tag name matching is always case-sensitive.<br><br>There are several operators available for each condition:<br>**Exists** - include the specified tag names;<br>**Equals** - include the specified tag names and values (case-sensitive);<br>**Contains** - include the specified tag names where the tag values contain the entered string (substring match, case-insensitive);<br>**Does not exist** - exclude the specified tag names;<br>**Does not equal** - exclude the specified tag names and values (case-sensitive);<br>**Does not contain** - exclude the specified tag names where the tag values contain the entered string (substring match, case-insensitive).<br><br>There are two calculation types for conditions:<br>**And/Or** - all conditions must be met, conditions having the same tag name will be grouped by the *Or* condition;<br>**Or** - enough if one condition is met.| |*Time period*|Select the [data source](/manual/web_interface/frontend_sections/dashboards/widgets#dynamic-parameters) for the time period:<br>**Dashboard** - set the *Time period* selector as the data source;<br>**Widget** - set a compatible widget specified in the *Widget* parameter as the data source;<br>**Custom** - set the time period specified in the *From* and *To* parameters as the data source; if set, a clock icon will be displayed in the top right corner of the widget, indicating the set time on mouseover.| |*Widget*|Enter or select a compatible widget (*Graph*, *Graph (classic)*, *Graph prototype*) as the data source for the time period.<br>This parameter is available if *Time period* is set to "Widget".| |*From*|Enter or select the start of the time period.<br>[Relative time syntax](/manual/web_interface/time_period_selector) (`now`, `now/d`, `now/w-1w`, etc.) is supported.<br>This parameter is available if *Time period* is set to "Custom".| |*To*|Enter or select the end of the time period.<br>[Relative time syntax](/manual/web_interface/time_period_selector) (`now`, `now/d`, `now/w-1w`, etc.) is supported.<br>This parameter is available if *Time period* is set to "Custom".| |*Trigger limit*|Set the number of triggers to be displayed. Possible value range: 1-1000 (1-100 before Zabbix 7.0.6).| #### Konfigurācija Lai konfigurētu, kā logrīka tipu atlasiet *Top triggers*: {width="600"} Papildus parametriem, kas ir [kopīgi](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters) visiem logrīkiem, varat iestatīt šādas specifiskās opcijas: | | | |--|--------| |*Host groups*|Atlasiet hostu grupas, kuru problēmas rādīt logrīkā.<br>Šis lauks atbalsta automātisko pabeigšanu, tāpēc, sākot rakstīt grupas nosaukumu, tiks piedāvāts nolaižamais saraksts ar atbilstošajām grupām.<br>Norādot vecāko hostu grupu, netieši tiek atlasītas arī visas ligzdotās hostu grupas.<br>Šo hostu grupu problēmas tiks rādītas logrīkā; ja hostu grupas nav norādītas, tiks rādītas visu hostu grupu problēmas.<br>Šis parametrs nav pieejams, konfigurējot logrīku [veidnes informācijas panelī](/manual/config/templates/template#adding-dashboards).| |*Hosts*|Atlasiet hosts, kuru problēmas rādīt logrīkā.<br>Šis lauks atbalsta automātisko pabeigšanu, tāpēc, sākot rakstīt hosta nosaukumu, tiks piedāvāts nolaižamais saraksts ar atbilstošajiem hostiem.<br>Ja hosts nav norādīti, tiks rādītas visu hostu problēmas.<br>Šis parametrs nav pieejams, konfigurējot logrīku [veidnes informācijas panelī](/manual/config/templates/template#adding-dashboards).| |*Problem*|Varat skatīt tikai konkrētu problēmu trigerus. Šim nolūkam ievadiet virkni, kurai jāsakrīt ar problēmas nosaukumu.<br>Makro netiek izvērsti.| |*Severity*|Atzīmējiet trigeru smaguma pakāpes, lai filtrētu logrīkā rādāmos trigerus.<br>Ja neviena smaguma pakāpe nav atzīmēta, tiks rādīti visi trigeri.| |*Problem tags*|Norādiet problēmu tagus, kas jāattēlo logrīkā.<br>Var iekļaut, kā arī izslēgt konkrētus tagus un tagu vērtības. Var iestatīt vairākus nosacījumus. Tagu nosaukumu salīdzināšana vienmēr ir reģistrjutīga.<br><br>Katram nosacījumam ir pieejami vairāki operatori:<br>**Exists** - iekļaut norādītos tagu nosaukumus;<br>**Equals** - iekļaut norādītos tagu nosaukumus un vērtības (reģistrjutīgi);<br>**Contains** - iekļaut norādītos tagu nosaukumus, kuru tagu vērtības satur ievadīto virkni (apakšvirknes atbilstība, nav reģistrjutīga);<br>**Does not exist** - izslēgt norādītos tagu nosaukumus;<br>**Does not equal** - izslēgt norādītos tagu nosaukumus un vērtības (reģistrjutīgi);<br>**Does not contain** - izslēgt norādītos tagu nosaukumus, kuru tagu vērtības satur ievadīto virkni (apakšvirknes atbilstība, nav reģistrjutīga).<br><br>Nosacījumiem ir pieejami divi aprēķina veidi:<br>**And/Or** - jāizpildās visiem nosacījumiem, nosacījumi ar vienādu taga nosaukumu tiks grupēti pēc *Or* nosacījuma;<br>**Or** - pietiek, ja izpildās viens nosacījums.| |*Time period*|Atlasiet [datu avotu](/manual/web_interface/frontend_sections/dashboards/widgets#dynamic-parameters) laika periodam:<br>**Dashboard** - iestatiet *Time period* atlasītāju kā datu avotu;<br>**Widget** - iestatiet saderīgu logrīku, kas norādīts parametrā *Widget*, kā datu avotu;<br>**Custom** - iestatiet laika periodu, kas norādīts parametros *From* un *To*, kā datu avotu; ja tas ir iestatīts, logrīka augšējā labajā stūrī tiks parādīta pulksteņa ikona, kas, uzvedot peli, norāda iestatīto laiku.| |*Widget*|Ievadiet vai atlasiet saderīgu logrīku (*Graph*, *Graph (classic)*, *Graph prototype*) kā laika perioda datu avotu.<br>Šis parametrs ir pieejams, ja *Time period* ir iestatīts uz "Widget".| |*From*|Ievadiet vai atlasiet laika perioda sākumu.<br>Tiek atbalstīta [relatīvā laika sintakse](/manual/web_interface/time_period_selector) (`now`, `now/d`, `now/w-1w` u. c.).<br>Šis parametrs ir pieejams, ja *Time period* ir iestatīts uz "Custom".| |*To*|Ievadiet vai atlasiet laika perioda beigas.<br>Tiek atbalstīta [relatīvā laika sintakse](/manual/web_interface/time_period_selector) (`now`, `now/d`, `now/w-1w` u. c.).<br>Šis parametrs ir pieejams, ja *Time period* ir iestatīts uz "Custom".| |*Trigger limit*|Iestatiet rādāmo trigeru skaitu. Iespējamais vērtību diapazons: 1-1000 (1-100 pirms Zabbix 7.0.6).| #### Configuration To configure, select *Trigger overview* as type: {width="600"} In addition to the parameters that are [common](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters) for all widgets, you may set the following specific options: | | | |--|--------| |*Show*|Filter triggers by trigger state:<br>**Recent problems** - *(default)* show triggers that recently have been or still are in a PROBLEM state (resolved and unresolved);<br>**Problems** - show triggers that are in a PROBLEM state (unresolved);<br>**Any** - show all triggers.| |*Host groups*|Select host groups.<br>Alternatively, select a compatible widget as the [data source](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) for host groups.<br>This field is auto-complete, so starting to type the name of a group will offer a dropdown of matching groups.<br>This parameter is not available when configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards).| |*Hosts*|Select hosts.<br>Alternatively, select a compatible widget or the dashboard as the [data source](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) for hosts.<br>This field is auto-complete, so starting to type the name of a host will offer a dropdown of matching hosts.<br>This parameter is not available when configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards).| |*Problem tags*|Specify tags to filter the triggers displayed in the widget.<br>It is possible to include as well as exclude specific tags and tag values. Several conditions can be set. Tag name matching is always case-sensitive.<br><br>**Note:** If the parameter *Show* is set to 'Any', all triggers will be displayed even if tags are specified. However, while recent trigger state changes (displayed as blinking blocks) will update for all triggers, the trigger state details (problem severity color and whether the problem is acknowledged) will only update for triggers that match the specified tags.<br><br>There are several operators available for each condition:<br>**Exists** - include the specified tag names;<br>**Equals** - include the specified tag names and values (case-sensitive);<br>**Contains** - include the specified tag names where the tag values contain the entered string (substring match, case-insensitive);<br>**Does not exist** - exclude the specified tag names;<br>**Does not equal** - exclude the specified tag names and values (case-sensitive);<br>**Does not contain** - exclude the specified tag names where the tag values contain the entered string (substring match, case-insensitive).<br><br>There are two calculation types for conditions:<br>**And/Or** - all conditions must be met, conditions having the same tag name will be grouped by the *Or* condition;<br>**Or** - enough if one condition is met.| |*Show suppressed problems*|Mark the checkbox to display problems that would otherwise be suppressed (not shown) because of host maintenance.| |*Hosts location*|Select host location - left or top.<br>This parameter is labeled *Host location* when configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards).| #### Konfigurācija Lai konfigurētu, kā tipu atlasiet *Trigger overview*: {width="600"} Papildus parametriem, kas ir [kopīgi](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters) visiem logrīkiem, varat iestatīt šādas specifiskās opcijas: | | | |--|--------| |*Show*|Filtrēt trigerus pēc trigeru stāvokļa:<br>**Recent problems** - *(noklusējums)* rādīt trigerus, kas nesen ir bijuši vai joprojām ir PROBLEM stāvoklī (atrisināti un neatrisināti);<br>**Problems** - rādīt trigerus, kas ir PROBLEM stāvoklī (neatrisināti);<br>**Any** - rādīt visus trigerus.| |*Host groups*|Atlasiet hostu grupas.<br>Alternatīvi atlasiet saderīgu logrīku kā [datu avotu](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) hostu grupām.<br>Šis lauks atbalsta automātisko pabeigšanu, tāpēc, sākot rakstīt grupas nosaukumu, tiks piedāvāts atbilstošo grupu nolaižamais saraksts.<br>Šis parametrs nav pieejams, konfigurējot logrīku [veidnes informācijas panelī](/manual/config/templates/template#adding-dashboards).| |*Hosts*|Atlasiet hosts.<br>Alternatīvi atlasiet saderīgu logrīku vai informācijas paneli kā [datu avotu](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) hosts.<br>Šis lauks atbalsta automātisko pabeigšanu, tāpēc, sākot rakstīt hosta nosaukumu, tiks piedāvāts atbilstošo hostu nolaižamais saraksts.<br>Šis parametrs nav pieejams, konfigurējot logrīku [veidnes informācijas panelī](/manual/config/templates/template#adding-dashboards).| |*Problem tags*|Norādiet tagus, lai filtrētu logrīkā attēlotos trigerus.<br>Iespējams iekļaut, kā arī izslēgt konkrētus tagus un tagu vērtības. Var iestatīt vairākus nosacījumus. Tagu nosaukumu atbilstība vienmēr ir reģistrjutīga.<br><br>**Piezīme:** Ja parametrs *Show* ir iestatīts uz 'Any', tiks rādīti visi trigeri pat tad, ja ir norādīti tagi. Tomēr, kamēr nesenās trigeru stāvokļa izmaiņas (attēlotas kā mirgojoši bloki) tiks atjauninātas visiem trigeriem, trigeru stāvokļa detaļas (problēmas smaguma krāsa un tas, vai problēma ir apstiprināta) tiks atjauninātas tikai tiem trigeriem, kas atbilst norādītajiem tagiem.<br><br>Katrai nosacījumam ir pieejami vairāki operatori:<br>**Exists** - iekļaut norādītos tagu nosaukumus;<br>**Equals** - iekļaut norādītos tagu nosaukumus un vērtības (reģistrjutīgi);<br>**Contains** - iekļaut norādītos tagu nosaukumus, kuru tagu vērtības satur ievadīto virkni (apakšvirknes atbilstība, nereģistrjutīgi);<br>**Does not exist** - izslēgt norādītos tagu nosaukumus;<br>**Does not equal** - izslēgt norādītos tagu nosaukumus un vērtības (reģistrjutīgi);<br>**Does not contain** - izslēgt norādītos tagu nosaukumus, kuru tagu vērtības satur ievadīto virkni (apakšvirknes atbilstība, nereģistrjutīgi).<br><br>Nosacījumiem ir divi aprēķina veidi:<br>**And/Or** - jāizpildās visiem nosacījumiem, nosacījumi ar vienādu taga nosaukumu tiks grupēti pēc *Or* nosacījuma;<br>**Or** - pietiek, ja izpildās viens nosacījums.| |*Show suppressed problems*|Atzīmējiet izvēles rūtiņu, lai rādītu problēmas, kas citādi tiktu slāpētas (nerādītas) hosta apkopes dēļ.| |*Hosts location*|Atlasiet hostu atrašanās vietu - pa kreisi vai augšā.<br>Šis parametrs tiek apzīmēts kā *Host location*, konfigurējot logrīku [veidnes informācijas panelī](/manual/config/templates/template#adding-dashboards).| #### Configuration To configure, select *URL* as type:  In addition to the parameters that are [common](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters) for all widgets, you may set the following specific options: | | | |--|--------| |*URL*|Enter the URL to display (up to 2048 characters).<br>External URLs must start with `http://` or `https://`.<br>Internal URLs support relative paths (for example, `zabbix.php?action=report.status`).<br>{HOST.\*} macros are supported.| |*Override host*|Select a compatible widget or the dashboard as the [data source](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) for hosts.<br>This parameter is not available when configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards).| ::: noteimportant Browsers might not load an HTTP page configured in the widget if Zabbix frontend is accessed over HTTPS. ::: #### Konfigurācija Lai konfigurētu, kā tipu atlasiet *URL*:  Papildus parametriem, kas ir [kopīgi](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters) visiem logrīkiem, varat iestatīt šādas specifiskās opcijas: | | | |--|--------| |*URL*|Ievadiet parādāmo URL (līdz 2048 rakstzīmēm).<br>Ārējiem URL jāsākas ar `http://` vai `https://`.<br>Iekšējie URL atbalsta relatīvos ceļus (piemēram, `zabbix.php?action=report.status`).<br>Tiek atbalstītas {HOST.\*} makrokomandas.| |*Override host*|Atlasiet saderīgu logrīku vai informācijas paneli kā [datu avotu](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) hosts.<br>Šis parametrs nav pieejams, konfigurējot logrīku [veidnes informācijas panelī](/manual/config/templates/template#adding-dashboards).| ::: noteimportant Pārlūkprogrammas var neielādēt HTTP lapu, kas konfigurēta logrīkā, ja Zabbix lietotāja saskarne tiek atvērta, izmantojot HTTPS. ::: #### Configuration To configure SMS as the media type: - Go to *Alerts → Media types* - Click on *Create media type* (or click on *SMS* in the list of pre-defined media types). The following parameters are specific for the SMS media type: |Parameter|Description| |--|--------| |*GSM modem*|Set the serial device name of the GSM modem.<br>The path entered here will be validated against the [SMSDevices](/manual/appendix/config/zabbix_server#smsdevices) server parameter (if specified).| See [common media type parameters](/manual/config/notifications/media#common-parameters) for details on how to configure default messages and alert processing options. Note that parallel processing of sending SMS notifications is not possible. #### Konfigurācija Lai konfigurētu SMS kā medija tipu: - Dodieties uz *Alerts → Media types* - Noklikšķiniet uz *Create media type* (vai noklikšķiniet uz *SMS* iepriekš definēto medija tipu sarakstā). Tālāk norādītie parametri ir specifiski SMS medija tipam: |Parameter|Description| |--|--------| |*GSM modem*|Iestatiet GSM modema seriālās ierīces nosaukumu.<br>Šeit ievadītais ceļš tiks validēts pret [SMSDevices](/manual/appendix/config/zabbix_server#smsdevices) serveris parametru (ja tas ir norādīts).| Skatiet [common media type parameters](/manual/config/notifications/media#common-parameters), lai iegūtu informāciju par to, kā konfigurēt noklusējuma ziņojumus un brīdinājumu apstrādes opcijas. Ņemiet vērā, ka SMS paziņojumu sūtīšanas paralēla apstrāde nav iespējama. #### Configuration To create a media type in Zabbix frontend: - Go to: *Alerts* > *Media types* - Click on *Create media type* - Enter parameters of the media type in the form Some parameters are **common** for all delivery methods. {width="600"} |Parameter|Description| |--|--------| |*Name*|Name of the media type.| |*Type*|Select the delivery method for the media type.| |*Description*|Enter a description for the media type.| |*Enabled*|Mark the checkbox to enable the media type.| For method-specific parameters, see [email](/manual/config/notifications/media/email#configuration), [SMS](/manual/config/notifications/media/sms#configuration), [custom alertscript](/manual/config/notifications/media/script#configuration), or [webhook](/manual/config/notifications/media/webhook#configuration) pages. #### Konfigurācija Lai izveidotu multivides tipu Zabbix lietotāja saskarnē: - Dodieties uz: *Alerts* > *Media types* - Noklikšķiniet uz *Create media type* - Formā ievadiet multivides tipa parametrus Daži parametri ir **kopīgi** visām piegādes metodēm. {width="600"} |Parameter|Description| |--|--------| |*Name*|Multivides tipa nosaukums.| |*Type*|Atlasiet multivides tipa piegādes metodi.| |*Description*|Ievadiet multivides tipa aprakstu.| |*Enabled*|Atzīmējiet izvēles rūtiņu, lai iespējotu multivides tipu.| Ar metodi saistītos parametrus skatiet [email](/manual/config/notifications/media/email#configuration), [SMS](/manual/config/notifications/media/sms#configuration), [custom alertscript](/manual/config/notifications/media/script#configuration) vai [webhook](/manual/config/notifications/media/webhook#configuration) lapās. #### Configuration To create an ad-hoc graph, do the following: - Go to *Monitoring* → *Latest data* - Use filter to display items that you want - Mark checkboxes of the items you want to graph - Click on *Display stacked graph* or *Display graph* buttons {width="600"} Your graph is created instantly: {width="600"} Note that to avoid displaying too many lines in the graph, only the average value for each item is displayed (min/max value lines are not displayed). Triggers and trigger information is not displayed in the graph. In the created graph window you have the [*Time period* selector](/manual/web_interface/time_period_selector) available and the possibility to switch from the "normal" line graph to a stacked one (and back). {width="600"} #### Konfigurācija Lai izveidotu ad hoc grafiku, rīkojieties šādi: - Dodieties uz *Monitoring* → *Latest data* - Izmantojiet filtru, lai parādītu vajadzīgos vienumus - Atzīmējiet izvēles rūtiņas tiem vienumiem, kurus vēlaties attēlot grafikā - Noklikšķiniet uz pogām *Display stacked graph* vai *Display graph* {width="600"} Jūsu grafiks tiek izveidots nekavējoties: {width="600"} Ņemiet vērā, ka, lai grafikā netiktu attēlots pārāk daudz līniju, tiek rādīta tikai katra vienuma vidējā vērtība (min/max vērtību līnijas netiek rādītas). Trigeri un trigeru informācija grafikā netiek rādīta. Izveidotā grafika logā ir pieejams [*Time period* atlasītājs](/manual/web_interface/time_period_selector) un iespēja pārslēgties no "parastā" līniju grafika uz sakrauto grafiku un atpakaļ. {width="600"} #### Configuration To create a new role, click on the *Create user role* button at the top right corner. To update an existing role, click on the role name to open the configuration form. {width="600"} Available permissions are displayed. To revoke a certain permission, unmark its checkbox. Available permissions along with the defaults for each pre-configured user role in Zabbix are described below. #### Konfigurācija Lai izveidotu jaunu lomu, noklikšķiniet uz pogas *Create user role* augšējā labajā stūrī. Lai atjauninātu esošu lomu, noklikšķiniet uz lomas nosaukuma, lai atvērtu konfigurācijas formu. {width="600"} Tiek parādītas pieejamās atļaujas. Lai atsauktu noteiktu atļauju, noņemiet atzīmi tās izvēles rūtiņai. Tālāk ir aprakstītas pieejamās atļaujas, kā arī noklusējuma iestatījumi katrai iepriekš konfigurētajai lietotāja lomai Zabbix. ### Configuration To create a new SLA, click on the *Create SLA* button. The **SLA** tab allows to specify general SLA parameters. {width=600} |Parameter|Description| |--|--------| |*Name*|Enter the SLA name. | |*SLO*|Enter the service level objective (SLO) as percentage. | |*Reporting period*|Select the SLI reporting period used for calculating the SLI data in the [SLA report](/manual/web_interface/frontend_sections/services/sla_report):<br>**Daily** - each day, from 00:00:00 to 23:59:59.<br>**Weekly** - each week, from Sunday 00:00:00 to Saturday 23:59:59.<br>**Monthly** - each month, from the first day 00:00:00 to the last day 23:59:59.<br>**Quarterly** - each calendar quarter: Q1 (Jan-Mar), Q2 (Apr-Jun), Q3 (Jul-Sep), Q4 (Oct-Dec).<br>**Annually** - each calendar year, from January 1 00:00:00 to December 31 23:59:59.| |*Time zone*|Select the SLA time zone. | |*Schedule*|Select the SLA schedule - 24x7 or custom. | |*Effective date*|Select the date of starting SLA calculation. | |*Service tags*|Add service tags to identify the services towards which this SLA should be applied. <br> **Name** - service tag name, must be exact match, case-sensitive. <br> **Operation** - select *Equals* if the tag value must match exactly (case-sensitive) or *Contains* if part of the tag value must match (case-insensitive). <br> **Value** - service tag value to search for according to selected operation.<br> The SLA is applied to a service, if at least one service tag matches. | |*Description*|Add a description for the SLA. | |*Enabled*|Mark the checkbox to enable the SLA calculation. | The **Excluded downtimes** tab allows to specify downtimes that are excluded from the SLA calculation. {width=600} Click on *Add* to configure excluded downtimes, then enter the period name, start date and duration. ### Konfigurācija Lai izveidotu jaunu SLA, noklikšķiniet uz pogas *Create SLA*. Cilne **SLA** ļauj norādīt vispārīgos SLA parametrus. {width=600} |Parameter|Description| |--|--------| |*Name*|Ievadiet SLA nosaukumu. | |*SLO*|Ievadiet pakalpojuma līmeņa mērķi (SLO) procentos. | |*Reporting period*|Atlasiet SLI atskaites periodu, ko izmanto SLI datu aprēķināšanai [SLA report](/manual/web_interface/frontend_sections/services/sla_report):<br>**Daily** - katru dienu no 00:00:00 līdz 23:59:59.<br>**Weekly** - katru nedēļu no svētdienas 00:00:00 līdz sestdienas 23:59:59.<br>**Monthly** - katru mēnesi no pirmās dienas 00:00:00 līdz pēdējās dienas 23:59:59.<br>**Quarterly** - katru kalendāro ceturksni: Q1 (Jan-Mar), Q2 (Apr-Jun), Q3 (Jul-Sep), Q4 (Oct-Dec).<br>**Annually** - katru kalendāro gadu no 1. janvāra 00:00:00 līdz 31. decembra 23:59:59.| |*Time zone*|Atlasiet SLA laika joslu. | |*Schedule*|Atlasiet SLA grafiku - 24x7 vai pielāgotu. | |*Effective date*|Atlasiet SLA aprēķina sākuma datumu. | |*Service tags*|Pievienojiet pakalpojumu tagus, lai identificētu pakalpojumus, kuriem šis SLA jāpiemēro. <br> **Name** - pakalpojuma taga nosaukums; tam precīzi jāsakrīt, ievērojot reģistrjutību. <br> **Operation** - atlasiet *Equals*, ja taga vērtībai jāsakrīt precīzi (reģistrjutīgi), vai *Contains*, ja jāsakrīt taga vērtības daļai (nereģistrjutīgi). <br> **Value** - pakalpojuma taga vērtība, ko meklēt atbilstoši atlasītajai darbībai.<br> SLA tiek piemērots pakalpojumam, ja sakrīt vismaz viens pakalpojuma tags. | |*Description*|Pievienojiet SLA aprakstu. | |*Enabled*|Atzīmējiet izvēles rūtiņu, lai iespējotu SLA aprēķinu. | Cilne **Excluded downtimes** ļauj norādīt dīkstāves periodus, kas tiek izslēgti no SLA aprēķina. {width=600} Noklikšķiniet uz *Add*, lai konfigurētu izslēgtās dīkstāves, pēc tam ievadiet perioda nosaukumu, sākuma datumu un ilgumu. ### Configuration To define a dependency: 1. Open the *Dependencies* tab in the trigger [configuration form](/manual/config/triggers/trigger#configuration). 2. Click *Add* in the *Dependencies* section and select one or more triggers that the trigger will depend on. {width="600"} 3. Click *Update*. Now the trigger has the indication of its dependency in the list.  ### Konfigurācija Lai definētu atkarību: 1. Atveriet cilni *Dependencies* trigeru [konfigurācijas formā](/manual/config/triggers/trigger#configuration). 2. Noklikšķiniet *Add* sadaļā *Dependencies* un atlasiet vienu vai vairākus trigerus, no kuriem šis trigeris būs atkarīgs. {width="600"} 3. Noklikšķiniet *Update*. Tagad trigeru sarakstā ir redzama tā atkarība.  #### Configuration To define user macros, go to the corresponding location in the frontend: - for global macros, visit *Administration → Macros* - for host and template level macros, open host or template properties and look for the *Macros* tab A user macro has the following attributes: {width="600"} |Parameter|Description| |--|--------| |*Macro*|Macro name. The name must be wrapped in curly brackets and start with a dollar sign.<br>Example: {$FRONTEND\_URL}. The following characters are allowed in the macro names: **A-Z** (uppercase only) , **0-9** , **\_** , **.**| |*Value*|Macro value. Three value types are supported:<br>**Text** (default) - plain-text value<br>**[Secret text](/manual/config/macros/secret_macros#secret-text)** - the value is masked with asterisks<br> **[Vault secret](/manual/config/macros/secret_macros#vault-secret)** - the value contains a path/query to a [vault secret](/manual/config/secrets). <br><br>To change the value type click on the button at the end of the value input field.<br><br>Maximum length of a user macro value is 2048 characters.| |*Description*|Text field used to provide more information about this macro.| When configuring user macros, **note** the following context-specific behaviors: - if user macros are used in template items or triggers, consider adding those macros to the template as well (even if they are defined globally); that way, *Text* type macros will work as expected after exporting the template to XML and importing into another system (secret macro values are not [exported](/manual/xml_export_import)) - if user macros are used in trigger expressions, those macros will resolve only if referencing a parameter or constant; they will NOT resolve if referencing a host, item key, function, operator, or another trigger expression (secret macros cannot be used in trigger expressions) - if user macros are used on a host that has a low-level discovery rule with host prototypes, [discovered hosts](/manual/discovery/low_level_discovery/host_prototypes#discovered-hosts) will inherit all user macros defined on that host #### Konfigurācija Lai definētu lietotāja makro, dodieties uz atbilstošo vietu lietotāja saskarnē: - globālajiem makro atveriet *Administration → Macros* - hosta un veidnes līmeņa makro atveriet hosta vai veidnes rekvizītus un meklējiet cilni *Macros* Lietotāja makro ir šādi atribūti: {width="600"} |Parameter|Description| |--|--------| |*Macro*|Makro nosaukums. Nosaukumam jābūt ietvertam figūriekavās un jāsākas ar dolāra zīmi.<br>Piemērs: {$FRONTEND\_URL}. Makro nosaukumos ir atļautas šādas rakstzīmes: **A-Z** (tikai lielie burti) , **0-9** , **\_** , **.**| |*Value*|Makro vērtība. Tiek atbalstīti trīs vērtību tipi:<br>**Text** (noklusējums) - vienkārša teksta vērtība<br>**[Secret text](/manual/config/macros/secret_macros#secret-text)** - vērtība tiek maskēta ar zvaigznītēm<br> **[Vault secret](/manual/config/macros/secret_macros#vault-secret)** - vērtība satur ceļu/vaicājumu uz [vault secret](/manual/config/secrets). <br><br>Lai mainītu vērtības tipu, noklikšķiniet uz pogas vērtības ievades lauka beigās.<br><br>Maksimālais lietotāja makro vērtības garums ir 2048 rakstzīmes.| |*Description*|Teksta lauks, ko izmanto, lai sniegtu vairāk informācijas par šo makro.| Konfigurējot lietotāja makro, **ņemiet vērā** šādu no konteksta atkarīgu uzvedību: - ja lietotāja makro tiek izmantoti veidnes vienumos vai trigeros, apsveriet iespēju pievienot šos makro arī veidnei (pat ja tie ir definēti globāli); tādā veidā *Text* tipa makro darbosies, kā paredzēts, pēc veidnes eksportēšanas uz XML un importēšanas citā sistēmā (slepeno makro vērtības netiek [eksportētas](/manual/xml_export_import)) - ja lietotāja makro tiek izmantoti trigeru izteiksmēs, šie makro tiks atrisināti tikai tad, ja tie atsaucas uz parametru vai konstanti; tie NETIKS atrisināti, ja tie atsaucas uz hostu, vienuma atslēgu, funkciju, operatoru vai citu trigeru izteiksmi (slepenos makro nevar izmantot trigeru izteiksmēs) - ja lietotāja makro tiek izmantoti hostā, kuram ir zemā līmeņa atklāšanas noteikums ar hosta prototipiem, [atklātie hosti](/manual/discovery/low_level_discovery/host_prototypes#discovered-hosts) pārmantos visus šajā hostā definētos lietotāja makro #### Configuration To enable maintenance mode, open the `maintenance.inc.php` file (located in `/conf` of the Zabbix HTML document directory on the web server) and uncomment the following lines: // Maintenance mode. define('ZBX_DENY_GUI_ACCESS', 1); // Array of IP addresses, which are allowed to connect to frontend (optional). $ZBX_GUI_ACCESS_IP_RANGE = array('127.0.0.1'); // Message shown on warning screen (optional). $ZBX_GUI_ACCESS_MESSAGE = 'We are upgrading MySQL database till 15:00. Stay tuned...'; #### Konfigurācija Lai iespējotu uzturēšanas režīmu, atveriet failu `maintenance.inc.php` (atrodas Zabbix HTML dokumentu direktorijas `/conf` mapē tīmekļa serverī) un noņemiet komentārus šādām rindām: // Uzturēšanas režīms. define('ZBX_DENY_GUI_ACCESS', 1); // IP adrešu masīvs, kurām ir atļauts pieslēgties lietotāja saskarnei (neobligāti). $ZBX_GUI_ACCESS_IP_RANGE = array('127.0.0.1'); // Brīdinājuma ekrānā parādāmais ziņojums (neobligāti). $ZBX_GUI_ACCESS_MESSAGE = 'Mēs veicam MySQL datubāzes jaunināšanu līdz plkst. 15:00. Lūdzu, uzgaidiet...'; #### Configuration To ensure proper communication between all elements involved make sure server configuration file and frontend configuration file parameters are properly configured. #### Konfigurācija Lai nodrošinātu pareizu saziņu starp visiem iesaistītajiem elementiem, pārliecinieties, ka servera konfigurācijas faila un lietotāja saskarnes konfigurācijas faila parametri ir pareizi konfigurēti. #### Configuration To ensure proper communication between all elements involved make sure server configuration file and frontend configuration parameters are properly configured. #### Konfigurācija Lai nodrošinātu pareizu saziņu starp visiem iesaistītajiem elementiem, pārliecinieties, ka servera konfigurācijas fails un lietotāja saskarnes konfigurācijas parametri ir pareizi konfigurēti. #### Configuration To reclassify a problem as symptom problem, first select it in the list of [problems](/manual/web_interface/frontend_sections/monitoring/problems). One or several problems can be selected. Then go to the cause problem, and in its context menu click on the *Mark selected as symptoms* option.  After that, the selected problems will be updated by the server to symptom problems of the cause problem. While the status of the problem is being updated, it is displayed in one of two ways: - A blinking "UPDATING" status is displayed in the Status column; - A blinking  or  icon in the Info column (this is in effect if *Problems* only are selected in the filter and thus the Status column is not shown). #### Konfigurācija Lai pārklasificētu problēmu par simptomu problēmu, vispirms atlasiet to [problēmu](/manual/web_interface/frontend_sections/monitoring/problems) sarakstā. Var atlasīt vienu vai vairākas problēmas. Pēc tam dodieties uz cēloņa problēmu un tās konteksta izvēlnē noklikšķiniet uz opcijas *Atzīmēt atlasītās kā simptomus*.  Pēc tam serveris atjauninās atlasītās problēmas, pārveidojot tās par cēloņa problēmas simptomu problēmām. Kamēr problēmas statuss tiek atjaunināts, tas tiek attēlots vienā no diviem veidiem: - Statusa kolonnā tiek rādīts mirgojošs statuss "UPDATING"; - Informācijas kolonnā tiek rādīta mirgojoša  vai  ikona (tas ir spēkā, ja filtrā ir atlasītas tikai *Problems* un tādēļ Statusa kolonna netiek rādīta). #### Configuration To start using a webhook integration: 1. Locate the required .yaml file in the `templates/media` directory of the downloaded Zabbix version or download it from Zabbix [git repository](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media?at=refs%2Fheads%2Frelease%2F7.0). 2. [Import](/manual/xml_export_import/media#importing) the file into your Zabbix installation. The webhook will appear in the list of media types. 3. Configure the webhook according to instructions in the *Readme.md* file (you may click on a webhook's name above to quickly access *Readme.md*). To create a custom webhook from scratch: 1. Go to *Alerts > Media types*. 2. Click on *Create media type*. The **Media type** tab contains various attributes specific for this media type: {width="600"} All mandatory input fields are marked with a red asterisk. The following parameters are specific for the webhook media type: |Parameter|Description| |--|--------| |*Parameters*|Specify the webhook variables as the attribute and value pairs.<br>For preconfigured webhooks, a list of parameters varies, depending on the service. Check the webhook's *Readme.md* file for parameter description.<br>For new webhooks, several common variables are included by default (URL:<empty>, HTTPProxy:<empty>, To:{ALERT.SENDTO}, Subject:{ALERT.SUBJECT}, Message:{ALERT.MESSAGE}), feel free to keep or remove them.<br><br>Webhook parameters support [user macros](/manual/appendix/macros/supported_by_location_user), all [macros](/manual/appendix/macros/supported_by_location) that are supported in problem notifications and, additionally, {ALERT.SENDTO}, {ALERT.SUBJECT}, and {ALERT.MESSAGE} macros.<br><br>If you specify an HTTP proxy, the field supports the same functionality as in the item configuration [HTTP proxy](/manual/config/items/itemtypes/http#configuration) field. The proxy string may be prefixed with `[scheme]://` to specify which kind of proxy is used (e.g., https, socks4, socks5; see [documentation](https://curl.haxx.se/libcurl/c/CURLOPT_PROXY.html)).| |*Script*|Enter JavaScript code in the modal editor that opens when clicking in the parameter field or on the pencil icon next to it. This code will perform the webhook operation.<br>The script is a function code that accepts parameter - value pairs. The values should be converted into JSON objects using JSON.parse() method, for example: `var params = JSON.parse(value);`.<br><br>The code has access to all parameters, it may perform HTTP GET, POST, PUT and DELETE requests, support additional methods such as CONNECT, PATCH, HEAD, OPTIONS and TRACE, and has control over HTTP headers and request body.<br>The script must contain a return operator, otherwise it will not be valid. It may return OK status along with an optional list of tags and tag values (see *Process tags* option) or an error string.<br><br>Note that the script is executed only after an alert is created. If the script is configured to return and process tags, these tags will not get resolved in {EVENT.TAGS} and {EVENT.RECOVERY.TAGS} macros in the initial problem message and recovery messages because the script has not had the time to run yet.<br>*Note*: Using local variables (e.g. `var local = 1`) instead of a global one (e.g. `global = 1`) is recommended to ensure each script operates on its own data and to avoid collisions between simultaneous calls (see [known issues](/manual/installation/known_issues#preprocessing--global-variables-are-unsafe)).<br><br>See also: [Webhook development guidelines](https://www.zabbix.com/documentation/guidelines/en/webhooks), [Webhook script examples](/manual/config/notifications/media/webhook/webhook_examples), [Additional JavaScript objects](/manual/config/items/preprocessing/javascript/javascript_objects).<br>| |*Timeout*|JavaScript execution timeout (1-60s, default 30s).<br>Time suffixes are supported, e.g., 30s, 1m.| |*Process tags*|Mark the checkbox to process returned JSON property values as tags. These tags are added to any existing problem tags.<br>Note that when using [webhook tags](https://www.zabbix.com/documentation/guidelines/en/webhooks#webhook-tags), the webhook must return a JSON object containing at least an empty tags object: `var result = {tags: {}};`<br>Examples of tags that can be returned: *jira-id:prod-1234*, *responsible:John Smith*, *processed:<no value>*| |*Include event menu entry*|Mark the checkbox to include an entry in the [event menu](/manual/web_interface/menu/event_menu) linking to a created external ticket.<br>An entry will be included for each webhook that is enabled and has this checkbox marked. Note that if the *Menu entry name* and *Menu entry URL* parameters contain any [{EVENT.TAGS.<tag name>}](/manual/appendix/macros/supported_by_location#events) macros, an entry will be included only if these macros can be resolved (that is, the event has these tags defined).<br>If marked, the webhook should not be used for sending notifications to different users (consider creating a [dedicated user](/manual/config/notifications/media/webhook#user-media) instead) and should not be used in multiple alert actions [for a single problem event](/manual/config/notifications/media/webhook#configuring-alert-actions).| |*Menu entry name*|Specify the menu entry name.<br>[{EVENT.TAGS.<tag name>}](/manual/appendix/macros/supported_by_location#events) macro is supported.<br>This field is only mandatory if *Include event menu entry* is marked.| |*Menu entry URL*|Specify the underlying URL of the menu entry.<br>[{EVENT.TAGS.<tag name>}](/manual/appendix/macros/supported_by_location#events) macro is supported.<br>This field is only mandatory if *Include event menu entry* is marked.| See [common media type parameters](/manual/config/notifications/media#common-parameters) for details on how to configure default messages and alert processing options. ::: notewarning Even if a webhook doesn't use default messages, message templates for operation types used by this webhook must still be defined. ::: #### Konfigurācija Lai sāktu izmantot webhook integrāciju: 1. Atrodiet nepieciešamo .yaml failu lejupielādētās Zabbix versijas direktorijā `templates/media` vai lejupielādējiet to no Zabbix [git repozitorija](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media?at=refs%2Fheads%2Frelease%2F7.0). 2. [Importējiet](/manual/xml_export_import/media#importing) failu savā Zabbix instalācijā. Webhook parādīsies mediju tipu sarakstā. 3. Konfigurējiet webhook saskaņā ar norādījumiem failā *Readme.md* (varat noklikšķināt uz webhook nosaukuma augstāk, lai ātri atvērtu *Readme.md*). Lai izveidotu pielāgotu webhook no nulles: 1. Dodieties uz *Alerts > Media types*. 2. Noklikšķiniet uz *Create media type*. Cilnē **Media type** ir dažādi šim mediju tipam specifiski atribūti: {width="600"} Visi obligātie ievades lauki ir atzīmēti ar sarkanu zvaigznīti. Tālāk norādītie parametri ir specifiski webhook mediju tipam: |Parameter|Description| |--|--------| |*Parameters*|Norādiet webhook mainīgos kā atribūtu un vērtību pārus.<br>Iepriekš konfigurētiem webhook parametru saraksts atšķiras atkarībā no pakalpojuma. Parametru aprakstu skatiet webhook failā *Readme.md*.<br>Jauniem webhook pēc noklusējuma ir iekļauti vairāki kopīgi mainīgie (URL:<empty>, HTTPProxy:<empty>, To:{ALERT.SENDTO}, Subject:{ALERT.SUBJECT}, Message:{ALERT.MESSAGE}); tos varat paturēt vai noņemt.<br><br>Webhook parametri atbalsta [lietotāja makro](/manual/appendix/macros/supported_by_location_user), visus [makro](/manual/appendix/macros/supported_by_location), kas tiek atbalstīti problēmu paziņojumos, kā arī {ALERT.SENDTO}, {ALERT.SUBJECT} un {ALERT.MESSAGE} makro.<br><br>Ja norādāt HTTP starpniekserveri, lauks atbalsta tādu pašu funkcionalitāti kā vienuma konfigurācijas laukā [HTTP proxy](/manual/config/items/itemtypes/http#configuration). Starpniekservera virknei var pievienot prefiksu `[scheme]://`, lai norādītu, kāda veida starpniekserveris tiek izmantots (piem., https, socks4, socks5; skatiet [dokumentāciju](https://curl.haxx.se/libcurl/c/CURLOPT_PROXY.html)).| |*Script*|Ievadiet JavaScript kodu modālajā redaktorā, kas tiek atvērts, noklikšķinot parametra laukā vai uz zīmuļa ikonas blakus tam. Šis kods veiks webhook darbību.<br>Skripts ir funkcijas kods, kas pieņem parametra - vērtības pārus. Vērtības jākonvertē JSON objektos, izmantojot JSON.parse() metodi, piemēram: `var params = JSON.parse(value);`.<br><br>Kodam ir piekļuve visiem parametriem; tas var veikt HTTP GET, POST, PUT un DELETE pieprasījumus, atbalstīt papildu metodes, piemēram, CONNECT, PATCH, HEAD, OPTIONS un TRACE, kā arī kontrolēt HTTP galvenes un pieprasījuma pamattekstu.<br>Skriptā obligāti jābūt return operatoram, pretējā gadījumā tas nebūs derīgs. Tas var atgriezt OK statusu kopā ar izvēles tagu un tagu vērtību sarakstu (skatiet opciju *Process tags*) vai kļūdas virkni.<br><br>Ņemiet vērā, ka skripts tiek izpildīts tikai pēc trauksmes izveides. Ja skripts ir konfigurēts atgriezt un apstrādāt tagus, šie tagi netiks atrisināti {EVENT.TAGS} un {EVENT.RECOVERY.TAGS} makros sākotnējā problēmas ziņojumā un atkopšanas ziņojumos, jo skriptam vēl nebūs bijis laika izpildīties.<br>*Piezīme*: Ieteicams izmantot lokālos mainīgos (piem., `var local = 1`) globālo mainīgo vietā (piem., `global = 1`), lai nodrošinātu, ka katrs skripts darbojas ar saviem datiem, un izvairītos no konfliktiem vienlaicīgu izsaukumu laikā (skatiet [zināmās problēmas](/manual/installation/known_issues#preprocessing--global-variables-are-unsafe)).<br><br>Skatiet arī: [Webhook izstrādes vadlīnijas](https://www.zabbix.com/documentation/guidelines/en/webhooks), [Webhook skriptu piemēri](/manual/config/notifications/media/webhook/webhook_examples), [Papildu JavaScript objekti](/manual/config/items/preprocessing/javascript/javascript_objects).<br>| |*Timeout*|JavaScript izpildes noildze (1-60 s, noklusējums 30 s).<br>Tiek atbalstīti laika sufiksi, piemēram, 30s, 1m.| |*Process tags*|Atzīmējiet izvēles rūtiņu, lai apstrādātu atgrieztās JSON īpašību vērtības kā tagus. Šie tagi tiek pievienoti jebkuriem esošajiem problēmas tagiem.<br>Ņemiet vērā, ka, izmantojot [webhook tagus](https://www.zabbix.com/documentation/guidelines/en/webhooks#webhook-tags), webhook ir jāatgriež JSON objekts, kas satur vismaz tukšu tags objektu: `var result = {tags: {}};`<br>Tagu piemēri, ko var atgriezt: *jira-id:prod-1234*, *responsible:John Smith*, *processed:<no value>*| |*Include event menu entry*|Atzīmējiet izvēles rūtiņu, lai [notikuma izvēlnē](/manual/web_interface/menu/event_menu) iekļautu ierakstu, kas saista uz izveidotu ārējo biļeti.<br>Ieraksts tiks iekļauts katram iespējotajam webhook, kuram ir atzīmēta šī izvēles rūtiņa. Ņemiet vērā, ka, ja parametros *Menu entry name* un *Menu entry URL* ir kādi [{EVENT.TAGS.<tag name>}](/manual/appendix/macros/supported_by_location#events) makro, ieraksts tiks iekļauts tikai tad, ja šos makro var atrisināt (tas ir, notikumam ir definēti šie tagi).<br>Ja ir atzīmēts, webhook nevajadzētu izmantot paziņojumu sūtīšanai dažādiem lietotājiem (apsveriet iespēju izveidot [atsevišķu lietotāju](/manual/config/notifications/media/webhook#user-media) tā vietā) un nevajadzētu to izmantot vairākās trauksmes darbībās [vienam problēmas notikumam](/manual/config/notifications/media/webhook#configuring-alert-actions).| |*Menu entry name*|Norādiet izvēlnes ieraksta nosaukumu.<br>Tiek atbalstīts [{EVENT.TAGS.<tag name>}](/manual/appendix/macros/supported_by_location#events) makro.<br>Šis lauks ir obligāts tikai tad, ja ir atzīmēts *Include event menu entry*.| |*Menu entry URL*|Norādiet izvēlnes ieraksta pamatā esošo URL.<br>Tiek atbalstīts [{EVENT.TAGS.<tag name>}](/manual/appendix/macros/supported_by_location#events) makro.<br>Šis lauks ir obligāts tikai tad, ja ir atzīmēts *Include event menu entry*.| Skatiet [kopīgos mediju tipa parametrus](/manual/config/notifications/media#common-parameters), lai uzzinātu, kā konfigurēt noklusējuma ziņojumus un trauksmju apstrādes opcijas. ::: notewarning Pat ja webhook neizmanto noklusējuma ziņojumus, ziņojumu veidnēm darbību tipiem, ko izmanto šis webhook, joprojām jābūt definētām. ::: #### Configuration Two steps are required to close a problem manually. #### Konfigurācija Lai manuāli aizvērtu problēmu, ir nepieciešami divi soļi. #### Configuration You can execute passive checks from: - *Monitoring* > [*Latest data*](/manual/web_interface/frontend_sections/monitoring/latest_data) - *Data collection* > *Hosts* > [*Items*](/manual/web_interface/frontend_sections/data_collection/hosts/items) or [*Discovery*](/manual/web_interface/frontend_sections/data_collection/hosts/discovery) - The [item menu](/manual/web_interface/menu/item_menu) - When editing items or low-level discovery rules (in their configuration forms) ::: noteimportant The check must exist in the configuration cache in order to get executed; see also [CacheUpdateFrequency](/manual/appendix/config/zabbix_server#cacheupdatefrequency). The cache is **not updated** before check execution, so recent changes to item or low-level discovery rule configuration will not be picked up. To test items or LLD rules that are being created or newly created, you can use the [Test](/manual/config/items/item#testing) option instead. ::: For example, to execute a passive check in *Monitoring* > [*Latest data*](/manual/web_interface/frontend_sections/monitoring/latest_data): 1. Select items; you can execute the check for multiple items at once. 2. Click *Execute now*.  ::: noteclassic In *Latest data*, users may *Execute now* items on hosts for which they have *read-write* [permission](/manual/config/users_and_usergroups/usergroup#configuration), or *read* permission and *Invoke "Execute now" on read-only hosts* [action](/manual/web_interface/frontend_sections/users/user_roles#default-permissions) enabled for their role. ::: #### Konfigurācija Jūs varat izpildīt pasīvos pārbaudes no: - *Uzraudzība* > [*Jaunākie dati*](/manual/web_interface/frontend_sections/monitoring/latest_data) - *Datu vākšana* > *Hosts* > [*Vienumi*](/manual/web_interface/frontend_sections/data_collection/hosts/items) vai [*Atklāšana*](/manual/web_interface/frontend_sections/data_collection/hosts/discovery) - [Vienuma izvēlne](/manual/web_interface/menu/item_menu) - Rediģējot vienumus vai zemā līmeņa atklāšanas noteikumus (to konfigurācijas formās) ::: noteimportant Pārbaudei ir jāatrodas konfigurācijas kešatmiņā, lai to varētu izpildīt; skatiet arī [CacheUpdateFrequency](/manual/appendix/config/zabbix_server#cacheupdatefrequency). Kešatmiņa pirms pārbaudes izpildes **netiek atjaunināta**, tāpēc nesen veiktās izmaiņas vienuma vai zemā līmeņa atklāšanas noteikuma konfigurācijā netiks ņemtas vērā. Lai pārbaudītu vienumus vai LLD noteikumus, kas tiek veidoti vai ir tikko izveidoti, tā vietā varat izmantot opciju [Test](/manual/config/items/item#testing). ::: Piemēram, lai izpildītu pasīvo pārbaudi sadaļā *Uzraudzība* > [*Jaunākie dati*](/manual/web_interface/frontend_sections/monitoring/latest_data): 1. Atlasiet vienumus; pārbaudi var izpildīt vairākiem vienumiem vienlaikus. 2. Noklikšķiniet uz *Izpildīt tagad*.  ::: noteclassic Sadaļā *Jaunākie dati* lietotāji var *Izpildīt tagad* vienumus uz hosts, kuriem viņiem ir *lasīšanas-rakstīšanas* [atļauja](/manual/config/users_and_usergroups/usergroup#configuration), vai arī *lasīšanas* atļauja un viņu lomai ir iespējota darbība *Izsaukt "Izpildīt tagad" tikai lasāmiem hosts* [darbība](/manual/web_interface/frontend_sections/users/user_roles#default-permissions). ::: #### Configure DB connection Enter details for connecting to the database. Zabbix database must already be created. For MySQL, entering `localhost` or leaving the *Database host* field empty results in connecting via the default Unix socket. The setup form does not provide a separate *Database socket* field, so to use a custom socket, configure it in the Zabbix server settings (for example, with [`DBSocket=`](/manual/appendix/config/zabbix_server#dbsocket) in zabbix_server.conf). This keeps the frontend aligned with server-to-database connection settings. For PostgreSQL, if the *Database host* field is left empty, the default Unix-domain socket is used. If a socket path is entered (for example, `/var/run/pgbouncer`), that Unix-domain socket will be used instead. {width="600"} If the *Database TLS encryption* option is checked, then additional fields for [configuring the TLS connection](/manual/appendix/install/db_encrypt) to the database appear in the form (MySQL or PostgreSQL only). If *Store credentials in* is set to HashiCorp Vault or CyberArk Vault, additional parameters will become available: - for [HashiCorp Vault](/manual/config/secrets/hashicorp): Vault API endpoint, vault prefix, secret path, and authentication token; - for [CyberArk Vault](/manual/config/secrets/cyberark): Vault API endpoint, vault prefix, secret query string, and certificates. Upon marking *Vault certificates* checkbox, two new fields for specifying paths to SSL certificate file and SSL key file will appear. {width="600"} #### Konfigurēt DB savienojumu Ievadiet informāciju par savienojumu ar datubāzi. Zabbix datubāzei jau ir jābūt izveidotai. MySQL gadījumā, ievadot `localhost` vai atstājot lauku *Database host* tukšu, savienojums tiek izveidots, izmantojot noklusējuma Unix socket. Iestatīšanas forma nenodrošina atsevišķu lauku *Database socket*, tāpēc, lai izmantotu pielāgotu socket, konfigurējiet to Zabbix servera iestatījumos (piemēram, ar [`DBSocket=`](/manual/appendix/config/zabbix_server#dbsocket) failā zabbix_server.conf). Tas nodrošina, ka lietotāja saskarne ir saskaņota ar servera un datubāzes savienojuma iestatījumiem. PostgreSQL gadījumā, ja lauks *Database host* tiek atstāts tukšs, tiek izmantots noklusējuma Unix-domain socket. Ja tiek ievadīts socket ceļš (piemēram, `/var/run/pgbouncer`), tiks izmantots šis Unix-domain socket. {width="600"} Ja ir atzīmēta opcija *Database TLS encryption*, formā parādās papildu lauki [TLS savienojuma konfigurēšanai](/manual/appendix/install/db_encrypt) ar datubāzi (tikai MySQL vai PostgreSQL). Ja *Store credentials in* ir iestatīts uz HashiCorp Vault vai CyberArk Vault, kļūs pieejami papildu parametri: - [HashiCorp Vault](/manual/config/secrets/hashicorp): Vault API galapunkts, Vault prefikss, slepenās informācijas ceļš un autentifikācijas tokens; - [CyberArk Vault](/manual/config/secrets/cyberark): Vault API galapunkts, Vault prefikss, slepenās informācijas vaicājuma virkne un sertifikāti. Atzīmējot izvēles rūtiņu *Vault certificates*, parādīsies divi jauni lauki SSL sertifikāta faila un SSL atslēgas faila ceļu norādīšanai. {width="600"} ###### Configure request A request to execute the *Configure* function of the *Configurator* interface. | | | |---|---| |direction|agent → plugin| |response|n/a| Parameters specific to *Configure* requests: |Name|Type|Comments| |---------|--------|----------| |global_options|JSON object|JSON object containing global agent configuration options.| |private_options|JSON object (optional)|JSON object containing private plugin configuration options, if provided.| *Example:* {"id":6,"type":8,"global_options":{...},"private_options":{...}} ###### Konfigurēt pieprasījumu Pieprasījums izpildīt *Configurator* saskarnes funkciju *Configure*. | | | |---|---| |virziens|aģents → spraudnis| |atbilde|n/a| Parametri, kas raksturīgi *Configure* pieprasījumiem: |Nosaukums|Tips|Komentāri| |---------|--------|----------| |global_options|JSON object|JSON objekts, kas satur globālās aģenta konfigurācijas opcijas.| |private_options|JSON object (optional)|JSON objekts, kas satur privātās spraudņa konfigurācijas opcijas, ja tādas ir norādītas.| *Piemērs:* {"id":6,"type":8,"global_options":{...},"private_options":{...}} #### Configure WebDriver Browser items require an automation framework (either Selenium Server or a plain WebDriver, for example, ChromeDriver) as a web testing endpoint that controls and interacts with a browser, executing test commands such as clicking buttons or entering text. As an example, this guide will use Selenium Server with Chrome in a Docker container. It is assumed that Docker is already configured. This guide does not cover the configuration of Docker. For installation instructions, see [Install Docker Engine on Ubuntu](https://docs.docker.com/engine/install/ubuntu/). 1\. Launch Selenium Server with Chrome in a Docker container with the following options: - **docker run --name browser** - runs a new Docker container named "browser"; - **-p 4444:4444** - maps port 4444 on your host machine to port 4444 on the container (this is the port used by Selenium Server to accept commands); - **-p 7900:7900** - maps port 7900 on your host machine to port 7900 on the container (this is the port used by the Virtual Network Computing (VNC) server, allowing you to view the browser GUI remotely; requires a VNC client); - **--shm-size="2g"** - allocates 2GB of shared memory to the container (this is important for Chrome to run properly, as it can require a significant amount of shared memory to avoid crashes); - **-d** - runs the container in detached mode, meaning it will run in the background; - **selenium/standalone-chrome:latest** - specifies the Docker image to use; in this case, the latest version of [Selenium Server with Chrome](https://hub.docker.com/r/selenium/standalone-chrome). ```bash docker run --name browser \ -p 4444:4444 \ -p 7900:7900 \ --shm-size="2g" \ -d selenium/standalone-chrome:latest ``` 2\. Ensure that the `browser` Docker container is running and accessible. - Retrieve the IP address of the container (in this example, 192.0.2.1): ```bash ip addr # 1: lo: <LOOPBACK,UP,LOWER_UP> # ... # 3: docker0: <NO-CARRIER,BROADCAST,MULTICAST,UP> ... # inet 192.0.2.1/16 brd 192.0.255.255 scope global docker0 # ... ``` - Test the connection to the container with [Ncat](https://nmap.org/ncat/): ```bash nc -zv 192.0.2.1 4444 # Connection to 192.0.2.1 4444 port [tcp/*] succeeded! ``` - Retrieve the webpage content from Selenium Server with [curl](https://curl.se/): ```bash curl -L 192.0.2.1:4444 # <!DOCTYPE html> # <html lang="en"> # # <head> # <meta charset="utf-8"/> # <link href="favicon.svg" rel="icon" type="image/svg"> # <meta content="width=device-width, initial-scale=1" name="viewport"/> # <link href="logo192.png" rel="apple-touch-icon"/> # <link href="manifest.json" rel="manifest"/> # <title>Selenium Grid</title> # </head> # # <body> # ... ``` ::: noteclassic For troubleshooting, refer to [Docker documentation](https://docs.docker.com/engine/). ::: #### Konfigurēt WebDriver Pārlūka vienumiem ir nepieciešams automatizācijas ietvars (vai nu Selenium Server, vai vienkāršs WebDriver, piemēram, ChromeDriver) kā tīmekļa testēšanas galapunktam, kas kontrolē pārlūku un mijiedarbojas ar to, izpildot testa komandas, piemēram, pogu klikšķināšanu vai teksta ievadi. Kā piemērs šajā rokasgrāmatā tiks izmantots Selenium Server ar Chrome Docker konteinerā. Tiek pieņemts, ka Docker jau ir konfigurēts. Šī rokasgrāmata neaptver Docker konfigurēšanu. Instalēšanas norādījumus skatiet [Install Docker Engine on Ubuntu](https://docs.docker.com/engine/install/ubuntu/). 1\. Palaidiet Selenium Server ar Chrome Docker konteinerā, izmantojot šādas opcijas: - **docker run --name browser** - palaiž jaunu Docker konteineru ar nosaukumu "browser"; - **-p 4444:4444** - piesaista 4444 portu jūsu hostā pie 4444 porta konteinerā (šis ir ports, ko Selenium Server izmanto komandu pieņemšanai); - **-p 7900:7900** - piesaista 7900 portu jūsu hostā pie 7900 porta konteinerā (šis ir ports, ko izmanto Virtual Network Computing (VNC) serveris, ļaujot attālināti skatīt pārlūka GUI; nepieciešams VNC klients); - **--shm-size="2g"** - piešķir konteineram 2 GB koplietotās atmiņas (tas ir svarīgi, lai Chrome darbotos pareizi, jo tam var būt nepieciešams ievērojams koplietotās atmiņas apjoms, lai izvairītos no avārijām); - **-d** - palaiž konteineru atdalītā režīmā, t. i., tas darbosies fonā; - **selenium/standalone-chrome:latest** - norāda izmantojamo Docker attēlu; šajā gadījumā jaunāko [Selenium Server with Chrome](https://hub.docker.com/r/selenium/standalone-chrome) versiju. ```bash docker run --name browser \ -p 4444:4444 \ -p 7900:7900 \ --shm-size="2g" \ -d selenium/standalone-chrome:latest ``` 2\. Pārliecinieties, ka `browser` Docker konteiners darbojas un ir pieejams. - Iegūstiet konteinera IP adresi (šajā piemērā 192.0.2.1): ```bash ip addr # 1: lo: <LOOPBACK,UP,LOWER_UP> # ... # 3: docker0: <NO-CARRIER,BROADCAST,MULTICAST,UP> ... # inet 192.0.2.1/16 brd 192.0.255.255 scope global docker0 # ... ``` - Pārbaudiet savienojumu ar konteineru, izmantojot [Ncat](https://nmap.org/ncat/): ```bash nc -zv 192.0.2.1 4444 # Connection to 192.0.2.1 4444 port [tcp/*] succeeded! ``` - Iegūstiet tīmekļa lapas saturu no Selenium Server, izmantojot [curl](https://curl.se/): ```bash curl -L 192.0.2.1:4444 # <!DOCTYPE html> # <html lang="en"> # # <head> # <meta charset="utf-8"/> # <link href="favicon.svg" rel="icon" type="image/svg"> # <meta content="width=device-width, initial-scale=1" name="viewport"/> # <link href="logo192.png" rel="apple-touch-icon"/> # <link href="manifest.json" rel="manifest"/> # <title>Selenium Grid</title> # </head> # # <body> # ... ``` ::: noteclassic Problēmu novēršanai skatiet [Docker documentation](https://docs.docker.com/engine/). ::: ##### Configure web scenario steps Switch to the *Steps* tab and define steps for the scenario. Click on *Add* button to add an individual step. ##### Konfigurēt tīmekļa scenārija soļus Pārslēdzieties uz cilni *Soļi* un definējiet scenārija soļus. Noklikšķiniet uz pogas *Pievienot*, lai pievienotu atsevišķu soli. #### Configure Zabbix agent for Windows event log monitoring 1\. Open `zabbix_agentd.conf` (default path `C:\Program Files\Zabbix Agent\zabbix_agentd.conf`) on your Windows host and ensure that the [ServerActive](/manual/appendix/config/zabbix_agentd_win#serveractive) parameter is set to the IP address of your Zabbix server, and the [Hostname](/manual/appendix/config/zabbix_agentd_win#hostname) parameter matches the host name that will be defined in [Zabbix frontend](#configure-zabbix-frontend). This enables the agent to request active checks for its host and from the specified Zabbix server. For example: ```ini ServerActive=192.0.2.1 Hostname=MyWindowsHost ``` 2\. Restart Zabbix agent service to apply the changes: ```bash net stop "Zabbix Agent" && net start "Zabbix Agent" ``` 3\. Check that the Windows host is running: - Ensure Zabbix agent service is running on the Windows host. - Check that the Windows host can connect to Zabbix server on port 10051. To test connectivity from the Windows host, open PowerShell and run the following command: ```powershell Test-NetConnection -ComputerName <Zabbix-server-IP> -Port 10051 ``` #### Konfigurējiet Zabbix aģentu Windows notikumu žurnāla uzraudzībai 1\. Atveriet `zabbix_agentd.conf` (noklusējuma ceļš `C:\Program Files\Zabbix Agent\zabbix_agentd.conf`) savā Windows hostā un pārliecinieties, ka parametrs [ServerActive](/manual/appendix/config/zabbix_agentd_win#serveractive) ir iestatīts uz jūsu Zabbix servera IP adresi, bet parametrs [Hostname](/manual/appendix/config/zabbix_agentd_win#hostname) atbilst hosta nosaukumam, kas tiks definēts [Zabbix lietotāja saskarne](#configure-zabbix-frontend). Tas ļauj aģentam pieprasīt aktīvās pārbaudes savam hostam no norādītā Zabbix servera. Piemēram: ```ini ServerActive=192.0.2.1 Hostname=MyWindowsHost ``` 2\. Restartējiet Zabbix aģenta pakalpojumu, lai piemērotu izmaiņas: ```bash net stop "Zabbix Agent" && net start "Zabbix Agent" ``` 3\. Pārbaudiet, vai Windows hosts darbojas: - Pārliecinieties, ka Zabbix aģenta pakalpojums darbojas Windows hostā. - Pārbaudiet, vai Windows hosts var izveidot savienojumu ar Zabbix serveri 10051. portā. Lai pārbaudītu savienojumu no Windows hosta, atveriet PowerShell un izpildiet šādu komandu: ```powershell Test-NetConnection -ComputerName <Zabbix-server-IP> -Port 10051 ``` ## Configure Zabbix for monitoring Zabbix agent can collect metrics in active or passive mode (simultaneously). ::: noteclassic A passive check is a simple data request. Zabbix server or proxy asks for some data (for example, CPU load) and Zabbix agent sends back the result to the server. Active checks require more complex processing. The Agent must first retrieve from the server(s) a list of items for independent processing and then bulk send the data back. See [Passive and active agent checks](/manual/appendix/items/activepassive) for more info. ::: Monitoring templates provided by Zabbix usually offer two alternatives - a template for Zabbix agent and a template for Zabbix agent (active). With the first option, the Agent will collect metrics in passive mode. Such templates will deliver identical monitoring results, but using different communication protocols. Further Zabbix configuration depends on whether you select a template for [active](#active-checks) or [passive](#passive-checks) Zabbix agent checks. ## Konfigurēt Zabbix uzraudzībai Zabbix aģents var vākt metriku aktīvajā vai pasīvajā režīmā (vienlaikus). ::: noteclassic Pasīvā pārbaude ir vienkāršs datu pieprasījums. Zabbix serveris vai starpniekserveris pieprasa noteiktus datus (piemēram, CPU noslodzi), un Zabbix aģents nosūta rezultātu atpakaļ serverim. Aktīvās pārbaudes prasa sarežģītāku apstrādi. Aģentam vispirms no servera(-iem) ir jāiegūst vienumu saraksts neatkarīgai apstrādei, un pēc tam dati jānosūta atpakaļ lielapjomā. Plašāku informāciju skatiet sadaļā [Pasīvās un aktīvās aģenta pārbaudes](/manual/appendix/items/activepassive). ::: Zabbix nodrošinātās uzraudzības veidnes parasti piedāvā divas alternatīvas - veidni Zabbix aģentam un veidni Zabbix aģentam (aktīvs). Izmantojot pirmo opciju, aģents vāks metriku pasīvajā režīmā. Šādas veidnes nodrošinās identiskus uzraudzības rezultātus, taču izmantos atšķirīgus saziņas protokolus. Turpmākā Zabbix konfigurācija ir atkarīga no tā, vai izvēlaties veidni [aktīvajām](#active-checks) vai [pasīvajām](#passive-checks) Zabbix aģenta pārbaudēm. ### Configure Zabbix for monitoring Zabbix agent can collect metrics in active or passive mode (simultaneously). See [Passive and active agent checks](/manual/appendix/items/activepassive) for more info. In this guide, monitoring by means of **active checks** will be described. ### Konfigurējiet Zabbix uzraudzībai Zabbix aģents var vākt metriku aktīvajā vai pasīvajā režīmā (vienlaikus). Plašāku informāciju skatiet sadaļā [Pasīvās un aktīvās aģenta pārbaudes](/manual/appendix/items/activepassive). Šajā ceļvedī tiks aprakstīta uzraudzība, izmantojot **aktīvās pārbaudes**. #### Configure Zabbix frontend 1\. Log into Zabbix frontend. 2\. [Create a host](/manual/config/hosts/host) in Zabbix web interface: - In the *Host name* field, enter a host name (for example, "git.zabbix.com"). - In the *Templates* field, type or select the "Website by Browser" template. For more information on this template, see [Website by Browser](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/website_browser?at=refs%2Fheads%2Frelease%2F7.0). - In the *Host groups* field, type or select a host group (for example, a new host group "Websites"). {width="600"} - In the *Macros* tab, switch to *Inherited and host macros*, look for the following macros and click on *Change* next to the macro value to update it: - {$WEBSITE.DOMAIN} - Domain name (for example, git.zabbix.com/projects/ZBX/repos/zabbix/browse) - {$WEBSITE.GET.DATA.INTERVAL} - Item data update interval (for example, 15m) {width="600"} 3\. Click the *Add* button to create the host. This host will represent the website you want to monitor. #### Konfigurēt Zabbix lietotāja saskarni 1\. Piesakieties Zabbix lietotāja saskarnē. 2\. [Izveidojiet hostu](/manual/config/hosts/host) Zabbix tīmekļa saskarnē: - Laukā *Host name* ievadiet hosta nosaukumu (piemēram, "git.zabbix.com"). - Laukā *Templates* ievadiet vai atlasiet veidni "Website by Browser". Plašāku informāciju par šo veidni skatiet [Website by Browser](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/website_browser?at=refs%2Fheads%2Frelease%2F7.0). - Laukā *Host groups* ievadiet vai atlasiet hostu grupu (piemēram, jaunu hostu grupu "Websites"). {width="600"} - Cilnē *Macros* pārslēdzieties uz *Inherited and host macros*, atrodiet tālāk norādītos makro un noklikšķiniet uz *Change* blakus makro vērtībai, lai to atjauninātu: - {$WEBSITE.DOMAIN} - domēna nosaukums (piemēram, git.zabbix.com/projects/ZBX/repos/zabbix/browse) - {$WEBSITE.GET.DATA.INTERVAL} - vienuma datu atjaunināšanas intervāls (piemēram, 15m) {width="600"} 3\. Noklikšķiniet uz pogas *Add*, lai izveidotu hostu. Šis hosts attēlos tīmekļa vietni, kuru vēlaties uzraudzīt. #### Configure Zabbix frontend 1\. Navigate to *Data collection > Hosts* and [create a host](/manual/config/hosts/host): - In the *Host name* field, enter a host name (e.g., "MyWindowsHost"). - In the *Host groups* field, type or select a host group (e.g., "Event log Monitoring"). - Press *Add* to save the configured host. ::: noteclassic In the *Templates* field you may add the "Windows by Zabbix agent active" template to help you troubleshoot by observing whether other active items on the same host are updating. ::: {width="600"} 2\. Create a new item with the following parameters: - In the *Name* field, enter a descriptive item name (e.g., "Security log: failed logon events"). - In the *Type* drop-down, select "Zabbix agent (active)" (required for Event log monitoring). - In the *Key* field, use the [eventlog](/manual/config/items/itemtypes/zabbix_agent/win_keys#eventlog) item key. For example, to monitor failed logon attempts (Event ID: 4625) in the Security log and to ignore entries older than the item's last check (using the `skip` parameter), enter the following item key: `eventlog[Security,,,,4625,,skip]` - In the *Type of information* drop-down, select "Log". {width="600"} 3\. Click *Add* to save the item. #### Konfigurēt Zabbix lietotāja saskarni 1\. Dodieties uz *Data collection > Hosts* un [izveidojiet hostu](/manual/config/hosts/host): - Laukā *Host name* ievadiet hosta nosaukumu (piem., "MyWindowsHost"). - Laukā *Host groups* ievadiet vai atlasiet hostu grupu (piem., "Event log Monitoring"). - Nospiediet *Add*, lai saglabātu konfigurēto hostu. ::: noteclassic Laukā *Templates* varat pievienot veidni "Windows by Zabbix agent active", lai palīdzētu novērst problēmas, novērojot, vai citi aktīvie vienumi tajā pašā hostā tiek atjaunināti. ::: {width="600"} 2\. Izveidojiet jaunu vienumu ar šādiem parametriem: - Laukā *Name* ievadiet aprakstošu vienuma nosaukumu (piem., "Security log: failed logon events"). - Nolaižamajā sarakstā *Type* atlasiet "Zabbix agent (active)" (nepieciešams Event log monitoring). - Laukā *Key* izmantojiet [eventlog](/manual/config/items/itemtypes/zabbix_agent/win_keys#eventlog) vienuma atslēgu. Piemēram, lai uzraudzītu neveiksmīgus pieteikšanās mēģinājumus (Event ID: 4625) Security žurnālā un ignorētu ierakstus, kas ir vecāki par vienuma pēdējo pārbaudi (izmantojot `skip` parametru), ievadiet šādu vienuma atslēgu: `eventlog[Security,,,,4625,,skip]` - Nolaižamajā sarakstā *Type of information* atlasiet "Log". {width="600"} 3\. Noklikšķiniet uz *Add*, lai saglabātu vienumu. #### Configure Zabbix server Browser items are executed and processed by *browser poller* Zabbix processes that need to be enabled by adjusting the [StartBrowserPollers](/manual/appendix/config/zabbix_server#startbrowserpollers) server configuration parameter. Additionally, the [WebDriverURL](/manual/appendix/config/zabbix_server#webdriverurl) parameter should specify the previously configured web testing endpoint. By default, the StartBrowserPollers parameter is set to 1, therefore you only need to specify the web testing endpoint. 1\. Open the Zabbix server configuration file. ```bash vi /etc/zabbix/zabbix_server.conf ``` 2\. Locate and set the [WebDriverURL](/manual/appendix/config/zabbix_server#webdriverurl) parameter in Zabbix server configuration file: ```ini ### Option: WebDriverURL # WebDriver interface HTTP[S] URL. For example, http://localhost:4444 used with Selenium WebDriver standalone server. # # Mandatory: no # Default: # WebDriverURL= WebDriverURL=192.0.2.1:4444 ``` 3\. Restart Zabbix server. ```bash systemctl restart zabbix-server ``` #### Zabbix servera konfigurēšana Pārlūka vienumus izpilda un apstrādā *browser poller* Zabbix procesi, kas jāiespējo, pielāgojot servera konfigurācijas parametru [StartBrowserPollers](/manual/appendix/config/zabbix_server#startbrowserpollers). Papildus tam parametram [WebDriverURL](/manual/appendix/config/zabbix_server#webdriverurl) jānorāda iepriekš konfigurētais tīmekļa testēšanas galapunkts. Pēc noklusējuma parametrs StartBrowserPollers ir iestatīts uz 1, tāpēc jums tikai jānorāda tīmekļa testēšanas galapunkts. 1\. Atveriet Zabbix servera konfigurācijas failu. ```bash vi /etc/zabbix/zabbix_server.conf ``` 2\. Atrodiet un iestatiet parametru [WebDriverURL](/manual/appendix/config/zabbix_server#webdriverurl) Zabbix servera konfigurācijas failā: ```ini ### Option: WebDriverURL # WebDriver interface HTTP[S] URL. For example http://localhost:4444 used with Selenium WebDriver standalone server. # # Mandatory: no # Default: # WebDriverURL= WebDriverURL=192.0.2.1:4444 ``` 3\. Restartējiet Zabbix serveri. ```bash systemctl restart zabbix-server ``` #### Configuring a *Clock* widget Configure a *Clock* widget that displays local date, time and time zone in a customized digital clock. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "clock", "name": "Clock", "x": 0, "y": 0, "width": 12, "height": 3, "view_mode": 0, "fields": [ { "type": 0, "name": "clock_type", "value": 1 }, { "type": 0, "name": "show.0", "value": 1 }, { "type": 0, "name": "show.1", "value": 2 }, { "type": 0, "name": "show.2", "value": 3 }, { "type": 1, "name": "date_color", "value": "E1E1E1" }, { "type": 0, "name": "time_bold", "value": 1 }, { "type": 1, "name": "tzone_color", "value": "E1E1E1" }, { "type": 1, "name": "tzone_timezone", "value": "Europe/Riga" }, { "type": 0, "name": "tzone_format", "value": 1 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### *Clock* logrīka konfigurēšana Konfigurējiet *Clock* logrīku, kas pielāgotā digitālajā pulkstenī attēlo vietējo datumu, laiku un laika joslu. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "clock", "name": "Clock", "x": 0, "y": 0, "width": 12, "height": 3, "view_mode": 0, "fields": [ { "type": 0, "name": "clock_type", "value": 1 }, { "type": 0, "name": "show.0", "value": 1 }, { "type": 0, "name": "show.1", "value": 2 }, { "type": 0, "name": "show.2", "value": 3 }, { "type": 1, "name": "date_color", "value": "E1E1E1" }, { "type": 0, "name": "time_bold", "value": 1 }, { "type": 1, "name": "tzone_color", "value": "E1E1E1" }, { "type": 1, "name": "tzone_timezone", "value": "Europe/Riga" }, { "type": 0, "name": "tzone_format", "value": 1 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring a *Data overview* widget Configure a *Data overview* widget that displays data for host "10084" and only for items for which the tag with the name "component" contains value "cpu". In addition, display the data with hosts located on top. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "dataover", "name": "Data overview", "x": 0, "y": 0, "width": 36, "height": 5, "view_mode": 0, "fields": [ { "type": 3, "name": "hostids.0", "value": 10084 }, { "type": 1, "name": "tags.0.tag", "value": "component" }, { "type": 0, "name": "tags.0.operator", "value": 0 }, { "type": 1, "name": "tags.0.value", "value": "cpu" }, { "type": 0, "name": "style", "value": 1 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### *Data overview* logrīka konfigurēšana Konfigurējiet *Data overview* logrīku, kas attēlo datus hostam "10084" un tikai tiem vienumiem, kuriem taga ar nosaukumu "component" vērtība satur "cpu". Papildus attēlojiet datus ar hostiem augšpusē. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "dataover", "name": "Data overview", "x": 0, "y": 0, "width": 36, "height": 5, "view_mode": 0, "fields": [ { "type": 3, "name": "hostids.0", "value": 10084 }, { "type": 1, "name": "tags.0.tag", "value": "component" }, { "type": 0, "name": "tags.0.operator", "value": 0 }, { "type": 1, "name": "tags.0.value", "value": "cpu" }, { "type": 0, "name": "style", "value": 1 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring a *Favorite graphs* widget Configure a *Favorite graphs* widget with the refresh interval set to 10 minutes. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "favgraphs", "name": "Favorite graphs", "x": 0, "y": 0, "width": 12, "height": 3, "view_mode": 0, "fields": [ { "type": 0, "name": "rf_rate", "value": 600 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### *Favorite graphs* logrīka konfigurēšana Konfigurējiet *Favorite graphs* logrīku, iestatot atsvaidzināšanas intervālu uz 10 minūtēm. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "favgraphs", "name": "Favorite graphs", "x": 0, "y": 0, "width": 12, "height": 3, "view_mode": 0, "fields": [ { "type": 0, "name": "rf_rate", "value": 600 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring a *Favorite maps* widget Configure a *Favorite maps* widget with the refresh interval set to 10 minutes. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "favmaps", "name": "Favorite maps", "x": 0, "y": 0, "width": 12, "height": 3, "view_mode": 0, "fields": [ { "type": 0, "name": "rf_rate", "value": 600 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### *Iecienīto karšu* logrīka konfigurēšana Konfigurējiet *Iecienīto karšu* logrīku, iestatot atsvaidzināšanas intervālu uz 10 minūtēm. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "favmaps", "name": "Favorite maps", "x": 0, "y": 0, "width": 12, "height": 3, "view_mode": 0, "fields": [ { "type": 0, "name": "rf_rate", "value": 600 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring a *Gauge* widget Configure a *Gauge* widget that displays the item value for the item "44474" (Interface enp0s3: Bits sent). In addition, visually fine-tune the widget with multiple advanced options, including thresholds. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "gauge", "name": "Gauge", "x": 0, "y": 0, "width": 18, "height": 5, "view_mode": 0, "fields": [ { "type": 4, "name": "itemid.0", "value": 44474 }, { "type": 1, "name": "min", "value": "100000" }, { "type": 1, "name": "max", "value": "1000000" }, { "type": 0, "name": "show.0", "value": 1 }, { "type": 0, "name": "show.1", "value": 2 }, { "type": 0, "name": "show.2", "value": 3 }, { "type": 0, "name": "show.4", "value": 4 }, { "type": 0, "name": "show.5", "value": 5 }, { "type": 0, "name": "angle", "value": 270 }, { "type": 0, "name": "desc_size", "value": 10 }, { "type": 0, "name": "desc_bold", "value": 1 }, { "type": 0, "name": "decimal_places", "value": 0 }, { "type": 0, "name": "value_bold", "value": 1 }, { "type": 0, "name": "units_size", "value": 15 }, { "type": 0, "name": "units_pos", "value": 3 }, { "type": 1, "name": "needle_color", "value": "3C3C3C" }, { "type": 1, "name": "thresholds.0.color", "value": "FF465C" }, { "type": 1, "name": "thresholds.0.threshold", "value": "700000" }, { "type": 1, "name": "thresholds.1.color", "value": "FFD54F" }, { "type": 1, "name": "thresholds.1.threshold", "value": "500000" }, { "type": 1, "name": "thresholds.2.color", "value": "0EC9AC" }, { "type": 1, "name": "thresholds.2.threshold", "value": "100000" }, { "type": 0, "name": "th_show_labels", "value": 1 }, { "type": 0, "name": "th_show_arc", "value": 1 }, { "type": 0, "name": "th_arc_size", "value": 15 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### *Gauge* logrīka konfigurēšana Konfigurējiet *Gauge* logrīku, kas attēlo vienuma vērtību vienumam "44474" (Saskarne enp0s3: Nosūtītie biti). Papildus vizuāli pielāgojiet logrīku, izmantojot vairākas papildu opcijas, tostarp sliekšņus. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "gauge", "name": "Gauge", "x": 0, "y": 0, "width": 18, "height": 5, "view_mode": 0, "fields": [ { "type": 4, "name": "itemid.0", "value": 44474 }, { "type": 1, "name": "min", "value": "100000" }, { "type": 1, "name": "max", "value": "1000000" }, { "type": 0, "name": "show.0", "value": 1 }, { "type": 0, "name": "show.1", "value": 2 }, { "type": 0, "name": "show.2", "value": 3 }, { "type": 0, "name": "show.4", "value": 4 }, { "type": 0, "name": "show.5", "value": 5 }, { "type": 0, "name": "angle", "value": 270 }, { "type": 0, "name": "desc_size", "value": 10 }, { "type": 0, "name": "desc_bold", "value": 1 }, { "type": 0, "name": "decimal_places", "value": 0 }, { "type": 0, "name": "value_bold", "value": 1 }, { "type": 0, "name": "units_size", "value": 15 }, { "type": 0, "name": "units_pos", "value": 3 }, { "type": 1, "name": "needle_color", "value": "3C3C3C" }, { "type": 1, "name": "thresholds.0.color", "value": "FF465C" }, { "type": 1, "name": "thresholds.0.threshold", "value": "700000" }, { "type": 1, "name": "thresholds.1.color", "value": "FFD54F" }, { "type": 1, "name": "thresholds.1.threshold", "value": "500000" }, { "type": 1, "name": "thresholds.2.color", "value": "0EC9AC" }, { "type": 1, "name": "thresholds.2.threshold", "value": "100000" }, { "type": 0, "name": "th_show_labels", "value": 1 }, { "type": 0, "name": "th_show_arc", "value": 1 }, { "type": 0, "name": "th_arc_size", "value": 15 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring agent Both generations of Zabbix agents run as a Windows service. For Zabbix agent 2, replace *agentd* with *agent2* in the instructions below. You can run a single instance of Zabbix agent or multiple instances of the agent on a Microsoft Windows host. A single instance may use either: - the default configuration file, located in the same directory as the agent binary; - a configuration file specified in the command line. In case of multiple instances each agent instance must have its own configuration file (one of the instances can use the default configuration file). An example configuration file is available in the Zabbix source archive as: - `conf/zabbix_agentd.conf` for Zabbix agent; - `conf/zabbix_agent2.conf` for Zabbix agent2. If you want to install Zabbix agent/agent 2 for Windows as a service from an [archive](https://www.zabbix.com/download_agents) without specifying the configuration file explicitly, then, before installing the agent: - `conf/zabbix_agentd.conf` should be copied manually to the directory where zabbix_agentd.exe will be installed; - `conf/zabbix_agent2.conf` and the `conf/zabbix_agent2.d` directory should be copied manually to the directory where zabbix_agent2.exe will be installed. See the [configuration file](/manual/appendix/config/zabbix_agentd_win) options for details on configuring Zabbix Windows agent. #### 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. #### Configuring a *Geomap* widget Configure a *Geomap* widget that displays hosts from host groups "2" and "22" based on the following tag configuration: tag with the name "component" contains value "node", and tag with the name "location" equals value "New York". In addition, set the map initial view to coordinates "40.6892494" (latitude), "-74.0466891" (longitude) with the zoom level "10". [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "geomap", "name": "Geomap", "x": 0, "y": 0, "width": 36, "height": 5, "view_mode": 0, "fields": [ { "type": 2, "name": "groupids.0", "value": 22 }, { "type": 2, "name": "groupids.1", "value": 2 }, { "type": 1, "name": "default_view", "value": "40.6892494,-74.0466891,10" }, { "type": 0, "name": "evaltype", "value": 2 }, { "type": 1, "name": "tags.0.tag", "value": "component" }, { "type": 0, "name": "tags.0.operator", "value": 0 }, { "type": 1, "name": "tags.0.value", "value": "node" }, { "type": 1, "name": "tags.1.tag", "value": "location" }, { "type": 0, "name": "tags.1.operator", "value": 1 }, { "type": 1, "name": "tags.1.value", "value": "New York" } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### *Geomap* logrīka konfigurēšana Konfigurējiet *Geomap* logrīku, kas attēlo hostus no hostu grupām "2" un "22", pamatojoties uz šādu birku konfigurāciju: birka ar nosaukumu "component" satur vērtību "node", un birka ar nosaukumu "location" ir vienāda ar vērtību "New York". Papildus iestatiet kartes sākotnējo skatu uz koordinātām "40.6892494" (platums), "-74.0466891" (garums) ar tālummaiņas līmeni "10". [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "geomap", "name": "Geomap", "x": 0, "y": 0, "width": 36, "height": 5, "view_mode": 0, "fields": [ { "type": 2, "name": "groupids.0", "value": 22 }, { "type": 2, "name": "groupids.1", "value": 2 }, { "type": 1, "name": "default_view", "value": "40.6892494,-74.0466891,10" }, { "type": 0, "name": "evaltype", "value": 2 }, { "type": 1, "name": "tags.0.tag", "value": "component" }, { "type": 0, "name": "tags.0.operator", "value": 0 }, { "type": 1, "name": "tags.0.value", "value": "node" }, { "type": 1, "name": "tags.1.tag", "value": "location" }, { "type": 0, "name": "tags.1.operator", "value": 1 }, { "type": 1, "name": "tags.1.value", "value": "New York" } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring a global script {width="600"} ::: noteclassic It is recommended to use [macro functions](/manual/config/macros/macro_functions) instead of plain macros in global scripts to enhance security, as macros are not automatically escaped. ::: Script attributes: |Parameter|<|Description| |-|----------|----------------------------------------| |*Name*|<|Unique name of the script.<br>E.g., `Clear /tmp filesystem`| |*Scope*|<|Scope of the script - action operation, manual host action or manual event action. This setting determines where the script can be used - in remote commands of action [operations](/manual/config/notifications/action/operation), from the [host menu](/manual/web_interface/menu/host_menu) or from the [event menu](/manual/web_interface/menu/event_menu) respectively.<br>Setting the scope to 'Action operation' makes the script available for all users with access to *Alerts* > *Actions*.<br>If a script is actually used in an action, its scope cannot be changed away from 'action operation'.<br>**Macro support**<br>The scope affects the range of available macros. For example, user-related macros (`{USER.*}`) are supported in scripts to allow passing information about the user that launched the script. However, they are not supported if the script scope is action operation, as action operations are executed automatically.<br>A {MANUALINPUT} macro allows to specify manual input at script execution time. It is supported for manual host action and manual event action scripts.<br>To find out which other macros are supported, do a search for 'Trigger-based notifications and commands/Trigger-based commands', 'Manual host action scripts' and 'Manual event action scripts' in the [supported macro](/manual/appendix/macros/supported_by_location) table. Note that if a macro may resolve to a value with spaces (for example, host name), don't forget to quote as needed.| |*Menu path*|<|The desired menu path to the script. For example, `Default` or `Default/`, will display the script in the respective directory. Menus can be nested, e.g., `Main menu/Sub menu1/Sub menu2`. When accessing scripts through the host/event menu in monitoring sections, they will be organized according to the given directories.<br>This field is displayed only if 'Manual host action' or 'Manual event action' is selected as *Scope*.| |*Type*|<|Click the respective button to select script type:<br>**URL**, **Webhook**, **Script**, **SSH**, **Telnet** or **[IPMI](/manual/config/notifications/action/operation/remote_command#ipmi-remote-commands)** command.<br> The type **URL** is available only when 'Manual host action' or 'Manual event action' is selected as *Scope*.| | |Script type: **URL**|<| |^|*URL*|Specify the URL for quick access from the [host menu](/manual/web_interface/menu/host_menu) or [event menu](/manual/web_interface/menu/event_menu).<br>[Macros](/manual/appendix/macros/supported_by_location) and custom [user macros](/manual/config/macros/user_macros) are supported. Macro support depends on the scope of the script (see *Scope* above).<br>Use the {MANUALINPUT} macro in this field to be able to specify manual input at script execution time, for example:<br>`http://{MANUALINPUT}/zabbix/zabbix.php?action=dashboard.view`<br>Macro values must not be URL-encoded. | |^|*Open in new window*|Determines whether the URL should be opened in a new or the same browser tab.| | |Script type: **Webhook**|<| |^|*Parameters*|Specify the webhook variables as attribute-value pairs.<br>See also: [Webhook](/manual/config/notifications/media/webhook) media configuration.<br>[Macros](/manual/appendix/macros/supported_by_location) and custom [user macros](/manual/config/macros/user_macros) are supported in parameter values. Macro support depends on the scope of the script (see *Scope* above).| |^|*Script*|Enter the JavaScript code in the modal editor that opens when clicking in the parameter field or on the pencil icon next to it.<br>Macro support depends on the scope of the script (see *Scope* above).<br>See also: [Webhook](/manual/config/notifications/media/webhook) media configuration, [Additional Javascript objects](/manual/config/items/preprocessing/javascript/javascript_objects).| |^|*Timeout*|JavaScript execution timeout (1-60s, default 30s).<br>Time suffixes are supported, e.g. 30s, 1m.| | |Script type: **Script**|<| |^|*Execute on*|Click the respective button to execute the shell script on:<br>**Zabbix agent** - the script will be executed by Zabbix agent (if the system.run item is [allowed](/manual/config/items/restrict_checks)) on the host<br>**Zabbix proxy or server** - the script will be executed by Zabbix proxy or server - depending on whether the host is monitored by proxy or server.<br>It will be executed on the proxy if enabled by [EnableRemoteCommands](/manual/appendix/config/zabbix_proxy#enableremotecommands).<br>It will be executed on the server if global scripts are enabled by the [EnableGlobalScripts](/manual/appendix/config/zabbix_server#enableglobalscripts) server parameter.<br>**Zabbix server** - the script will be executed by Zabbix server only.<br>This option will not be available if global scripts are disabled by the [EnableGlobalScripts](/manual/appendix/config/zabbix_server#enableglobalscripts) server parameter.| |^|*Commands*|Enter full path to the commands to be executed within the script.<br>Macro support depends on the scope of the script (see *Scope* above). Custom [user macros](/manual/config/macros/user_macros) are supported.| | |Script type: **SSH**|<| |^|*Authentication method*|Select authentication method - password or public key.| |^|*Username*|Enter the username.| |^|*Password*|Enter the password.<br>This field is available if 'Password' is selected as the authentication method.| |^|*Public key file*|Enter the path to the public key file.<br>This field is available if 'Public key' is selected as the authentication method.| |^|*Private key file*|Enter the path to the private key file.<br>This field is available if 'Public key' is selected as the authentication method.| |^|*Passphrase*|Enter the passphrase.<br>This field is available if 'Public key' is selected as the authentication method.| |^|*Port*|Enter the remote SSH service port on the target host that Zabbix will connect to.| |^|*Commands*|Enter the commands.<br>Macro support depends on the scope of the script (see *Scope* above). Custom [user macros](/manual/config/macros/user_macros) are supported.| | |Script type: **Telnet**|<| |^|*Username*|Enter the username.| |^|*Password*|Enter the password.| |^|*Port*|Enter the remote Telnet service port on the target host that Zabbix will connect to.| |^|*Commands*|Enter the commands.<br>Macro support depends on the scope of the script (see *Scope* above). Custom [user macros](/manual/config/macros/user_macros) are supported.| | |Script type: **IPMI**|<| |^|*Command*|Enter the IPMI command.<br>Macro support depends on the scope of the script (see *Scope* above). Custom [user macros](/manual/config/macros/user_macros) are supported.| |*Description*|<|Enter a description for the script.| |*Host group*|<|Select the host group that the script will be available for (or *All* for all host groups).| |*User group*|<|Select the user group that the script will be available to (or *All* for all user groups).<br>This field is displayed only if 'Manual host action' or 'Manual event action' is selected as *Scope*.| |*Required host permissions*|<|Select the permission level for the host group - *Read* or *Write*. Only users with the required permission level will have access to executing the script.<br>This field is displayed only if 'Manual host action' or 'Manual event action' is selected as *Scope*.| |*Advanced configuration*|<|Click on the *Advanced configuration* header to display [advanced configuration](#advanced-configuration) options.<br>This field is displayed only if 'Manual host action' or 'Manual event action' is selected as *Scope*.| #### Globāla skripta konfigurēšana {width="600"} ::: noteclassic Drošības uzlabošanai globālajos skriptos ieteicams izmantot [makro funkcijas](/manual/config/macros/macro_functions), nevis vienkāršus makro, jo makro netiek automātiski ekrānēti. ::: Skripta atribūti: |Parameter|<|Description| |-|----------|----------------------------------------| |*Name*|<|Skripta unikālais nosaukums.<br>Piem., `Clear /tmp filesystem`| |*Scope*|<|Skripta tvērums - darbības operācija, manuāla hosts darbība vai manuāla notikuma darbība. Šis iestatījums nosaka, kur skriptu var izmantot - attālinātajās komandās darbības [operācijām](/manual/config/notifications/action/operation), no [hosts izvēlnes](/manual/web_interface/menu/host_menu) vai no [notikumu izvēlnes](/manual/web_interface/menu/event_menu) attiecīgi.<br>Iestatot tvērumu uz 'Action operation', skripts būs pieejams visiem lietotājiem ar piekļuvi *Alerts* > *Actions*.<br>Ja skripts faktiski tiek izmantots darbībā, tā tvērumu vairs nevar mainīt prom no 'action operation'.<br>**Makro atbalsts**<br>Tvērums ietekmē pieejamo makro diapazonu. Piemēram, ar lietotāju saistītie makro (`{USER.*}`) tiek atbalstīti skriptos, lai varētu nodot informāciju par lietotāju, kurš palaida skriptu. Tomēr tie netiek atbalstīti, ja skripta tvērums ir action operation, jo darbības operācijas tiek izpildītas automātiski.<br>Makro {MANUALINPUT} ļauj norādīt manuālu ievadi skripta izpildes laikā. Tas tiek atbalstīts manuālas hosts darbības un manuālas notikuma darbības skriptos.<br>Lai uzzinātu, kuri citi makro tiek atbalstīti, meklējiet tabulā [supported macro](/manual/appendix/macros/supported_by_location) 'Trigger-based notifications and commands/Trigger-based commands', 'Manual host action scripts' un 'Manual event action scripts'. Ņemiet vērā: ja makro var tikt aizstāts ar vērtību, kurā ir atstarpes (piemēram, hosts nosaukums), neaizmirstiet to attiecīgi ievietot pēdiņās.| |*Menu path*|<|Vēlamais izvēlnes ceļš uz skriptu. Piemēram, `Default` vai `Default/` parādīs skriptu attiecīgajā direktorijā. Izvēlnes var būt ligzdotas, piemēram, `Main menu/Sub menu1/Sub menu2`. Piekļūstot skriptiem caur hosts/notikumu izvēlni uzraudzības sadaļās, tie tiks sakārtoti atbilstoši norādītajām direktorijām.<br>Šis lauks tiek rādīts tikai tad, ja kā *Scope* ir atlasīts 'Manual host action' vai 'Manual event action'.| |*Type*|<|Noklikšķiniet uz attiecīgās pogas, lai atlasītu skripta tipu:<br>**URL**, **Webhook**, **Script**, **SSH**, **Telnet** vai **[IPMI](/manual/config/notifications/action/operation/remote_command#ipmi-remote-commands)** komandu.<br> Tips **URL** ir pieejams tikai tad, ja kā *Scope* ir atlasīts 'Manual host action' vai 'Manual event action'.| | |Script type: **URL**|<| |^|*URL*|Norādiet URL ātrai piekļuvei no [hosts izvēlnes](/manual/web_interface/menu/host_menu) vai [notikumu izvēlnes](/manual/web_interface/menu/event_menu).<br>Tiek atbalstīti [makro](/manual/appendix/macros/supported_by_location) un pielāgoti [lietotāja makro](/manual/config/macros/user_macros). Makro atbalsts ir atkarīgs no skripta tvēruma (skatiet *Scope* iepriekš).<br>Šajā laukā izmantojiet makro {MANUALINPUT}, lai skripta izpildes laikā varētu norādīt manuālu ievadi, piemēram:<br>`http://{MANUALINPUT}/zabbix/zabbix.php?action=dashboard.view`<br>Makro vērtības nedrīkst būt URL kodētas. | |^|*Open in new window*|Nosaka, vai URL jāatver jaunā vai tajā pašā pārlūkprogrammas cilnē.| | |Script type: **Webhook**|<| |^|*Parameters*|Norādiet webhook mainīgos kā atribūtu-vērtību pārus.<br>Skatiet arī: [Webhook](/manual/config/notifications/media/webhook) multivides konfigurāciju.<br>Parametru vērtībās tiek atbalstīti [makro](/manual/appendix/macros/supported_by_location) un pielāgoti [lietotāja makro](/manual/config/macros/user_macros). Makro atbalsts ir atkarīgs no skripta tvēruma (skatiet *Scope* iepriekš).| |^|*Script*|Ievadiet JavaScript kodu modālajā redaktorā, kas atveras, noklikšķinot parametra laukā vai uz blakus esošās zīmuļa ikonas.<br>Makro atbalsts ir atkarīgs no skripta tvēruma (skatiet *Scope* iepriekš).<br>Skatiet arī: [Webhook](/manual/config/notifications/media/webhook) multivides konfigurāciju, [Papildu Javascript objekti](/manual/config/items/preprocessing/javascript/javascript_objects).| |^|*Timeout*|JavaScript izpildes noildze (1-60 s, noklusējums 30 s).<br>Tiek atbalstīti laika sufiksi, piemēram, 30s, 1m.| | |Script type: **Script**|<| |^|*Execute on*|Noklikšķiniet uz attiecīgās pogas, lai izpildītu čaulas skriptu uz:<br>**Zabbix aģents** - skriptu izpildīs Zabbix aģents (ja system.run vienums ir [atļauts](/manual/config/items/restrict_checks)) uz hosta<br>**Zabbix starpniekserveris vai serveris** - skriptu izpildīs Zabbix starpniekserveris vai serveris - atkarībā no tā, vai hosts tiek uzraudzīts ar starpniekserveri vai serveri.<br>To izpildīs starpniekserveris, ja tas ir iespējots ar [EnableRemoteCommands](/manual/appendix/config/zabbix_proxy#enableremotecommands).<br>To izpildīs serveris, ja globālie skripti ir iespējoti ar servera parametru [EnableGlobalScripts](/manual/appendix/config/zabbix_server#enableglobalscripts).<br>**Zabbix serveris** - skriptu izpildīs tikai Zabbix serveris.<br>Šī opcija nebūs pieejama, ja globālie skripti ir atspējoti ar servera parametru [EnableGlobalScripts](/manual/appendix/config/zabbix_server#enableglobalscripts).| |^|*Commands*|Ievadiet pilnu izpildāmo komandu ceļu skripta ietvaros.<br>Makro atbalsts ir atkarīgs no skripta tvēruma (skatiet *Scope* iepriekš). Tiek atbalstīti pielāgoti [lietotāja makro](/manual/config/macros/user_macros).| | |Script type: **SSH**|<| |^|*Authentication method*|Atlasiet autentifikācijas metodi - parole vai publiskā atslēga.| |^|*Username*|Ievadiet lietotājvārdu.| |^|*Password*|Ievadiet paroli.<br>Šis lauks ir pieejams, ja kā autentifikācijas metode ir atlasīta 'Password'.| |^|*Public key file*|Ievadiet publiskās atslēgas faila ceļu.<br>Šis lauks ir pieejams, ja kā autentifikācijas metode ir atlasīta 'Public key'.| |^|*Private key file*|Ievadiet privātās atslēgas faila ceļu.<br>Šis lauks ir pieejams, ja kā autentifikācijas metode ir atlasīta 'Public key'.| |^|*Passphrase*|Ievadiet ieejas frāzi.<br>Šis lauks ir pieejams, ja kā autentifikācijas metode ir atlasīta 'Public key'.| |^|*Port*|Ievadiet attālā SSH pakalpojuma portu mērķa hostā, ar kuru Zabbix izveidos savienojumu.| |^|*Commands*|Ievadiet komandas.<br>Makro atbalsts ir atkarīgs no skripta tvēruma (skatiet *Scope* iepriekš). Tiek atbalstīti pielāgoti [lietotāja makro](/manual/config/macros/user_macros).| | |Script type: **Telnet**|<| |^|*Username*|Ievadiet lietotājvārdu.| |^|*Password*|Ievadiet paroli.| |^|*Port*|Ievadiet attālā Telnet pakalpojuma portu mērķa hostā, ar kuru Zabbix izveidos savienojumu.| |^|*Commands*|Ievadiet komandas.<br>Makro atbalsts ir atkarīgs no skripta tvēruma (skatiet *Scope* iepriekš). Tiek atbalstīti pielāgoti [lietotāja makro](/manual/config/macros/user_macros).| | |Script type: **IPMI**|<| |^|*Command*|Ievadiet IPMI komandu.<br>Makro atbalsts ir atkarīgs no skripta tvēruma (skatiet *Scope* iepriekš). Tiek atbalstīti pielāgoti [lietotāja makro](/manual/config/macros/user_macros).| |*Description*|<|Ievadiet skripta aprakstu.| |*Host group*|<|Atlasiet hostu grupu, kurai skripts būs pieejams (vai *All* visām hostu grupām).| |*User group*|<|Atlasiet lietotāju grupu, kurai skripts būs pieejams (vai *All* visām lietotāju grupām).<br>Šis lauks tiek rādīts tikai tad, ja kā *Scope* ir atlasīts 'Manual host action' vai 'Manual event action'.| |*Required host permissions*|<|Atlasiet hostu grupas atļauju līmeni - *Read* vai *Write*. Tikai lietotājiem ar nepieciešamo atļauju līmeni būs piekļuve skripta izpildei.<br>Šis lauks tiek rādīts tikai tad, ja kā *Scope* ir atlasīts 'Manual host action' vai 'Manual event action'.| |*Advanced configuration*|<|Noklikšķiniet uz virsraksta *Advanced configuration*, lai parādītu [papildu konfigurācijas](#advanced-configuration) opcijas.<br>Šis lauks tiek rādīts tikai tad, ja kā *Scope* ir atlasīts 'Manual host action' vai 'Manual event action'.| #### Configuring a *Graph (classic)* widget Configure a *Graph (classic)* widget that displays a simple graph for the item "42269". [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "graph", "name": "Graph (classic)", "x": 0, "y": 0, "width": 36, "height": 5, "view_mode": 0, "fields": [ { "type": 0, "name": "source_type", "value": 1 }, { "type": 4, "name": "itemid.0", "value": 42269 }, { "type": 1, "name": "reference", "value": "RSTUV" } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### *Graph (classic)* logrīka konfigurēšana Konfigurējiet *Graph (classic)* logrīku, kas attēlo vienkāršu grafiku vienumam "42269". [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "graph", "name": "Graph (classic)", "x": 0, "y": 0, "width": 36, "height": 5, "view_mode": 0, "fields": [ { "type": 0, "name": "source_type", "value": 1 }, { "type": 4, "name": "itemid.0", "value": 42269 }, { "type": 1, "name": "reference", "value": "RSTUV" } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring a *Graph prototype* widget Configure a *Graph prototype* widget that displays a grid of 3 graphs (3 columns, 1 row) created from an item prototype (ID: "42316") by low-level discovery. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "graphprototype", "name": "Graph prototype", "x": 0, "y": 0, "width": 48, "height": 5, "view_mode": 0, "fields": [ { "type": 0, "name": "source_type", "value": 3 }, { "type": 5, "name": "itemid.0", "value": 42316 }, { "type": 0, "name": "columns", "value": 3 }, { "type": 1, "name": "reference", "value": "OPQWX" } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### *Graph prototype* logrīka konfigurēšana Konfigurējiet *Graph prototype* logrīku, kas attēlo 3 grafiku režģi (3 kolonnas, 1 rinda), kas izveidoti no vienuma prototipa (ID: "42316"), izmantojot zema līmeņa atklāšanu. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "graphprototype", "name": "Graph prototype", "x": 0, "y": 0, "width": 48, "height": 5, "view_mode": 0, "fields": [ { "type": 0, "name": "source_type", "value": 3 }, { "type": 5, "name": "itemid.0", "value": 42316 }, { "type": 0, "name": "columns", "value": 3 }, { "type": 1, "name": "reference", "value": "OPQWX" } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring a *Graph* widget Configure a *Graph* widget in the following way: - 2 data sets for a total of 9 items on 1 host. - The first data set is of type "Item list" and consists of 3 items that are represented by lines with a different color, but the same width, transparency, and fill. - The second data set is of type "Item patterns", consists of 6 items, has a configured aggregation, and is represented by a line with a custom color, width, transparency, and fill. - The second data set also has a custom data set label. - Data in the graph are displayed for a time period of the last 3 hours. - Problems in the graph are displayed only for the configured items. - Graph has two Y axes of which the right Y axis displays values only for the second data set. - Graph legend displays configured items in 4 rows, as well as minimum, maximum and average values of the data sets. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "svggraph", "name": "Graph", "x": 0, "y": 0, "width": 36, "height": 5, "view_mode": 0, "fields": [ { "type": 0, "name": "ds.0.dataset_type", "value": 0 }, { "type": 4, "name": "ds.0.itemids.0", "value": 23264 }, { "type": 1, "name": "ds.0.color.0", "value": "FF0000" }, { "type": 4, "name": "ds.0.itemids.1", "value": 23269 }, { "type": 1, "name": "ds.0.color.1", "value": "BF00FF" }, { "type": 4, "name": "ds.0.itemids.2", "value": 23257 }, { "type": 1, "name": "ds.0.color.2", "value": "0040FF" }, { "type": 0, "name": "ds.0.width", "value": 3 }, { "type": 0, "name": "ds.0.transparency", "value": 3 }, { "type": 0, "name": "ds.0.fill", "value": 1 }, { "type": 1, "name": "ds.1.hosts.0", "value": "Zabbix server" }, { "type": 1, "name": "ds.1.items.0", "value": "*: Number of processed *values per second" }, { "type": 1, "name": "ds.1.color", "value": "000000" }, { "type": 0, "name": "ds.1.transparency", "value": 0 }, { "type": 0, "name": "ds.1.fill", "value": 0 }, { "type": 0, "name": "ds.1.axisy", "value": 1 }, { "type": 0, "name": "ds.1.aggregate_function", "value": 3 }, { "type": 1, "name": "ds.1.aggregate_interval", "value": "1m" }, { "type": 0, "name": "ds.1.aggregate_grouping", "value": 1 }, { "type": 1, "name": "ds.1.data_set_label", "value": "Number of processed values per second" }, { "type": 0, "name": "graph_time", "value": 1 }, { "type": 1, "name": "time_period.from", "value": "now-3h" }, { "type": 1, "name": "time_period.to", "value": "now" }, { "type": 0, "name": "legend_statistic", "value": 1 }, { "type": 0, "name": "legend_lines", "value": 4 }, { "type": 0, "name": "show_problems", "value": 1 }, { "type": 1, "name": "reference", "value": "YZABC" } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### *Graph* logrīka konfigurēšana Konfigurējiet *Graph* logrīku šādi: - 2 datu kopas ar kopumā 9 vienumiem 1 hostā. - Pirmā datu kopa ir tipa "Item list" un sastāv no 3 vienumiem, kas ir attēloti kā līnijas ar atšķirīgu krāsu, bet vienādu platumu, caurspīdīgumu un aizpildījumu. - Otrā datu kopa ir tipa "Item patterns", sastāv no 6 vienumiem, tai ir konfigurēta agregācija, un tā ir attēlota kā līnija ar pielāgotu krāsu, platumu, caurspīdīgumu un aizpildījumu. - Otrajai datu kopai ir arī pielāgota datu kopas etiķete. - Dati grafikā tiek attēloti par pēdējo 3 stundu periodu. - Problēmas grafikā tiek attēlotas tikai konfigurētajiem vienumiem. - Grafikam ir divas Y asis, no kurām labā Y ass attēlo vērtības tikai otrajai datu kopai. - Grafika leģenda attēlo konfigurētos vienumus 4 rindās, kā arī datu kopu minimālās, maksimālās un vidējās vērtības. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "svggraph", "name": "Graph", "x": 0, "y": 0, "width": 36, "height": 5, "view_mode": 0, "fields": [ { "type": 0, "name": "ds.0.dataset_type", "value": 0 }, { "type": 4, "name": "ds.0.itemids.0", "value": 23264 }, { "type": 1, "name": "ds.0.color.0", "value": "FF0000" }, { "type": 4, "name": "ds.0.itemids.1", "value": 23269 }, { "type": 1, "name": "ds.0.color.1", "value": "BF00FF" }, { "type": 4, "name": "ds.0.itemids.2", "value": 23257 }, { "type": 1, "name": "ds.0.color.2", "value": "0040FF" }, { "type": 0, "name": "ds.0.width", "value": 3 }, { "type": 0, "name": "ds.0.transparency", "value": 3 }, { "type": 0, "name": "ds.0.fill", "value": 1 }, { "type": 1, "name": "ds.1.hosts.0", "value": "Zabbix server" }, { "type": 1, "name": "ds.1.items.0", "value": "*: Number of processed *values per second" }, { "type": 1, "name": "ds.1.color", "value": "000000" }, { "type": 0, "name": "ds.1.transparency", "value": 0 }, { "type": 0, "name": "ds.1.fill", "value": 0 }, { "type": 0, "name": "ds.1.axisy", "value": 1 }, { "type": 0, "name": "ds.1.aggregate_function", "value": 3 }, { "type": 1, "name": "ds.1.aggregate_interval", "value": "1m" }, { "type": 0, "name": "ds.1.aggregate_grouping", "value": 1 }, { "type": 1, "name": "ds.1.data_set_label", "value": "Number of processed values per second" }, { "type": 0, "name": "graph_time", "value": 1 }, { "type": 1, "name": "time_period.from", "value": "now-3h" }, { "type": 1, "name": "time_period.to", "value": "now" }, { "type": 0, "name": "legend_statistic", "value": 1 }, { "type": 0, "name": "legend_lines", "value": 4 }, { "type": 0, "name": "show_problems", "value": 1 }, { "type": 1, "name": "reference", "value": "YZABC" } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring a *Honeycomb* widget Configure a *Honeycomb* widget that displays the utilization of Zabbix server processes. In addition, change the primary label of honeycomb cells and visually fine-tune the widget with thresholds. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": "30", "auto_start": "1", "pages": [ { "widgets": [ { "type": "honeycomb", "name": "Honeycomb", "x": "0", "y": "0", "width": "24", "height": "5", "view_mode": "0", "fields": [ { "type": 2, "name": "groupids.0", "value": 4 }, { "type": 3, "name": "hostids.0", "value": 10084 }, { "type": 1, "name": "items.0", "value": "Zabbix server: Utilization*" }, { "type": 1, "name": "primary_label", "value": "{ITEM.NAME}" }, { "type": 1, "name": "thresholds.0.color", "value": "0EC9AC" }, { "type": 1, "name": "thresholds.0.threshold", "value": "0" }, { "type": 1, "name": "thresholds.1.color", "value": "FFD54F" }, { "type": 1, "name": "thresholds.1.threshold", "value": "70" }, { "type": 1, "name": "thresholds.2.color", "value": "FF465C" }, { "type": 1, "name": "thresholds.2.threshold", "value": "90" }, { "type": 1, "name": "reference", "value": "KSTMQ" } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### *Honeycomb* logrīka konfigurēšana Konfigurējiet *Honeycomb* logrīku, kas attēlo Zabbix servera procesu noslodzi. Papildus mainiet honeycomb šūnu primāro etiķeti un vizuāli precizējiet logrīku ar sliekšņiem. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": "30", "auto_start": "1", "pages": [ { "widgets": [ { "type": "honeycomb", "name": "Honeycomb", "x": "0", "y": "0", "width": "24", "height": "5", "view_mode": "0", "fields": [ { "type": 2, "name": "groupids.0", "value": 4 }, { "type": 3, "name": "hostids.0", "value": 10084 }, { "type": 1, "name": "items.0", "value": "Zabbix server: Utilization*" }, { "type": 1, "name": "primary_label", "value": "{ITEM.NAME}" }, { "type": 1, "name": "thresholds.0.color", "value": "0EC9AC" }, { "type": 1, "name": "thresholds.0.threshold", "value": "0" }, { "type": 1, "name": "thresholds.1.color", "value": "FFD54F" }, { "type": 1, "name": "thresholds.1.threshold", "value": "70" }, { "type": 1, "name": "thresholds.2.color", "value": "FF465C" }, { "type": 1, "name": "thresholds.2.threshold", "value": "90" }, { "type": 1, "name": "reference", "value": "KSTMQ" } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring a *Host availability* widget Configure a *Host availability* widget that displays availability information (in a vertical layout) for hosts in host group "4" with "Zabbix agent" and "SNMP" interfaces configured. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "hostavail", "name": "Host availability", "x": 0, "y": 0, "width": 18, "height": 3, "view_mode": 0, "fields": [ { "type": 2, "name": "groupids.0", "value": 4 }, { "type": 0, "name": "interface_type", "value": 1 }, { "type": 0, "name": "interface_type", "value": 2 }, { "type": 0, "name": "layout", "value": 1 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### *Host availability* logrīka konfigurēšana Konfigurējiet *Host availability* logrīku, kas attēlo pieejamības informāciju (vertikālā izkārtojumā) hostiem hostu grupā "4", kuriem ir konfigurētas "Zabbix aģents" un "SNMP" saskarnes. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "hostavail", "name": "Host availability", "x": 0, "y": 0, "width": 18, "height": 3, "view_mode": 0, "fields": [ { "type": 2, "name": "groupids.0", "value": 4 }, { "type": 0, "name": "interface_type", "value": 1 }, { "type": 0, "name": "interface_type", "value": 2 }, { "type": 0, "name": "layout", "value": 1 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring a *Host navigator* widget Configure a *Host navigator* widget that displays hosts grouped by their host group and, then, by the "city" tag value. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": "30", "auto_start": "1", "pages": [ { "widgets": [ { "type": "hostnavigator", "name": "Host navigator", "x": "0", "y": "0", "width": "12", "height": "5", "view_mode": "0", "fields": [ { "type": 2, "name": "groupids.0", "value": 2 }, { "type": 2, "name": "groupids.1", "value": 4 }, { "type": 0, "name": "group_by.0.attribute", "value": 0 }, { "type": 0, "name": "group_by.1.attribute", "value": 1 }, { "type": 1, "name": "group_by.1.tag_name", "value": "city" }, { "type": 1, "name": "reference", "value": "SWKLB" } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### *Host navigator* logrīka konfigurēšana Konfigurējiet *Host navigator* logrīku, kas attēlo hostus, grupētus vispirms pēc to hostu grupas un pēc tam pēc birkas "city" vērtības. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": "30", "auto_start": "1", "pages": [ { "widgets": [ { "type": "hostnavigator", "name": "Host navigator", "x": "0", "y": "0", "width": "12", "height": "5", "view_mode": "0", "fields": [ { "type": 2, "name": "groupids.0", "value": 2 }, { "type": 2, "name": "groupids.1", "value": 4 }, { "type": 0, "name": "group_by.0.attribute", "value": 0 }, { "type": 0, "name": "group_by.1.attribute", "value": 1 }, { "type": 1, "name": "group_by.1.tag_name", "value": "city" }, { "type": 1, "name": "reference", "value": "SWKLB" } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring alert actions Actions determine which notifications should be sent via the webhook. Steps for [configuring actions](/manual/config/notifications/action) involving webhooks are the same as for all other media types with these exceptions: - If a webhook uses [webhook tags](https://www.zabbix.com/documentation/guidelines/en/webhooks#webhook-tags) to store ticket\\message ID and handle update\\resolve operations, avoid using the same webhook in multiple alert actions for a single problem event. If {EVENT.TAGS.<tag name>} exists and gets updated in the webhook, its resulting value will be undefined. To avoid this, use a new tag name in the webhook for storing updated values. This applies to Jira, Jira Service Desk, Mattermost, Opsgenie, OTRS, Redmine, ServiceNow, Slack, Zammad, and Zendesk webhooks provided by Zabbix and to most webhooks utilizing the *Include event menu entry* option. Note, however, that a single webhook can be used in multiple operations or escalation steps of the same action, as well as in different actions that will not be triggered by the same problem event due to different [conditions](/manual/config/notifications/action/conditions). - When using a webhook in actions for [internal events](/manual/config/events/sources#internal-events), ensure to mark the *Custom message* checkbox and define a custom message in the action operation configuration. Otherwise, a notification will not be sent. #### Brīdinājumu darbību konfigurēšana Darbības nosaka, kuri paziņojumi jānosūta, izmantojot webhook. Darbību [konfigurēšanas](/manual/config/notifications/action) soļi, kuros tiek izmantoti webhook, ir tādi paši kā visiem citiem mediju tipiem, izņemot šādus gadījumus: - Ja webhook izmanto [webhook tagus](https://www.zabbix.com/documentation/guidelines/en/webhooks#webhook-tags), lai saglabātu biļetes\\ziņojuma ID un apstrādātu atjaunināšanas\\atrisināšanas darbības, izvairieties no viena un tā paša webhook izmantošanas vairākās brīdinājumu darbībās vienam problēmas notikumam. Ja {EVENT.TAGS.<tag name>} pastāv un tiek atjaunināts webhook, tā iegūtā vērtība būs nedefinēta. Lai no tā izvairītos, izmantojiet webhook jaunu taga nosaukumu atjaunināto vērtību glabāšanai. Tas attiecas uz Jira, Jira Service Desk, Mattermost, Opsgenie, OTRS, Redmine, ServiceNow, Slack, Zammad un Zendesk webhook, ko nodrošina Zabbix, kā arī uz lielāko daļu webhook, kas izmanto opciju *Include event menu entry*. Tomēr ņemiet vērā, ka vienu webhook var izmantot vairākās vienas un tās pašas darbības operācijās vai eskalācijas soļos, kā arī dažādās darbībās, kuras netiks aktivizētas ar vienu un to pašu problēmas notikumu atšķirīgu [nosacījumu](/manual/config/notifications/action/conditions) dēļ. - Izmantojot webhook darbībās [iekšējiem notikumiem](/manual/config/events/sources#internal-events), noteikti atzīmējiet izvēles rūtiņu *Custom message* un definējiet pielāgotu ziņojumu darbības operācijas konfigurācijā. Pretējā gadījumā paziņojums netiks nosūtīts. #### Configuring a linked *Map* widget Configure a *Map* widget that is linked to a [*Map navigation tree*](/manual/api/reference/dashboard/widget_fields/map_tree#configuring-a-map-navigation-tree-widget) widget. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "map", "name": "Map", "x": 0, "y": 5, "width": 54, "height": 5, "view_mode": 0, "fields": [ { "type": 1, "name": "sysmapid._reference", "value": "ABCDE._mapid" } ] }, { "type": "navtree", "name": "Map navigation tree", "x": 0, "y": 0, "width": 18, "height": 5, "view_mode": 0, "fields": [ { "type": 1, "name": "navtree.1.name", "value": "Element A" }, { "type": 1, "name": "navtree.2.name", "value": "Element B" }, { "type": 1, "name": "navtree.3.name", "value": "Element C" }, { "type": 1, "name": "navtree.4.name", "value": "Element A1" }, { "type": 1, "name": "navtree.5.name", "value": "Element A2" }, { "type": 1, "name": "navtree.6.name", "value": "Element B1" }, { "type": 1, "name": "navtree.7.name", "value": "Element B2" }, { "type": 0, "name": "navtree.4.parent", "value": 1 }, { "type": 0, "name": "navtree.5.parent", "value": 1 }, { "type": 0, "name": "navtree.6.parent", "value": 2 }, { "type": 0, "name": "navtree.7.parent", "value": 2 }, { "type": 0, "name": "navtree.1.order", "value": 1 }, { "type": 0, "name": "navtree.2.order", "value": 2 }, { "type": 0, "name": "navtree.3.order", "value": 3 }, { "type": 0, "name": "navtree.4.order", "value": 1 }, { "type": 0, "name": "navtree.5.order", "value": 2 }, { "type": 0, "name": "navtree.6.order", "value": 1 }, { "type": 0, "name": "navtree.7.order", "value": 2 }, { "type": 8, "name": "navtree.6.sysmapid", "value": 1 }, { "type": 1, "name": "reference", "value": "ABCDE" } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Saistīta *Map* logrīka konfigurēšana Konfigurējiet *Map* logrīku, kas ir saistīts ar [*Map navigation tree*](/manual/api/reference/dashboard/widget_fields/map_tree#configuring-a-map-navigation-tree-widget) logrīku. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "map", "name": "Map", "x": 0, "y": 5, "width": 54, "height": 5, "view_mode": 0, "fields": [ { "type": 1, "name": "sysmapid._reference", "value": "ABCDE._mapid" } ] }, { "type": "navtree", "name": "Map navigation tree", "x": 0, "y": 0, "width": 18, "height": 5, "view_mode": 0, "fields": [ { "type": 1, "name": "navtree.1.name", "value": "Element A" }, { "type": 1, "name": "navtree.2.name", "value": "Element B" }, { "type": 1, "name": "navtree.3.name", "value": "Element C" }, { "type": 1, "name": "navtree.4.name", "value": "Element A1" }, { "type": 1, "name": "navtree.5.name", "value": "Element A2" }, { "type": 1, "name": "navtree.6.name", "value": "Element B1" }, { "type": 1, "name": "navtree.7.name", "value": "Element B2" }, { "type": 0, "name": "navtree.4.parent", "value": 1 }, { "type": 0, "name": "navtree.5.parent", "value": 1 }, { "type": 0, "name": "navtree.6.parent", "value": 2 }, { "type": 0, "name": "navtree.7.parent", "value": 2 }, { "type": 0, "name": "navtree.1.order", "value": 1 }, { "type": 0, "name": "navtree.2.order", "value": 2 }, { "type": 0, "name": "navtree.3.order", "value": 3 }, { "type": 0, "name": "navtree.4.order", "value": 1 }, { "type": 0, "name": "navtree.5.order", "value": 2 }, { "type": 0, "name": "navtree.6.order", "value": 1 }, { "type": 0, "name": "navtree.7.order", "value": 2 }, { "type": 8, "name": "navtree.6.sysmapid", "value": 1 }, { "type": 1, "name": "reference", "value": "ABCDE" } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring a *Map navigation tree* widget Configure a *Map navigation tree* widget that displays the following map navigation tree: - Element A - Element A1 - Element A2 - Element B - Element B1 (contains linked map "1" that can be displayed in a [linked *Map widget*](/manual/api/reference/dashboard/widget_fields/map#configuring-a-linked-map-widget)) - Element B2 - Element C [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "navtree", "name": "Map navigation tree", "x": 0, "y": 0, "width": 18, "height": 5, "view_mode": 0, "fields": [ { "type": 1, "name": "navtree.1.name", "value": "Element A" }, { "type": 1, "name": "navtree.2.name", "value": "Element B" }, { "type": 1, "name": "navtree.3.name", "value": "Element C" }, { "type": 1, "name": "navtree.4.name", "value": "Element A1" }, { "type": 1, "name": "navtree.5.name", "value": "Element A2" }, { "type": 1, "name": "navtree.6.name", "value": "Element B1" }, { "type": 1, "name": "navtree.7.name", "value": "Element B2" }, { "type": 0, "name": "navtree.4.parent", "value": 1 }, { "type": 0, "name": "navtree.5.parent", "value": 1 }, { "type": 0, "name": "navtree.6.parent", "value": 2 }, { "type": 0, "name": "navtree.7.parent", "value": 2 }, { "type": 0, "name": "navtree.1.order", "value": 1 }, { "type": 0, "name": "navtree.2.order", "value": 2 }, { "type": 0, "name": "navtree.3.order", "value": 3 }, { "type": 0, "name": "navtree.4.order", "value": 1 }, { "type": 0, "name": "navtree.5.order", "value": 2 }, { "type": 0, "name": "navtree.6.order", "value": 1 }, { "type": 0, "name": "navtree.7.order", "value": 2 }, { "type": 8, "name": "navtree.6.sysmapid", "value": 1 }, { "type": 1, "name": "reference", "value": "HJQXF" } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### *Kartes navigācijas koka* logrīka konfigurēšana Konfigurējiet *Kartes navigācijas koka* logrīku, kas attēlo šādu kartes navigācijas koku: - Elements A - Elements A1 - Elements A2 - Elements B - Elements B1 (satur saistīto karti "1", ko var attēlot [saistītā *Kartes logrīkā*](/manual/api/reference/dashboard/widget_fields/map#configuring-a-linked-map-widget)) - Elements B2 - Elements C [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "navtree", "name": "Map navigation tree", "x": 0, "y": 0, "width": 18, "height": 5, "view_mode": 0, "fields": [ { "type": 1, "name": "navtree.1.name", "value": "Element A" }, { "type": 1, "name": "navtree.2.name", "value": "Element B" }, { "type": 1, "name": "navtree.3.name", "value": "Element C" }, { "type": 1, "name": "navtree.4.name", "value": "Element A1" }, { "type": 1, "name": "navtree.5.name", "value": "Element A2" }, { "type": 1, "name": "navtree.6.name", "value": "Element B1" }, { "type": 1, "name": "navtree.7.name", "value": "Element B2" }, { "type": 0, "name": "navtree.4.parent", "value": 1 }, { "type": 0, "name": "navtree.5.parent", "value": 1 }, { "type": 0, "name": "navtree.6.parent", "value": 2 }, { "type": 0, "name": "navtree.7.parent", "value": 2 }, { "type": 0, "name": "navtree.1.order", "value": 1 }, { "type": 0, "name": "navtree.2.order", "value": 2 }, { "type": 0, "name": "navtree.3.order", "value": 3 }, { "type": 0, "name": "navtree.4.order", "value": 1 }, { "type": 0, "name": "navtree.5.order", "value": 2 }, { "type": 0, "name": "navtree.6.order", "value": 1 }, { "type": 0, "name": "navtree.7.order", "value": 2 }, { "type": 8, "name": "navtree.6.sysmapid", "value": 1 }, { "type": 1, "name": "reference", "value": "HJQXF" } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring a *Map* widget Configure a *Map* widget that displays the map "1". [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "map", "name": "Map", "x": 0, "y": 0, "width": 54, "height": 5, "view_mode": 0, "fields": [ { "type": 8, "name": "sysmapid.0", "value": 1 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### *Map* logrīka konfigurēšana Konfigurējiet *Map* logrīku, kas attēlo karti "1". [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "map", "name": "Map", "x": 0, "y": 0, "width": 54, "height": 5, "view_mode": 0, "fields": [ { "type": 8, "name": "sysmapid.0", "value": 1 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring an *Action log* widget Configure an *Action log* widget that displays 10 entries of action operation details, sorted by time (in ascending order). In addition, display details only for those action operations that attempted to send an email to user "1", but were unsuccessful. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "actionlog", "name": "Action log", "x": 0, "y": 0, "width": 36, "height": 5, "view_mode": 0, "fields": [ { "type": 0, "name": "show_lines", "value": 10 }, { "type": 0, "name": "sort_triggers", "value": 3 }, { "type": 11, "name": "userids.0", "value": 1 }, { "type": 13, "name": "mediatypeids.0", "value": 1 }, { "type": 0, "name": "statuses.0", "value": 2 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### *Darbību žurnāla* logrīka konfigurēšana Konfigurējiet *Darbību žurnāla* logrīku, kas attēlo 10 darbību operāciju detalizētus ierakstus, sakārtotus pēc laika (augošā secībā). Papildus attēlojiet detalizētu informāciju tikai par tām darbību operācijām, kurās tika mēģināts nosūtīt e-pastu lietotājam "1", bet tas neizdevās. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "actionlog", "name": "Action log", "x": 0, "y": 0, "width": 36, "height": 5, "view_mode": 0, "fields": [ { "type": 0, "name": "show_lines", "value": 10 }, { "type": 0, "name": "sort_triggers", "value": 3 }, { "type": 11, "name": "userids.0", "value": 1 }, { "type": 13, "name": "mediatypeids.0", "value": 1 }, { "type": 0, "name": "statuses.0", "value": 2 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring an action To configure an action, do the following: - Go to *Alerts* > *Actions* and select the required action type from the submenu (you can switch to another type later, using the title dropdown). - Click on *Create action*. - Name the action. - Choose [conditions](/manual/config/notifications/action/conditions) upon which operations are carried out. - Choose the [operations](/manual/config/notifications/action/operation) to carry out. General action attributes:  All mandatory input fields are marked with a red asterisk. |Parameter|Description| |--|--------| |*Name*|Unique action name.| |*Type of calculation*|Select the evaluation [option](/manual/config/notifications/action/conditions#type-of-calculation) for action conditions (with more than one condition):<br>**And** - all conditions must be met.<br>**Or** - enough if one condition is met.<br>**And/Or** - combination of the two: AND with different condition types and OR with the same condition type.<br>**Custom expression** - a user-defined calculation formula for evaluating action conditions.| |*Conditions*|List of action conditions.<br>Click on *Add* to add a new [condition](/manual/config/notifications/action/conditions).<br>If no conditions are configured, the action will run for every event that corresponds to the [action type](#overview) being configured.| |*Enabled*|Mark the checkbox to enable the action. Otherwise, it will be disabled.| #### Darbības konfigurēšana Lai konfigurētu darbību, rīkojieties šādi: - Dodieties uz *Alerts* > *Actions* un apakšizvēlnē atlasiet nepieciešamo darbības tipu (vēlāk varat pārslēgties uz citu tipu, izmantojot virsraksta nolaižamo izvēlni). - Noklikšķiniet uz *Create action*. - Norādiet darbības nosaukumu. - Izvēlieties [nosacījumus](/manual/config/notifications/action/conditions), pēc kuriem tiks veiktas operācijas. - Izvēlieties veicamās [operācijas](/manual/config/notifications/action/operation). Darbības vispārīgie atribūti:  Visi obligātie ievades lauki ir atzīmēti ar sarkanu zvaigznīti. |Parameter|Description| |--|--------| |*Name*|Unikāls darbības nosaukums.| |*Type of calculation*|Atlasiet darbības nosacījumu novērtēšanas [opciju](/manual/config/notifications/action/conditions#type-of-calculation) (ja ir vairāk nekā viens nosacījums):<br>**And** - jāizpildās visiem nosacījumiem.<br>**Or** - pietiek, ja izpildās viens nosacījums.<br>**And/Or** - abu kombinācija: AND ar dažādiem nosacījumu tipiem un OR ar vienu un to pašu nosacījumu tipu.<br>**Custom expression** - lietotāja definēta aprēķina formula darbības nosacījumu novērtēšanai.| |*Conditions*|Darbības nosacījumu saraksts.<br>Noklikšķiniet uz *Add*, lai pievienotu jaunu [nosacījumu](/manual/config/notifications/action/conditions).<br>Ja nav konfigurēti nosacījumi, darbība tiks izpildīta katram notikumam, kas atbilst konfigurētajam [darbības tipam](#overview).| |*Enabled*|Atzīmējiet izvēles rūtiņu, lai iespējotu darbību. Pretējā gadījumā tā būs atspējota.| #### Configuring and running Java gateway By default, Java gateway listens on port 10052. If you plan on running Java gateway on a different port, you can specify that in `settings.sh` script. See the description of [Java gateway configuration file](/manual/appendix/config/zabbix_java) for how to specify this and other options. ::: notewarning Port 10052 is not [IANA registered](http://www.iana.org/assignments/service-names-port-numbers/service-names-port-numbers.txt). ::: Once you are comfortable with the settings, you can start Java gateway by running the `startup.sh` script: ./startup.sh Likewise, once you no longer need Java gateway, run the `shutdown.sh` script to stop it: ./shutdown.sh Note that unlike server or proxy, Java gateway is lightweight and does not need a database. #### 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 var norādīt `settings.sh` skriptā. Skatiet [Java gateway konfigurācijas faila](/manual/appendix/config/zabbix_java) aprakstu, lai uzzinātu, kā norādīt šo un citas opcijas. ::: notewarning 10052. ports nav [IANA reģistrēts](http://www.iana.org/assignments/service-names-port-numbers/service-names-port-numbers.txt). ::: Kad iestatījumi ir jums piemēroti, varat palaist Java gateway, izpildot `startup.sh` skriptu: ./startup.sh Tāpat, kad Java gateway vairs nav nepieciešams, palaidiet `shutdown.sh` 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. #### Configuring and running Java gateway Configuration parameters of Zabbix Java gateway may be tuned in the file: /etc/zabbix/zabbix_java_gateway.conf For more details, see Zabbix Java gateway configuration [parameters](/manual/appendix/config/zabbix_java). To start Zabbix Java gateway: systemctl restart zabbix-java-gateway To automatically start Zabbix Java gateway on boot: RHEL 7 and later: systemctl enable zabbix-java-gateway RHEL prior to 7: chkconfig --level 12345 zabbix-java-gateway on #### Java gateway konfigurēšana un palaišana Zabbix Java gateway konfigurācijas parametrus var pielāgot failā: /etc/zabbix/zabbix_java_gateway.conf Plašāku informāciju skatiet Zabbix Java gateway konfigurācijas [parametros](/manual/appendix/config/zabbix_java). Lai palaistu Zabbix Java gateway: systemctl restart zabbix-java-gateway Lai Zabbix Java gateway automātiski startētu sistēmas palaišanas laikā: RHEL 7 un jaunākās versijas: systemctl enable zabbix-java-gateway RHEL pirms 7: chkconfig --level 12345 zabbix-java-gateway on #### Configuring and running Java gateway Java gateway configuration may be tuned in the file: /etc/zabbix/zabbix_java_gateway.conf For more details, see Zabbix Java gateway configuration [parameters](/manual/appendix/config/zabbix_java). To start Zabbix Java gateway: systemctl restart zabbix-java-gateway To automatically start Zabbix Java gateway on boot: systemctl enable zabbix-java-gateway #### Java gateway konfigurēšana un palaišana Java gateway konfigurāciju var pielāgot failā: /etc/zabbix/zabbix_java_gateway.conf Papildu informāciju skatiet Zabbix Java gateway konfigurācijas [parametros](/manual/appendix/config/zabbix_java). Lai palaistu Zabbix Java gateway: systemctl restart zabbix-java-gateway Lai Zabbix Java gateway automātiski startētu sistēmas palaišanas laikā: systemctl enable zabbix-java-gateway #### Configuring an *Item history* widget Configure an *Item history* widget that displays latest data for two numeric items "42269" and "42270". In addition, configure the item columns to be displayed vertically, with column names displayed horizontally; limit the display to 15 lines of data and include a separate timestamp column. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "itemhistory", "name": "Item history", "x": "0", "y": "0", "width": "18", "height": "6", "view_mode": "0", "fields": [ { "type": "0", "name": "layout", "value": "1" }, { "type": "1", "name": "columns.0.name", "value": "CPU utilization" }, { "type": "4", "name": "columns.0.itemid", "value": "42269" }, { "type": "1", "name": "columns.1.name", "value": "Memory utilization" }, { "type": "4", "name": "columns.1.itemid", "value": "42270" }, { "type": "0", "name": "show_lines", "value": "15" }, { "type": "0", "name": "show_timestamp", "value": "1" }, { "type": "0", "name": "show_column_header", "value": "1" }, { "type": "1", "name": "reference", "value": "KIVKD" } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### *Vienuma vēstures* logrīka konfigurēšana Konfigurējiet *Vienuma vēstures* logrīku, kas attēlo jaunākos datus diviem skaitliskiem vienumiem "42269" un "42270". Papildus konfigurējiet vienumu kolonnas attēlošanai vertikāli, kolonnu nosaukumus attēlojot horizontāli; ierobežojiet attēlojumu līdz 15 datu rindām un iekļaujiet atsevišķu laikspiedola kolonnu. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "itemhistory", "name": "Item history", "x": "0", "y": "0", "width": "18", "height": "6", "view_mode": "0", "fields": [ { "type": "0", "name": "layout", "value": "1" }, { "type": "1", "name": "columns.0.name", "value": "CPU utilization" }, { "type": "4", "name": "columns.0.itemid", "value": "42269" }, { "type": "1", "name": "columns.1.name", "value": "Memory utilization" }, { "type": "4", "name": "columns.1.itemid", "value": "42270" }, { "type": "0", "name": "show_lines", "value": "15" }, { "type": "0", "name": "show_timestamp", "value": "1" }, { "type": "0", "name": "show_column_header", "value": "1" }, { "type": "1", "name": "reference", "value": "KIVKD" } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring an *Item navigator* widget Configure an *Item navigator* widget that displays up to 1000 items grouped by their host and, then, by the "component" item tag value. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": "30", "auto_start": "1", "pages": [ { "widgets": [ { "type": "itemnavigator", "name": "Item navigator", "x": "0", "y": "0", "width": "12", "height": "5", "view_mode": "0", "fields": [ { "type": 0, "name": "group_by.0.attribute", "value": 0 }, { "type": 0, "name": "group_by.1.attribute", "value": 3 }, { "type": 1, "name": "group_by.1.tag_name", "value": "component" }, { "type": 0, "name": "show_lines", "value": 1000 }, { "type": 1, "name": "reference", "value": "DFNLK" } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### *Vienumu navigatora* logrīka konfigurēšana Konfigurējiet *Vienumu navigatora* logrīku, kas attēlo līdz 1000 vienumiem, grupētiem pēc to hosta un pēc tam pēc vienuma birkas "component" vērtības. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": "30", "auto_start": "1", "pages": [ { "widgets": [ { "type": "itemnavigator", "name": "Item navigator", "x": "0", "y": "0", "width": "12", "height": "5", "view_mode": "0", "fields": [ { "type": 0, "name": "group_by.0.attribute", "value": 0 }, { "type": 0, "name": "group_by.1.attribute", "value": 3 }, { "type": 1, "name": "group_by.1.tag_name", "value": "component" }, { "type": 0, "name": "show_lines", "value": 1000 }, { "type": 1, "name": "reference", "value": "DFNLK" } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring an *Item value* widget Configure an *Item value* widget that displays the item value for the item "42266" (Zabbix agent availability). In addition, visually fine-tune the widget with multiple advanced options, including a dynamic background color that changes based on the availability status of Zabbix agent. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "item", "name": "Item value", "x": 0, "y": 0, "width": 12, "height": 3, "view_mode": 0, "fields": [ { "type": 4, "name": "itemid.0", "value": 42266 }, { "type": 0, "name": "show.0", "value": 1 }, { "type": 0, "name": "show.1", "value": 2 }, { "type": 0, "name": "show.2", "value": 3 }, { "type": 1, "name": "description", "value": "Agent status" }, { "type": 0, "name": "desc_h_pos", "value": 0 }, { "type": 0, "name": "desc_v_pos", "value": 0 }, { "type": 0, "name": "desc_bold", "value": 1 }, { "type": 1, "name": "desc_color", "value": "F06291" }, { "type": 0, "name": "value_h_pos", "value": 0 }, { "type": 0, "name": "value_size", "value": 25 }, { "type": 1, "name": "value_color", "value": "FFFF00" }, { "type": 0, "name": "units_show", "value": 0 }, { "type": 0, "name": "time_h_pos", "value": 2 }, { "type": 0, "name": "time_v_pos", "value": 2 }, { "type": 0, "name": "time_size", "value": 10 }, { "type": 0, "name": "time_bold", "value": 1 }, { "type": 1, "name": "time_color", "value": "9FA8DA" }, { "type": 1, "name": "thresholds.0.color", "value": "E1E1E1" }, { "type": 1, "name": "thresholds.0.threshold", "value": "0" }, { "type": 1, "name": "thresholds.1.color", "value": "D1C4E9" }, { "type": 1, "name": "thresholds.1.threshold", "value": "1" } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### *Vienuma vērtības* logrīka konfigurēšana Konfigurējiet *Vienuma vērtības* logrīku, kas attēlo vienuma vērtību vienumam "42266" (Zabbix aģenta pieejamība). Papildus tam vizuāli pielāgojiet logrīku, izmantojot vairākas papildu opcijas, tostarp dinamisku fona krāsu, kas mainās atkarībā no Zabbix aģenta pieejamības statusa. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "item", "name": "Item value", "x": 0, "y": 0, "width": 12, "height": 3, "view_mode": 0, "fields": [ { "type": 4, "name": "itemid.0", "value": 42266 }, { "type": 0, "name": "show.0", "value": 1 }, { "type": 0, "name": "show.1", "value": 2 }, { "type": 0, "name": "show.2", "value": 3 }, { "type": 1, "name": "description", "value": "Agent status" }, { "type": 0, "name": "desc_h_pos", "value": 0 }, { "type": 0, "name": "desc_v_pos", "value": 0 }, { "type": 0, "name": "desc_bold", "value": 1 }, { "type": 1, "name": "desc_color", "value": "F06291" }, { "type": 0, "name": "value_h_pos", "value": 0 }, { "type": 0, "name": "value_size", "value": 25 }, { "type": 1, "name": "value_color", "value": "FFFF00" }, { "type": 0, "name": "units_show", "value": 0 }, { "type": 0, "name": "time_h_pos", "value": 2 }, { "type": 0, "name": "time_v_pos", "value": 2 }, { "type": 0, "name": "time_size", "value": 10 }, { "type": 0, "name": "time_bold", "value": 1 }, { "type": 1, "name": "time_color", "value": "9FA8DA" }, { "type": 1, "name": "thresholds.0.color", "value": "E1E1E1" }, { "type": 1, "name": "thresholds.0.threshold", "value": "0" }, { "type": 1, "name": "thresholds.1.color", "value": "D1C4E9" }, { "type": 1, "name": "thresholds.1.threshold", "value": "1" } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring an operation To configure an operation, go to the *Operations* tab in [action](/manual/config/notifications/action) configuration. {width="600"} General operation attributes: |Parameter|Description| |--|-----------| |*Default operation step duration*|Duration of one operation step by default (60 seconds to 1 week).<br>For example, an hour-long step duration means that if an operation is carried out, an hour will pass before the next step.<br>[Time suffixes](/manual/appendix/suffixes) are supported, e.g. 60s, 1m, 2h, 1d.<br>[User macros](/manual/config/macros/user_macros) are supported.| |*Operations*|Action operations (if any) are displayed, with these details:<br>**Steps** - escalation step(s) to which the operation is assigned.<br>**Details** - type of operation and its recipient/target.<br>The operation list also displays the media type (email, SMS or script) used as well as the name and surname (in parentheses after the username) of a notification recipient.<br>**Start in** - how long after an event the operation is performed.<br>**Duration (sec)** - step duration is displayed. *Default* is displayed if the step uses default duration, and a time is displayed if custom duration is used.<br>**Action** - links for editing and removing an operation are displayed.| |*Recovery operations*|Action operations (if any) are displayed, with these details:<br>**Details** - type of operation and its recipient/target.<br>The operation list also displays the media type (email, SMS or script) used as well as the name and surname (in parentheses after the username) of a notification recipient.<br>**Action** - links for editing and removing an operation are displayed.| |*Update operations*|Action operations (if any) are displayed, with these details:<br>**Details** - type of operation and its recipient/target.<br>The operation list also displays the media type (email, SMS or script) used as well as the name and surname (in parentheses after the username) of a notification recipient.<br>**Action** - links for editing and removing an operation are displayed.| |*Pause operations for symptom problems*|Mark this checkbox to pause operations (after the first operation) for symptom problems.<br>Note that this setting affects only problem escalations; recovery and update operations will not be affected.<br>This option is available for *Trigger actions* only.| |*Pause operations for suppressed problems*|Mark this checkbox to delay the start of operations for the duration of a maintenance period. When operations are started, after the maintenance, all operations are performed including those for the events during the maintenance.<br>Note that this setting affects only problem escalations; recovery and update operations will not be affected.<br>If you unmark this checkbox, operations will be executed without delay even during a maintenance period.<br>This option is not available for *Service actions*.| |*Notify about canceled escalations*|Unmark this checkbox to disable notifications about canceled escalations (when host, item, trigger or action is disabled).| All mandatory input fields are marked with a red asterisk. To configure details of a new operation, click on  in the *Operations* block. To edit an existing operation, click on  next to the operation. A pop-up window will open where you can edit the operation step details. #### Operācijas konfigurēšana Lai konfigurētu operāciju, dodieties uz cilni *Operations* [action](/manual/config/notifications/action) konfigurācijā. {width="600"} Vispārīgie operācijas atribūti: |Parameter|Description| |--|-----------| |*Default operation step duration*|Vienas operācijas darbības soļa noklusējuma ilgums (no 60 sekundēm līdz 1 nedēļai).<br>Piemēram, ja soļa ilgums ir viena stunda, tas nozīmē, ka pēc operācijas izpildes līdz nākamajam solim paies viena stunda.<br>Tiek atbalstīti [laika sufiksi](/manual/appendix/suffixes), piemēram, 60s, 1m, 2h, 1d.<br>Tiek atbalstīti [lietotāja makrosi](/manual/config/macros/user_macros).| |*Operations*|Tiek parādītas action operācijas, ja tādas ir, ar šādu informāciju:<br>**Steps** - eskalācijas solis(-i), kuram(-iem) operācija ir piešķirta.<br>**Details** - operācijas veids un tās saņēmējs/mērķis.<br>Operāciju sarakstā tiek parādīts arī izmantotais mediju tips (e-pasts, SMS vai skripts), kā arī paziņojuma saņēmēja vārds un uzvārds (iekavās aiz lietotājvārda).<br>**Start in** - cik ilgi pēc notikuma operācija tiek veikta.<br>**Duration (sec)** - tiek parādīts soļa ilgums. Ja tiek izmantots noklusējuma ilgums, tiek parādīts *Default*; ja tiek izmantots pielāgots ilgums, tiek parādīts laiks.<br>**Action** - tiek parādītas saites operācijas rediģēšanai un dzēšanai.| |*Recovery operations*|Tiek parādītas action operācijas, ja tādas ir, ar šādu informāciju:<br>**Details** - operācijas veids un tās saņēmējs/mērķis.<br>Operāciju sarakstā tiek parādīts arī izmantotais mediju tips (e-pasts, SMS vai skripts), kā arī paziņojuma saņēmēja vārds un uzvārds (iekavās aiz lietotājvārda).<br>**Action** - tiek parādītas saites operācijas rediģēšanai un dzēšanai.| |*Update operations*|Tiek parādītas action operācijas, ja tādas ir, ar šādu informāciju:<br>**Details** - operācijas veids un tās saņēmējs/mērķis.<br>Operāciju sarakstā tiek parādīts arī izmantotais mediju tips (e-pasts, SMS vai skripts), kā arī paziņojuma saņēmēja vārds un uzvārds (iekavās aiz lietotājvārda).<br>**Action** - tiek parādītas saites operācijas rediģēšanai un dzēšanai.| |*Pause operations for symptom problems*|Atzīmējiet šo izvēles rūtiņu, lai apturētu operācijas (pēc pirmās operācijas) simptomu problēmām.<br>Ņemiet vērā, ka šis iestatījums ietekmē tikai problēmu eskalācijas; atkopšanas un atjaunināšanas operācijas netiks ietekmētas.<br>Šī opcija ir pieejama tikai *Trigger actions*.| |*Pause operations for suppressed problems*|Atzīmējiet šo izvēles rūtiņu, lai aizkavētu operāciju sākšanu uz apkopes perioda ilgumu. Kad operācijas tiek sāktas pēc apkopes, tiek izpildītas visas operācijas, tostarp tās, kas attiecas uz notikumiem apkopes laikā.<br>Ņemiet vērā, ka šis iestatījums ietekmē tikai problēmu eskalācijas; atkopšanas un atjaunināšanas operācijas netiks ietekmētas.<br>Ja noņemsiet atzīmi no šīs izvēles rūtiņas, operācijas tiks izpildītas bez aizkaves pat apkopes perioda laikā.<br>Šī opcija nav pieejama *Service actions*.| |*Notify about canceled escalations*|Noņemiet atzīmi no šīs izvēles rūtiņas, lai atspējotu paziņojumus par atceltām eskalācijām (kad hosts, vienums, trigeris vai action ir atspējots).| Visi obligātie ievades lauki ir atzīmēti ar sarkanu zvaigznīti. Lai konfigurētu jaunas operācijas detaļas, noklikšķiniet uz  blokā *Operations*. Lai rediģētu esošu operāciju, noklikšķiniet uz  blakus operācijai. Tiks atvērts uznirstošais logs, kurā varēsiet rediģēt operācijas soļa detaļas. #### Configuring an *SLA report* widget Configure an *SLA report* widget that displays the SLA report for SLA "4" service "2" for the period of last 30 days. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "slareport", "name": "SLA report", "x": 0, "y": 0, "width": 36, "height": 5, "view_mode": 0, "fields": [ { "type": 10, "name": "slaid.0", "value": 4 }, { "type": 9, "name": "serviceid.0", "value": 2 }, { "type": 1, "name": "date_from", "value": "now-30d" }, { "type": 1, "name": "date_to", "value": "now" } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### *SLA atskaites* logrīka konfigurēšana Konfigurējiet *SLA atskaites* logrīku, kas attēlo SLA atskaiti SLA "4" pakalpojumam "2" par pēdējām 30 dienām. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "slareport", "name": "SLA report", "x": 0, "y": 0, "width": 36, "height": 5, "view_mode": 0, "fields": [ { "type": 10, "name": "slaid.0", "value": 4 }, { "type": 9, "name": "serviceid.0", "value": 2 }, { "type": 1, "name": "date_from", "value": "now-30d" }, { "type": 1, "name": "date_to", "value": "now" } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring an update operation To configure an update operation, follow these steps: 1. Go to the *Operations* tab in the [action configuration](/manual/config/notifications/action#configuring-an-action) form. 2. To configure a new update operation, click *Add* in the *Update operations* section. To edit an existing operation, click *Edit* next to the operation. 3. Configure the [operation details](/manual/config/notifications/action/update_operations#update-operation-details). {width="600"} #### Atjaunināšanas operācijas konfigurēšana Lai konfigurētu atjaunināšanas operāciju, veiciet šādas darbības: 1. Atveriet cilni *Operations* [darbības konfigurācijas](/manual/config/notifications/action#configuring-an-action) formā. 2. Lai konfigurētu jaunu atjaunināšanas operāciju, sadaļā *Update operations* noklikšķiniet uz *Add*. Lai rediģētu esošu operāciju, blakus operācijai noklikšķiniet uz *Edit*. 3. Konfigurējiet [operācijas informāciju](/manual/config/notifications/action/update_operations#update-operation-details). {width="600"} #### Configuring a *Pie chart* widget Configure a *Pie chart* widget in the following way: - 2 data sets for a total of 9 items on 1 host. - The first data set is of type "Item list" and consists of 3 items that are all with type "Normal" and represented by a different color. - The second data set is of type "Item patterns", consists of 6 items, has a configured aggregation for each item, and is represented by a custom color. - The second data set also has a custom data set label. - Data in the pie chart are displayed as a doughnut chart with a custom width and total value with units in the center. - Data in the pie chart are displayed and aggregated for a custom time period of the last 3 hours. - Pie chart legend displays configured items in 4 rows. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "piechart", "name": "Pie chart", "x": 0, "y": 0, "width": 24, "height": 5, "view_mode": 0, "fields": [ { "type": 0, "name": "ds.0.dataset_type", "value": 0 }, { "type": 4, "name": "ds.0.itemids.0", "value": 23264 }, { "type": 1, "name": "ds.0.color.0", "value": "FF0000" }, { "type": 0, "name": "ds.0.type.0", "value": 0 }, { "type": 4, "name": "ds.0.itemids.1", "value": 23269 }, { "type": 1, "name": "ds.0.color.1", "value": "BF00FF" }, { "type": 0, "name": "ds.0.type.1", "value": 0 }, { "type": 4, "name": "ds.0.itemids.2", "value": 23257 }, { "type": 1, "name": "ds.0.color.2", "value": "0040FF" }, { "type": 0, "name": "ds.0.type.2", "value": 0 }, { "type": 1, "name": "ds.1.hosts.0", "value": "Zabbix server" }, { "type": 1, "name": "ds.1.items.0", "value": "*: Number of processed *values per second" }, { "type": 1, "name": "ds.1.color", "value": "000000" }, { "type": 0, "name": "ds.1.aggregate_function", "value": 3 }, { "type": 1, "name": "ds.1.data_set_label", "value": "Number of processed values per second" }, { "type": 0, "name": "draw_type", "value": 1 }, { "type": 0, "name": "width", "value": 30 }, { "type": 0, "name": "total_show", "value": 1 }, { "type": 0, "name": "units_show", "value": 1 }, { "type": 0, "name": "graph_time", "value": 1 }, { "type": 1, "name": "time_period.from", "value": "now-3h" }, { "type": 1, "name": "time_period.to", "value": "now" }, { "type": 0, "name": "legend_lines", "value": 4 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### *Sektoru diagrammas* logrīka konfigurēšana Konfigurējiet *Sektoru diagrammas* logrīku šādi: - 2 datu kopas ar kopumā 9 vienumiem 1 hostā. - Pirmā datu kopa ir tipa "Vienumu saraksts" un sastāv no 3 vienumiem, kuri visi ir ar tipu "Parasts" un attēloti dažādās krāsās. - Otrā datu kopa ir tipa "Vienumu šabloni", sastāv no 6 vienumiem, tai ir konfigurēta agregācija katram vienumam, un tā ir attēlota ar pielāgotu krāsu. - Otrajai datu kopai ir arī pielāgota datu kopas etiķete. - Dati sektoru diagrammā tiek attēloti kā gredzenveida diagramma ar pielāgotu platumu un kopējo vērtību ar mērvienībām centrā. - Dati sektoru diagrammā tiek attēloti un agregēti pielāgotam pēdējo 3 stundu laika periodam. - Sektoru diagrammas leģenda attēlo konfigurētos vienumus 4 rindās. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "piechart", "name": "Pie chart", "x": 0, "y": 0, "width": 24, "height": 5, "view_mode": 0, "fields": [ { "type": 0, "name": "ds.0.dataset_type", "value": 0 }, { "type": 4, "name": "ds.0.itemids.0", "value": 23264 }, { "type": 1, "name": "ds.0.color.0", "value": "FF0000" }, { "type": 0, "name": "ds.0.type.0", "value": 0 }, { "type": 4, "name": "ds.0.itemids.1", "value": 23269 }, { "type": 1, "name": "ds.0.color.1", "value": "BF00FF" }, { "type": 0, "name": "ds.0.type.1", "value": 0 }, { "type": 4, "name": "ds.0.itemids.2", "value": 23257 }, { "type": 1, "name": "ds.0.color.2", "value": "0040FF" }, { "type": 0, "name": "ds.0.type.2", "value": 0 }, { "type": 1, "name": "ds.1.hosts.0", "value": "Zabbix server" }, { "type": 1, "name": "ds.1.items.0", "value": "*: Number of processed *values per second" }, { "type": 1, "name": "ds.1.color", "value": "000000" }, { "type": 0, "name": "ds.1.aggregate_function", "value": 3 }, { "type": 1, "name": "ds.1.data_set_label", "value": "Number of processed values per second" }, { "type": 0, "name": "draw_type", "value": 1 }, { "type": 0, "name": "width", "value": 30 }, { "type": 0, "name": "total_show", "value": 1 }, { "type": 0, "name": "units_show", "value": 1 }, { "type": 0, "name": "graph_time", "value": 1 }, { "type": 1, "name": "time_period.from", "value": "now-3h" }, { "type": 1, "name": "time_period.to", "value": "now" }, { "type": 0, "name": "legend_lines", "value": 4 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring a *Problem hosts* widget Configure a *Problem hosts* widget that displays hosts from host groups "2" and "4" that have problems with a name that includes the string "CPU" and that have the following severities: "Warning", "Average", "High", "Disaster". [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "problemhosts", "name": "Problem hosts", "x": 0, "y": 0, "width": 36, "height": 5, "view_mode": 0, "fields": [ { "type": 2, "name": "groupids.0", "value": 2 }, { "type": 2, "name": "groupids.1", "value": 4 }, { "type": 1, "name": "problem", "value": "cpu" }, { "type": 0, "name": "severities.0", "value": 2 }, { "type": 0, "name": "severities.1", "value": 3 }, { "type": 0, "name": "severities.2", "value": 4 }, { "type": 0, "name": "severities.3", "value": 5 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### *Problem hosts* logrīka konfigurēšana Konfigurējiet *Problem hosts* logrīku, kas attēlo hostus no hostu grupām "2" un "4", kuriem ir problēmas ar nosaukumu, kas ietver virkni "CPU", un kuriem ir šādas nopietnības pakāpes: "Brīdinājums", "Vidēja", "Augsta", "Katastrofa". [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "problemhosts", "name": "Problem hosts", "x": 0, "y": 0, "width": 36, "height": 5, "view_mode": 0, "fields": [ { "type": 2, "name": "groupids.0", "value": 2 }, { "type": 2, "name": "groupids.1", "value": 4 }, { "type": 1, "name": "problem", "value": "cpu" }, { "type": 0, "name": "severities.0", "value": 2 }, { "type": 0, "name": "severities.1", "value": 3 }, { "type": 0, "name": "severities.2", "value": 4 }, { "type": 0, "name": "severities.3", "value": 5 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring a *Problems by severity* widget Configure a *Problems by severity* widget that displays problem totals for all host groups. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "problemsbysv", "name": "Problems by severity", "x": 0, "y": 0, "width": 36, "height": 5, "view_mode": 0, "fields": [ { "type": 0, "name": "show_type", "value": 1 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### *Problēmas pēc smaguma pakāpes* logrīka konfigurēšana Konfigurējiet *Problēmas pēc smaguma pakāpes* logrīku, kas parāda problēmu kopsummas visām hostu grupām. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "problemsbysv", "name": "Problems by severity", "x": 0, "y": 0, "width": 36, "height": 5, "view_mode": 0, "fields": [ { "type": 0, "name": "show_type", "value": 1 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring a *Problems* widget Configure a *Problems* widget that displays problems for host group "4" that satisfy the following conditions: - Problems that have a tag with the name "scope" that contains values "performance" or "availability", or "capacity". - Problems that have the following severities: "Warning", "Average", "High", "Disaster". In addition, configure the widget to show tags and operational data. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "problems", "name": "Problems", "x": 0, "y": 0, "width": 36, "height": 5, "view_mode": 0, "fields": [ { "type": 2, "name": "groupids.0", "value": 4 }, { "type": 1, "name": "tags.0.tag", "value": "scope" }, { "type": 0, "name": "tags.0.operator", "value": 0 }, { "type": 1, "name": "tags.0.value", "value": "performance" }, { "type": 1, "name": "tags.1.tag", "value": "scope" }, { "type": 0, "name": "tags.1.operator", "value": 0 }, { "type": 1, "name": "tags.1.value", "value": "availability" }, { "type": 1, "name": "tags.2.tag", "value": "scope" }, { "type": 0, "name": "tags.2.operator", "value": 0 }, { "type": 1, "name": "tags.2.value", "value": "capacity" }, { "type": 0, "name": "severities.0", "value": 2 }, { "type": 0, "name": "severities.1", "value": 3 }, { "type": 0, "name": "severities.2", "value": 4 }, { "type": 0, "name": "severities.3", "value": 5 }, { "type": 0, "name": "show_tags", "value": 1 }, { "type": 0, "name": "show_opdata", "value": 1 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### *Problēmas* logrīka konfigurēšana Konfigurējiet *Problēmas* logrīku, kas attēlo problēmas hostu grupai "4" un atbilst šādiem nosacījumiem: - Problēmas, kurām ir tags ar nosaukumu "scope", kas satur vērtības "performance" vai "availability", vai "capacity". - Problēmas ar šādiem svarīguma līmeņiem: "Warning", "Average", "High", "Disaster". Papildus konfigurējiet logrīku tā, lai tas rādītu tagus un darbības datus. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "problems", "name": "Problems", "x": 0, "y": 0, "width": 36, "height": 5, "view_mode": 0, "fields": [ { "type": 2, "name": "groupids.0", "value": 4 }, { "type": 1, "name": "tags.0.tag", "value": "scope" }, { "type": 0, "name": "tags.0.operator", "value": 0 }, { "type": 1, "name": "tags.0.value", "value": "performance" }, { "type": 1, "name": "tags.1.tag", "value": "scope" }, { "type": 0, "name": "tags.1.operator", "value": 0 }, { "type": 1, "name": "tags.1.value", "value": "availability" }, { "type": 1, "name": "tags.2.tag", "value": "scope" }, { "type": 0, "name": "tags.2.operator", "value": 0 }, { "type": 1, "name": "tags.2.value", "value": "capacity" }, { "type": 0, "name": "severities.0", "value": 2 }, { "type": 0, "name": "severities.1", "value": 3 }, { "type": 0, "name": "severities.2", "value": 4 }, { "type": 0, "name": "severities.3", "value": 5 }, { "type": 0, "name": "show_tags", "value": 1 }, { "type": 0, "name": "show_opdata", "value": 1 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring a proxy group To configure a proxy group in Zabbix frontend: 1. Go to *Administration > Proxy groups* 2. Click *Create proxy group* {width="600"} |Parameter|Description| |--|--------| |*Name*|Name of the proxy group.| |*Failover period*|Period in seconds during which a proxy in the proxy group must communicate with Zabbix server to be considered online (default: 1m; range: 10s-15m). If the proxy does not communicate within this period, the proxy state is changed to *Offline*, and its hosts are immediately redistributed to other proxies. Proxy load balancing begins after 10 x this period.<br>Supports time suffixes (e.g., 30s, 1m) and user macros.| |*Minimum number of proxies*|Minimum number of [online proxies](/manual/web_interface/frontend_sections/administration/proxies) required to keep the [proxy group online](/manual/web_interface/frontend_sections/administration/proxy_groups) (default: 1; range: 1-1000).<br>Supports user macros.<br><br>This value should be less than the total number of proxies in the group. For example, in a group of 10 proxies, setting the minimum to 10 will cause the group to go offline if any proxy fails. Note that online proxies in an offline group continue to function normally, but load balancing/high availability will not take place.| |*Description*|Description of the proxy group.| |*Proxies*|Displays a list of up to five proxies (as links or in plain text, depending on user permissions to proxies) when editing a group with proxies.| #### Starpniekserveru grupas konfigurēšana Lai konfigurētu starpniekserveru grupu Zabbix lietotāja saskarnē: 1. Dodieties uz *Administration > Proxy groups* 2. Noklikšķiniet uz *Create proxy group* {width="600"} |Parametrs|Apraksts| |--|--------| |*Name*|Starpniekserveru grupas nosaukums.| |*Failover period*|Periods sekundēs, kura laikā starpniekserverim starpniekserveru grupā ir jāsazinās ar Zabbix serveri, lai tas tiktu uzskatīts par tiešsaistē esošu (noklusējums: 1m; diapazons: 10s-15m). Ja starpniekserveris šajā periodā nesazinās, tā stāvoklis tiek mainīts uz *Offline*, un tā hosti tiek nekavējoties pārdalīti citiem starpniekserveriem. Starpniekserveru slodzes līdzsvarošana sākas pēc 10 x šī perioda.<br>Atbalsta laika sufiksus (piemēram, 30s, 1m) un lietotāja makrosus.| |*Minimum number of proxies*|Minimālais [tiešsaistē esošo starpniekserveru](/manual/web_interface/frontend_sections/administration/proxies) skaits, kas nepieciešams, lai [starpniekserveru grupa būtu tiešsaistē](/manual/web_interface/frontend_sections/administration/proxy_groups) (noklusējums: 1; diapazons: 1-1000).<br>Atbalsta lietotāja makrosus.<br><br>Šai vērtībai jābūt mazākai par kopējo starpniekserveru skaitu grupā. Piemēram, 10 starpniekserveru grupā, iestatot minimālo skaitu uz 10, grupa pāries bezsaistes režīmā, ja kāds starpniekserveris nedarbosies. Ņemiet vērā, ka tiešsaistē esošie starpniekserveri bezsaistes grupā turpina darboties normāli, taču slodzes līdzsvarošana/augsta pieejamība nenotiks.| |*Description*|Starpniekserveru grupas apraksts.| |*Proxies*|Rediģējot grupu ar starpniekserveriem, tiek parādīts saraksts ar ne vairāk kā pieciem starpniekserveriem (kā saites vai vienkāršs teksts atkarībā no lietotāja piekļuves tiesībām starpniekserveriem).| ### Configuring a recovery operation To configure a recovery operation, follow these steps: 1. Go to the *Operations* tab in the [action configuration](/manual/config/notifications/action#configuring-an-action) form. 2. To configure a new recovery operation, click *Add* in the *Recovery operations* section. To edit an existing operation, click *Edit* next to the operation. 3. Configure the [operation details](/manual/config/notifications/action/recovery_operations#recovery-operation-details). {width="600"} ### Atkopšanas operācijas konfigurēšana Lai konfigurētu atkopšanas operāciju, veiciet šādas darbības: 1. Dodieties uz cilni *Operations* [darbības konfigurācijas](/manual/config/notifications/action#configuring-an-action) formā. 2. Lai konfigurētu jaunu atkopšanas operāciju, sadaļā *Recovery operations* noklikšķiniet uz *Add*. Lai rediģētu esošu operāciju, blakus operācijai noklikšķiniet uz *Edit*. 3. Konfigurējiet [operācijas informāciju](/manual/config/notifications/action/recovery_operations#recovery-operation-details). {width="600"} #### Configuring a *System information* widget Configure a *System information* widget that displays system stats with a refresh interval of 10 minutes and software update check enabled. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "systeminfo", "name": "System information", "x": 0, "y": 0, "width": 36, "height": 5, "view_mode": 0, "fields": [ { "type": 0, "name": "rf_rate", "value": 600 }, { "type": 0, "name": "show_software_update_check_details", "value": 1 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### *Sistēmas informācijas* logrīka konfigurēšana Konfigurējiet *Sistēmas informācijas* logrīku, kas attēlo sistēmas statistiku ar atsvaidzināšanas intervālu 10 minūtes un iespējotu programmatūras atjauninājumu pārbaudi. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "systeminfo", "name": "System information", "x": 0, "y": 0, "width": 36, "height": 5, "view_mode": 0, "fields": [ { "type": 0, "name": "rf_rate", "value": 600 }, { "type": 0, "name": "show_software_update_check_details", "value": 1 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring a *Top hosts* widget Configure a *Top hosts* widget that displays top hosts by CPU utilization in host group "4". In addition, configure the following custom columns: "Host name", "CPU utilization in %", "1m avg", "5m avg", "15m avg", "Processes". [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "tophosts", "name": "Top hosts", "x": 0, "y": 0, "width": 36, "height": 5, "view_mode": 0, "fields": [ { "type": 2, "name": "groupids.0", "value": 4 }, { "type": 1, "name": "columns.0.name", "value": "Host" }, { "type": 0, "name": "columns.0.data", "value": 2 }, { "type": 1, "name": "columns.0.base_color", "value": "FFFFFF" }, { "type": 1, "name": "columns.1.name", "value": "CPU utilization in %" }, { "type": 0, "name": "columns.1.data", "value": 1 }, { "type": 1, "name": "columns.1.base_color", "value": "4CAF50" }, { "type": 1, "name": "columns.1.item", "value": "CPU utilization" }, { "type": 0, "name": "columns.1.display", "value": 3 }, { "type": 1, "name": "columns.1.min", "value": "0" }, { "type": 1, "name": "columns.1.max", "value": "100" }, { "type": 1, "name": "columnsthresholds.1.color.0", "value": "FFFF00" }, { "type": 1, "name": "columnsthresholds.1.threshold.0", "value": "50" }, { "type": 1, "name": "columnsthresholds.1.color.1", "value": "FF8000" }, { "type": 1, "name": "columnsthresholds.1.threshold.1", "value": "80" }, { "type": 1, "name": "columnsthresholds.1.color.2", "value": "FF4000" }, { "type": 1, "name": "columnsthresholds.1.threshold.2", "value": "90" }, { "type": 1, "name": "columns.2.name", "value": "1m avg" }, { "type": 0, "name": "columns.2.data", "value": 1 }, { "type": 1, "name": "columns.2.base_color", "value": "FFFFFF" }, { "type": 1, "name": "columns.2.item", "value": "Load average (1m avg)" }, { "type": 1, "name": "columns.3.name", "value": "5m avg" }, { "type": 0, "name": "columns.3.data", "value": 1 }, { "type": 1, "name": "columns.3.base_color", "value": "FFFFFF" }, { "type": 1, "name": "columns.3.item", "value": "Load average (5m avg)" }, { "type": 1, "name": "columns.4.name", "value": "15m avg" }, { "type": 0, "name": "columns.4.data", "value": 1 }, { "type": 1, "name": "columns.4.base_color", "value": "FFFFFF" }, { "type": 1, "name": "columns.4.item", "value": "Load average (15m avg)" }, { "type": 1, "name": "columns.5.name", "value": "Processes" }, { "type": 0, "name": "columns.5.data", "value": 1 }, { "type": 1, "name": "columns.5.base_color", "value": "FFFFFF" }, { "type": 1, "name": "columns.5.item", "value": "Number of processes" }, { "type": 0, "name": "columns.5.decimal_places", "value": 0 }, { "type": 0, "name": "column", "value": 1 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### *Top hosts* logrīka konfigurēšana Konfigurējiet *Top hosts* logrīku, kas attēlo augstākās noslodzes hostus pēc CPU izmantojuma hostu grupā "4". Papildus konfigurējiet šādas pielāgotās kolonnas: "Hosta nosaukums", "CPU izmantojums %", "1m vid.", "5m vid.", "15m vid.", "Procesi". [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "tophosts", "name": "Top hosts", "x": 0, "y": 0, "width": 36, "height": 5, "view_mode": 0, "fields": [ { "type": 2, "name": "groupids.0", "value": 4 }, { "type": 1, "name": "columns.0.name", "value": "Host" }, { "type": 0, "name": "columns.0.data", "value": 2 }, { "type": 1, "name": "columns.0.base_color", "value": "FFFFFF" }, { "type": 1, "name": "columns.1.name", "value": "CPU utilization in %" }, { "type": 0, "name": "columns.1.data", "value": 1 }, { "type": 1, "name": "columns.1.base_color", "value": "4CAF50" }, { "type": 1, "name": "columns.1.item", "value": "CPU utilization" }, { "type": 0, "name": "columns.1.display", "value": 3 }, { "type": 1, "name": "columns.1.min", "value": "0" }, { "type": 1, "name": "columns.1.max", "value": "100" }, { "type": 1, "name": "columnsthresholds.1.color.0", "value": "FFFF00" }, { "type": 1, "name": "columnsthresholds.1.threshold.0", "value": "50" }, { "type": 1, "name": "columnsthresholds.1.color.1", "value": "FF8000" }, { "type": 1, "name": "columnsthresholds.1.threshold.1", "value": "80" }, { "type": 1, "name": "columnsthresholds.1.color.2", "value": "FF4000" }, { "type": 1, "name": "columnsthresholds.1.threshold.2", "value": "90" }, { "type": 1, "name": "columns.2.name", "value": "1m avg" }, { "type": 0, "name": "columns.2.data", "value": 1 }, { "type": 1, "name": "columns.2.base_color", "value": "FFFFFF" }, { "type": 1, "name": "columns.2.item", "value": "Load average (1m avg)" }, { "type": 1, "name": "columns.3.name", "value": "5m avg" }, { "type": 0, "name": "columns.3.data", "value": 1 }, { "type": 1, "name": "columns.3.base_color", "value": "FFFFFF" }, { "type": 1, "name": "columns.3.item", "value": "Load average (5m avg)" }, { "type": 1, "name": "columns.4.name", "value": "15m avg" }, { "type": 0, "name": "columns.4.data", "value": 1 }, { "type": 1, "name": "columns.4.base_color", "value": "FFFFFF" }, { "type": 1, "name": "columns.4.item", "value": "Load average (15m avg)" }, { "type": 1, "name": "columns.5.name", "value": "Processes" }, { "type": 0, "name": "columns.5.data", "value": 1 }, { "type": 1, "name": "columns.5.base_color", "value": "FFFFFF" }, { "type": 1, "name": "columns.5.item", "value": "Number of processes" }, { "type": 0, "name": "columns.5.decimal_places", "value": 0 }, { "type": 0, "name": "column", "value": 1 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring a *Top triggers* widget Configure a *Top triggers* widget that displays the top 5 triggers for host group "4" with the count of all problems for each trigger. The widget displays only triggers that have severities "Warning", "Average", "High", or "Disaster", and problems that have a tag with the name "scope" that contains values "performance" or "availability", or "capacity". [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "toptriggers", "name": "Top triggers", "x": 0, "y": 0, "width": 36, "height": 5, "view_mode": 0, "fields": [ { "type": 2, "name": "groupids.0", "value": 4 }, { "type": 0, "name": "severities.0", "value": 2 }, { "type": 0, "name": "severities.1", "value": 3 }, { "type": 0, "name": "severities.2", "value": 4 }, { "type": 0, "name": "severities.3", "value": 5 }, { "type": 1, "name": "tags.0.tag", "value": "scope" }, { "type": 0, "name": "tags.0.operator", "value": 0 }, { "type": 1, "name": "tags.0.value", "value": "performance" }, { "type": 1, "name": "tags.1.tag", "value": "scope" }, { "type": 0, "name": "tags.1.operator", "value": 0 }, { "type": 1, "name": "tags.1.value", "value": "availability" }, { "type": 1, "name": "tags.2.tag", "value": "scope" }, { "type": 0, "name": "tags.2.operator", "value": 0 }, { "type": 1, "name": "tags.2.value", "value": "capacity" }, { "type": 0, "name": "show_lines", "value": 5 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### *Top trigeri* logrīka konfigurēšana Konfigurējiet *Top trigeri* logrīku, kas attēlo 5 populārākos trigerus hostu grupai "4" ar visu problēmu skaitu katram trigerim. Logrīks attēlo tikai tos trigerus, kuriem ir nopietnības līmeņi "Warning", "Average", "High" vai "Disaster", un problēmas, kurām ir birka ar nosaukumu "scope", kas satur vērtības "performance" vai "availability", vai "capacity". [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "toptriggers", "name": "Top triggers", "x": 0, "y": 0, "width": 36, "height": 5, "view_mode": 0, "fields": [ { "type": 2, "name": "groupids.0", "value": 4 }, { "type": 0, "name": "severities.0", "value": 2 }, { "type": 0, "name": "severities.1", "value": 3 }, { "type": 0, "name": "severities.2", "value": 4 }, { "type": 0, "name": "severities.3", "value": 5 }, { "type": 1, "name": "tags.0.tag", "value": "scope" }, { "type": 0, "name": "tags.0.operator", "value": 0 }, { "type": 1, "name": "tags.0.value", "value": "performance" }, { "type": 1, "name": "tags.1.tag", "value": "scope" }, { "type": 0, "name": "tags.1.operator", "value": 0 }, { "type": 1, "name": "tags.1.value", "value": "availability" }, { "type": 1, "name": "tags.2.tag", "value": "scope" }, { "type": 0, "name": "tags.2.operator", "value": 0 }, { "type": 1, "name": "tags.2.value", "value": "capacity" }, { "type": 0, "name": "show_lines", "value": 5 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring a *Trigger overview* widget Configure a *Trigger overview* widget that displays trigger states for all host groups that have triggers with a tag that has the name "scope" and contains value "availability". [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "trigover", "name": "Trigger overview", "x": 0, "y": 0, "width": 36, "height": 5, "view_mode": 0, "fields": [ { "type": 1, "name": "tags.0.tag", "value": "scope" }, { "type": 0, "name": "tags.0.operator", "value": 0 }, { "type": 1, "name": "tags.0.value", "value": "availability" } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### *Trigera pārskata* logrīka konfigurēšana Konfigurējiet *Trigera pārskata* logrīku, kas attēlo trigeru stāvokļus visām hostu grupām, kurām ir trigeri ar birku, kuras nosaukums ir "scope" un kuras vērtība satur "availability". [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "trigover", "name": "Trigger overview", "x": 0, "y": 0, "width": 36, "height": 5, "view_mode": 0, "fields": [ { "type": 1, "name": "tags.0.tag", "value": "scope" }, { "type": 0, "name": "tags.0.operator", "value": 0 }, { "type": 1, "name": "tags.0.value", "value": "availability" } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring a *URL* widget Configure a *URL* widget that displays the home page of Zabbix manual. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "url", "name": "URL", "x": 0, "y": 0, "width": 36, "height": 5, "view_mode": 0, "fields": [ { "type": 1, "name": "url", "value": "https://www.zabbix.com/documentation/7.0/en" } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### URL logrīka konfigurēšana Konfigurējiet *URL* logrīku, kas parāda Zabbix rokasgrāmatas sākumlapu. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "url", "name": "URL", "x": 0, "y": 0, "width": 36, "height": 5, "view_mode": 0, "fields": [ { "type": 1, "name": "url", "value": "https://www.zabbix.com/documentation/7.0/en" } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring authentication The **Authentication** tab allows you to configure scenario authentication options. A green dot next to the tab name indicates that some type of HTTP authentication is enabled.  Authentication parameters: |Parameter|Description| |--|--------| |*HTTP authentication*|Select the authentication option:<br>**None** - no authentication used;<br>**Basic** - basic authentication is used;<br>**NTLM** - NTLM ([Windows NT LAN Manager](http://en.wikipedia.org/wiki/NTLM)) authentication is used;<br>**Kerberos** - Kerberos authentication is used (see also: [Configuring Kerberos with Zabbix](/manual/appendix/items/kerberos));<br>**Digest** - Digest authentication is used.| |*User*|Enter the user name (up to 255 characters).<br>This field is available if *HTTP authentication* is set to Basic, NTLM, Kerberos, or Digest. User macros are supported. | |*Password*|Enter the user password (up to 255 characters).<br>This field is available if *HTTP authentication* is set to Basic, NTLM, Kerberos, or Digest. User macros are supported. | |*SSL verify peer*|Mark the checkbox to verify the SSL certificate of the web server.<br>The server certificate will be automatically taken from system-wide certificate authority (CA) location. You can override the location of CA files using Zabbix server or proxy configuration parameter [SSLCALocation](/manual/appendix/config/zabbix_server#sslcalocation).<br>This sets the [CURLOPT\_SSL\_VERIFYPEER](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYPEER.html) cURL option.| |*SSL verify host*|Mark the checkbox to verify that the *Common Name* field or the *Subject Alternate Name* field of the web server certificate matches.<br>This sets the [CURLOPT\_SSL\_VERIFYHOST](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYHOST.html) cURL option.| |*SSL certificate file*|Name of the SSL certificate file used for client authentication. The certificate file must be in PEM^1^ format. If the certificate file contains also the private key, leave the *SSL key file* field empty. If the key is encrypted, specify the password in *SSL key password* field. The directory containing this file is specified by Zabbix server or proxy configuration parameter [SSLCertLocation](/manual/appendix/config/zabbix_server).<br>`HOST.*` macros and user macros can be used in this field.<br>This sets the [CURLOPT\_SSLCERT](http://curl.haxx.se/libcurl/c/CURLOPT_SSLCERT.html) cURL option.| |*SSL key file*|Name of the SSL private key file used for client authentication. The private key file must be in PEM^1^ format. The directory containing this file is specified by Zabbix server or proxy configuration parameter [SSLKeyLocation](/manual/appendix/config/zabbix_server).<br>`HOST.*` macros and user macros can be used in this field.<br>This sets the [CURLOPT\_SSLKEY](http://curl.haxx.se/libcurl/c/CURLOPT_SSLKEY.html) cURL option.| |*SSL key password*|SSL private key file password.<br>User macros can be used in this field.<br>This sets the [CURLOPT\_KEYPASSWD](http://curl.haxx.se/libcurl/c/CURLOPT_KEYPASSWD.html) cURL option.| ::: noteimportant \[1\] Zabbix supports certificate and private key files in PEM format only. In case you have your certificate and private key data in PKCS \#12 format file (usually with extension \*.p12 or \*.pfx) you may generate the PEM file from it using the following commands: openssl pkcs12 -in ssl-cert.p12 -clcerts -nokeys -out ssl-cert.pem openssl pkcs12 -in ssl-cert.p12 -nocerts -nodes -out ssl-cert.key ::: ::: noteclassic Zabbix server picks up changes in certificates without a restart. ::: ::: noteclassic If you have client certificate and private key in a single file just specify it in a "SSL certificate file" field and leave "SSL key file" field empty. The certificate and key must still be in PEM format. Combining certificate and key is easy: cat client.crt client.key > client.pem ::: #### Autentifikācijas konfigurēšana Cilne **Authentication** ļauj konfigurēt scenārija autentifikācijas opcijas. Zaļš punkts blakus cilnes nosaukumam norāda, ka ir iespējota kāda HTTP autentifikācijas forma.  Autentifikācijas parametri: |Parameter|Description| |--|--------| |*HTTP authentication*|Atlasiet autentifikācijas opciju:<br>**None** - autentifikācija netiek izmantota;<br>**Basic** - tiek izmantota pamata autentifikācija;<br>**NTLM** - tiek izmantota NTLM ([Windows NT LAN Manager](http://en.wikipedia.org/wiki/NTLM)) autentifikācija;<br>**Kerberos** - tiek izmantota Kerberos autentifikācija (skatiet arī: [Kerberos konfigurēšana ar Zabbix](/manual/appendix/items/kerberos));<br>**Digest** - tiek izmantota Digest autentifikācija.| |*User*|Ievadiet lietotājvārdu (līdz 255 rakstzīmēm).<br>Šis lauks ir pieejams, ja *HTTP authentication* ir iestatīts uz Basic, NTLM, Kerberos vai Digest. Tiek atbalstīti lietotāja makrosi. | |*Password*|Ievadiet lietotāja paroli (līdz 255 rakstzīmēm).<br>Šis lauks ir pieejams, ja *HTTP authentication* ir iestatīts uz Basic, NTLM, Kerberos vai Digest. Tiek atbalstīti lietotāja makrosi. | |*SSL verify peer*|Atzīmējiet izvēles rūtiņu, lai pārbaudītu tīmekļa servera SSL sertifikātu.<br>Servera sertifikāts tiks automātiski ņemts no sistēmas mēroga sertifikātu autoritātes (CA) atrašanās vietas. CA failu atrašanās vietu var pārrakstīt, izmantojot Zabbix servera vai starpniekserveris konfigurācijas parametru [SSLCALocation](/manual/appendix/config/zabbix_server#sslcalocation).<br>Tas iestata cURL opciju [CURLOPT\_SSL\_VERIFYPEER](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYPEER.html).| |*SSL verify host*|Atzīmējiet izvēles rūtiņu, lai pārbaudītu, vai tīmekļa servera sertifikāta lauks *Common Name* vai lauks *Subject Alternate Name* atbilst.<br>Tas iestata cURL opciju [CURLOPT\_SSL\_VERIFYHOST](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYHOST.html).| |*SSL certificate file*|SSL sertifikāta faila nosaukums, ko izmanto klienta autentifikācijai. Sertifikāta failam jābūt PEM^1^ formātā. Ja sertifikāta fails satur arī privāto atslēgu, atstājiet lauku *SSL key file* tukšu. Ja atslēga ir šifrēta, norādiet paroli laukā *SSL key password*. Katalogu, kurā atrodas šis fails, nosaka Zabbix servera vai starpniekserveris konfigurācijas parametrs [SSLCertLocation](/manual/appendix/config/zabbix_server).<br>Šajā laukā var izmantot `HOST.*` makrosus un lietotāja makrosus.<br>Tas iestata cURL opciju [CURLOPT\_SSLCERT](http://curl.haxx.se/libcurl/c/CURLOPT_SSLCERT.html).| |*SSL key file*|SSL privātās atslēgas faila nosaukums, ko izmanto klienta autentifikācijai. Privātās atslēgas failam jābūt PEM^1^ formātā. Katalogu, kurā atrodas šis fails, nosaka Zabbix servera vai starpniekserveris konfigurācijas parametrs [SSLKeyLocation](/manual/appendix/config/zabbix_server).<br>Šajā laukā var izmantot `HOST.*` makrosus un lietotāja makrosus.<br>Tas iestata cURL opciju [CURLOPT\_SSLKEY](http://curl.haxx.se/libcurl/c/CURLOPT_SSLKEY.html).| |*SSL key password*|SSL privātās atslēgas faila parole.<br>Šajā laukā var izmantot lietotāja makrosus.<br>Tas iestata cURL opciju [CURLOPT\_KEYPASSWD](http://curl.haxx.se/libcurl/c/CURLOPT_KEYPASSWD.html).| ::: noteimportant \[1\] Zabbix atbalsta tikai PEM formāta sertifikātu un privātās atslēgas failus. Ja jūsu sertifikāta un privātās atslēgas dati ir PKCS \#12 formāta failā (parasti ar paplašinājumu \*.p12 vai \*.pfx), no tā varat izveidot PEM failu, izmantojot šādas komandas: openssl pkcs12 -in ssl-cert.p12 -clcerts -nokeys -out ssl-cert.pem openssl pkcs12 -in ssl-cert.p12 -nocerts -nodes -out ssl-cert.key ::: ::: noteclassic Zabbix serveris sertifikātu izmaiņas nolasa bez restartēšanas. ::: ::: noteclassic Ja klienta sertifikāts un privātā atslēga ir vienā failā, vienkārši norādiet to laukā "SSL certificate file" un atstājiet lauku "SSL key file" tukšu. Sertifikātam un atslēgai joprojām jābūt PEM formātā. Sertifikāta un atslēgas apvienošana ir vienkārša: cat client.crt client.key > client.pem ::: #### Configuring a *Web monitoring* widget Configure a *Web monitoring* widget that displays a status summary of the active web monitoring scenarios for host group "4". [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "web", "name": "Web monitoring", "x": 0, "y": 0, "width": 18, "height": 3, "view_mode": 0, "fields": [ { "type": 2, "name": "groupids.0", "value": 4 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### *Web monitoring* logrīka konfigurēšana Konfigurējiet *Web monitoring* logrīku, kas attēlo aktīvo tīmekļa uzraudzības scenāriju statusa kopsavilkumu hostu grupai "4". [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "web", "name": "Web monitoring", "x": 0, "y": 0, "width": 18, "height": 3, "view_mode": 0, "fields": [ { "type": 2, "name": "groupids.0", "value": 4 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring a web scenario To configure a web scenario: - Go to: *Data collection → Hosts* (or *Templates*) - Click on *Web* in the row of the host/template - Click on *Create web scenario* to the right (or on the scenario name to edit an existing scenario) - Enter parameters of the scenario in the form The **Scenario** tab allows you to configure the general parameters of a web scenario.  All mandatory input fields are marked with a red asterisk. Scenario parameters: |Parameter|Description| |--|--------| |*Name*|Unique scenario name.<br>[User macros](/manual/config/macros/user_macros) are supported. *Note* that if user macros are used, these macros will be left unresolved in [web monitoring item](/manual/web_monitoring/items) names.| |*Update interval*|How often the scenario will be executed.<br>[Time suffixes](/manual/appendix/suffixes) are supported, e.g. 30s, 1m, 2h, 1d.<br>[User macros](/manual/config/macros/user_macros) are supported. *Note* that if a user macro is used and its value is changed (e.g. 5m → 30s), the next check will be executed according to the previous value (farther in the future with the example values). <br> New web scenarios will be checked within 60 seconds of their creation.| |*Attempts*|The number of attempts for executing web scenario steps. In case of network problems (timeout, no connectivity, etc) Zabbix can repeat executing a step several times. The figure set will equally affect each step of the scenario. Up to 10 attempts can be specified, default value is 1.<br>*Note*: Zabbix will not repeat a step because of a wrong response code or the mismatch of a required string.| |*Agent*|Select a client agent.<br>Zabbix will pretend to be the selected browser. This is useful when a website returns different content for different browsers.<br>User macros can be used in this field.| |*HTTP proxy*|You can specify an HTTP proxy to use, using the format `[protocol://][username[:password]@]proxy.example.com[:port]`.<br>This sets the [CURLOPT\_PROXY](https://curl.haxx.se/libcurl/c/CURLOPT_PROXY.html) cURL option.<br>The optional `protocol://` prefix may be used to specify alternative proxy protocols (the protocol prefix support was added in cURL 7.21.7). With no protocol specified, the proxy will be treated as an HTTP proxy.<br>By default, 1080 port will be used.<br>If specified, the proxy will overwrite proxy related environment variables like http\_proxy, HTTPS\_PROXY. If not specified, the proxy will not overwrite proxy-related environment variables. The entered value is passed on "as is", no sanity checking takes place.<br>You may also enter a SOCKS proxy address. If you specify the wrong protocol, the connection will fail and the item will become unsupported.<br>*Note* that only simple authentication is supported with HTTP proxy.<br>User macros can be used in this field.| |*Variables*|Variables that may be used in scenario steps (URL, post variables).<br>They have the following format:<br>**{macro1}**=value1<br>**{macro2}**=value2<br>**{macro3}**=regex:<regular expression><br>**{macro4}**=jsonpath:<jsonpath><br>**{macro5}**=xmlxpath:<xmlxpath><br>**{macro6}**={{macro}.function()} (see [macro functions](/manual/config/macros/macro_functions)).<br>*Note* that using JSONPath, XML XPath, and macro functions in variables is supported since Zabbix 7.0.4.<br>For example:<br>{username}=Alexei<br>{password}=kj3h5kJ34bd<br>{hostid}=regex:hostid is (\[0-9\]+)<br>{url}=jsonpath:$.host_url<br>{status}=xmlxpath://host/response/status<br>{newvar}={{myvar}.btoa()}<br>The macros can then be referenced in the steps as {username}, {password}, {hostid}, etc. Zabbix will automatically replace them with actual values. Note that variables with `regex:` need one step to get the value of the regular expression so the extracted value can only be applied to the step after.<br>If the value part starts with `regex:` then the part after it is treated as a regular expression that searches the web page and, if found, stores the match in the variable. At least one subgroup must be present so that the matched value can be extracted.<br>User macros and {HOST.\*} [macros](/manual/appendix/macros/supported_by_location) are supported.<br>Variables are automatically URL-encoded when used in query fields or form data for post variables, but must be URL-encoded manually when used in raw post or directly in URL.| |*Headers*|HTTP Headers are used when performing a request. Default and custom headers can be used.<br>Headers will be assigned using default settings depending on the Agent type selected from a drop-down list on a scenario level, and will be applied to all the steps, unless they are custom defined on a step level.<br>**It should be noted that defining the header on a step level automatically discards all the previously defined headers, except for a default header that is assigned by selecting the 'User-Agent' from a drop-down list on a scenario level.**<br>However, even the 'User-Agent' default header can be overridden by specifying it on a step level.<br>To unset the header on a scenario level, the header should be named and attributed with no value on a step level.<br>Headers should be listed using the same syntax as they would appear in the HTTP protocol, optionally using some additional features supported by the [CURLOPT\_HTTPHEADER](http://curl.haxx.se/libcurl/c/CURLOPT_HTTPHEADER.html) cURL option.<br>For example:<br>Accept-Charset=utf-8<br>Accept-Language=en-US<br>Content-Type=application/xml; charset=utf-8<br>User macros and {HOST.\*} [macros](/manual/appendix/macros/supported_by_location) are supported.| |*Enabled*|The scenario is active if this box is checked, otherwise - disabled.| Note that when editing an existing scenario, two extra buttons are available in the form: | | | |--|--------| ||Create another scenario based on the properties of the existing one.| ||Delete history and trend data for the scenario. This will make the server perform the scenario immediately after deleting the data.| ::: notetip If *HTTP proxy* field is left empty, another way for using an HTTP proxy is to set proxy related environment variables. For HTTP checks - set the **http\_proxy** environment variable for the Zabbix server user. For example, `http_proxy=http://proxy_ip:proxy_port`. For HTTPS checks - set the **HTTPS\_PROXY** environment variable. For example, `HTTPS_PROXY=http://proxy_ip:proxy_port`. More details are available by running a shell command: *\# man curl*. ::: The **Steps** tab allows you to configure the web scenario steps. To add a web scenario step, click on *Add* in the *Steps* block. {width="600"} ::: noteclassic Secret [user macros](/manual/config/macros/user_macros#configuration) must not be used in URLs as they will resolve to "\*\*\*\*\*\*". ::: #### Web scenārija konfigurēšana Lai konfigurētu web scenāriju: - Dodieties uz: *Datu vākšana → Hosts* (vai *Veidnes*) - Hosta/veidnes rindā noklikšķiniet uz *Web* - Labajā pusē noklikšķiniet uz *Izveidot web scenāriju* (vai uz scenārija nosaukuma, lai rediģētu esošu scenāriju) - Formā ievadiet scenārija parametrus Cilne **Scenārijs** ļauj konfigurēt web scenārija vispārīgos parametrus.  Visi obligātie ievades lauki ir atzīmēti ar sarkanu zvaigznīti. Scenārija parametri: |Parameter|Description| |--|--------| |*Name*|Unikāls scenārija nosaukums.<br>Tiek atbalstīti [lietotāja makrosi](/manual/config/macros/user_macros). *Piezīme*: ja tiek izmantoti lietotāja makrosi, šie makrosi paliks neatrisināti [web monitoring vienums](/manual/web_monitoring/items) nosaukumos.| |*Update interval*|Cik bieži scenārijs tiks izpildīts.<br>Tiek atbalstīti [laika sufiksi](/manual/appendix/suffixes), piemēram, 30s, 1m, 2h, 1d.<br>Tiek atbalstīti [lietotāja makrosi](/manual/config/macros/user_macros). *Piezīme*: ja tiek izmantots lietotāja makross un tā vērtība tiek mainīta (piem., 5m → 30s), nākamā pārbaude tiks izpildīta atbilstoši iepriekšējai vērtībai (ar dotajiem piemēriem - tālāk nākotnē). <br> Jauni web scenāriji tiks pārbaudīti 60 sekunžu laikā pēc to izveides.| |*Attempts*|Mēģinājumu skaits web scenārija soļu izpildei. Tīkla problēmu gadījumā (noildze, nav savienojuma utt.) Zabbix var atkārtot soļa izpildi vairākas reizes. Norādītā vērtība vienādi ietekmēs katru scenārija soli. Var norādīt līdz 10 mēģinājumiem, noklusējuma vērtība ir 1.<br>*Piezīme*: Zabbix neatkārtos soli nepareiza atbildes koda vai prasītās virknes neatbilstības dēļ.| |*Agent*|Atlasiet klienta aģentu.<br>Zabbix izliksies par atlasīto pārlūkprogrammu. Tas ir noderīgi, ja vietne dažādām pārlūkprogrammām atgriež atšķirīgu saturu.<br>Šajā laukā var izmantot lietotāja makrosus.| |*HTTP proxy*|Varat norādīt izmantojamo HTTP starpniekserveri, izmantojot formātu `[protocol://][username[:password]@]proxy.example.com[:port]`.<br>Tas iestata cURL opciju [CURLOPT\_PROXY](https://curl.haxx.se/libcurl/c/CURLOPT_PROXY.html).<br>Neobligāto prefiksu `protocol://` var izmantot, lai norādītu alternatīvus starpniekservera protokolus (protokola prefiksa atbalsts tika pievienots cURL 7.21.7). Ja protokols nav norādīts, starpniekserveris tiks uzskatīts par HTTP starpniekserveri.<br>Pēc noklusējuma tiks izmantots 1080 ports.<br>Ja norādīts, starpniekserveris pārrakstīs ar starpniekserveri saistītos vides mainīgos, piemēram, http\_proxy, HTTPS\_PROXY. Ja nav norādīts, starpniekserveris nepārrakstīs ar starpniekserveri saistītos vides mainīgos. Ievadītā vērtība tiek nodota "tā, kā ir", bez jebkādas pārbaudes.<br>Varat arī ievadīt SOCKS starpniekservera adresi. Ja norādīsiet nepareizu protokolu, savienojums neizdosies un vienums kļūs neatbalstīts.<br>*Piezīme*: ar HTTP starpniekserveri tiek atbalstīta tikai vienkārša autentifikācija.<br>Šajā laukā var izmantot lietotāja makrosus.| |*Variables*|Mainīgie, kurus var izmantot scenārija soļos (URL, post mainīgie).<br>Tiem ir šāds formāts:<br>**{macro1}**=value1<br>**{macro2}**=value2<br>**{macro3}**=regex:<regular expression><br>**{macro4}**=jsonpath:<jsonpath><br>**{macro5}**=xmlxpath:<xmlxpath><br>**{macro6}**={{macro}.function()} (skatiet [makro funkcijas](/manual/config/macros/macro_functions)).<br>*Piezīme*: JSONPath, XML XPath un makro funkciju izmantošana mainīgajos tiek atbalstīta kopš Zabbix 7.0.4.<br>Piemēram:<br>{username}=Alexei<br>{password}=kj3h5kJ34bd<br>{hostid}=regex:hostid is (\[0-9\]+)<br>{url}=jsonpath:$.host_url<br>{status}=xmlxpath://host/response/status<br>{newvar}={{myvar}.btoa()}<br>Pēc tam makrosus var izmantot soļos kā {username}, {password}, {hostid} utt. Zabbix tos automātiski aizstās ar faktiskajām vērtībām. Ņemiet vērā, ka mainīgajiem ar `regex:` ir nepieciešams viens solis, lai iegūtu regulārās izteiksmes vērtību, tāpēc iegūto vērtību var piemērot tikai nākamajam solim.<br>Ja vērtības daļa sākas ar `regex:`, tad daļa aiz tās tiek uzskatīta par regulāro izteiksmi, kas meklē tīmekļa lapā un, ja tiek atrasta, saglabā atbilstību mainīgajā. Jābūt vismaz vienai apakšgrupai, lai atbilstošo vērtību varētu iegūt.<br>Tiek atbalstīti lietotāja makrosi un {HOST.\*} [makrosi](/manual/appendix/macros/supported_by_location).<br>Mainīgie tiek automātiski URL kodēti, ja tos izmanto vaicājuma laukos vai formas datos post mainīgajiem, taču tie ir jāURL kodē manuāli, ja tos izmanto raw post vai tieši URL.| |*Headers*|HTTP galvenes tiek izmantotas, veicot pieprasījumu. Var izmantot noklusējuma un pielāgotās galvenes.<br>Galvenes tiks piešķirtas, izmantojot noklusējuma iestatījumus atkarībā no scenārija līmenī nolaižamajā sarakstā atlasītā Agent tipa, un tās tiks piemērotas visiem soļiem, ja vien tās nav pielāgotas soļa līmenī.<br>**Jāņem vērā, ka galvenes definēšana soļa līmenī automātiski atmet visas iepriekš definētās galvenes, izņemot noklusējuma galveni, kas tiek piešķirta, scenārija līmenī nolaižamajā sarakstā atlasot 'User-Agent'.**<br>Tomēr pat noklusējuma galveni 'User-Agent' var pārrakstīt, norādot to soļa līmenī.<br>Lai noņemtu galveni scenārija līmenī, galvenei jābūt nosauktai un soļa līmenī tai jābūt piešķirtai bez vērtības.<br>Galvenes jāuzskaita, izmantojot to pašu sintaksi, kāda tām būtu HTTP protokolā, pēc izvēles izmantojot dažas papildu funkcijas, ko atbalsta cURL opcija [CURLOPT\_HTTPHEADER](http://curl.haxx.se/libcurl/c/CURLOPT_HTTPHEADER.html).<br>Piemēram:<br>Accept-Charset=utf-8<br>Accept-Language=en-US<br>Content-Type=application/xml; charset=utf-8<br>Tiek atbalstīti lietotāja makrosi un {HOST.\*} [makrosi](/manual/appendix/macros/supported_by_location).| |*Enabled*|Scenārijs ir aktīvs, ja šis lodziņš ir atzīmēts, pretējā gadījumā - atspējots.| Ņemiet vērā, ka, rediģējot esošu scenāriju, formā ir pieejamas divas papildu pogas: | | | |--|--------| ||Izveidot vēl vienu scenāriju, pamatojoties uz esošā scenārija īpašībām.| ||Dzēst scenārija vēstures un tendenču datus. Tas liks serverim nekavējoties izpildīt scenāriju pēc datu dzēšanas.| ::: notetip Ja lauks *HTTP proxy* ir atstāts tukšs, vēl viens veids, kā izmantot HTTP starpniekserveri, ir iestatīt ar starpniekserveri saistītos vides mainīgos. HTTP pārbaudēm - iestatiet **http\_proxy** vides mainīgo Zabbix servera lietotājam. Piemēram, `http_proxy=http://proxy_ip:proxy_port`. HTTPS pārbaudēm - iestatiet **HTTPS\_PROXY** vides mainīgo. Piemēram, `HTTPS_PROXY=http://proxy_ip:proxy_port`. Papildu informācija ir pieejama, izpildot čaulas komandu: *\# man curl*. ::: Cilne **Soļi** ļauj konfigurēt web scenārija soļus. Lai pievienotu web scenārija soli, blokā *Soļi* noklikšķiniet uz *Pievienot*. {width="600"} ::: noteclassic Slepenus [lietotāja makrosus](/manual/config/macros/user_macros#configuration) URL nedrīkst izmantot, jo tie tiks atrisināti kā "\*\*\*\*\*\*". ::: #### Configuring custom graphs To create a custom graph, do the following: - Go to *Data collection > Hosts (or Templates)* - Click on *Graphs* in the row next to the desired host or template - In the Graphs screen click on *Create graph* - Edit graph attributes {width="600"} All mandatory input fields are marked with a red asterisk. Graph attributes: |Parameter|<|Description| |-|----------|----------------------------------------| |*Name*|<|Unique graph name.<br>Expression [macros](/manual/appendix/macros/supported_by_location) are supported in this field, but only with `avg`, `last`, `min` and `max` functions, with time as parameter (for example, `{?avg(/host/key,1h)}`).<br>{HOST.HOST<1-9>} macros are supported for the use within this macro, referencing the first, second, third, etc. host in the graph, for example `{?avg(/{HOST.HOST2}/key,1h)}`. Note that referencing the first host with this macro is redundant, as the first host can be referenced implicitly, for example `{?avg(//key,1h)}`.| |*Width*|<|Graph width in pixels (for preview and pie/exploded graphs only).| |*Height*|<|Graph height in pixels.| |*Graph type*|<|Graph type:<br>**Normal** - normal graph, values displayed as lines<br>**Stacked** - stacked graph, filled areas displayed<br>**Pie** - pie graph<br>**Exploded** - "exploded" pie graph, portions displayed as "cut out" of the pie| |*Show legend*|<|Checking this box will set to display the graph legend.| |*Show working time*|<|If selected, non-working hours will be shown with a gray background. This parameter is not available for pie and exploded pie graphs.| |*Show triggers*|<|If selected, [simple triggers](/manual/web_interface/frontend_sections/dashboards/widgets/graph#displaying-options) will be displayed as lines with black dashes over trigger severity color. This parameter is not available for pie and exploded pie graphs.| |*Percentile line (left)*|<|Display percentile for left Y-axis. If, for example, 95% percentile is set, then the percentile line will be at the level where 95 percent of the values fall under. Displayed as a bright green line. Only available for normal graphs.| |*Percentile line (right)*|<|Display percentile for right Y-axis. If, for example, 95% percentile is set, then the percentile line will be at the level where 95 percent of the values fall under. Displayed as a bright red line. Only available for normal graphs.| |*Y axis MIN value*|<|Minimum value of Y-axis:<br>**Calculated** - Y axis minimum value will be automatically calculated.<br>**Fixed** - fixed minimum value for Y-axis. <br>**Item** - last value of the selected item will be the minimum value.<br><br> This parameter is not available for pie and exploded pie graphs.| |*Y axis MAX value*|<|Maximum value of Y-axis:<br>**Calculated** - Y axis maximum value will be automatically calculated.<br>**Fixed** - fixed maximum value for Y-axis. <br>**Item** - last value of the selected item will be the maximum value<br><br> This parameter is not available for pie and exploded pie graphs.| |*3D view*|<|Enable 3D style. For pie and exploded pie graphs only.| |*Items*|<|Items, data of which are to be displayed in this graph. Click on *Add* to select items. You can also select various displaying options (function, draw style, left/right axis display, color).| |<|*Sort order (0→100)*|Draw order. 0 will be processed first. Can be used to draw lines or regions behind (or in front of) another.<br>You can drag and drop items using the icon at the beginning of a line to set the sort order or which item is displayed in front of the other.| |^|*Name*|Name of the selected item is displayed as a link. Clicking on the link opens the list of other available items.| |^|*Type*|Type (only available for pie and exploded pie graphs):<br>**Simple** - the value of the item is represented proportionally on the pie<br>**Graph sum** - the value of the item represents the whole pie<br>Note that coloring of the "graph sum" item will only be visible to the extent that it is not taken up by "proportional" items.| |^|*Function*|Select what values will be displayed when more than one value exists per vertical graph pixel for an item:<br>**all** - display all possible values (minimum, maximum, average) in the graph. Note that for shorter periods this setting has no effect; only for longer periods, when data congestion in a vertical graph pixel increases, 'all' starts displaying minimum, maximum, and average values. This function is only available for *Normal* graph type. See also: Generating graphs [from history/trends](/manual/config/visualization/graphs/simple#generating-from-historytrends).<br>**avg** - display the average values<br>**last** - display the latest values. This function is only available if either *Pie/Exploded pie* is selected as graph type.<br>**max** - display the maximum values<br>**min** - display the minimum values| |^|*Draw style*|Select the draw style (only available for normal graphs; for stacked graphs filled region is always used) to apply to the item data - *Line*, *Bold line*, *Filled region*, *Dot*, *Dashed line*, *Gradient line*.| |^|*Y axis side*|Select the Y axis side to show the item data - *Left*, *Right*.| |^|*Color*|Select the color to apply to the item data.| #### Pielāgotu grafiku konfigurēšana Lai izveidotu pielāgotu grafiku, rīkojieties šādi: - Dodieties uz *Datu vākšana > Hosts (vai veidnes)* - Rindā blakus vajadzīgajam hostam vai veidnei noklikšķiniet uz *Grafiki* - Grafiku ekrānā noklikšķiniet uz *Izveidot grafiku* - Rediģējiet grafika atribūtus {width="600"} Visi obligātie ievades lauki ir atzīmēti ar sarkanu zvaigznīti. Grafika atribūti: |Parameter|<|Description| |-|----------|----------------------------------------| |*Name*|<|Unikāls grafika nosaukums.<br>Šajā laukā tiek atbalstītas izteiksmes [macros](/manual/appendix/macros/supported_by_location), taču tikai ar funkcijām `avg`, `last`, `min` un `max`, izmantojot laiku kā parametru (piemēram, `{?avg(/host/key,1h)}`).<br>{HOST.HOST<1-9>} macros tiek atbalstītas izmantošanai šajā macro, atsaucoties uz pirmo, otro, trešo utt. hostu grafikā, piemēram, `{?avg(/{HOST.HOST2}/key,1h)}`. Ņemiet vērā, ka atsaukšanās uz pirmo hostu ar šo macro ir lieka, jo uz pirmo hostu var atsaukties netieši, piemēram, `{?avg(//key,1h)}`.| |*Width*|<|Grafika platums pikseļos (tikai priekšskatījumam un sektoru/izvērsto sektoru grafikiem).| |*Height*|<|Grafika augstums pikseļos.| |*Graph type*|<|Grafika tips:<br>**Normal** - parasts grafiks, vērtības tiek attēlotas kā līnijas<br>**Stacked** - sakrauts grafiks, tiek attēlotas aizpildītas zonas<br>**Pie** - sektoru grafiks<br>**Exploded** - "izvērsts" sektoru grafiks, daļas tiek attēlotas kā "izgrieztas" no sektora| |*Show legend*|<|Atzīmējot šo izvēles rūtiņu, tiks parādīta grafika leģenda.| |*Show working time*|<|Ja šī opcija ir atlasīta, nestrādājošais laiks tiks parādīts ar pelēku fonu. Šis parametrs nav pieejams sektoru un izvērsto sektoru grafikiem.| |*Show triggers*|<|Ja šī opcija ir atlasīta, [vienkāršie trigeri](/manual/web_interface/frontend_sections/dashboards/widgets/graph#displaying-options) tiks parādīti kā līnijas ar melnām svītrām virs trigeru nopietnības krāsas. Šis parametrs nav pieejams sektoru un izvērsto sektoru grafikiem.| |*Percentile line (left)*|<|Parādīt procentili kreisajai Y asij. Ja, piemēram, ir iestatīta 95% procentile, tad procentiles līnija būs līmenī, zem kura atrodas 95 procenti vērtību. Tiek attēlota kā spilgti zaļa līnija. Pieejams tikai parastajiem grafikiem.| |*Percentile line (right)*|<|Parādīt procentili labajai Y asij. Ja, piemēram, ir iestatīta 95% procentile, tad procentiles līnija būs līmenī, zem kura atrodas 95 procenti vērtību. Tiek attēlota kā spilgti sarkana līnija. Pieejams tikai parastajiem grafikiem.| |*Y axis MIN value*|<|Y ass minimālā vērtība:<br>**Calculated** - Y ass minimālā vērtība tiks aprēķināta automātiski.<br>**Fixed** - fiksēta Y ass minimālā vērtība. <br>**Item** - atlasītā vienuma pēdējā vērtība būs minimālā vērtība.<br><br> Šis parametrs nav pieejams sektoru un izvērsto sektoru grafikiem.| |*Y axis MAX value*|<|Y ass maksimālā vērtība:<br>**Calculated** - Y ass maksimālā vērtība tiks aprēķināta automātiski.<br>**Fixed** - fiksēta Y ass maksimālā vērtība. <br>**Item** - atlasītā vienuma pēdējā vērtība būs maksimālā vērtība<br><br> Šis parametrs nav pieejams sektoru un izvērsto sektoru grafikiem.| |*3D view*|<|Iespējot 3D stilu. Tikai sektoru un izvērsto sektoru grafikiem.| |*Items*|<|Vienumi, kuru dati tiks attēloti šajā grafikā. Noklikšķiniet uz *Pievienot*, lai atlasītu vienumus. Varat arī atlasīt dažādas attēlošanas opcijas (funkcija, zīmēšanas stils, kreisās/labās ass attēlošana, krāsa).| |<|*Sort order (0→100)*|Zīmēšanas secība. 0 tiks apstrādāts pirmais. Var izmantot, lai zīmētu līnijas vai apgabalus aiz cita (vai tā priekšā).<br>Varat vilkt un nomest vienumus, izmantojot ikonu rindas sākumā, lai iestatītu kārtošanas secību vai noteiktu, kurš vienums tiek attēlots cita priekšā.| |^|*Name*|Atlasītā vienuma nosaukums tiek parādīts kā saite. Noklikšķinot uz saites, tiek atvērts citu pieejamo vienumu saraksts.| |^|*Type*|Tips (pieejams tikai sektoru un izvērsto sektoru grafikiem):<br>**Simple** - vienuma vērtība tiek attēlota proporcionāli sektorā<br>**Graph sum** - vienuma vērtība attēlo visu sektoru<br>Ņemiet vērā, ka "graph sum" vienuma krāsojums būs redzams tikai tiktāl, cik to neaizņem "proportional" vienumi.| |^|*Function*|Atlasiet, kuras vērtības tiks attēlotas, ja vienumam uz vienu vertikālo grafika pikseli ir vairāk nekā viena vērtība:<br>**all** - attēlot visas iespējamās vērtības (minimumu, maksimumu, vidējo) grafikā. Ņemiet vērā, ka īsākiem periodiem šim iestatījumam nav ietekmes; tikai garākiem periodiem, kad datu blīvums vienā vertikālajā grafika pikselī palielinās, 'all' sāk attēlot minimālās, maksimālās un vidējās vērtības. Šī funkcija ir pieejama tikai *Normal* grafika tipam. Skatiet arī: Grafiku ģenerēšana [no vēstures/tendencēm](/manual/config/visualization/graphs/simple#generating-from-historytrends).<br>**avg** - attēlot vidējās vērtības<br>**last** - attēlot jaunākās vērtības. Šī funkcija ir pieejama tikai tad, ja grafika tips ir *Pie/Exploded pie*.<br>**max** - attēlot maksimālās vērtības<br>**min** - attēlot minimālās vērtības| |^|*Draw style*|Atlasiet zīmēšanas stilu (pieejams tikai parastajiem grafikiem; sakrautiem grafikiem vienmēr tiek izmantots aizpildīts apgabals), ko piemērot vienuma datiem - *Line*, *Bold line*, *Filled region*, *Dot*, *Dashed line*, *Gradient line*.| |^|*Y axis side*|Atlasiet Y ass pusi, kurā rādīt vienuma datus - *Left*, *Right*.| |^|*Color*|Atlasiet krāsu, ko piemērot vienuma datiem.| #### Configuring *Discovery status* widget Configure a *Discovery status* widget with the refresh interval set to 15 minutes. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "discovery", "name": "Discovery status", "x": 0, "y": 0, "width": 18, "height": 3, "view_mode": 0, "fields": [ { "type": 0, "name": "rf_rate", "value": 900 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### *Atklāšanas statusa* logrīka konfigurēšana Konfigurējiet *Atklāšanas statusa* logrīku, iestatot atsvaidzināšanas intervālu uz 15 minūtēm. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "discovery", "name": "Discovery status", "x": 0, "y": 0, "width": 18, "height": 3, "view_mode": 0, "fields": [ { "type": 0, "name": "rf_rate", "value": 900 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring JMX interfaces and items in Zabbix frontend With Java gateway running, server knowing where to find it and a Java application started with support for remote JMX monitoring, it is time to configure the interfaces and items in Zabbix GUI. #### JMX saskarņu un vienumu konfigurēšana Zabbix lietotāja saskarnē Kad Java gateway darbojas, serveris zina, kur to atrast, un Java lietojumprogramma ir palaista ar attālinātās JMX uzraudzības atbalstu, ir laiks konfigurēt saskarnes un vienumus Zabbix lietotāja saskarnē. ##### Configuring JMX interface You begin by creating a JMX-type interface on the host of interest. {width="600"} All mandatory input fields are marked with a red asterisk. ##### JMX saskarnes konfigurēšana Jūs sākat, izveidojot JMX tipa saskarni interesējošajā hostā. {width="600"} Visi obligātie ievades lauki ir atzīmēti ar sarkanu zvaigznīti. #### Configuring low-level discovery rules See the [low-level discovery](/manual/discovery/low_level_discovery) section of the manual. #### Zema līmeņa atklāšanas noteikumu konfigurēšana Skatiet rokasgrāmatas sadaļu [zema līmeņa atklāšana](/manual/discovery/low_level_discovery). ### Configuring low-level discovery We will illustrate low-level discovery based on an example of file system discovery. To configure the discovery, do the following: 1. Go to *Data collection* > *Templates* or *Hosts*. 2. Click *Discovery* in the row of an appropriate template/host. {width="600"} 3. Click *Create discovery rule* in the upper-right corner of the screen. 4. Fill in the discovery rule form with the required details. ### Zema līmeņa atklāšanas konfigurēšana Mēs ilustrēsim zema līmeņa atklāšanu, izmantojot failu sistēmas atklāšanas piemēru. Lai konfigurētu atklāšanu, veiciet šādas darbības: 1. Dodieties uz *Datu vākšana* > *Veidnes* vai *Hosts*. 2. Atbilstošas veidnes/hosta rindā noklikšķiniet uz *Atklāšana*. {width="600"} 3. Ekrāna augšējā labajā stūrī noklikšķiniet uz *Izveidot atklāšanas noteikumu*. 4. Aizpildiet atklāšanas noteikuma veidlapu ar nepieciešamo informāciju. #### Configuring nested templates To link templates, you need to take an existing template (or create a new one), and then: 1. Open the [template configuration form](/manual/config/templates/template#creating-a-template). 2. Find the *Templates* field. 3. Click on *Select* to open the *Templates* pop-up window. 4. In the pop-up window, choose the required templates, and then click on *Select* to add the templates to the list. 5. Click on *Add* or *Update* in the template configuration form. Thus, all entities of the configured template, as well as all entities of linked templates will now appear in the template configuration. This includes items, triggers, graphs, low-level discovery rules, and web scenarios, but excludes dashboards. However, linked template dashboards will, nevertheless, be inherited by hosts. To unlink any of the linked templates, click on *Unlink* or *Unlink and clear* in the template configuration form, and then click on *Update*. The *Unlink* option will simply remove the association with the linked template, while not removing any of its entities (items, triggers, etc.). The *Unlink and clear* option will remove both the association with the linked template, as well as all its entities (items, triggers, etc.). #### Iekļauto veidņu konfigurēšana Lai saistītu veidnes, jums ir jāņem esoša veidne (vai jāizveido jauna), un pēc tam: 1. Atveriet [veidnes konfigurācijas formu](/manual/config/templates/template#creating-a-template). 2. Atrodiet lauku *Templates*. 3. Noklikšķiniet uz *Select*, lai atvērtu uznirstošo logu *Templates*. 4. Uznirstošajā logā izvēlieties nepieciešamās veidnes un pēc tam noklikšķiniet uz *Select*, lai pievienotu veidnes sarakstam. 5. Veidnes konfigurācijas formā noklikšķiniet uz *Add* vai *Update*. Tādējādi visi konfigurētās veidnes objekti, kā arī visu saistīto veidņu objekti tagad būs redzami veidnes konfigurācijā. Tas ietver vienumus, trigerus, grafikus, zemā līmeņa atklāšanas noteikumus un tīmekļa scenārijus, bet neietver informācijas paneļus. Tomēr saistīto veidņu informācijas paneļi joprojām tiks mantoti hosts. Lai atsaistītu jebkuru no saistītajām veidnēm, veidnes konfigurācijas formā noklikšķiniet uz *Unlink* vai *Unlink and clear* un pēc tam noklikšķiniet uz *Update*. Opcija *Unlink* vienkārši noņems saistību ar saistīto veidni, bet nenoņems nevienu no tās objektiem (vienumus, trigerus utt.). Opcija *Unlink and clear* noņems gan saistību ar saistīto veidni, gan visus tās objektus (vienumus, trigerus utt.). ##### Configuring Perl trap receiver Requirements: Perl, Net-SNMP compiled with `--enable-embedded-perl` (done by default since Net-SNMP 5.4) A Perl trap receiver (look for `misc/snmptrap/zabbix\_trap\_receiver.pl`) can be used to pass traps to Zabbix server directly from snmptrapd. To configure it: - Add the Perl script to the snmptrapd configuration file (`snmptrapd.conf`), e.g.: ```perl perl do "[FULL PATH TO PERL RECEIVER SCRIPT]"; ``` - configure the receiver, e.g: ```ini $SNMPTrapperFile = '[TRAP FILE]'; $DateTimeFormat = '[DATE TIME FORMAT]'; ``` :::notetip snmptrapd might need to be restarted to pick up changes to its configuration. ::: ::: notetip If the script name is not quoted, snmptrapd will refuse to start up with messages, similar to these:<br><br> ```yaml Regexp modifiers "/l" and "/a" are mutually exclusive at (eval 2) line 1, at end of line Regexp modifier "/l" may not appear twice at (eval 2) line 1, at end of line ``` ::: ##### Perl trigeru uztvērēja konfigurēšana Prasības: Perl, Net-SNMP, kas kompilēts ar `--enable-embedded-perl` (pēc noklusējuma tas ir izdarīts kopš Net-SNMP 5.4) Perl trigeru uztvērēju (meklējiet `misc/snmptrap/zabbix\_trap\_receiver.pl`) var izmantot, lai nodotu trigerus uz Zabbix serveris tieši no snmptrapd. Lai to konfigurētu: - Pievienojiet Perl skriptu snmptrapd konfigurācijas failam (`snmptrapd.conf`), piemēram: ```perl perl do "[FULL PATH TO PERL RECEIVER SCRIPT]"; ``` - konfigurējiet uztvērēju, piemēram: ```ini $SNMPTrapperFile = '[TRAP FILE]'; $DateTimeFormat = '[DATE TIME FORMAT]'; ``` :::notetip Lai snmptrapd ielādētu konfigurācijas izmaiņas, var būt nepieciešams to restartēt. ::: ::: notetip Ja skripta nosaukums nav ievietots pēdiņās, snmptrapd atteiksies startēties un parādīs ziņojumus, kas līdzīgi šiem:<br><br> ```yaml Regexp modifiers "/l" and "/a" are mutually exclusive at (eval 2) line 1, at end of line Regexp modifier "/l" may not appear twice at (eval 2) line 1, at end of line ``` ::: #### Configuring plugins This section provides common plugin configuration principles and best practices. All plugins are configured using `Plugins.\*` parameter, which can either be part of the Zabbix agent 2 [configuration file](/manual/appendix/config/zabbix_agent2) or a plugin's own [configuration file](/manual/appendix/config/zabbix_agent2_plugins). If a plugin uses a separate configuration file, path to this file should be specified in the Include parameter of Zabbix agent 2 configuration file. A typical plugin parameter has the following structure: `Plugins.<PluginName>.<Parameter>=<Value>` Additionally, there are two specific groups of parameters: - `Plugins.<PluginName>.Default.<Parameter>=<Value>` used for defining [default parameter values](#default-values). - `Plugins.<PluginName>.<SessionName>.<Parameter>=<Value>` used for defining separate sets of parameters for different monitoring targets via [named sessions](#named-sessions). All parameter names should adhere to the following requirements: - It is recommended to capitalize the names of your plugins. - The parameter should be capitalized. - Special characters are not allowed. - Nesting isn't limited by a maximum level. - The number of parameters is not limited. For example, to perform [active checks](/manual/concepts/agent2#passive-and-active-checks) that do not have *Scheduling* [update interval](/manual/config/items/item/custom_intervals#scheduling-intervals) immediately after the agent restart only for the Uptime plugin, set `Plugins.Uptime.System.ForceActiveChecksOnStart=1` in the [configuration file](/manual/appendix/config/zabbix_agent2). Similarly, to set custom limit for [concurrent checks](/manual/concepts/agent2#check-concurrency) for the CPU plugin, set the `Plugins.CPU.System.Capacity=N` in the [configuration file](/manual/appendix/config/zabbix_agent2). #### Spraudņu konfigurēšana Šajā sadaļā ir aprakstīti vispārīgi spraudņu konfigurēšanas principi un labākā prakse. Visi spraudņi tiek konfigurēti, izmantojot `Plugins.\*` parametru, kas var būt vai nu Zabbix aģents 2 [konfigurācijas faila](/manual/appendix/config/zabbix_agent2) daļa, vai arī paša spraudņa [konfigurācijas fails](/manual/appendix/config/zabbix_agent2_plugins). Ja spraudnis izmanto atsevišķu konfigurācijas failu, šī faila ceļš jānorāda Zabbix aģents 2 konfigurācijas faila parametrā Include. Tipiskam spraudņa parametram ir šāda struktūra: `Plugins.<PluginName>.<Parameter>=<Value>` Papildus ir divas specifiskas parametru grupas: - `Plugins.<PluginName>.Default.<Parameter>=<Value>` tiek izmantots [noklusējuma parametru vērtību](#default-values) definēšanai. - `Plugins.<PluginName>.<SessionName>.<Parameter>=<Value>` tiek izmantots atsevišķu parametru kopu definēšanai dažādiem uzraudzības mērķiem, izmantojot [nosauktās sesijas](#named-sessions). Visiem parametru nosaukumiem jāatbilst šādām prasībām: - Ieteicams spraudņu nosaukumus rakstīt ar lielajiem burtiem. - Parametram jābūt rakstītam ar lielo sākumburtu. - Speciālās rakstzīmes nav atļautas. - Iekļaušanas dziļums nav ierobežots ar maksimālo līmeni. - Parametru skaits nav ierobežots. Piemēram, lai tikai Uptime spraudnim pēc aģents restartēšanas nekavējoties veiktu [aktīvās pārbaudes](/manual/concepts/agent2#passive-and-active-checks), kurām nav *Scheduling* [atjaunināšanas intervāla](/manual/config/items/item/custom_intervals#scheduling-intervals), konfigurācijas failā [/manual/appendix/config/zabbix_agent2) iestatiet `Plugins.Uptime.System.ForceActiveChecksOnStart=1`. Līdzīgi, lai CPU spraudnim iestatītu pielāgotu [vienlaicīgo pārbaužu](/manual/concepts/agent2#check-concurrency) limitu, konfigurācijas failā [/manual/appendix/config/zabbix_agent2) iestatiet `Plugins.CPU.System.Capacity=N`. #### Configuring proxy load balancing To use proxy load balancing, you need to configure a proxy group in Zabbix frontend (see above) and make sure that hosts are [monitored by](/manual/config/hosts/host#configuration) a proxy group, not individual proxies (you may use host [mass update](/manual/config/hosts/hostupdate) to move hosts from proxies to the proxy group). If using Zabbix agent, also configure it as follows: - For [passive checks](/manual/appendix/items/activepassive), list all proxy group proxies in the [Server](/manual/appendix/config/zabbix_agentd#server) parameter. - For [active checks](/manual/appendix/items/activepassive), it's recommended to list all proxy group proxies or Zabbix server in the [ServerActive](/manual/appendix/config/zabbix_agentd#serveractive) parameter. Note that only Zabbix agent 7.0 (or later) will work with proxy groups in its active mode. If the `ServerActive` parameter includes only one proxy from a proxy group (or Zabbix server), the agent will still be able to connect to the correct proxy. When the agent service starts and connects to the specified proxy, the agent will receive and cache the full list of proxy IPs and their current load within the group. Then, active checks will be redirected to the correct online proxy for the host, based on the current proxy-host assignment within the proxy group. ::: notewarning Having only a single proxy specified in Zabbix agent `ServerActive` parameter may lead to lost monitoring data if the agent is started/rebooted while the specified proxy is offline. ::: ::: noteclassic When using [Zabbix sender](/manual/concepts/sender), data requests are also redirected to the correct online proxy for the host, based on the current proxy-host assignment within the proxy group. However, if you're sending values of multiple hosts from an input file, use the [`-g` option](/manpages/zabbix_sender) to prevent sending data to the wrong proxy. ::: Zabbix agent must also be able to connect to all proxies in the proxy group through the firewall. Otherwise, active checks may hang or fail during redirection or failover. For example: - During active checks, a proxy may redirect the agent to another proxy. If that proxy is blocked by a firewall, the communication will hang while waiting for a response. - In stable high-availability setups without recent rebalancing, agents may never contact backup proxies. If firewall rules changed and weren't tested, failover may fail. #### Starpniekservera slodzes balansēšanas konfigurēšana Lai izmantotu starpniekservera slodzes balansēšanu, jums ir jākonfigurē starpniekserveru grupa Zabbix lietotāja saskarnē (skatiet iepriekš) un jāpārliecinās, ka hosts tiek [uzraudzīti ar](/manual/config/hosts/host#configuration) starpniekserveru grupu, nevis ar atsevišķiem starpniekserveriem (varat izmantot hostu [masveida atjaunināšanu](/manual/config/hosts/hostupdate), lai pārvietotu hostus no starpniekserveriem uz starpniekserveru grupu). Ja izmantojat Zabbix aģentu, konfigurējiet to arī šādi: - [Pasīvajām pārbaudēm](/manual/appendix/items/activepassive) parametram [Server](/manual/appendix/config/zabbix_agentd#server) norādiet visus starpniekserveru grupas starpniekserverus. - [Aktīvajām pārbaudēm](/manual/appendix/items/activepassive) ieteicams parametram [ServerActive](/manual/appendix/config/zabbix_agentd#serveractive) norādīt visus starpniekserveru grupas starpniekserverus vai Zabbix serveri. Ņemiet vērā, ka ar starpniekserveru grupām aktīvajā režīmā darbosies tikai Zabbix aģents 7.0 (vai jaunāks). Ja parametrs `ServerActive` ietver tikai vienu starpniekserveri no starpniekserveru grupas (vai Zabbix serveri), aģents joprojām varēs izveidot savienojumu ar pareizo starpniekserveri. Kad aģenta pakalpojums tiek palaists un izveido savienojumu ar norādīto starpniekserveri, aģents saņems un kešatmiņā saglabās pilnu starpniekserveru IP adrešu sarakstu un to pašreizējo slodzi grupā. Pēc tam aktīvās pārbaudes tiks pāradresētas uz pareizo tiešsaistes starpniekserveri attiecīgajam hostam, pamatojoties uz pašreizējo starpniekservera un hosta piešķīrumu starpniekserveru grupā. ::: notewarning Ja Zabbix aģenta parametrā `ServerActive` ir norādīts tikai viens starpniekserveris, tas var izraisīt uzraudzības datu zudumu, ja aģents tiek palaists vai restartēts, kamēr norādītais starpniekserveris ir bezsaistē. ::: ::: noteclassic Izmantojot [Zabbix sender](/manual/concepts/sender), datu pieprasījumi arī tiek pāradresēti uz pareizo tiešsaistes starpniekserveri attiecīgajam hostam, pamatojoties uz pašreizējo starpniekservera un hosta piešķīrumu starpniekserveru grupā. Tomēr, ja sūtāt vairāku hostu vērtības no ievades faila, izmantojiet [`-g` opciju](/manpages/zabbix_sender), lai novērstu datu nosūtīšanu uz nepareizo starpniekserveri. ::: Zabbix aģentam arī jāspēj caur ugunsmūri izveidot savienojumu ar visiem starpniekserveriem starpniekserveru grupā. Pretējā gadījumā aktīvās pārbaudes var iestrēgt vai neizdoties pāradresācijas vai atteices pārslēgšanas laikā. Piemēram: - Aktīvo pārbaužu laikā starpniekserveris var pāradresēt aģentu uz citu starpniekserveri. Ja šis starpniekserveris ir bloķēts ar ugunsmūri, saziņa iestrēgs, gaidot atbildi. - Stabilās augstas pieejamības konfigurācijās bez nesenas līdzsvarošanas aģenti, iespējams, nekad nesazināsies ar rezerves starpniekserveriem. Ja ugunsmūra noteikumi ir mainīti un nav pārbaudīti, atteices pārslēgšana var neizdoties. #### Configuring PSK for server - active proxy communication (example) On the proxy, write the PSK value into a file, for example, `/home/zabbix/zabbix_proxy.psk`. The file must contain PSK in the first text string, for example: e560cb0d918d26d31b4f642181f5f570ad89a390931102e5391d08327ba434e9 Set access rights to PSK file - it must be readable only by Zabbix user. Edit TLS parameters in proxy configuration file `zabbix_proxy.conf`, for example, set: TLSConnect=psk TLSPSKFile=/home/zabbix/zabbix_proxy.psk TLSPSKIdentity=PSK 002 The proxy will connect to server using PSK. PSK identity will be "PSK 002". (To minimize downtime see how to change connection type in [Connection encryption management](/manual/encryption#connection-encryption-management)). Configure PSK for this proxy in Zabbix frontend. Go to *Administration→Proxies*, select the proxy, go to "Encryption" tab. In "Connections from proxy" mark `PSK`. Paste into "PSK identity" field "PSK 002" and "e560cb0d918d26d31b4f642181f5f570ad89a390931102e5391d08327ba434e9" into "PSK" field. Click "Update". Restart proxy. It will start using PSK-based encrypted connections to server. Check server and proxy logfiles for error messages. For a passive proxy the procedure is very similar. The only difference - set `TLSAccept=psk` in proxy configuration file and set "Connections to proxy" in Zabbix frontend to `PSK`. #### PSK konfigurēšana servera - aktīvā starpniekservera saziņai (piemērs) Starpniekserverī ierakstiet PSK vērtību failā, piemēram, `/home/zabbix/zabbix_proxy.psk`. Faila pirmajā teksta rindā jābūt PSK, piemēram: e560cb0d918d26d31b4f642181f5f570ad89a390931102e5391d08327ba434e9 Iestatiet PSK failam piekļuves tiesības — tam jābūt lasāmam tikai Zabbix lietotājam. Rediģējiet TLS parametrus starpniekservera konfigurācijas failā `zabbix_proxy.conf`, piemēram, iestatiet: TLSConnect=psk TLSPSKFile=/home/zabbix/zabbix_proxy.psk TLSPSKIdentity=PSK 002 Starpniekserveris izveidos savienojumu ar serveri, izmantojot PSK. PSK identitāte būs "PSK 002". (Lai samazinātu dīkstāvi, skatiet, kā mainīt savienojuma tipu sadaļā [Savienojuma šifrēšanas pārvaldība](/manual/encryption#connection-encryption-management)). Konfigurējiet PSK šim starpniekserverim Zabbix lietotāja saskarnē. Dodieties uz *Administration→Proxies*, atlasiet starpniekserveri, atveriet cilni "Encryption". Laukā "Connections from proxy" atzīmējiet `PSK`. Laukā "PSK identity" ievadiet "PSK 002", bet laukā "PSK" ievietojiet "e560cb0d918d26d31b4f642181f5f570ad89a390931102e5391d08327ba434e9". Noklikšķiniet uz "Update". Restartējiet starpniekserveri. Tas sāks izmantot ar PSK balstītus šifrētus savienojumus ar serveri. Pārbaudiet servera un starpniekservera žurnālfailus, vai tajos nav kļūdu ziņojumu. Pasīvam starpniekserverim procedūra ir ļoti līdzīga. Vienīgā atšķirība — starpniekservera konfigurācijas failā iestatiet `TLSAccept=psk`, bet Zabbix lietotāja saskarnē laukā "Connections to proxy" iestatiet `PSK`. #### Configuring PSK for server-agent communication (example) On the agent host, write the PSK value into a file, for example, `/home/zabbix/zabbix_agentd.psk`. The file must contain PSK in the first text string, for example: 1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952 Set access rights to PSK file - it must be readable only by Zabbix user. Edit TLS parameters in agent configuration file `zabbix_agentd.conf`, for example, set: TLSConnect=psk TLSAccept=psk TLSPSKFile=/home/zabbix/zabbix_agentd.psk TLSPSKIdentity=PSK 001 The agent will connect to server (active checks) and accept from server and `zabbix_get` only connections using PSK. PSK identity will be "PSK 001". Restart the agent. Now you can test the connection using `zabbix_get`, for example: zabbix_get -s 127.0.0.1 -k "system.cpu.load[all,avg1]" --tls-connect=psk --tls-psk-identity="PSK 001" --tls-psk-file=/home/zabbix/zabbix_agentd.psk (To minimize downtime see how to change connection type in [Connection encryption management](/manual/encryption#connection-encryption-management)). Configure PSK encryption for this agent in Zabbix frontend: - Go to: *Data collection → Hosts* - Select host and click on **Encryption** tab Example: {width="600"} All mandatory input fields are marked with a red asterisk. When configuration cache is synchronized with database the new connections will use PSK. Check server and agent logfiles for error messages. #### PSK konfigurēšana servera-aģenta saziņai (piemērs) Aģenta hostā ierakstiet PSK vērtību failā, piemēram, `/home/zabbix/zabbix_agentd.psk`. Failā PSK jābūt pirmajā teksta rindā, piemēram: 1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952 Iestatiet piekļuves tiesības PSK failam - tam jābūt lasāmam tikai Zabbix lietotājam. Rediģējiet TLS parametrus aģenta konfigurācijas failā `zabbix_agentd.conf`, piemēram, iestatiet: TLSConnect=psk TLSAccept=psk TLSPSKFile=/home/zabbix/zabbix_agentd.psk TLSPSKIdentity=PSK 001 Aģents izveidos savienojumu ar serveris (aktīvās pārbaudes) un pieņems no serveris un `zabbix_get` tikai savienojumus, izmantojot PSK. PSK identitāte būs "PSK 001". Pārstartējiet aģentu. Tagad varat pārbaudīt savienojumu, izmantojot `zabbix_get`, piemēram: zabbix_get -s 127.0.0.1 -k "system.cpu.load[all,avg1]" --tls-connect=psk --tls-psk-identity="PSK 001" --tls-psk-file=/home/zabbix/zabbix_agentd.psk (Lai samazinātu dīkstāvi, skatiet, kā mainīt savienojuma tipu sadaļā [Connection encryption management](/manual/encryption#connection-encryption-management)). Konfigurējiet PSK šifrēšanu šim aģentam Zabbix lietotāja saskarne: - Dodieties uz: *Data collection → Hosts* - Atlasiet host un noklikšķiniet uz cilnes **Encryption** Piemērs: {width="600"} Visi obligātie ievades lauki ir atzīmēti ar sarkanu zvaigznīti. Kad konfigurācijas kešatmiņa ir sinhronizēta ar datubāzi, jaunie savienojumi izmantos PSK. Pārbaudiet serveris un aģenta žurnālfailus, vai nav kļūdu ziņojumu. #### Configuring server for use with Java gateway With Java gateway up and running, you have to tell Zabbix server where to find Zabbix Java gateway. This is done by specifying `JavaGateway` and `JavaGatewayPort` parameters in the [server configuration file](/manual/appendix/config/zabbix_server). If the host on which JMX application is running is monitored by Zabbix proxy, then you specify the connection parameters in the [proxy configuration file](/manual/appendix/config/zabbix_proxy) instead. JavaGateway=192.168.3.14 JavaGatewayPort=10052 By default, server does not start any processes related to JMX monitoring. If you wish to use it, however, you have to specify the number of pre-forked instances of Java pollers. You do this in the same way you specify regular pollers and trappers. StartJavaPollers=5 Do not forget to restart server or proxy, once you are done with configuring them. #### Servera konfigurēšana lietošanai 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ā](/manual/appendix/config/zabbix_server). Ja hosts, kurā darbojas JMX lietojumprogramma, tiek uzraudzīts ar Zabbix starpniekserveri, tad savienojuma parametrus norāda [starpniekservera konfigurācijas failā](/manual/appendix/config/zabbix_proxy). JavaGateway=192.168.3.14 JavaGatewayPort=10052 Pēc noklusējuma serveris nepalaiž nekādus procesus, kas saistīti ar JMX uzraudzību. Tomēr, ja vēlaties to izmantot, jums jānorāda Java poller iepriekš izveidoto instanču skaits. To izdara tāpat kā norādot parastos pollerus un trappers. StartJavaPollers=5 Neaizmirstiet pēc konfigurēšanas pabeigšanas restartēt serveri vai starpniekserveri. #### Configuring server for use with Java gateway With Java gateway up and running, you have to tell Zabbix server where to find Zabbix Java gateway. This is done by specifying `JavaGateway` and `JavaGatewayPort` parameters in the [server configuration file](/manual/appendix/config/zabbix_server). If the host on which JMX application is running is monitored by Zabbix proxy, then you specify the connection parameters in the [proxy configuration file](/manual/appendix/config/zabbix_proxy) instead. JavaGateway=192.168.3.14 JavaGatewayPort=10052 By default, server does not start any processes related to JMX monitoring. If you wish to use it, however, you have to specify the number of pre-forked instances of Java pollers. You do this in the same way you specify regular pollers and trappers. StartJavaPollers=5 Do not forget to restart server or proxy, once you are done with configuring them. #### Servera konfigurēšana lietošanai ar Java gateway Kad Java gateway ir palaists un darbojas, jums jānorāda Zabbix serverim, kur atrast Zabbix Java gateway. To veic, norādot `JavaGateway` un `JavaGatewayPort` parametrus [servera konfigurācijas failā](/manual/appendix/config/zabbix_server). Ja hosts, kurā darbojas JMX lietojumprogramma, tiek uzraudzīts ar Zabbix starpniekserveri, tad savienojuma parametrus norādiet [starpniekservera konfigurācijas failā](/manual/appendix/config/zabbix_proxy). JavaGateway=192.168.3.14 JavaGatewayPort=10052 Pēc noklusējuma serveris nepalaiž nekādus procesus, kas saistīti ar JMX uzraudzību. Tomēr, ja vēlaties to izmantot, jums jānorāda Java poller iepriekš atzaroto instanču skaits. To veic tāpat kā norādot parastos pollerus un trappers. StartJavaPollers=5 Neaizmirstiet pēc konfigurēšanas pabeigšanas restartēt serveri vai starpniekserveri. #### Configuring server for use with Java gateway With Java gateway up and running, you have to tell Zabbix server where to find Zabbix Java gateway. This is done by specifying `JavaGateway` and `JavaGatewayPort` parameters in the [server configuration file](/manual/appendix/config/zabbix_server). If the host on which JMX application is running is monitored by Zabbix proxy, then you specify the connection parameters in the [proxy configuration file](/manual/appendix/config/zabbix_proxy) instead. JavaGateway=192.168.3.14 JavaGatewayPort=10052 By default, server does not start any processes related to JMX monitoring. If you wish to use it, however, you have to specify the number of pre-forked instances of Java pollers. You do this in the same way you specify regular pollers and trappers. StartJavaPollers=5 Do not forget to restart server or proxy, once you are done with configuring them. #### Servera konfigurēšana lietošanai 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 `JavaGateway` un `JavaGatewayPort` parametrus [servera konfigurācijas failā](/manual/appendix/config/zabbix_server). Ja hosts, kurā darbojas JMX lietojumprogramma, tiek uzraudzīts ar Zabbix starpniekserveri, tad savienojuma parametrus norādāt [starpniekservera konfigurācijas failā](/manual/appendix/config/zabbix_proxy). JavaGateway=192.168.3.14 JavaGatewayPort=10052 Pēc noklusējuma serveris nepalaiž nekādus procesus, kas saistīti ar JMX uzraudzību. Tomēr, ja vēlaties to izmantot, jums jānorāda Java poller iepriekš atzaroto instanču skaits. To izdara tāpat, kā norādot parastos pollerus un trappers. StartJavaPollers=5 Neaizmirstiet pēc konfigurēšanas pabeigšanas restartēt serveri vai starpniekserveri. ## Configuring SNMP monitoring To start monitoring a device through SNMP, the following steps have to be performed: ## SNMP uzraudzības konfigurēšana Lai sāktu ierīces uzraudzību, izmantojot SNMP, ir jāveic šādas darbības: #### Configuring SNMP traps This item type requires the following frontend configuration: ##### Step 1: Create an SNMP interface for the host 1. In *Data collection > Hosts*, [create a host](/manual/config/hosts/host) or edit the existing one. 2. In the *Interfaces* field, select the *SNMP* interface type. 3. Enter the IP address/DNS name and port number. 4. Select the *SNMP version* from the dropdown: ([*SNMPv1*, *SNMPv2*](#snmpv-snmpv), or [*SNMPv3*](#snmpv)) and add interface credentials depending on the selected SNMP version. The address from each received trap will be compared to the IP and DNS addresses of all SNMP interfaces to find the corresponding hosts. ##### Step 2: Configure the item 1. For the host, [create an item](/manual/config/items/item) or edit the existing one. 2. In the *Key* field, use one of the SNMP trap keys: - `snmptrap[regexp]` - catches all SNMP traps that match the [regular expression](/manual/regular_expressions) specified in the `regexp` parameter; if `regexp` is unspecified, catches any trap.<br> User macros and global regular expressions are supported in the parameter.<br> Return value: SNMP trap.<br> This item can be set only for SNMP interfaces. - `snmptrap.fallback` - catches all SNMP traps that were not caught by any of the `snmptrap[]` items for that interface.<br> Return value: SNMP trap.<br> This item can be set only for SNMP interfaces. ::: noteclassic Multiline regular expression matching is not supported at this time. ::: 3. Set the *Type of information* to *Log* for the timestamps to be parsed. Other formats such as *Numeric* are also acceptable but might require a custom trap handler. #### SNMP trapu konfigurēšana Šim vienuma tipam ir nepieciešama šāda lietotāja saskarnes konfigurācija: ##### 1. darbība: izveidojiet SNMP saskarni hostam 1. Sadaļā *Data collection > Hosts* [izveidojiet hostu](/manual/config/hosts/host) vai rediģējiet esošo. 2. Laukā *Interfaces* atlasiet *SNMP* saskarnes tipu. 3. Ievadiet IP adresi/DNS nosaukumu un porta numuru. 4. Nolaižamajā sarakstā atlasiet *SNMP version*: ([*SNMPv1*, *SNMPv2*](#snmpv-snmpv) vai [*SNMPv3*](#snmpv)) un pievienojiet saskarnes akreditācijas datus atkarībā no izvēlētās SNMP versijas. Adrese no katra saņemtā trapa tiks salīdzināta ar visu SNMP saskarņu IP un DNS adresēm, lai atrastu atbilstošos hostus. ##### 2. darbība: konfigurējiet vienumu 1. Hostam [izveidojiet vienumu](/manual/config/items/item) vai rediģējiet esošo. 2. Laukā *Key* izmantojiet vienu no SNMP trap atslēgām: - `snmptrap[regexp]` - uztver visus SNMP trapus, kas atbilst `regexp` parametrā norādītajai [regulārajai izteiksmei](/manual/regular_expressions); ja `regexp` nav norādīts, uztver jebkuru trapu.<br> Parametrā tiek atbalstīti lietotāja makrosi un globālās regulārās izteiksmes.<br> Atgrieztā vērtība: SNMP traps.<br> Šo vienumu var iestatīt tikai SNMP saskarnēm. - `snmptrap.fallback` - uztver visus SNMP trapus, kurus nav uztvēris neviens no šīs saskarnes `snmptrap[]` vienumiem.<br> Atgrieztā vērtība: SNMP traps.<br> Šo vienumu var iestatīt tikai SNMP saskarnēm. ::: noteclassic Pašlaik vairāku rindu regulāro izteiksmju atbilstība netiek atbalstīta. ::: 3. Iestatiet *Type of information* uz *Log*, lai tiktu parsēti laikspiedoli. Ir pieļaujami arī citi formāti, piemēram, *Numeric*, taču tiem var būt nepieciešams pielāgots trapu apstrādātājs. ##### Configuring SNMPTT At first, snmptrapd should be configured to use SNMPTT. ::: notetip For the best performance, SNMPTT should be configured as a daemon using `snmptthandler-embedded` to pass the traps to it. See instructions for [configuring SNMPTT](http://snmptt.sourceforge.net/docs/snmptt.shtml). ::: When SNMPTT is configured to receive the traps, configure `snmptt.ini`: 1. Enable the use of the Perl module from the `NET-SNMP` package: ```ini net_snmp_perl_enable = 1 ``` 2. log traps to the trap file which will be read by Zabbix: ```ini log_enable = 1 log_file = [TRAP FILE] ``` 3. set the date-time format: ```ini date_time_format = %Y-%m-%dT%H:%M:%S%z ``` ::: notewarning The `net-snmp-perl` package has been removed in RHEL 8.0-8.2; re-added in RHEL 8.3. For more information, see the [known issues](/manual/installation/known_issues#snmp-traps). ::: Now format the traps for Zabbix to recognize them (edit `snmptt.conf`): 1. Each `FORMAT` statement should start with `ZBXTRAP [address]`, where `[address]` will be compared to IP and DNS addresses of SNMP interfaces on Zabbix. E.g.: ```ini EVENT coldStart .1.3.6.1.6.3.1.1.5.1 "Status Events" Normal FORMAT ZBXTRAP $aA Device reinitialized (coldStart) ``` 2. See more about SNMP trap format below. ::: noteimportant Do not use unknown traps - Zabbix will not be able to recognize them. Unknown traps can be handled by defining a general event in `snmptt.conf`:<br><br> ```ini EVENT general .* "General event" Normal ``` ::: ##### SNMPTT konfigurēšana Vispirms `snmptrapd` ir jākonfigurē, lai tas izmantotu SNMPTT. ::: notetip Vislabākai veiktspējai SNMPTT jābūt konfigurētam kā dēmonam, izmantojot `snmptthandler-embedded`, lai tam nodotu trapes. Skatiet norādījumus par [SNMPTT konfigurēšanu](http://snmptt.sourceforge.net/docs/snmptt.shtml). ::: Kad SNMPTT ir konfigurēts trapu saņemšanai, konfigurējiet `snmptt.ini`: 1. Iespējojiet Perl moduļa izmantošanu no `NET-SNMP` pakotnes: ```ini net_snmp_perl_enable = 1 ``` 2. Reģistrējiet trapes trapu failā, ko nolasīs Zabbix: ```ini log_enable = 1 log_file = [TRAP FILE] ``` 3. Iestatiet datuma un laika formātu: ```ini date_time_format = %Y-%m-%dT%H:%M:%S%z ``` ::: notewarning Pakotne `net-snmp-perl` tika noņemta RHEL 8.0-8.2; tā tika atkārtoti pievienota RHEL 8.3. Papildinformāciju skatiet [zināmajās problēmās](/manual/installation/known_issues#snmp-traps). ::: Tagad noformējiet trapes tā, lai Zabbix tās atpazītu (rediģējiet `snmptt.conf`): 1. Katram `FORMAT` paziņojumam jāsākas ar `ZBXTRAP [address]`, kur `[address]` tiks salīdzināta ar Zabbix SNMP interfeisu IP un DNS adresēm. Piem.: ```ini EVENT coldStart .1.3.6.1.6.3.1.1.5.1 "Status Events" Normal FORMAT ZBXTRAP $aA Device reinitialized (coldStart) ``` 2. Skatiet tālāk vairāk par SNMP trapu formātu. ::: noteimportant Neizmantojiet nezināmas trapes - Zabbix tās nespēs atpazīt. Nezināmās trapes var apstrādāt, definējot vispārīgu notikumu `snmptt.conf` failā:<br><br> ```ini EVENT general .* "General event" Normal ``` ::: #### Configuring steps {width="600"} Step parameters: |Parameter|Description| |--|--------| |*Name*|Unique step name.<br>[User macros](/manual/config/macros/user_macros) are supported. *Note* that if user macros are used, these macros will be left unresolved in [web monitoring item](/manual/web_monitoring/items) names.| |*URL*|URL to connect to and retrieve data. For example:<br>https://www.example.com<br>http://www.example.com/download<br>Domain names can be specified in Unicode characters. They are automatically punycode-converted to ASCII when executing the web scenario step.<br>The *Parse* button can be used to separate optional query fields (like ?name=Admin&password=mypassword) from the URL, moving the attributes and values into *Query fields* for automatic URL-encoding.<br>Variables can be used in the URL, using the {macro} syntax. Variables can be URL-encoded manually using a {{macro}.urlencode()} syntax.<br>User macros and {HOST.\*} [macros](/manual/appendix/macros/supported_by_location) are supported.<br>Limited to 2048 characters.| |*Query fields*|HTTP GET variables for the URL.<br>Specified as attribute and value pairs.<br>Values are URL-encoded automatically. Values from scenario variables, user macros or {HOST.\*} macros are resolved and then URL-encoded automatically. Using a {{macro}.urlencode()} syntax will double URL-encode them.<br>User macros and {HOST.\*} [macros](/manual/appendix/macros/supported_by_location) are supported.| |*Post*|HTTP POST variables.<br>In **Form data** mode, specified as attribute and value pairs.<br>Values are URL-encoded automatically. Values from scenario variables, user macros or {HOST.\*} macros are resolved and then URL-encoded automatically.<br>In **Raw data** mode, attributes/values are displayed on a single line and concatenated with a **&** symbol.<br>Raw values can be URL-encoded/decoded manually using a {{macro}.urlencode()} or {{macro}.urldecode()} syntax.<br>For example: id=2345&userid={user}<br>If {user} is defined as a variable of the web scenario, it will be replaced by its value when the step is executed. If you wish to URL-encode the variable, substitute {user} with {{user}.urlencode()}.<br>User macros and {HOST.\*} [macros](/manual/appendix/macros/supported_by_location) are supported.| |*Variables*|Step-level variables that may be used for GET and POST functions.<br>Specified as attribute and value pairs.<br>Step-level variables override scenario-level variables or variables from the previous step. However, the value of a step-level variable only affects the step after (and not the current step).<br>They have the following format:<br>**{macro}**=value<br>**{macro}**=regex:<regular expression><br>For more information see variable description on the [scenario](web_monitoring#configuring-a-web-scenario) level.<br>Variables are automatically URL-encoded when used in query fields or form data for post variables, but must be URL-encoded manually when used in raw post or directly in URL.| |*Headers*|Custom HTTP headers that will be sent when performing a request.<br>Specified as attribute and value pairs.<br>A header defined on a step level will be used for that particular step.<br>**It should be noted that defining the header on a step level automatically discards all the previously defined headers, except for a default header that is assigned by selecting the 'User-Agent' from a drop-down list on a scenario level.**<br>However, even the 'User-Agent' default header can be overridden by specifying it on a step level.<br>For example, assigning the name to a header, but setting no value will unset the default header on a scenario level.<br>User macros and {HOST.\*} macros are supported.<br>This sets the [CURLOPT\_HTTPHEADER](http://curl.haxx.se/libcurl/c/CURLOPT_HTTPHEADER.html) cURL option.| |*Follow redirects*|Mark the checkbox to follow HTTP redirects.<br>This sets the [CURLOPT\_FOLLOWLOCATION](http://curl.haxx.se/libcurl/c/CURLOPT_FOLLOWLOCATION.html) cURL option.| |*Retrieve mode*|Select the retrieve mode:<br>**Body** - retrieve only body from the HTTP response<br>**Headers** - retrieve only headers from the HTTP response<br>**Body and headers** - retrieve body and headers from the HTTP response| |*Timeout*|Zabbix will not spend more than the set amount of time on processing the URL (from one second to maximum of 1 hour). Actually this parameter defines the maximum time for making connection to the URL and maximum time for performing an HTTP request. Therefore, Zabbix will not spend more than **2 x Timeout** seconds on the step.<br>[Time suffixes](/manual/appendix/suffixes) are supported, e.g. 30s, 1m, 1h. [User macros](/manual/config/macros/user_macros) are supported.| |*Required string*|Required regular expression pattern.<br>Unless retrieved content (HTML) matches the required pattern the step will fail. If empty, no check on required string is performed.<br>For example:<br>Homepage of Zabbix<br>Welcome.\*admin<br>*Note*: Referencing [regular expressions](regular_expressions) created in the Zabbix frontend is not supported in this field.<br>User macros and {HOST.\*} [macros](/manual/appendix/macros/supported_by_location) are supported.| |*Required status codes*|List of expected HTTP status codes. If Zabbix gets a code which is not in the list, the step will fail.<br>If empty, no check on status codes is performed.<br>For example: 200,201,210-299<br>User macros are supported.| ::: noteclassic Any changes in web scenario steps will only be saved when the whole scenario is saved. ::: See also a [real-life example](/manual/web_monitoring/example) of how web monitoring steps can be configured. #### Soļu konfigurēšana {width="600"} Soļa parametri: |Parametrs|Apraksts| |--|--------| |*Name*|Unikāls soļa nosaukums.<br>Tiek atbalstīti [lietotāja makrosi](/manual/config/macros/user_macros). *Ņemiet vērā*, ka, ja tiek izmantoti lietotāja makrosi, šie makrosi paliks neatrisināti [tīmekļa uzraudzības vienumu](/manual/web_monitoring/items) nosaukumos.| |*URL*|URL, ar kuru izveidot savienojumu un iegūt datus. Piemēram:<br>https://www.example.com<br>http://www.example.com/download<br>Domēna nosaukumus var norādīt Unicode rakstzīmēs. Izpildot tīmekļa scenārija soli, tie tiek automātiski pārveidoti no punycode uz ASCII.<br>Pogu *Parse* var izmantot, lai no URL atdalītu neobligātos vaicājuma laukus (piemēram, ?name=Admin&password=mypassword), pārvietojot atribūtus un vērtības uz *Query fields* automātiskai URL kodēšanai.<br>URL var izmantot mainīgos, izmantojot sintaksi {macro}. Mainīgos var URL kodēt manuāli, izmantojot sintaksi {{macro}.urlencode()}.<br>Tiek atbalstīti lietotāja makrosi un {HOST.\*} [makrosi](/manual/appendix/macros/supported_by_location).<br>Ierobežots līdz 2048 rakstzīmēm.| |*Query fields*|HTTP GET mainīgie URL adresei.<br>Norādīti kā atribūtu un vērtību pāri.<br>Vērtības tiek automātiski URL kodētas. Vērtības no scenārija mainīgajiem, lietotāja makrosiem vai {HOST.\*} makrosiem tiek atrisinātas un pēc tam automātiski URL kodētas. Izmantojot sintaksi {{macro}.urlencode()}, tās tiks URL kodētas divreiz.<br>Tiek atbalstīti lietotāja makrosi un {HOST.\*} [makrosi](/manual/appendix/macros/supported_by_location).| |*Post*|HTTP POST mainīgie.<br>Režīmā **Form data** tie tiek norādīti kā atribūtu un vērtību pāri.<br>Vērtības tiek automātiski URL kodētas. Vērtības no scenārija mainīgajiem, lietotāja makrosiem vai {HOST.\*} makrosiem tiek atrisinātas un pēc tam automātiski URL kodētas.<br>Režīmā **Raw data** atribūti/vērtības tiek parādīti vienā rindā un savienoti ar simbolu **&**.<br>Neapstrādātas vērtības var URL kodēt/dekodēt manuāli, izmantojot sintaksi {{macro}.urlencode()} vai {{macro}.urldecode()}.<br>Piemēram: id=2345&userid={user}<br>Ja {user} ir definēts kā tīmekļa scenārija mainīgais, izpildot soli tas tiks aizstāts ar savu vērtību. Ja vēlaties mainīgo URL kodēt, aizstājiet {user} ar {{user}.urlencode()}.<br>Tiek atbalstīti lietotāja makrosi un {HOST.\*} [makrosi](/manual/appendix/macros/supported_by_location).| |*Variables*|Soļa līmeņa mainīgie, kurus var izmantot GET un POST funkcijām.<br>Norādīti kā atribūtu un vērtību pāri.<br>Soļa līmeņa mainīgie pārraksta scenārija līmeņa mainīgos vai iepriekšējā soļa mainīgos. Tomēr soļa līmeņa mainīgā vērtība ietekmē tikai nākamo soli (nevis pašreizējo soli).<br>Tiem ir šāds formāts:<br>**{macro}**=value<br>**{macro}**=regex:<regular expression><br>Papildinformāciju skatiet mainīgo aprakstā [scenārija](web_monitoring#configuring-a-web-scenario) līmenī.<br>Mainīgie tiek automātiski URL kodēti, ja tos izmanto vaicājuma laukos vai formas datos POST mainīgajiem, taču tie ir manuāli URL jākodē, ja tiek izmantoti neapstrādātā POST vai tieši URL.| |*Headers*|Pielāgotas HTTP galvenes, kas tiks nosūtītas, izpildot pieprasījumu.<br>Norādītas kā atribūtu un vērtību pāri.<br>Soļa līmenī definēta galvene tiks izmantota konkrētajam solim.<br>**Jāņem vērā, ka galvenes definēšana soļa līmenī automātiski atmet visas iepriekš definētās galvenes, izņemot noklusējuma galveni, kas tiek piešķirta, scenārija līmenī nolaižamajā sarakstā izvēloties 'User-Agent'.**<br>Tomēr pat noklusējuma galveni 'User-Agent' var pārrakstīt, to norādot soļa līmenī.<br>Piemēram, piešķirot galvenei nosaukumu, bet nenorādot vērtību, scenārija līmeņa noklusējuma galvene tiks atcelta.<br>Tiek atbalstīti lietotāja makrosi un {HOST.\*} makrosi.<br>Tas iestata [CURLOPT\_HTTPHEADER](http://curl.haxx.se/libcurl/c/CURLOPT_HTTPHEADER.html) cURL opciju.| |*Follow redirects*|Atzīmējiet izvēles rūtiņu, lai sekotu HTTP pāradresācijām.<br>Tas iestata [CURLOPT\_FOLLOWLOCATION](http://curl.haxx.se/libcurl/c/CURLOPT_FOLLOWLOCATION.html) cURL opciju.| |*Retrieve mode*|Atlasiet iegūšanas režīmu:<br>**Body** - iegūt tikai HTTP atbildes pamattekstu<br>**Headers** - iegūt tikai HTTP atbildes galvenes<br>**Body and headers** - iegūt HTTP atbildes pamattekstu un galvenes| |*Timeout*|Zabbix URL apstrādei netērēs vairāk par iestatīto laiku (no vienas sekundes līdz maksimāli 1 stundai). Faktiski šis parametrs nosaka maksimālo laiku savienojuma izveidei ar URL un maksimālo laiku HTTP pieprasījuma izpildei. Tādēļ Zabbix šim solim netērēs vairāk par **2 x Timeout** sekundēm.<br>Tiek atbalstīti [laika sufiksi](/manual/appendix/suffixes), piemēram, 30s, 1m, 1h. Tiek atbalstīti [lietotāja makrosi](/manual/config/macros/user_macros).| |*Required string*|Obligāts regulārās izteiksmes raksts.<br>Ja vien iegūtais saturs (HTML) neatbilst obligātajam rakstam, solis neizdosies. Ja lauks ir tukšs, obligātās virknes pārbaude netiek veikta.<br>Piemēram:<br>Zabbix sākumlapa<br>Welcome.\*admin<br>*Piezīme*: Šajā laukā netiek atbalstīta atsauce uz [regulārajām izteiksmēm](regular_expressions), kas izveidotas Zabbix lietotāja saskarnē.<br>Tiek atbalstīti lietotāja makrosi un {HOST.\*} [makrosi](/manual/appendix/macros/supported_by_location).| |*Required status codes*|Sagaidāmo HTTP statusa kodu saraksts. Ja Zabbix saņem kodu, kas nav sarakstā, solis neizdosies.<br>Ja lauks ir tukšs, statusa kodu pārbaude netiek veikta.<br>Piemēram: 200,201,210-299<br>Tiek atbalstīti lietotāja makrosi.| ::: noteclassic Jebkādas izmaiņas tīmekļa scenārija soļos tiks saglabātas tikai tad, kad tiks saglabāts viss scenārijs. ::: Skatiet arī [reālu piemēru](/manual/web_monitoring/example), kā var konfigurēt tīmekļa uzraudzības soļus. #### Configuring tags The **Tags** tab allows to define scenario-level [tags](/manual/config/tagging).  Tagging allows to filter web scenarios and web monitoring [items](/manual/web_monitoring/items). #### Birku konfigurēšana Cilne **Tags** ļauj definēt scenārija līmeņa [birkas](/manual/config/tagging).  Birku izmantošana ļauj filtrēt tīmekļa scenārijus un tīmekļa uzraudzības [vienumus](/manual/web_monitoring/items). #### Configuring unixODBC To configure unixODBC, you must edit the `odbcinst.ini` and `odbc.ini` files. You can verify the location of these files by executing the following command: ```bash odbcinst -j ``` The command result should contain information that is similar to the following: ```bash unixODBC 2.3.9 DRIVERS............: /etc/odbcinst.ini SYSTEM DATA SOURCES: /etc/odbc.ini FILE DATA SOURCES..: /etc/ODBCDataSources ``` #### unixODBC konfigurēšana Lai konfigurētu unixODBC, jums jārediģē faili `odbcinst.ini` un `odbc.ini`. Šo failu atrašanās vietu varat pārbaudīt, izpildot šādu komandu: ```bash odbcinst -j ``` Komandas rezultātā jābūt informācijai, kas ir līdzīga šādai: ```bash unixODBC 2.3.9 DRIVERS............: /etc/odbcinst.ini SYSTEM DATA SOURCES: /etc/odbc.ini FILE DATA SOURCES..: /etc/ODBCDataSources ``` ##### Configuring Zabbix agent 1\. Open the agent configuration file on the machine where the agent is installed. If you're using Zabbix agent: sudo vi /etc/zabbix/zabbix_agentd.conf If you're using Zabbix agent 2: sudo vi /etc/zabbix/zabbix_agent2.conf 2\. Add the IP address or DNS name (and optional port) of your Zabbix server to the ServerActive parameter. For example: ServerActive=192.0.2.1:10051 Zabbix agent will use this address to connect to Zabbix server's trapper port (default: 10051) and request the configuration data for active checks. 3\. Define the Hostname parameter, which must match the host name that will be defined in [Zabbix frontend](#zabbix-frontend). In our example, it is: Hostname=Remote host The Hostname value must match because, for active checks, Zabbix agent uses it to retrieve the correct host configuration from the server. Specifically, the Agent initiates a connection to the Server and identifies itself using the Hostname value. The Server then provides the monitoring configuration for that host. If these values differ, the Agent will not receive the appropriate configuration, resulting in missing metrics or monitoring issues. 4\. Restart Zabbix agent. If you're using Zabbix agent: systemctl restart zabbix-agent If you're using Zabbix agent 2: systemctl restart zabbix-agent2 ##### Zabbix aģenta konfigurēšana 1\. Atveriet aģenta konfigurācijas failu datorā, kurā ir instalēts aģents. Ja izmantojat Zabbix aģentu: sudo vi /etc/zabbix/zabbix_agentd.conf Ja izmantojat Zabbix aģentu 2: sudo vi /etc/zabbix/zabbix_agent2.conf 2\. Pievienojiet sava Zabbix servera IP adresi vai DNS nosaukumu (un, ja nepieciešams, portu) parametram ServerActive. Piemēram: ServerActive=192.0.2.1:10051 Zabbix aģents izmantos šo adresi, lai izveidotu savienojumu ar Zabbix servera trapper portu (noklusējums: 10051) un pieprasītu konfigurācijas datus aktīvajām pārbaudēm. 3\. Definējiet parametru Hostname, kam jāsakrīt ar hosta nosaukumu, kas tiks definēts [Zabbix lietotāja saskarne](#zabbix-frontend). Mūsu piemērā tas ir: Hostname=Remote host Hostname vērtībai ir jāsakrīt, jo aktīvajām pārbaudēm Zabbix aģents to izmanto, lai no servera izgūtu pareizo hosta konfigurāciju. Konkrēti, aģents uzsāk savienojumu ar serveri un identificē sevi, izmantojot Hostname vērtību. Pēc tam serveris nodrošina šī hosta uzraudzības konfigurāciju. Ja šīs vērtības atšķiras, aģents nesaņems atbilstošo konfigurāciju, kā rezultātā var trūkt metriku vai rasties uzraudzības problēmas. 4\. Restartējiet Zabbix aģentu. Ja izmantojat Zabbix aģentu: systemctl restart zabbix-agent Ja izmantojat Zabbix aģentu 2: systemctl restart zabbix-agent2 ##### Configuring Zabbix server/proxy To read the traps, Zabbix server or proxy must be configured to start the SNMP trapper process and point to the trap file that is being written by SNMPTT or a Bash/Perl trap receiver. To do that, edit the configuration file ([`zabbix\_server.conf`](/manual/appendix/config/zabbix_server) or [`zabbix\_proxy.conf`](/manual/appendix/config/zabbix_proxy)): ```ini StartSNMPTrapper=1 SNMPTrapperFile=[TRAP FILE] ``` ::: notewarning If systemd parameter [`PrivateTmp`](http://www.freedesktop.org/software/systemd/man/systemd.exec.html#PrivateTmp=) is used, this file is unlikely to work in `/tmp`. ::: ##### Configuring Bash trap receiver Requirements: only snmptrapd. A Bash trap receiver [script](https://raw.githubusercontent.com/zabbix/zabbix-docker/7.0/templates/scripts/snmptraps/zabbix_trap_handler.sh) can be used to pass traps to Zabbix server from snmptrapd using trapper file. To configure it, add the `traphandle` option to snmptrapd configuration file (`snmptrapd.conf`), see [example](https://raw.githubusercontent.com/zabbix/zabbix-docker/7.0/templates/config/snmptraps/snmp/snmptrapd.conf). :::notetip snmptrapd might need to be restarted to pick up changes to its configuration. ::: ##### Zabbix servera/starpniekservera konfigurēšana Lai nolasītu trapus, Zabbix serverim vai starpniekserverim ir jākonfigurē SNMP trapper procesa palaišana un jānorāda trapu fails, kurā raksta SNMPTT vai Bash/Perl trapu saņēmējs. Lai to izdarītu, rediģējiet konfigurācijas failu ([`zabbix\_server.conf`](/manual/appendix/config/zabbix_server) vai [`zabbix\_proxy.conf`](/manual/appendix/config/zabbix_proxy)): ```ini StartSNMPTrapper=1 SNMPTrapperFile=[TRAP FILE] ``` ::: notewarning Ja tiek izmantots systemd parametrs [`PrivateTmp`](http://www.freedesktop.org/software/systemd/man/systemd.exec.html#PrivateTmp=), šis fails, visticamāk, nedarbosies `/tmp`. ::: ##### Bash trapu saņēmēja konfigurēšana Prasības: tikai snmptrapd. Bash trapu saņēmēja [skriptu](https://raw.githubusercontent.com/zabbix/zabbix-docker/7.0/templates/scripts/snmptraps/zabbix_trap_handler.sh) var izmantot, lai nodotu trapus Zabbix serverim no snmptrapd, izmantojot trapper failu. Lai to konfigurētu, pievienojiet opciju `traphandle` snmptrapd konfigurācijas failam (`snmptrapd.conf`), skatiet [piemēru](https://raw.githubusercontent.com/zabbix/zabbix-docker/7.0/templates/config/snmptraps/snmp/snmptrapd.conf). :::notetip Lai stātos spēkā konfigurācijas izmaiņas, snmptrapd, iespējams, būs jāpārstartē. ::: #### Connect and log in to Zabbix API Next, connect to the Zabbix API. This lets your script manage Zabbix objects such as hosts and items. 1\. Import the `ZabbixAPI` class from zabbix\_utils. 2\. Create a `ZabbixAPI` instance and provide the URL of your Zabbix web interface. 3\. Call the `login()` method on the `ZabbixAPI` instance and provide your username and password. The account must have [permission](/manual/web_interface/frontend_sections/users/user_roles#default-permissions) to access Zabbix API. 4\. Call the `logout()` method to close the session after API operations. ```python from zabbix_utils import ZabbixAPI api = ZabbixAPI(url='127.0.0.1/zabbix') api.login(user='Admin', password='zabbix') # API operations go here api.logout() ``` #### Pievienojieties un piesakieties Zabbix API Tālāk pievienojieties Zabbix API. Tas ļauj jūsu skriptam pārvaldīt Zabbix objektus, piemēram, hostus un vienumus. 1\. Importējiet `ZabbixAPI` klasi no zabbix\_utils. 2\. Izveidojiet `ZabbixAPI` instanci un norādiet savas Zabbix tīmekļa lietotāja saskarnes URL. 3\. Izsauciet `login()` metodi `ZabbixAPI` instancei un norādiet savu lietotājvārdu un paroli. Kontam jābūt [atļaujai](/manual/web_interface/frontend_sections/users/user_roles#default-permissions) piekļūt Zabbix API. 4\. Izsauciet `logout()` metodi, lai pēc API darbībām aizvērtu sesiju. ```python from zabbix_utils import ZabbixAPI api = ZabbixAPI(url='127.0.0.1/zabbix') api.login(user='Admin', password='zabbix') # API operations go here api.logout() ``` #### Connection encryption management Connections in Zabbix can use: - no encryption (default) - [RSA certificate-based encryption](/manual/encryption/using_certificates) - [PSK-based encryption](/manual/encryption/using_pre_shared_keys) There are two important parameters used to specify encryption between Zabbix components: - TLSConnect - specifies what encryption to use for outgoing connections (unencrypted, PSK or certificate) - TLSAccept - specifies what types of connections are allowed for incoming connections (unencrypted, PSK or certificate). One or more values can be specified. `TLSConnect` is used in the configuration files for Zabbix proxy (in active mode, specifies only connections to server) and Zabbix agent (for active checks). In Zabbix frontend the TLSConnect equivalent is the *Connections to host* field in *Data collection → Hosts → <some host> → Encryption* tab and the *Connections to proxy* field in *Administration → Proxies → <some proxy> → Encryption* tab. If the configured encryption type for connection fails, no other encryption types will be tried. `TLSAccept` is used in the configuration files for Zabbix proxy (in passive mode, specifies only connections from server) and Zabbix agent (for passive checks). In Zabbix frontend the TLSAccept equivalent is the *Connections from host* field in *Data collection → Hosts → <some host> → Encryption* tab and the *Connections from proxy* field in *Administration → Proxies → <some proxy> → Encryption* tab. Normally you configure only one type of encryption for incoming connections. But you may want to switch the encryption type, e.g. from unencrypted to certificate-based with minimum downtime and rollback possibility. To achieve this: - Set `TLSAccept=unencrypted,cert` in the agent configuration file and restart Zabbix agent - Test connection with zabbix\_get to the agent using certificate. If it works, you can reconfigure encryption for that agent in Zabbix frontend in the *Data collection → Hosts → <some host> → Encryption* tab by setting *Connections to host* to "Certificate". - When server configuration cache gets updated (and proxy configuration is updated if the host is monitored by proxy) then connections to that agent will be encrypted - If everything works as expected you can set `TLSAccept=cert` in the agent configuration file and restart Zabbix agent. Now the agent will be accepting only encrypted certificate-based connections. Unencrypted and PSK-based connections will be rejected. In a similar way it works on server and proxy. If in Zabbix frontend in host configuration *Connections from host* is set to "Certificate" then only certificate-based encrypted connections will be accepted from the agent (active checks) and zabbix\_sender (trapper items). Most likely you will configure incoming and outgoing connections to use the same encryption type or no encryption at all. But technically it is possible to configure it asymmetrically, e.g. certificate-based encryption for incoming and PSK-based for outgoing connections. Encryption configuration for each host is displayed in the Zabbix frontend, in *Data collection → Hosts* in the *Agent encryption* column. For example: |Example|Connections to host|Allowed connections from host|Rejected connections from host| |-------|-------------------|-----------------------------|------------------------------| ||Unencrypted|Unencrypted|Encrypted, certificate and PSK-based encrypted| ||Encrypted, certificate-based|Encrypted, certificate-based|Unencrypted and PSK-based encrypted| ||Encrypted, PSK-based|Encrypted, PSK-based|Unencrypted and certificate-based encrypted| ||Encrypted, PSK-based|Unencrypted and PSK-based encrypted|Certificate-based encrypted| ||Encrypted, certificate-based|Unencrypted, PSK or certificate-based encrypted|\-| ::: noteimportant Connections are unencrypted by default. Encryption must be configured for each host and proxy individually. ::: #### Savienojumu šifrēšanas pārvaldība Savienojumi Zabbix var izmantot: - bez šifrēšanas (noklusējums) - [uz RSA sertifikātiem balstītu šifrēšanu](/manual/encryption/using_certificates) - [uz PSK balstītu šifrēšanu](/manual/encryption/using_pre_shared_keys) Ir divi svarīgi parametri, ko izmanto, lai norādītu šifrēšanu starp Zabbix komponentiem: - TLSConnect - norāda, kādu šifrēšanu izmantot izejošajiem savienojumiem (bez šifrēšanas, PSK vai sertifikāts) - TLSAccept - norāda, kādi savienojumu tipi ir atļauti ienākošajiem savienojumiem (bez šifrēšanas, PSK vai sertifikāts). Var norādīt vienu vai vairākas vērtības. `TLSConnect` tiek izmantots Zabbix starpniekserveris konfigurācijas failos (aktīvajā režīmā norāda tikai savienojumus ar serveris) un Zabbix aģents konfigurācijas failos (aktīvajām pārbaudēm). Zabbix lietotāja saskarne parametrs, kas atbilst TLSConnect, ir lauks *Connections to host* cilnē *Data collection → Hosts → <some host> → Encryption* un lauks *Connections to proxy* cilnē *Administration → Proxies → <some proxy> → Encryption*. Ja konfigurētais savienojuma šifrēšanas tips neizdodas, citi šifrēšanas tipi netiks mēģināti. `TLSAccept` tiek izmantots Zabbix starpniekserveris konfigurācijas failos (pasīvajā režīmā norāda tikai savienojumus no serveris) un Zabbix aģents konfigurācijas failos (pasīvajām pārbaudēm). Zabbix lietotāja saskarne parametrs, kas atbilst TLSAccept, ir lauks *Connections from host* cilnē *Data collection → Hosts → <some host> → Encryption* un lauks *Connections from proxy* cilnē *Administration → Proxies → <some proxy> → Encryption*. Parasti ienākošajiem savienojumiem konfigurē tikai vienu šifrēšanas tipu. Taču, iespējams, vēlēsieties pārslēgt šifrēšanas tipu, piemēram, no nešifrēta uz uz sertifikātiem balstītu, ar minimālu dīkstāvi un iespēju atgriezties pie iepriekšējās konfigurācijas. Lai to panāktu: - Iestatiet `TLSAccept=unencrypted,cert` aģents konfigurācijas failā un restartējiet Zabbix aģents - Pārbaudiet savienojumu ar aģents, izmantojot zabbix\_get ar sertifikātu. Ja tas darbojas, varat pārkonfigurēt šifrēšanu šim aģents Zabbix lietotāja saskarne cilnē *Data collection → Hosts → <some host> → Encryption*, iestatot *Connections to host* uz "Certificate". - Kad serveris konfigurācijas kešatmiņa tiks atjaunināta (un starpniekserveris konfigurācija tiks atjaunināta, ja hosts tiek uzraudzīts ar starpniekserveris), savienojumi ar šo aģents tiks šifrēti - Ja viss darbojas, kā paredzēts, varat iestatīt `TLSAccept=cert` aģents konfigurācijas failā un restartēt Zabbix aģents. Tagad aģents pieņems tikai šifrētus, uz sertifikātiem balstītus savienojumus. Nešifrēti un uz PSK balstīti savienojumi tiks noraidīti. Līdzīgā veidā tas darbojas serveris un starpniekserveris. Ja Zabbix lietotāja saskarne hosts konfigurācijā lauks *Connections from host* ir iestatīts uz "Certificate", tad no aģents tiks pieņemti tikai uz sertifikātiem balstīti šifrēti savienojumi (aktīvās pārbaudes) un zabbix\_sender (trapper vienumi). Visticamāk, jūs konfigurēsiet ienākošos un izejošos savienojumus tā, lai tie izmantotu vienu un to pašu šifrēšanas tipu vai vispār neizmantotu šifrēšanu. Taču tehniski ir iespējams to konfigurēt asimetriski, piemēram, uz sertifikātiem balstītu šifrēšanu ienākošajiem savienojumiem un uz PSK balstītu šifrēšanu izejošajiem savienojumiem. Katra hosts šifrēšanas konfigurācija tiek parādīta Zabbix lietotāja saskarne sadaļā *Data collection → Hosts* kolonnā *Agent encryption*. Piemēram: |Piemērs|Savienojumi ar hostu|Atļautie savienojumi no hosta|Noraidītie savienojumi no hosta| |-------|-------------------|-----------------------------|------------------------------| ||Nešifrēti|Nešifrēti|Šifrēti, uz sertifikātiem balstīti un uz PSK balstīti šifrēti| ||Šifrēti, uz sertifikātiem balstīti|Šifrēti, uz sertifikātiem balstīti|Nešifrēti un uz PSK balstīti šifrēti| ||Šifrēti, uz PSK balstīti|Šifrēti, uz PSK balstīti|Nešifrēti un uz sertifikātiem balstīti šifrēti| ||Šifrēti, uz PSK balstīti|Nešifrēti un uz PSK balstīti šifrēti|Uz sertifikātiem balstīti šifrēti| ||Šifrēti, uz sertifikātiem balstīti|Nešifrēti, uz PSK balstīti vai uz sertifikātiem balstīti šifrēti|\-| ::: noteimportant Savienojumi pēc noklusējuma nav šifrēti. Šifrēšana jākonfigurē katram hostam un starpniekserverim atsevišķi. ::: #### Connection setup Zabbix supports two types of connect identifiers (connection methods): - Easy Connect - Net Service Name Connection configuration parameters for Zabbix server and Zabbix proxy can be set in the configuration files. Important parameters for the server and proxy are *DBHost*, *DBUser*, *DBName* and *DBPassword*. The same parameters are important for the frontend: *$DB\["SERVER"\]*, *$DB\["PORT"\]*, *$DB\["DATABASE"\]*, *$DB\["USER"\]*, *$DB\["PASSWORD"\]*. Zabbix uses the following connection string syntax: {DBUser/DBPassword[@<connect_identifier>]} <connect\_identifier> can be specified either in the form of "Net Service Name" or "Easy Connect". @[[//]Host[:Port]/<service_name> | <net_service_name>] #### Savienojuma iestatīšana Zabbix atbalsta divu veidu savienojuma identifikatorus (savienojuma metodes): - Easy Connect - Net Service Name Savienojuma konfigurācijas parametrus Zabbix serverim un Zabbix starpniekserverim var iestatīt konfigurācijas failos. Svarīgi parametri serverim un starpniekserverim ir *DBHost*, *DBUser*, *DBName* un *DBPassword*. Tie paši parametri ir svarīgi lietotāja saskarnei: *$DB\["SERVER"\]*, *$DB\["PORT"\]*, *$DB\["DATABASE"\]*, *$DB\["USER"\]*, *$DB\["PASSWORD"\]*. Zabbix izmanto šādu savienojuma virknes sintaksi: {DBUser/DBPassword[@<connect_identifier>]} <connect\_identifier> var norādīt vai nu formā "Net Service Name", vai "Easy Connect". @[[//]Host[:Port]/<service_name> | <net_service_name>] ##### Connections Some plugins support gathering metrics from multiple instances simultaneously. Both local and remote instances can be monitored. TCP and Unix-socket connections are supported. It is recommended to configure plugins to keep connections to instances in an open state. The benefits are reduced network congestion, latency, and CPU and memory usage due to the lower number of connections. The client library takes care of this. ::: notetip Time period for which unused connections should remain open can be determined by `Plugins.<PluginName>.KeepAlive` parameter. Example: `Plugins.Memcached.KeepAlive` ::: ##### Savienojumi Daži spraudņi atbalsta metrikas apkopošanu no vairākām instancēm vienlaikus. Var uzraudzīt gan lokālās, gan attālās instances. Tiek atbalstīti TCP un Unix-soketa savienojumi. Ieteicams konfigurēt spraudņus tā, lai savienojumi ar instancēm tiktu uzturēti atvērtā stāvoklī. Ieguvumi ir mazāka tīkla pārslodze, latentums, kā arī CPU un atmiņas patēriņš, jo tiek izmantots mazāks savienojumu skaits. Par to rūpējas klienta bibliotēka. ::: notetip Laika periodu, cik ilgi neizmantotajiem savienojumiem jāpaliek atvērtiem, var noteikt ar parametru `Plugins.<PluginName>.KeepAlive`. Piemērs: `Plugins.Memcached.KeepAlive` ::: # connector.create # connector.create # connector.delete # connector.delete # connector.get # connector.get # Connector object The following objects are directly related to the `connector` API. # Savienotāja objekts Tālāk norādītie objekti ir tieši saistīti ar `connector` API. ## Connectors The [data streaming](/manual/config/export/streaming) functionality is no longer experimental. ## Savienotāji [data streaming](/manual/config/export/streaming) funkcionalitāte vairs nav eksperimentāla. #### Connectors This section allows to configure connectors for Zabbix data [streaming to external systems](/manual/config/export/streaming) over HTTP. {width="600"} Click on *Create connector* to configure a new [connector](/manual/config/export/streaming#configuration). You may filter connectors by name or status (enabled/disabled). Click on the connector status in the list to enable/disable a connector. You may also mass enable/disable connectors by selecting them in the list and then clicking on the *Enable/Disable* buttons below the list. #### Savienotāji Šī sadaļa ļauj konfigurēt Zabbix datu [straumēšanas uz ārējām sistēmām](/manual/config/export/streaming) savienotājus, izmantojot HTTP. {width="600"} Noklikšķiniet uz *Create connector*, lai konfigurētu jaunu [savienotāju](/manual/config/export/streaming#configuration). Varat filtrēt savienotājus pēc nosaukuma vai statusa (enabled/disabled). Noklikšķiniet uz savienotāja statusa sarakstā, lai iespējotu/atspējotu savienotāju. Varat arī masveidā iespējot/atspējot savienotājus, atlasot tos sarakstā un pēc tam noklikšķinot uz pogām *Enable/Disable* zem saraksta. ### Connector The connector object has the following properties. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |connectorid|ID|ID of the connector.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*<br>- *required* for update operations| |name|string|Name of the connector.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |url|string|Endpoint URL, that is, URL of the receiver.<br>User macros are supported.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |protocol|integer|Communication protocol.<br><br>Possible values:<br>0 - *(default)* Zabbix Streaming Protocol v1.0.| |data\_type|integer|Data type.<br><br>Possible values:<br>0 - *(default)* Item values;<br>1 - Events.| |item\_value\_type|integer|A sum of item value types to be sent.<br><br>Possible values:<br>1 - Numeric (float);<br>2 - Character;<br>4 - Log;<br>8 - Numeric (unsigned);<br>16 - Text;<br>32 - Binary (supported since Zabbix 7.0.5).<br><br>Default: 31 - All item types (except binary).<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `data_type` is set to "Item values".| |max\_records|integer|Maximum number of events or items that can be sent within one message.<br><br>Possible values: 0-2147483647 (max value of 32-bit signed integer).<br><br>Default: 0 - Unlimited.| |max\_senders|integer|Number of sender processes to run for this connector.<br><br>Possible values: 1-100.<br><br>Default: 1.| |max\_attempts|integer|Number of attempts.<br><br>Possible values: 1-5.<br><br>Default: 1.| |attempt\_interval|string|The interval between retry attempts.<br>Accepts seconds.<br><br>Possible values: 0s-10s.<br><br>Default: 5s.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `max_attempts` is greater than 1.| |timeout|string|Timeout.<br>Time suffixes are supported (e.g., 30s, 1m).<br>User macros are supported.<br><br>Possible values: 1s-60s.<br><br>Default: 5s.| |http\_proxy|string|HTTP(S) proxy connection string given as <br>*\[protocol\]://\[username\[:password\]@\]proxy.example.com\[:port\]*.<br><br>User macros are supported.| |authtype|integer|HTTP authentication method.<br><br>Possible values:<br>0 - *(default)* None;<br>1 - Basic;<br>2 - NTLM;<br>3 - Kerberos;<br>4 - Digest;<br>5 - Bearer.| |username|string|User name.<br>User macros are supported.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `authtype` is set to "Basic", "NTLM", "Kerberos", or "Digest"| |password|string|Password.<br>User macros are supported.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `authtype` is set to "Basic", "NTLM", "Kerberos", or "Digest"| |token|string|Bearer token.<br>User macros are supported.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `authtype` is set to "Bearer"| |verify\_peer|integer|Whether to validate that the host's certificate is authentic.<br><br>Possible values:<br>0 - Do not validate;<br>1 - *(default)* Validate.| |verify\_host|integer|Whether to validate that the host name for the connection matches the one in the host's certificate.<br><br>Possible values:<br>0 - Do not validate;<br>1 - *(default)* Validate.| |ssl\_cert\_file|string|Public SSL Key file path.<br>User macros are supported.| |ssl\_key\_file|string|Private SSL Key file path.<br>User macros are supported.| |ssl\_key\_password|string|Password for SSL Key file.<br>User macros are supported.| |description|text|Description of the connector.| |status|integer|Whether the connector is enabled.<br><br>Possible values:<br>0 - Disabled;<br>1 - *(default)* Enabled.| |tags\_evaltype|integer|Tag [evaluation method](/manual/config/export/streaming#configuration).<br><br>Possible values:<br>0 - *(default)* And/Or;<br>2 - Or.| ### Connector Savienotāja objektam ir šādi īpašumi. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|--| |connectorid|ID|Savienotāja ID.<br><br>[Īpašuma uzvedība](/manual/api/reference_commentary#property-behavior):<br>- *tikai lasāms*<br>- *obligāts* atjaunināšanas operācijām| |name|string|Savienotāja nosaukums.<br><br>[Īpašuma uzvedība](/manual/api/reference_commentary#property-behavior):<br>- *obligāts* izveides operācijām| |url|string|Galamērķa URL, tas ir, saņēmēja URL.<br>Tiek atbalstīti lietotāja makrosi.<br><br>[Īpašuma uzvedība](/manual/api/reference_commentary#property-behavior):<br>- *obligāts* izveides operācijām| |protocol|integer|Sakaru protokols.<br><br>Iespējamās vērtības:<br>0 - *(noklusējums)* Zabbix Streaming Protocol v1.0.| |data\_type|integer|Datu tips.<br><br>Iespējamās vērtības:<br>0 - *(noklusējums)* vienumu vērtības;<br>1 - notikumi.| |item\_value\_type|integer|Nosūtāmo vienumu vērtību tipu summa.<br><br>Iespējamās vērtības:<br>1 - skaitlisks (float);<br>2 - rakstzīmju;<br>4 - žurnāls;<br>8 - skaitlisks (bez zīmes);<br>16 - teksts;<br>32 - binārs (atbalstīts kopš Zabbix 7.0.5).<br><br>Noklusējums: 31 - visi vienumu tipi (izņemot bināro).<br><br>[Īpašuma uzvedība](/manual/api/reference_commentary#property-behavior):<br>- *atbalstīts*, ja `data_type` ir iestatīts uz "Item values".| |max\_records|integer|Maksimālais notikumu vai vienumu skaits, ko var nosūtīt vienā ziņojumā.<br><br>Iespējamās vērtības: 0-2147483647 (32 bitu zīmes vesela skaitļa maksimālā vērtība).<br><br>Noklusējums: 0 - neierobežots.| |max\_senders|integer|Sūtītāja procesu skaits, kas jāpalaiž šim savienotājam.<br><br>Iespējamās vērtības: 1-100.<br><br>Noklusējums: 1.| |max\_attempts|integer|Mēģinājumu skaits.<br><br>Iespējamās vērtības: 1-5.<br><br>Noklusējums: 1.| |attempt\_interval|string|Intervāls starp atkārtotiem mēģinājumiem.<br>Pieņem sekundes.<br><br>Iespējamās vērtības: 0s-10s.<br><br>Noklusējums: 5s.<br><br>[Īpašuma uzvedība](/manual/api/reference_commentary#property-behavior):<br>- *atbalstīts*, ja `max_attempts` ir lielāks par 1.| |timeout|string|Noildze.<br>Tiek atbalstīti laika sufiksi (piem., 30s, 1m).<br>Tiek atbalstīti lietotāja makrosi.<br><br>Iespējamās vērtības: 1s-60s.<br><br>Noklusējums: 5s.| |http\_proxy|string|HTTP(S) starpniekservera savienojuma virkne šādā formātā: <br>*\[protocol\]://\[username\[:password\]@\]proxy.example.com\[:port\]*.<br><br>Tiek atbalstīti lietotāja makrosi.| |authtype|integer|HTTP autentifikācijas metode.<br><br>Iespējamās vērtības:<br>0 - *(noklusējums)* nav;<br>1 - Basic;<br>2 - NTLM;<br>3 - Kerberos;<br>4 - Digest;<br>5 - Bearer.| |username|string|Lietotājvārds.<br>Tiek atbalstīti lietotāja makrosi.<br><br>[Īpašuma uzvedība](/manual/api/reference_commentary#property-behavior):<br>- *atbalstīts*, ja `authtype` ir iestatīts uz "Basic", "NTLM", "Kerberos" vai "Digest"| |password|string|Parole.<br>Tiek atbalstīti lietotāja makrosi.<br><br>[Īpašuma uzvedība](/manual/api/reference_commentary#property-behavior):<br>- *atbalstīts*, ja `authtype` ir iestatīts uz "Basic", "NTLM", "Kerberos" vai "Digest"| |token|string|Bearer marķieris.<br>Tiek atbalstīti lietotāja makrosi.<br><br>[Īpašuma uzvedība](/manual/api/reference_commentary#property-behavior):<br>- *obligāts*, ja `authtype` ir iestatīts uz "Bearer"| |verify\_peer|integer|Vai validēt, ka hosts sertifikāts ir autentisks.<br><br>Iespējamās vērtības:<br>0 - nevalidēt;<br>1 - *(noklusējums)* validēt.| |verify\_host|integer|Vai validēt, ka savienojuma hosta nosaukums atbilst tam, kas norādīts hosta sertifikātā.<br><br>Iespējamās vērtības:<br>0 - nevalidēt;<br>1 - *(noklusējums)* validēt.| |ssl\_cert\_file|string|Publiskās SSL atslēgas faila ceļš.<br>Tiek atbalstīti lietotāja makrosi.| |ssl\_key\_file|string|Privātās SSL atslēgas faila ceļš.<br>Tiek atbalstīti lietotāja makrosi.| |ssl\_key\_password|string|Parole SSL atslēgas failam.<br>Tiek atbalstīti lietotāja makrosi.| |description|text|Savienotāja apraksts.| |status|integer|Vai savienotājs ir iespējots.<br><br>Iespējamās vērtības:<br>0 - atspējots;<br>1 - *(noklusējums)* iespējots.| |tags\_evaltype|integer|Tagu [novērtēšanas metode](/manual/config/export/streaming#configuration).<br><br>Iespējamās vērtības:<br>0 - *(noklusējums)* Un/Vai;<br>2 - Vai.| # Connector This class is designed to work with connectors. Object references: - [Connector](/manual/api/reference/connector/object#connector) - [Tag filter](/manual/api/reference/connector/object#tag-filter) Available methods: - [connector.create](/manual/api/reference/connector/create) - create new connectors - [connector.delete](/manual/api/reference/connector/delete) - delete connectors - [connector.get](/manual/api/reference/connector/get) - retrieve connectors - [connector.update](/manual/api/reference/connector/update) - update connectors # Savienotājs Šī klase ir paredzēta darbam ar savienotājiem. Objektu atsauces: - [Savienotājs](/manual/api/reference/connector/object#connector) - [Birkas filtrs](/manual/api/reference/connector/object#tag-filter) Pieejamās metodes: - [connector.create](/manual/api/reference/connector/create) - izveidot jaunus savienotājus - [connector.delete](/manual/api/reference/connector/delete) - dzēst savienotājus - [connector.get](/manual/api/reference/connector/get) - izgūt savienotājus - [connector.update](/manual/api/reference/connector/update) - atjaunināt savienotājus # connector.update # connector.update #### connector [ZBXNEXT-8735](https://support.zabbix.com/browse/ZBXNEXT-8735) Added new property `item_value_type`, which is supported if `data_type` is set to "Item values" (0).<br> [ZBXNEXT-8735](https://support.zabbix.com/browse/ZBXNEXT-8735) Added new property `attempt_interval`, which is supported if `max_attempts` is greater than 1. #### savienotājs [ZBXNEXT-8735](https://support.zabbix.com/browse/ZBXNEXT-8735) Pievienota jauna īpašība `item_value_type`, kas tiek atbalstīta, ja `data_type` ir iestatīts uz "Item values" (0).<br> [ZBXNEXT-8735](https://support.zabbix.com/browse/ZBXNEXT-8735) Pievienota jauna īpašība `attempt_interval`, kas tiek atbalstīta, ja `max_attempts` ir lielāks par 1. #### Consistent default history storage period The default period for keeping item history has been made consistent at 31 days in the frontend and in the database. This change affects item, template item and item prototype configuration forms as well as the history storage period override in low-level discovery. #### Konsekvents noklusējuma vēstures glabāšanas periods Noklusējuma periods vienumu vēstures glabāšanai ir padarīts konsekvents — 31 diena lietotāja saskarnē un datubāzē. Šīs izmaiņas ietekmē vienumu, veidnes vienumu un vienumu prototipu konfigurācijas formas, kā arī vēstures glabāšanas perioda pārrakstīšanu zemlīmeņa atklāšanā. #### Content The event context menu has six sections: *View*, *Actions*, *Configuration*, *Problem*, *Links*, and *Scripts*. For the entities that are not configured, links are disabled and displayed in gray. The sections *Scripts* and *Links* are displayed if their entities are configured. The *View* section contains links to: - **Problems** - opens the list of unresolved problems of the underlying trigger; - **History** - leads to the *Latest data* graph/item history for the underlying item(s). If a trigger uses several items, links will be available for each of them. The *Actions* section is available in *Trigger overview* widgets only. It contains a link to: - **Update problem** - opens the [problem update](/manual/acknowledgment#updating-problems) screen. The *Configuration* section contains links to the configuration of: - **Trigger** that fired the problem; - **Items** used in the trigger expression. ::: notetip Note that configuration section is available only for Admin and Super admin users. ::: The *Problem* section contains the options to: - **Mark as cause** - mark the problem as cause; - **Mark selected as symptoms** - mark the selected problems as symptoms of this problem. The *Links* section contains links to: - access a configured [trigger URL](/manual/config/triggers/trigger#configuration); - access custom links configured in [Global scripts](/manual/web_interface/frontend_sections/alerts/scripts) (with scope 'Manual event action' and type 'URL'); - access a configured external ticket for the problem (see the *Include event menu entry* option when configuring [webhooks](/manual/config/notifications/media/webhook)). The *Scripts* section contains links to execute a global [script](/manual/web_interface/frontend_sections/alerts/scripts) (with scope *Manual event action*). This feature may be handy for running scripts used for managing problem tickets in external systems. #### Saturs Notikuma konteksta izvēlnē ir sešas sadaļas: *Skats*, *Darbības*, *Konfigurācija*, *Problēma*, *Saites* un *Skripti*. Entītijām, kas nav konfigurētas, saites ir atspējotas un attēlotas pelēkā krāsā. Sadaļas *Skripti* un *Saites* tiek attēlotas, ja to entītijas ir konfigurētas. Sadaļā *Skats* ir saites uz: - **Problēmas** - atver pamatā esošā trigeris neatrisināto problēmu sarakstu; - **Vēsture** - ved uz pamatā esošā vienums(-u) *Jaunākie dati* grafiku/vienuma vēsturi. Ja trigeris izmanto vairākus vienumus, saites būs pieejamas katram no tiem. Sadaļa *Darbības* ir pieejama tikai *Trigeru pārskata* logrīkos. Tajā ir saite uz: - **Atjaunināt problēmu** - atver [problēmas atjaunināšanas](/manual/acknowledgment#updating-problems) ekrānu. Sadaļā *Konfigurācija* ir saites uz šādu objektu konfigurāciju: - **Trigeris**, kas izraisīja problēmu; - **Vienumi**, kas izmantoti trigeris izteiksmē. ::: notetip Ņemiet vērā, ka konfigurācijas sadaļa ir pieejama tikai Admin un Super admin lietotājiem. ::: Sadaļā *Problēma* ir pieejamas šādas opcijas: - **Atzīmēt kā cēloni** - atzīmēt problēmu kā cēloni; - **Atzīmēt atlasītos kā simptomus** - atzīmēt atlasītās problēmas kā šīs problēmas simptomus. Sadaļā *Saites* ir saites, lai: - piekļūtu konfigurētam [trigeris URL](/manual/config/triggers/trigger#configuration); - piekļūtu pielāgotām saitēm, kas konfigurētas [Globālajos skriptos](/manual/web_interface/frontend_sections/alerts/scripts) (ar tvērumu 'Manual event action' un tipu 'URL'); - piekļūtu konfigurētai ārējai problēmas biļetei (skatiet opciju *Include event menu entry*, konfigurējot [webhooks](/manual/config/notifications/media/webhook)). Sadaļā *Skripti* ir saites globāla [skripta](/manual/web_interface/frontend_sections/alerts/scripts) izpildei (ar tvērumu *Manual event action*). Šī iespēja var būt noderīga, lai palaistu skriptus, kas tiek izmantoti problēmu biļešu pārvaldībai ārējās sistēmās. #### Content The host context menu has four sections: *View*, *Configuration*, *Links*, and *Scripts*. For the entities that are not configured, links are disabled and displayed in gray color. The sections *Scripts* and *Links* are displayed if their entities are configured. *View* section contains links to: - **Dashboards** - opens widgets and graphs. - **Problems** - opens the *Problems* section with the list of unresolved problems of the underlying trigger. - **Latest data** - opens the *Latest data* section with the list of all the latest data of the current host. - **Graphs** - opens simple graphs of the current host. - **Web**- opens the link to the configured web scenarios. - **Inventory** - opens the link to the inventory of the current host. *Configuration* section contains links to: - **Host** - configuration form of the current host. - **Items** - the list of the current host items. - **Triggers** - the list of the current host triggers. - **Graphs** - simple graphs of the current host. - **Discovery** - the list of low-level discovery rules of the current host. - **Web** - the list of web scenarios of the current host. ::: notetip Note that configuration section is available only for Admin and Super admin users. ::: *Links* section contains links to: - access a configured [trigger URL](/manual/config/triggers/trigger#configuration). - access custom links configured in [Global scripts](/manual/web_interface/frontend_sections/alerts/scripts) (with scope *Manual host action* and type 'URL'). *Scripts* section allows to execute [global scripts](/manual/web_interface/frontend_sections/alerts/scripts) configured for the current host. These scripts need to have their scope defined as *Manual host action* to be available in the host menu. #### Saturs Hosts konteksta izvēlnei ir četras sadaļas: *View*, *Configuration*, *Links* un *Scripts*. Entītijām, kas nav konfigurētas, saites ir atspējotas un tiek rādītas pelēkā krāsā. Sadaļas *Scripts* un *Links* tiek rādītas, ja to entītijas ir konfigurētas. Sadaļa *View* satur saites uz: - **Dashboards** - atver logrīkus un grafikus. - **Problems** - atver sadaļu *Problems* ar neatrisināto problēmu sarakstu attiecīgajam trigerim. - **Latest data** - atver sadaļu *Latest data* ar visu pašreizējā hosta jaunāko datu sarakstu. - **Graphs** - atver pašreizējā hosta vienkāršos grafikus. - **Web**- atver saiti uz konfigurētajiem tīmekļa scenārijiem. - **Inventory** - atver saiti uz pašreizējā hosta inventāru. Sadaļa *Configuration* satur saites uz: - **Host** - pašreizējā hosta konfigurācijas forma. - **Items** - pašreizējā hosta vienumu saraksts. - **Triggers** - pašreizējā hosta trigeru saraksts. - **Graphs** - pašreizējā hosta vienkāršie grafiki. - **Discovery** - pašreizējā hosta zema līmeņa atklāšanas noteikumu saraksts. - **Web** - pašreizējā hosta tīmekļa scenāriju saraksts. ::: notetip Ņemiet vērā, ka konfigurācijas sadaļa ir pieejama tikai Admin un Super admin lietotājiem. ::: Sadaļa *Links* satur saites uz: - piekļuvi konfigurētam [trigger URL](/manual/config/triggers/trigger#configuration). - piekļuvi pielāgotām saitēm, kas konfigurētas sadaļā [Global scripts](/manual/web_interface/frontend_sections/alerts/scripts) (ar tvērumu *Manual host action* un tipu 'URL'). Sadaļa *Scripts* ļauj izpildīt [global scripts](/manual/web_interface/frontend_sections/alerts/scripts), kas konfigurēti pašreizējam hostam. Lai tie būtu pieejami hosta izvēlnē, šo skriptu tvērumam jābūt definētam kā *Manual host action*. #### Content The item menu has three sections: *View*, *Configuration*, and *Actions*. The *View* section contains the following options: - **Latest data** - opens the [*Latest data*](/manual/web_interface/frontend_sections/monitoring/latest_data) section filtered by the current host and item; - **Graph** - opens a [simple graph](/manual/config/visualization/graphs/simple) of the current item; - **Values** - opens the list of all [values](/manual/config/visualization/graphs/simple#switching-to-raw-values) received for the current item within the past 60 minutes; - **500 latest values** - opens the list of [500 latest values](/manual/config/visualization/graphs/simple#switching-to-raw-values) for the current item. The *Configuration* section (available only for *Admin* and *Super admin* type users) contains the following options: - **Item** - opens the [item configuration form](/manual/config/items/item#configuration) of the current item; - **Template** - opens the [template configuration form](/manual/config/templates/template#creating-a-template) of the template that the item belongs to (since Zabbix 7.0.4; available only when the item menu is accessed from *Data collection* → *Templates* → [*Items*](/manual/web_interface/frontend_sections/data_collection/templates/items)); - **Host** - opens the [host configuration form](/manual/config/hosts/host#configuring-a-host) of the host that the item belongs to (since Zabbix 7.0.4); - **Triggers** - on mouseover, opens a list of item's triggers, if any; clicking on a trigger opens its [trigger configuration form](/manual/config/triggers/trigger#configuration); - **Create trigger** - opens the [trigger configuration form](/manual/config/triggers/trigger#configuration) to create a trigger for this item; - **Create dependent item** - opens the [item configuration form](/manual/config/items/item#configuration) to create a dependent item, with the current item as the master item; - **Create dependent discovery rule** - opens the [discovery rule configuration form](/manual/discovery/network_discovery/rule) to create a dependent discovery rule, with the current item as the master item. The *Actions* section contains the following option: - **Execute now** - [executes a check](/manual/config/items/check_now) for a new item value immediately. #### Saturs Vienuma izvēlnei ir trīs sadaļas: *View*, *Configuration* un *Actions*. Sadaļa *View* satur šādas opcijas: - **Latest data** - atver sadaļu [*Latest data*](/manual/web_interface/frontend_sections/monitoring/latest_data), kas filtrēta pēc pašreizējā hosta un vienuma; - **Graph** - atver pašreizējā vienuma [vienkāršo grafiku](/manual/config/visualization/graphs/simple); - **Values** - atver visu [vērtību](/manual/config/visualization/graphs/simple#switching-to-raw-values) sarakstu, kas saņemtas pašreizējam vienumam pēdējo 60 minūšu laikā; - **500 latest values** - atver pašreizējā vienuma [500 jaunāko vērtību](/manual/config/visualization/graphs/simple#switching-to-raw-values) sarakstu. Sadaļa *Configuration* (pieejama tikai lietotājiem ar *Admin* un *Super admin* tipu) satur šādas opcijas: - **Item** - atver pašreizējā vienuma [vienuma konfigurācijas formu](/manual/config/items/item#configuration); - **Template** - atver veidnes, kurai pieder vienums, [veidnes konfigurācijas formu](/manual/config/templates/template#creating-a-template) (kopš Zabbix 7.0.4; pieejama tikai tad, ja vienuma izvēlne tiek atvērta no *Data collection* → *Templates* → [*Items*](/manual/web_interface/frontend_sections/data_collection/templates/items)); - **Host** - atver hosta, kuram pieder vienums, [hosta konfigurācijas formu](/manual/config/hosts/host#configuring-a-host) (kopš Zabbix 7.0.4); - **Triggers** - novietojot peles kursoru, atver vienuma trigeru sarakstu, ja tāds ir; noklikšķinot uz trigera, tiek atvērta tā [trigera konfigurācijas forma](/manual/config/triggers/trigger#configuration); - **Create trigger** - atver [trigera konfigurācijas formu](/manual/config/triggers/trigger#configuration), lai izveidotu trigeri šim vienumam; - **Create dependent item** - atver [vienuma konfigurācijas formu](/manual/config/items/item#configuration), lai izveidotu atkarīgo vienumu, izmantojot pašreizējo vienumu kā galveno vienumu; - **Create dependent discovery rule** - atver [atklāšanas noteikuma konfigurācijas formu](/manual/discovery/network_discovery/rule), lai izveidotu atkarīgo atklāšanas noteikumu, izmantojot pašreizējo vienumu kā galveno vienumu. Sadaļa *Actions* satur šādu opciju: - **Execute now** - nekavējoties [izpilda pārbaudi](/manual/config/items/check_now) jaunai vienuma vērtībai. #### Context menus In addition to the main menu, Zabbix provides context menus for [host](/manual/web_interface/menu/host_menu), [item](/manual/web_interface/menu/item_menu), and [event](/manual/web_interface/menu/event_menu) for quick access to frequently used entities, such as the latest values, simple graph, configuration form, related scripts or external links. The context menus are accessible by clicking on the host, item or problem/trigger name in supported locations. #### Konteksta izvēlnes Papildus galvenajai izvēlnei Zabbix nodrošina konteksta izvēlnes [host](/manual/web_interface/menu/host_menu), [vienums](/manual/web_interface/menu/item_menu) un [event](/manual/web_interface/menu/event_menu) ātrai piekļuvei bieži izmantotām entītijām, piemēram, jaunākajām vērtībām, vienkāršam grafikam, konfigurācijas formai, saistītajiem skriptiem vai ārējām saitēm. Konteksta izvēlnes ir pieejamas, noklikšķinot uz host, vienums vai problēmas/trigeris nosaukuma atbalstītajās vietās. ### Controller Action controller workflow: 1. Check that all parameters passed in an HTTP request are valid: - Call the controller's *checkInput()* method; - Use validation rules defined in CNewValidator.php; - Call *validateInput()* method. 2. Check user permissions. 3. Prepare the data according to passed parameters: if *checkInput()* returns true, Zabbix calls the controller's *doAction()* method. 4. Prepare the **$data** array for the view. Use *CControllerResponseData* and *setResponse()* method to store response in the **$data** array. Example: ````php /** * Validate input parameters. * * @return bool */ protected function checkInput(): bool { $ret = $this->validateInput([ 'status' => 'in '.implode(',', [HOST_STATUS_MONITORED, HOST_STATUS_NOT_MONITORED]) ]); if (!$ret) { $this->setResponse(new CControllerResponseFatal()); } return $ret; } /** * Check user permissions. * * @return bool */ protected function checkPermissions() { return $this->getUserType() >= USER_TYPE_ZABBIX_ADMIN; } /** * Execute action and generate response object. */ protected function do Action(): void { $data = [ 'hosts_count' => API::Host()->get([ 'countOutput' => true, 'filter' => [ 'status' => $this->getInput('status') ] ]) ]; $this->setResponse(new CControllerResponseData($data)); } ```` ::: notetip You can view the full list of available controller classes in Zabbix [source code](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/ui/app/controllers). ::: ### Kontrolieris Darbplūsma darbībai kontrolierī: 1. Pārbaudiet, vai visi HTTP pieprasījumā nodotie parametri ir derīgi: - Izsauciet kontroliera *checkInput()* metodi; - Izmantojiet validācijas noteikumus, kas definēti CNewValidator.php; - Izsauciet *validateInput()* metodi. 2. Pārbaudiet lietotāja atļaujas. 3. Sagatavojiet datus atbilstoši nodotajiem parametriem: ja *checkInput()* atgriež true, Zabbix izsauc kontroliera *doAction()* metodi. 4. Sagatavojiet **$data** masīvu skatam. Izmantojiet *CControllerResponseData* un *setResponse()* metodi, lai saglabātu atbildi **$data** masīvā. Piemērs: ````php /** * Validate input parameters. * * @return bool */ protected function checkInput(): bool { $ret = $this->validateInput([ 'status' => 'in '.implode(',', [HOST_STATUS_MONITORED, HOST_STATUS_NOT_MONITORED]) ]); if (!$ret) { $this->setResponse(new CControllerResponseFatal()); } return $ret; } /** * Check user permissions. * * @return bool */ protected function checkPermissions() { return $this->getUserType() >= USER_TYPE_ZABBIX_ADMIN; } /** * Execute action and generate response object. */ protected function do Action(): void { $data = [ 'hosts_count' => API::Host()->get([ 'countOutput' => true, 'filter' => [ 'status' => $this->getInput('status') ] ]) ]; $this->setResponse(new CControllerResponseData($data)); } ```` ::: notetip Pilnu pieejamo kontrolieru klašu sarakstu varat skatīt Zabbix [avota kodā](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/ui/app/controllers). ::: ##### ControlSocket The control socket, used to send runtime commands with the `-R` option. Default: `\\.\pipe\agent.sock` ##### ControlSocket Vadības ligzda, ko izmanto izpildlaika komandu nosūtīšanai ar `-R` opciju. Noklusējums: `\\.\pipe\agent.sock` ##### ControlSocket The control socket, used to send runtime commands with the `-R` option. Default: `/tmp/agent.sock` ##### ControlSocket Vadības ligzda, ko izmanto izpildlaika komandu nosūtīšanai ar `-R` opciju. Noklusējums: `/tmp/agent.sock` #### Cookie The `Cookie` object is returned by the [`Browser`](#browser) object `getCookies()` method and passed to the `addCookie()` method. While the `Cookie` object does not have any methods, it can contain the following properties: |Property|Type|Description| |--|--|------| |name|string|Name of the cookie.| |value|string|Value of the cookie.| |path|string|Path for which the cookie is valid.<br>Defaults to `"/"` if omitted when adding a cookie.| |domain|string|Domain to which the cookie is visible.<br>Defaults to the URL domain of the session's current browsing context's active document if omitted when adding a cookie.| |secure|boolean|Indicates whether the cookie is secure.<br>Defaults to `false` if omitted when adding a cookie.| |httpOnly|boolean|Indicates whether the cookie is HTTP-only.<br>Defaults to `false` if omitted when adding a cookie.| |expiry|integer|Expiration time of the cookie (in seconds since the Unix Epoch). Must not be set if omitted when adding a cookie.| |sameSite|string|The `sameSite` attribute of the cookie, which controls whether the cookie should be restricted to a first-party or same-site context.<br>Can be set to either `"Lax"` or `"Strict"`.<br>Defaults to `"None"` if omitted when adding a cookie.| #### Cookie Objektu `Cookie` atgriež objekta [`Browser`](#browser) metode `getCookies()`, un tas tiek nodots metodei `addCookie()`. Lai gan objektam `Cookie` nav metožu, tas var saturēt šādas īpašības: |Īpašība|Type|Apraksts| |--|--|------| |name|string|Sīkdatnes nosaukums.| |value|string|Sīkdatnes vērtība.| |path|string|Ceļš, kuram sīkdatne ir derīga.<br>Ja, pievienojot sīkdatni, tas nav norādīts, pēc noklusējuma tiek izmantots `"/"`.| |domain|string|Domēns, kurā sīkdatne ir redzama.<br>Ja, pievienojot sīkdatni, tas nav norādīts, pēc noklusējuma tiek izmantots sesijas pašreizējā pārlūkošanas konteksta aktīvā dokumenta URL domēns.| |secure|boolean|Norāda, vai sīkdatne ir droša.<br>Ja, pievienojot sīkdatni, tas nav norādīts, pēc noklusējuma tiek izmantots `false`.| |httpOnly|boolean|Norāda, vai sīkdatne ir tikai HTTP.<br>Ja, pievienojot sīkdatni, tas nav norādīts, pēc noklusējuma tiek izmantots `false`.| |expiry|integer|Sīkdatnes derīguma termiņš (sekundēs kopš Unix laikmeta sākuma). To nedrīkst iestatīt, ja, pievienojot sīkdatni, tas nav norādīts.| |sameSite|string|Sīkdatnes atribūts `sameSite`, kas nosaka, vai sīkdatnei jābūt ierobežotai līdz pirmās puses vai tās pašas vietnes kontekstam.<br>Var iestatīt uz `"Lax"` vai `"Strict"`.<br>Ja, pievienojot sīkdatni, tas nav norādīts, pēc noklusējuma tiek izmantots `"None"`.| #### Copy an LLD rule to multiple hosts Copy an LLD rule to two hosts. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "discoveryrule.copy", "params": { "discoveryids": [ "27426" ], "hostids": [ "10196", "10197" ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": true, "id": 1 } ``` #### LLD noteikuma kopēšana uz vairākiem hosts Kopējiet LLD noteikumu uz diviem hosts. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "discoveryrule.copy", "params": { "discoveryids": [ "27426" ], "hostids": [ "10196", "10197" ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": true, "id": 1 } ``` #### Copying/pasting pages Dashboard pages can be copied and pasted, allowing to create a new page with the properties of an existing one. They can be pasted from the same dashboard or a different dashboard. To paste an existing page to the dashboard, first copy it, using the [page menu](#page-menu):  To paste the copied page: - Make sure the dashboard is in the [editing mode](#viewing-a-dashboard) - Click on the arrow next to the *Add* button and select the *Paste page* option #### Lapu kopēšana/ielīmēšana Informācijas paneļa lapas var kopēt un ielīmēt, tādējādi izveidojot jaunu lapu ar esošas lapas īpašībām. Tās var ielīmēt no tā paša informācijas paneļa vai no cita informācijas paneļa. Lai ielīmētu esošu lapu informācijas panelī, vispirms to nokopējiet, izmantojot [lapas izvēlni](#page-menu):  Lai ielīmētu nokopēto lapu: - Pārliecinieties, ka informācijas panelis ir [rediģēšanas režīmā](#viewing-a-dashboard) - Noklikšķiniet uz bultiņas blakus pogai *Add* un atlasiet opciju *Paste page* #### Copying/pasting widgets You can copy and paste dashboard widgets to quickly create new widgets with the same configuration. Widgets can be copy-pasted within the same dashboard or between dashboards opened in different tabs. To copy a widget, use the [widget menu](#widget-menu). To paste a copied widget (available in dashboard [editing mode](#editing-a-dashboard)): - Click the arrow next to the *Add* button and select *Paste widget*. - Alternatively, click an empty area in the dashboard and select *Paste widget*. You can also paste a copied widget over an existing widget using the *Paste* option in its [widget menu](#widget-menu). #### Logrīku kopēšana un ielīmēšana Varat kopēt un ielīmēt paneļa logrīkus, lai ātri izveidotu jaunus logrīkus ar tādu pašu konfigurāciju. Logrīkus var kopēt un ielīmēt vienā un tajā pašā panelī vai starp paneļiem, kas atvērti dažādās cilnēs. Lai kopētu logrīku, izmantojiet [logrīka izvēlni](#widget-menu). Lai ielīmētu nokopētu logrīku (pieejams paneļa [rediģēšanas režīmā](#editing-a-dashboard)): - Noklikšķiniet uz bultiņas blakus pogai *Add* un atlasiet *Paste widget*. - Vai arī noklikšķiniet uz tukšas vietas panelī un atlasiet *Paste widget*. Varat arī ielīmēt nokopētu logrīku virs esoša logrīka, izmantojot opciju *Paste* tā [logrīka izvēlnē](#widget-menu). ##### Copying PHP files Zabbix frontend is written in PHP, so to run it a PHP supported webserver is needed. Installation is done by simply copying the PHP files from the ui directory to the webserver HTML documents directory. Common locations of HTML documents directories for Apache web servers include: - /usr/local/apache2/htdocs (default directory when installing Apache from source) - /srv/www/htdocs (OpenSUSE, SLES) - /var/www/html (Debian, Ubuntu, Fedora, RHEL) It is suggested to use a subdirectory instead of the HTML root. To create a subdirectory and copy Zabbix frontend files into it, execute the following commands, replacing the <htdocs> with actual directory: mkdir <htdocs>/zabbix cd ui cp -a . <htdocs>/zabbix If planning to use any other language than English, see [Installation of additional frontend languages](/manual/appendix/install/locales) for instructions. ##### PHP failu kopēšana Zabbix lietotāja saskarne ir rakstīta PHP valodā, tāpēc tās palaišanai ir nepieciešams tīmekļa serveris ar PHP atbalstu. Instalēšana tiek veikta, vienkārši kopējot PHP failus no ui direktorijas uz tīmekļa servera HTML dokumentu direktoriju. Biežāk sastopamās HTML dokumentu direktoriju atrašanās vietas Apache tīmekļa serveriem ir šādas: - /usr/local/apache2/htdocs (noklusējuma direktorija, instalējot Apache no pirmkoda) - /srv/www/htdocs (OpenSUSE, SLES) - /var/www/html (Debian, Ubuntu, Fedora, RHEL) Ieteicams izmantot apakšdirektoriju, nevis HTML saknes direktoriju. Lai izveidotu apakšdirektoriju un tajā kopētu Zabbix lietotāja saskarnes failus, izpildiet šādas komandas, aizstājot <htdocs> ar faktisko direktoriju: mkdir <htdocs>/zabbix cd ui cp -a . <htdocs>/zabbix Ja plānojat izmantot jebkuru citu valodu, nevis angļu, skatiet [Papildu lietotāja saskarnes valodu instalēšana](/manual/appendix/install/locales), lai iegūtu norādījumus. # Copyright notice Zabbix documentation is NOT distributed under the AGPL-3.0 license. Use of Zabbix documentation is subject to the following terms: You may create a printed copy of this documentation solely for your own personal use. Conversion to other formats is allowed as long as the actual content is not altered or edited in any way. You shall not publish or distribute this documentation in any form or on any media, except if you distribute the documentation in a manner similar to how Zabbix disseminates it (that is, electronically for download on a Zabbix web site) or on a USB or similar medium, provided however that the documentation is disseminated together with the software on the same medium. Any other use, such as any dissemination of printed copies or use of this documentation, in whole or in part, in another publication, requires the prior written consent from an authorized representative of Zabbix. Zabbix reserves any and all rights to this documentation not expressly granted above. # Autortiesību paziņojums Uz Zabbix dokumentāciju NEATTIECAS AGPL-3.0 licence. Uz Zabbix dokumentācijas izmantošanu attiecas šādi noteikumi: Jūs drīkstat izveidot šīs dokumentācijas drukātu kopiju tikai savai personīgai lietošanai. Pārveidošana citos formātos ir atļauta, ja vien faktiskais saturs nekādā veidā netiek mainīts vai rediģēts. Jūs nedrīkstat publicēt vai izplatīt šo dokumentāciju jebkādā formā vai jebkādā datu nesējā, izņemot gadījumus, kad izplatāt dokumentāciju līdzīgā veidā, kā to izplata Zabbix (tas ir, elektroniski lejupielādei Zabbix tīmekļa vietnē) vai USB vai līdzīgā datu nesējā, tomēr ar nosacījumu, ka dokumentācija tiek izplatīta kopā ar programmatūru tajā pašā datu nesējā. Jebkurai citai izmantošanai, piemēram, drukātu kopiju izplatīšanai vai šīs dokumentācijas pilnīgai vai daļējai izmantošanai citā publikācijā, ir nepieciešama iepriekšēja rakstiska piekrišana no pilnvarota Zabbix pārstāvja. Zabbix patur visas tiesības uz šo dokumentāciju, kas nav skaidri piešķirtas iepriekš. #### Core processes - [Server](/manual/concepts/server) - the central process that performs polling and trapping of data, calculates triggers, and sends notifications to users. - [Agent](/manual/concepts/agent) - collects data from monitored hosts. - [Agent 2](/manual/concepts/agent2) - a new generation agent with plugin architecture and enhanced capabilities. - [Proxy](/manual/concepts/proxy) - collects monitoring data from monitored devices and sends the information to Zabbix server. - [Java gateway](/manual/concepts/java) - enables monitoring of Java applications. #### Pamatprocesi - [Serveris](/manual/concepts/server) - centrālais process, kas veic datu aptaujāšanu un uztveršanu, aprēķina trigerus un sūta paziņojumus lietotājiem. - [Aģents](/manual/concepts/agent) - apkopo datus no uzraudzītajiem hostiem. - [Aģents 2](/manual/concepts/agent2) - jaunās paaudzes aģents ar spraudņu arhitektūru un paplašinātām iespējām. - [Starpniekserveris](/manual/concepts/proxy) - apkopo uzraudzības datus no uzraudzītajām ierīcēm un nosūta informāciju uz Zabbix serveri. - [Java gateway](/manual/concepts/java) - nodrošina Java lietotņu uzraudzību. # correlation.create # correlation.create # correlation.delete # correlation.delete #### Correlation filter condition The correlation filter condition object defines a specific condition that must be checked before running the correlation operations. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |type|integer|Type of condition.<br><br>Possible values:<br>0 - old event tag;<br>1 - new event tag;<br>2 - new event host group;<br>3 - event tag pair;<br>4 - old event tag value;<br>5 - new event tag value.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |tag|string|Event tag (old or new).<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "old event tag", "new event tag", "old event tag value", or "new event tag value"| |groupid|ID|ID of the host group.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "new event host group"| |oldtag|string|Old event tag.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "event tag pair"| |newtag|string|Old event tag.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "event tag pair"| |value|string|Event tag (old or new) value.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "old event tag value" or "new event tag value"| |formulaid|string|Arbitrary unique ID that is used to reference the condition from a custom expression. Can only contain capital-case letters. The ID must be defined by the user when modifying filter conditions, but will be generated anew when requesting them afterward.| |operator|integer|Condition operator.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "new event host group", "old event tag value", or "new event tag value"| ::: notetip To better understand how to use filters with various types of expressions, see examples on the [correlation.get](get#retrieve-correlations) and [correlation.create](create#using-a-custom-expression-filter) method pages. ::: The following operators and values are supported for each condition type. |Condition|Condition name|Supported operators|Expected value| |---------|--------------|-------------------|--------------| |2|Host group|=, <>|Host group ID.| |4|Old event tag value|=, <>, like, not like|string| |5|New event tag value|=, <>, like, not like|string| #### Korelācijas filtra nosacījums Korelācijas filtra nosacījuma objekts definē konkrētu nosacījumu, kas jāpārbauda pirms korelācijas operāciju izpildes. |Īpašība|[Tips](/manual/api/reference_commentary#data-types)|Apraksts| |--|--|------| |type|integer|Nosacījuma tips.<br><br>Iespējamās vērtības:<br>0 - vecā notikuma tags;<br>1 - jaunā notikuma tags;<br>2 - jaunā notikuma hostu grupa;<br>3 - notikuma tagu pāris;<br>4 - vecā notikuma taga vērtība;<br>5 - jaunā notikuma taga vērtība.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāts*| |tag|string|Notikuma tags (vecais vai jaunais).<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāts*, ja `type` ir iestatīts uz "vecā notikuma tags", "jaunā notikuma tags", "vecā notikuma taga vērtība" vai "jaunā notikuma taga vērtība"| |groupid|ID|Hostu grupas ID.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāts*, ja `type` ir iestatīts uz "jaunā notikuma hostu grupa"| |oldtag|string|Vecā notikuma tags.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāts*, ja `type` ir iestatīts uz "notikuma tagu pāris"| |newtag|string|Vecā notikuma tags.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāts*, ja `type` ir iestatīts uz "notikuma tagu pāris"| |value|string|Notikuma taga (vecā vai jaunā) vērtība.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāts*, ja `type` ir iestatīts uz "vecā notikuma taga vērtība" vai "jaunā notikuma taga vērtība"| |formulaid|string|Patvaļīgs unikāls ID, ko izmanto, lai atsauktos uz nosacījumu no pielāgotas izteiksmes. Tas var saturēt tikai lielos burtus. Lietotājam šis ID jādefinē, modificējot filtra nosacījumus, taču pēc tam, kad tie tiek pieprasīti atkārtoti, tas tiks ģenerēts no jauna.| |operator|integer|Nosacījuma operators.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāts*, ja `type` ir iestatīts uz "jaunā notikuma hostu grupa", "vecā notikuma taga vērtība" vai "jaunā notikuma taga vērtība"| ::: notetip Lai labāk saprastu, kā izmantot filtrus ar dažādiem izteiksmju tipiem, skatiet piemērus [correlation.get](get#retrieve-correlations) un [correlation.create](create#using-a-custom-expression-filter) metožu lapās. ::: Tālāk ir norādīti operatori un vērtības, kas tiek atbalstīti katram nosacījuma tipam. |Nosacījums|Nosacījuma nosaukums|Atbalstītie operatori|Sagaidāmā vērtība| |---------|--------------|-------------------|--------------| |2|Hostu grupa|=, <>|Hostu grupas ID.| |4|Vecā notikuma taga vērtība|=, <>, like, not like|string| |5|Jaunā notikuma taga vērtība|=, <>, like, not like|string| ### Correlation filter The correlation filter object defines a set of conditions that must be met to perform the configured correlation operations. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |conditions|array|Set of [filter conditions](#correlation-filter-condition) to use for filtering results. The conditions will be sorted in the order of their placement in the formula.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |evaltype|integer|Filter condition [evaluation method](/manual/config/event_correlation/global#configuration).<br><br>Possible values:<br>0 - And/Or;<br>1 - And;<br>2 - Or;<br>3 - Custom expression.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |eval\_formula|string|Generated expression that will be used for evaluating filter conditions. The expression contains IDs that reference specific filter conditions by its `formulaid`. The value of `eval_formula` is equal to the value of `formula` for filters with a custom expression.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |formula|string|User-defined expression to be used for evaluating conditions of filters with a custom expression. The expression must contain IDs that reference specific filter conditions by its `formulaid`. The IDs used in the expression must exactly match the ones defined in the filter conditions: no condition can remain unused or omitted.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `evaltype` is set to "custom expression"| ### Korelācijas filtrs Korelācijas filtra objekts definē nosacījumu kopu, kam jābūt izpildītai, lai veiktu konfigurētās korelācijas darbības. Tam ir šādas īpašības. |Īpašība|[Tips](/manual/api/reference_commentary#data-types)|Apraksts| |--|--|------| |conditions|array|[Filtra nosacījumu](#correlation-filter-condition) kopa, ko izmantot rezultātu filtrēšanai. Nosacījumi tiks sakārtoti to izvietojuma secībā formulā.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāta*| |evaltype|integer|Filtra nosacījumu [novērtēšanas metode](/manual/config/event_correlation/global#configuration).<br><br>Iespējamās vērtības:<br>0 - Un/Vai;<br>1 - Un;<br>2 - Vai;<br>3 - Pielāgota izteiksme.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāta*| |eval\_formula|string|Ģenerēta izteiksme, kas tiks izmantota filtra nosacījumu novērtēšanai. Izteiksme satur ID, kas atsaucas uz konkrētiem filtra nosacījumiem pēc to `formulaid`. `eval_formula` vērtība ir vienāda ar `formula` vērtību filtriem ar pielāgotu izteiksmi.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *tikai lasāma*| |formula|string|Lietotāja definēta izteiksme, kas tiks izmantota filtru ar pielāgotu izteiksmi nosacījumu novērtēšanai. Izteiksmei jāsatur ID, kas atsaucas uz konkrētiem filtra nosacījumiem pēc to `formulaid`. Izteiksmē izmantotajiem ID precīzi jāsakrīt ar tiem, kas definēti filtra nosacījumos: neviens nosacījums nedrīkst palikt neizmantots vai izlaists.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāta*, ja `evaltype` ir iestatīts uz "pielāgota izteiksme"| # correlation.get # correlation.get # Correlation object The following objects are directly related to the `correlation` API. # Korelācijas objekts Tālāk norādītie objekti ir tieši saistīti ar `correlation` API. ### Correlation operation The correlation operation object defines an operation that will be performed when a correlation is executed. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |type|integer|Type of operation.<br><br>Possible values:<br>0 - close old events;<br>1 - close new event.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| ### Korelācijas operācija Korelācijas operācijas objekts definē operāciju, kas tiks izpildīta, kad tiks veikta korelācija. Tam ir šādas īpašības. |Īpašība|[Type](/manual/api/reference_commentary#data-types)|Apraksts| |--|--|------| |type|integer|Operācijas tips.<br><br>Iespējamās vērtības:<br>0 - aizvērt vecos notikumus;<br>1 - aizvērt jauno notikumu.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāts*| ### Correlation The correlation object has the following properties. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |correlationid|ID|ID of the correlation.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*<br>- *required* for update operations| |name|string|Name of the correlation.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |description|string|Description of the correlation.| |status|integer|Whether the correlation is enabled or disabled.<br><br>Possible values:<br>0 - *(default)* enabled;<br>1 - disabled.| ### Korelācija Korelācijas objektam ir šādas īpašības. |Īpašība|[Tips](/manual/api/reference_commentary#data-types)|Apraksts| |--|--|------| |correlationid|ID|Korelācijas ID.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *tikai lasāms*<br>- *obligāts* atjaunināšanas operācijām| |name|string|Korelācijas nosaukums.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāts* izveides operācijām| |description|string|Korelācijas apraksts.| |status|integer|Vai korelācija ir iespējota vai atspējota.<br><br>Iespējamās vērtības:<br>0 - *(noklusējums)* iespējota;<br>1 - atspējota.| # Correlation This class is designed to work with correlations. Object references: - [Correlation](/manual/api/reference/correlation/object#correlation) - [Correlation operation](/manual/api/reference/correlation/object#correlation-operation) - [Correlation filter](/manual/api/reference/correlation/object#correlation-filter) - [Correlation filter condition](/manual/api/reference/correlation/object#correlation-filter-condition) Available methods: - [correlation.create](/manual/api/reference/correlation/create) - create new correlations - [correlation.delete](/manual/api/reference/correlation/delete) - delete correlations - [correlation.get](/manual/api/reference/correlation/get) - retrieve correlations - [correlation.update](/manual/api/reference/correlation/update) - update correlations # Korelācija Šī klase ir paredzēta darbam ar korelācijām. Objektu atsauces: - [Korelācija](/manual/api/reference/correlation/object#correlation) - [Korelācijas darbība](/manual/api/reference/correlation/object#correlation-operation) - [Korelācijas filtrs](/manual/api/reference/correlation/object#correlation-filter) - [Korelācijas filtra nosacījums](/manual/api/reference/correlation/object#correlation-filter-condition) Pieejamās metodes: - [correlation.create](/manual/api/reference/correlation/create) - izveidot jaunas korelācijas - [correlation.delete](/manual/api/reference/correlation/delete) - dzēst korelācijas - [correlation.get](/manual/api/reference/correlation/get) - izgūt korelācijas - [correlation.update](/manual/api/reference/correlation/update) - atjaunināt korelācijas # correlation.update # correlation.update #### correlation [ZBX-21850](https://support.zabbix.com/browse/ZBX-21850) `correlation.get`: Filter conditions will be sorted in the order of their placement in the formula. #### korelācija [ZBX-21850](https://support.zabbix.com/browse/ZBX-21850) `correlation.get`: Filtra nosacījumi tiks sakārtoti formulas izvietojuma secībā. ##### cosh(value) {#cosh} The hyperbolic cosine of a value. Returns the value as a real number, not as scientific notation. Parameter: - **value** - the value to check For example, the hyperbolic cosine of a value '1' will be '1.54308063482'. Example: cosh(last(/host/key)) ##### cosh(value) {#cosh} Vērtības hiperboliskais kosinuss. Atgriež vērtību kā reālu skaitli, nevis zinātniskajā pierakstā. Parametrs: - **value** - pārbaudāmā vērtība Piemēram, vērtības '1' hiperboliskais kosinuss būs '1.54308063482'. Piemērs: cosh(last(/host/key)) ##### cos(value) {#cos} The cosine of a value, where the value is an angle expressed in radians. Parameter: - **value** - the value to check For example, the cosine of a value '1' will be '0.54030230586'. Example: cos(last(/host/key)) ##### cos(value) {#cos} Vērtības kosinuss, kur vērtība ir leņķis, kas izteikts radiānos. Parametrs: - **value** - pārbaudāmā vērtība Piemēram, vērtības '1' kosinuss būs '0.54030230586'. Piemērs: cos(last(/host/key)) ##### cot(value) {#cot} The cotangent of a value, where the value is an angle expressed in radians. Parameter: - **value** - the value to check For example, the cotangent of a value '1' will be '0.54030230586'. Example: cot(last(/host/key)) ##### cot(value) {#cot} Vērtības kotangenss, kur vērtība ir leņķis, kas izteikts radiānos. Parametrs: - **value** - pārbaudāmā vērtība Piemēram, vērtības '1' kotangenss būs '0.54030230586'. Piemērs: cot(last(/host/key)) ##### count(func_foreach(item filter,<time period>),<operator>,<pattern>) {#count} The count of values in an array returned by a foreach function.<br> Supported [foreach functions](/manual/appendix/functions/aggregate/foreach): *avg_foreach*, *count_foreach*, *exists_foreach*, *last_foreach*, *max_foreach*, *min_foreach*, *sum_foreach*. Parameters: - **func_foreach** - foreach function for which the number of returned values should be counted. See [foreach functions](/manual/appendix/functions/aggregate/foreach) for details. Note that count_foreach and bucket_rate_foreach support [additional parameters](/manual/appendix/functions/aggregate/foreach#additional-parameters). - **item filter** - see [item filter](/manual/appendix/functions/aggregate/foreach#item-filter-syntax);<br> - **time period** - see [time period](/manual/appendix/functions/aggregate/foreach#time-period);<br> - **operator** (must be double-quoted). Supported `operators`:<br>*eq* - equal<br>*ne* - not equal<br>*gt* - greater<br>*ge* - greater or equal<br>*lt* - less<br>*le* - less or equal<br>*like* - matches if contains pattern (case-sensitive)<br>*bitand* - bitwise AND<br>*regexp* - case-sensitive match of the regular expression given in `pattern`<br>*iregexp* - case-insensitive match of the regular expression given in `pattern`<br> - **pattern** - the required pattern (string arguments must be double-quoted); supported if *operator* is specified in the third parameter. Comments: - Using **count()** with a history-related foreach function (max_foreach, avg_foreach, etc.) may lead to performance implications, whereas using **exists_foreach()**, which works only with configuration data, will not have such effect. - Optional parameters *operator* or *pattern* can't be left empty after a comma, only fully omitted. - With *bitand* as the third parameter, the fourth `pattern` parameter can be specified as two numbers, separated by '/': **number_to_compare_with/mask**. count() calculates "bitwise AND" from the value and the *mask* and compares the result to *number_to_compare_with*. If the result of "bitwise AND" is equal to *number_to_compare_with*, the value is counted.<br>If *number_to_compare_with* and *mask* are equal, only the *mask* need be specified (without '/'). - With *regexp* or *iregexp* as the third parameter, the fourth `pattern` parameter can be an ordinary or [global](/manual/regular_expressions#global-regular-expressions) (starting with '@') regular expression. In case of global regular expressions case sensitivity is inherited from global regular expression settings. For the purpose of regexp matching, float values will always be represented with 4 decimal digits after '.'. Also note that for large numbers difference in decimal (stored in database) and binary (used by Zabbix server) representation may affect the 4th decimal digit. Examples: ```default count(max_foreach(/*/net.if.in[*],1h)) #calculate the number of net.if.in items that received data in the last hour until now count(last_foreach(/*/vfs.fs.size[*,pused]),"gt",95) #calculate the number of file systems with over 95% of disk space used ``` ##### count(func_foreach(item filter,<time period>),<operator>,<pattern>) {#count} Vērtību skaits masīvā, ko atgriež foreach funkcija.<br> Atbalstītās [foreach funkcijas](/manual/appendix/functions/aggregate/foreach): *avg_foreach*, *count_foreach*, *exists_foreach*, *last_foreach*, *max_foreach*, *min_foreach*, *sum_foreach*. Parametri: - **func_foreach** - foreach funkcija, kurai jāskaita atgriezto vērtību skaits. Sīkāku informāciju skatiet [foreach functions](/manual/appendix/functions/aggregate/foreach). Ņemiet vērā, ka count_foreach un bucket_rate_foreach atbalsta [papildu parametrus](/manual/appendix/functions/aggregate/foreach#additional-parameters). - **item filter** - skatiet [item filter](/manual/appendix/functions/aggregate/foreach#item-filter-syntax);<br> - **time period** - skatiet [time period](/manual/appendix/functions/aggregate/foreach#time-period);<br> - **operator** (jābūt ietvertam dubultpēdiņās). Atbalstītie `operators`:<br>*eq* - vienāds<br>*ne* - nav vienāds<br>*gt* - lielāks<br>*ge* - lielāks vai vienāds<br>*lt* - mazāks<br>*le* - mazāks vai vienāds<br>*like* - atbilst, ja satur paraugu (reģistrjutīgs)<br>*bitand* - bitu līmeņa AND<br>*regexp* - reģistrjutīga atbilstība regulārajai izteiksmei, kas norādīta `pattern`<br>*iregexp* - reģistrnejutīga atbilstība regulārajai izteiksmei, kas norādīta `pattern`<br> - **pattern** - nepieciešamais paraugs (string argumentiem jābūt ietvertiem dubultpēdiņās); atbalstīts, ja trešajā parametrā ir norādīts *operator*. Komentāri: - Izmantojot **count()** kopā ar ar vēsturi saistītu foreach funkciju (max_foreach, avg_foreach u. c.), var rasties veiktspējas ietekme, savukārt, izmantojot **exists_foreach()**, kas darbojas tikai ar konfigurācijas datiem, šādas ietekmes nebūs. - Neobligātos parametrus *operator* vai *pattern* nevar atstāt tukšus pēc komata; tos var tikai pilnībā izlaist. - Ja trešais parametrs ir *bitand*, ceturto `pattern` parametru var norādīt kā divus skaitļus, kas atdalīti ar '/': **number_to_compare_with/mask**. count() aprēķina "bitu līmeņa AND" starp vērtību un *mask* un salīdzina rezultātu ar *number_to_compare_with*. Ja "bitu līmeņa AND" rezultāts ir vienāds ar *number_to_compare_with*, vērtība tiek ieskaitīta.<br>Ja *number_to_compare_with* un *mask* ir vienādi, jānorāda tikai *mask* (bez '/'). - Ja trešais parametrs ir *regexp* vai *iregexp*, ceturtais `pattern` parametrs var būt parasta vai [globāla](/manual/regular_expressions#global-regular-expressions) (sākas ar '@') regulārā izteiksme. Globālo regulāro izteiksmju gadījumā reģistrjutība tiek mantota no globālo regulāro izteiksmju iestatījumiem. Regexp atbilstības noteikšanai peldošā komata vērtības vienmēr tiks attēlotas ar 4 decimāldaļām aiz '.'. Ņemiet vērā arī to, ka lieliem skaitļiem atšķirība decimālajā (datubāzē glabātajā) un binārajā (Zabbix serveris izmantotajā) attēlojumā var ietekmēt 4. decimāldaļu. Piemēri: ```default count(max_foreach(/*/net.if.in[*],1h)) #aprēķina net.if.in vienumu skaitu, kas saņēmuši datus pēdējās stundas laikā līdz šim brīdim count(last_foreach(/*/vfs.fs.size[*,pused]),"gt",95) #aprēķina failu sistēmu skaitu, kurās izmantoti vairāk nekā 95% diska vietas ``` ##### count(/host/key,(sec|#num)<:time shift>,<operator>,<pattern>) {#count} The number of values within the defined evaluation period.<br> Supported value types: *Float*, *Integer*, *String*, *Text*, *Log*. Parameters: - See [common parameters](#common-parameters)<br> - **operator** (must be double-quoted) Supported `operators`:<br>*eq* - equal (default for integer, float)<br>*ne* - not equal<br>*gt* - greater<br>*ge* - greater or equal<br>*lt* - less<br>*le* - less or equal<br>*like* (default for string, text, log) - matches if contains pattern (case-sensitive)<br>*bitand* - bitwise AND<br>*regexp* - case-sensitive match of the regular expression given in `pattern`<br>*iregexp* - case-insensitive match of the regular expression given in `pattern`<br> - **pattern** - the required pattern (string arguments must be double-quoted) Comments: - Float items match with the precision of 2.22e-16. - *like* is not supported as operator for integer values. - *like* and *bitand* are not supported as operators for float values. - For string, text, and log values only *eq*, *ne*, *like*, *regexp* and *iregexp* operators are supported. - With *bitand* as operator, the fourth `pattern` parameter can be specified as two numbers, separated by '/': **number_to_compare_with/mask**. count() calculates "bitwise AND" from the value and the *mask* and compares the result to *number_to_compare_with*. If the result of "bitwise AND" is equal to *number_to_compare_with*, the value is counted.<br>If *number_to_compare_with* and *mask* are equal, only the *mask* need be specified (without '/'). - With *regexp* or *iregexp* as operator, the fourth `pattern` parameter can be an ordinary or [global](/manual/regular_expressions#global-regular-expressions) (starting with '@') regular expression. In case of global regular expressions case sensitivity is inherited from global regular expression settings. For the purpose of regexp matching, float values will always be represented with 4 decimal digits after '.'. Also note that for large numbers difference in decimal (stored in database) and binary (used by Zabbix server) representation may affect the 4th decimal digit. Examples: ```default count(/host/icmpping,30m,,"0")>5 #ping has failed more than 5 times in 30 minutes count(/host/key,10m,"like","error") #the number of values for the last 10 minutes until now that contain 'error' count(/host/key,10m,,12) #the number of values for the last 10 minutes until now that equal '12' count(/host/key,10m,"gt",12) #the number of values for the last 10 minutes until now that are over '12' count(/host/key,#10,"gt",12) #the number of values within the last 10 values until now that are over '12' count(/host/key,10m:now-1d,"gt",12) #the number of values between 24 hours and 10 minutes and 24 hours ago from now that were over '12' count(/host/key,10m,"bitand","6/7") #the number of values for the last 10 minutes until now having '110' (in binary) in the 3 least significant bits count(/host/key,10m:now-1d) #the number of values between 24 hours and 10 minutes and 24 hours ago from now ``` ##### count(/host/key,(sec|#num)<:time shift>,<operator>,<pattern>) {#count} Vērtību skaits noteiktajā novērtēšanas periodā.<br> Atbalstītie vērtību tipi: *Float*, *Integer*, *String*, *Text*, *Log*. Parametri: - Skatiet [kopīgos parametrus](#common-parameters)<br> - **operator** (jābūt dubultpēdiņās) Atbalstītie `operators`:<br>*eq* - vienāds (noklusējums integer, float)<br>*ne* - nav vienāds<br>*gt* - lielāks<br>*ge* - lielāks vai vienāds<br>*lt* - mazāks<br>*le* - mazāks vai vienāds<br>*like* (noklusējums string, text, log) - atbilst, ja satur šablonu (reģistrjutīgs)<br>*bitand* - bitu AND<br>*regexp* - reģistrjutīga atbilstība regulārajai izteiksmei, kas norādīta `pattern`<br>*iregexp* - reģistrnejutīga atbilstība regulārajai izteiksmei, kas norādīta `pattern`<br> - **pattern** - nepieciešamais šablons (string argumentiem jābūt dubultpēdiņās) Komentāri: - Float vienumi tiek salīdzināti ar precizitāti 2.22e-16. - *like* netiek atbalstīts kā operators integer vērtībām. - *like* un *bitand* netiek atbalstīti kā operatori float vērtībām. - String, text un log vērtībām tiek atbalstīti tikai operatori *eq*, *ne*, *like*, *regexp* un *iregexp*. - Ja kā operators tiek izmantots *bitand*, ceturto `pattern` parametru var norādīt kā divus skaitļus, atdalītus ar '/': **number_to_compare_with/mask**. count() aprēķina "bitu AND" no vērtības un *mask* un salīdzina rezultātu ar *number_to_compare_with*. Ja "bitu AND" rezultāts ir vienāds ar *number_to_compare_with*, vērtība tiek ieskaitīta.<br>Ja *number_to_compare_with* un *mask* ir vienādi, jānorāda tikai *mask* (bez '/'). - Ja kā operators tiek izmantots *regexp* vai *iregexp*, ceturtais `pattern` parametrs var būt parasta vai [globāla](/manual/regular_expressions#global-regular-expressions) (sākas ar '@') regulārā izteiksme. Globālo regulāro izteiksmju gadījumā reģistrjutība tiek mantota no globālās regulārās izteiksmes iestatījumiem. Regexp salīdzināšanas vajadzībām float vērtības vienmēr tiks attēlotas ar 4 cipariem aiz '.'. Ņemiet vērā arī to, ka lieliem skaitļiem atšķirība starp decimālo (glabājas datubāzē) un bināro (izmanto Zabbix serveris) attēlojumu var ietekmēt 4. ciparu aiz komata. Piemēri: ```default count(/host/icmpping,30m,,"0")>5 #ping nav izdevies vairāk nekā 5 reizes 30 minūtēs count(/host/key,10m,"like","error") #vērtību skaits pēdējās 10 minūtēs līdz šim brīdim, kas satur 'error' count(/host/key,10m,,12) #vērtību skaits pēdējās 10 minūtēs līdz šim brīdim, kas ir vienādas ar '12' count(/host/key,10m,"gt",12) #vērtību skaits pēdējās 10 minūtēs līdz šim brīdim, kas ir lielākas par '12' count(/host/key,#10,"gt",12) #vērtību skaits pēdējās 10 vērtībās līdz šim brīdim, kas ir lielākas par '12' count(/host/key,10m:now-1d,"gt",12) #vērtību skaits starp periodu pirms 24 stundām un pirms 24 stundām mīnus 10 minūtes no pašreizējā brīža, kas bija lielākas par '12' count(/host/key,10m,"bitand","6/7") #vērtību skaits pēdējās 10 minūtēs līdz šim brīdim, kurām 3 vismazāk nozīmīgajos bitos ir '110' (binārā formā) count(/host/key,10m:now-1d) #vērtību skaits starp periodu pirms 24 stundām un pirms 24 stundām mīnus 10 minūtes no pašreizējā brīža ``` #### Counting of lines in Windows event log A new [`eventlog.count`](/manual/config/items/itemtypes/zabbix_agent/win_keys#eventlog.count) item has been added to Zabbix agent/agent 2 on Windows. This item returns an integer value with the count of lines in the Windows event log based on the specified parameters. #### Rindu skaita noteikšana Windows notikumu žurnālā Zabbix aģentam/aģentam 2 operētājsistēmā Windows ir pievienots jauns [`eventlog.count`](/manual/config/items/itemtypes/zabbix_agent/win_keys#eventlog.count) vienums. Šis vienums atgriež vesela skaitļa vērtību ar rindu skaitu Windows notikumu žurnālā, pamatojoties uz norādītajiem parametriem. ##### Counting of threads in `proc.mem[]` and `proc.num[]` items Linux kernel threads are counted by `proc.num[]` item but do not report memory in `proc.mem[]` item. For example: $ ps -ef | grep kthreadd root 2 0 0 09:51 ? 00:00:00 [kthreadd] $ zabbix_get -s localhost -k 'proc.num[kthreadd]' 1 $ zabbix_get -s localhost -k 'proc.mem[kthreadd]' ZBX_NOTSUPPORTED: Cannot get amount of "VmSize" memory. But what happens if there is a user process with the same name as a kernel thread ? Then it could look like this: $ ps -ef | grep kthreadd root 2 0 0 09:51 ? 00:00:00 [kthreadd] zabbix 9611 6133 0 17:58 pts/1 00:00:00 ./kthreadd $ zabbix_get -s localhost -k 'proc.num[kthreadd]' 2 $ zabbix_get -s localhost -k 'proc.mem[kthreadd]' 4157440 `proc.num[]` counted both the kernel thread and the user process. `proc.mem[]` reports memory for the user process only and counts the kernel thread memory as if it was 0. This is different from the case above when ZBX\_NOTSUPPORTED was reported. Be careful when using `proc.mem[]` and `proc.num[]` items if the program name happens to match one of the thread. Before putting parameters into `proc.mem[]` and `proc.num[]` items, you may want to test the parameters using `proc.num[]` item and `ps` command. ##### Pavedienu skaitīšana `proc.mem[]` un `proc.num[]` vienumos Linux kodola pavedieni tiek skaitīti ar `proc.num[]` vienumu, taču tie neziņo par atmiņu `proc.mem[]` vienumā. Piemēram: $ ps -ef | grep kthreadd root 2 0 0 09:51 ? 00:00:00 [kthreadd] $ zabbix_get -s localhost -k 'proc.num[kthreadd]' 1 $ zabbix_get -s localhost -k 'proc.mem[kthreadd]' ZBX_NOTSUPPORTED: Cannot get amount of "VmSize" memory. Bet kas notiek, ja ir lietotāja process ar tādu pašu nosaukumu kā kodola pavedienam? Tad tas varētu izskatīties šādi: $ ps -ef | grep kthreadd root 2 0 0 09:51 ? 00:00:00 [kthreadd] zabbix 9611 6133 0 17:58 pts/1 00:00:00 ./kthreadd $ zabbix_get -s localhost -k 'proc.num[kthreadd]' 2 $ zabbix_get -s localhost -k 'proc.mem[kthreadd]' 4157440 `proc.num[]` saskaitīja gan kodola pavedienu, gan lietotāja procesu. `proc.mem[]` ziņo par atmiņu tikai lietotāja procesam un uzskata kodola pavediena atmiņu par 0. Tas atšķiras no iepriekšējā gadījuma, kad tika ziņots ZBX\_NOTSUPPORTED. Esiet piesardzīgi, izmantojot `proc.mem[]` un `proc.num[]` vienumus, ja programmas nosaukums nejauši sakrīt ar kāda pavediena nosaukumu. Pirms parametru ievietošanas `proc.mem[]` un `proc.num[]` vienumos, iespējams, vēlēsieties pārbaudīt parametrus, izmantojot `proc.num[]` vienumu un komandu `ps`. ##### countunique(/host/key,(sec|#num)<:time shift>,<operator>,<pattern>) {#countunique} The number of unique values within the defined evaluation period.<br> Supported value types: *Float*, *Integer*, *String*, *Text*, *Log*. Parameters: - See [common parameters](#common-parameters)<br> - **operator** (must be double-quoted). Supported `operators`:<br>*eq* - equal (default for integer, float)<br>*ne* - not equal<br>*gt* - greater<br>*ge* - greater or equal<br>*lt* - less<br>*le* - less or equal<br>*like* (default for string, text, log) - matches if contains pattern (case-sensitive)<br>*bitand* - bitwise AND<br>*regexp* - case-sensitive match of the regular expression given in `pattern`<br>*iregexp* - case-insensitive match of the regular expression given in `pattern`<br> - **pattern** - the required pattern (string arguments must be double-quoted) Comments: - Float items match with the precision of 2.22e-16. - *like* is not supported as operator for integer values. - *like* and *bitand* are not supported as operators for float values. - For string, text, and log values only *eq*, *ne*, *like*, *regexp* and *iregexp* operators are supported. - With *bitand* as operator, the fourth `pattern` parameter can be specified as two numbers, separated by '/': **number_to_compare_with/mask**. countunique() calculates "bitwise AND" from the value and the *mask* and compares the result to *number_to_compare_with*. If the result of "bitwise AND" is equal to *number_to_compare_with*, the value is counted.<br>If *number_to_compare_with* and *mask* are equal, only the *mask* need be specified (without '/'). - With *regexp* or *iregexp* as operator, the fourth `pattern` parameter can be an ordinary or [global](/manual/regular_expressions#global-regular-expressions) (starting with '@') regular expression. In case of global regular expressions case sensitivity is inherited from global regular expression settings. For the purpose of regexp matching, float values will always be represented with 4 decimal digits after '.'. Also note that for large numbers difference in decimal (stored in database) and binary (used by Zabbix server) representation may affect the 4th decimal digit. Examples: ```default countunique(/host/key,10m) #the number of unique values for the last 10 minutes until now countunique(/host/key,10m,"like","error") #the number of unique values for the last 10 minutes until now that contain 'error' countunique(/host/key,10m,,12) #the number of unique values for the last 10 minutes until now that equal '12' countunique(/host/key,10m,"gt",12) #the number of unique values for the last 10 minutes until now that are over '12' countunique(/host/key,#10,"gt",12) #the number of unique values within the last 10 values until now that are over '12' countunique(/host/key,10m:now-1d,"gt",12) #the number of unique values between 24 hours and 10 minutes and 24 hours ago from now that were over '12' countunique(/host/key,10m,"bitand","6/7") #the number of unique values for the last 10 minutes until now having '110' (in binary) in the 3 least significant bits countunique(/host/key,10m:now-1d) #the number of unique values between 24 hours and 10 minutes and 24 hours ago from now ``` ##### countunique(/host/key,(sec|#num)<:time shift>,<operator>,<pattern>) {#countunique} Unikālo vērtību skaits definētajā novērtēšanas periodā.<br> Atbalstītie vērtību tipi: *Float*, *Integer*, *String*, *Text*, *Log*. Parametri: - Skatiet [kopīgos parametrus](#common-parameters)<br> - **operator** (jābūt dubultpēdiņās). Atbalstītie `operatori`:<br>*eq* - vienāds (noklusējums integer, float)<br>*ne* - nav vienāds<br>*gt* - lielāks par<br>*ge* - lielāks vai vienāds<br>*lt* - mazāks par<br>*le* - mazāks vai vienāds<br>*like* (noklusējums string, text, log) - atbilst, ja satur šablonu (reģistrjutīgs)<br>*bitand* - bitu UN<br>*regexp* - reģistrjutīga atbilstība `pattern` norādītajai regulārajai izteiksmei<br>*iregexp* - reģistrnejutīga atbilstība `pattern` norādītajai regulārajai izteiksmei<br> - **pattern** - nepieciešamais šablons (virknes argumentiem jābūt dubultpēdiņās) Komentāri: - Float vienumi tiek salīdzināti ar precizitāti 2.22e-16. - *like* netiek atbalstīts kā operators integer vērtībām. - *like* un *bitand* netiek atbalstīti kā operatori float vērtībām. - String, text un log vērtībām tiek atbalstīti tikai operatori *eq*, *ne*, *like*, *regexp* un *iregexp*. - Ja kā operators tiek izmantots *bitand*, ceturto `pattern` parametru var norādīt kā divus skaitļus, atdalītus ar '/': **number_to_compare_with/mask**. countunique() aprēķina "bitu UN" no vērtības un *mask* un salīdzina rezultātu ar *number_to_compare_with*. Ja "bitu UN" rezultāts ir vienāds ar *number_to_compare_with*, vērtība tiek ieskaitīta.<br>Ja *number_to_compare_with* un *mask* ir vienādi, var norādīt tikai *mask* (bez '/'). - Ja kā operators tiek izmantots *regexp* vai *iregexp*, ceturtais `pattern` parametrs var būt parasta vai [globāla](/manual/regular_expressions#global-regular-expressions) (sākas ar '@') regulārā izteiksme. Globālo regulāro izteiksmju gadījumā reģistrjutība tiek mantota no globālās regulārās izteiksmes iestatījumiem. Regexp salīdzināšanas vajadzībām float vērtības vienmēr tiks attēlotas ar 4 cipariem aiz '.'. Ņemiet vērā arī to, ka lieliem skaitļiem atšķirība starp decimālo (glabājas datubāzē) un bināro (izmanto Zabbix serveris) attēlojumu var ietekmēt 4. ciparu aiz komata. Piemēri: ```default countunique(/host/key,10m) #unikālo vērtību skaits pēdējās 10 minūtēs līdz šim brīdim countunique(/host/key,10m,"like","error") #unikālo vērtību skaits pēdējās 10 minūtēs līdz šim brīdim, kas satur 'error' countunique(/host/key,10m,,12) #unikālo vērtību skaits pēdējās 10 minūtēs līdz šim brīdim, kas ir vienādas ar '12' countunique(/host/key,10m,"gt",12) #unikālo vērtību skaits pēdējās 10 minūtēs līdz šim brīdim, kas ir lielākas par '12' countunique(/host/key,#10,"gt",12) #unikālo vērtību skaits pēdējās 10 vērtībās līdz šim brīdim, kas ir lielākas par '12' countunique(/host/key,10m:now-1d,"gt",12) #unikālo vērtību skaits starp periodu pirms 24 stundām un 10 minūtēm līdz periodam pirms 24 stundām no pašreizējā brīža, kas bija lielākas par '12' countunique(/host/key,10m,"bitand","6/7") #unikālo vērtību skaits pēdējās 10 minūtēs līdz šim brīdim, kurām 3 vismazāk nozīmīgajos bitos ir '110' (bināri) countunique(/host/key,10m:now-1d) #unikālo vērtību skaits starp periodu pirms 24 stundām un 10 minūtēm līdz periodam pirms 24 stundām no pašreizējā brīža ``` **CPU** Zabbix and especially Zabbix database may require significant CPU resources depending on number of monitored parameters and chosen database engine. **CPU** Zabbix un jo īpaši Zabbix datubāzei var būt nepieciešami ievērojami CPU resursi atkarībā no uzraudzīto parametru skaita un izvēlētā datubāzes dzinēja. #### Create a background image Create a small background image to be used as a pattern. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "image.create", "params": { "imagetype": 2, "name": "background_image", "image": "iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAIAAABvFaqvAAABhWlDQ1BJQ0MgcHJvZmlsZQAAKJF9kb1Lw0AYxp+miiJVEYuIOGSoTnZREcdahSJUCLVCqw4ml35Bk4YkxcVRcC04+LFYdXBx1tXBVRAEP0D8A8RJ0UVKfC8ptIjxjuN+PPc+D3fvAUK9zDSrIwZoum2mEnExk10Vu14RpNmHAQzJzDLmJCkJ3/F1jwDf76I8y7/uz9Gr5iwGBETiGDNMm3iDeGbTNjjvE4dZUVaJz4knTLog8SPXFY/fOBdcFnhm2Eyn5onDxGKhjZU2ZkVTI54mjqiaTvlCxmOV8xZnrVxlzXvyF4Zy+soy12mNIoFFLEGCCAVVlFCGjSjtOikWUnQe9/GPuH6JXAq5SmDkWEAFGmTXD/4Hv3tr5acmvaRQHOh8cZyPMaBrF2jUHOf72HEaJ0DwGbjSW/5KHZj9JL3W0iJHQP82cHHd0pQ94HIHGH4yZFN2pSAtIZ8H3s/om7LA4C3Qs+b1rXmO0wcgTb1K3gAHh8B4gbLXfd7d3d63f2ua/fsBNgxyjt6uuLsAAAAJcEhZcwAALiMAAC4jAXilP3YAAAAHdElNRQfqAwMOEg/MywcyAAAAGXRFWHRDb21tZW50AENyZWF0ZWQgd2l0aCBHSU1QV4EOFwAAACJJREFUOMtj5HLLYqAGYGKgEhg1aNSgUYNGDRo1aNQg8gEAon8A6hfVTC8AAAAASUVORK5CYII=" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "imageids": [ "189" ] }, "id": 1 } ``` #### Izveidojiet fona attēlu Izveidojiet nelielu fona attēlu, ko izmantot kā rakstu. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "image.create", "params": { "imagetype": 2, "name": "background_image", "image": "iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAIAAABvFaqvAAABhWlDQ1BJQ0MgcHJvZmlsZQAAKJF9kb1Lw0AYxp+miiJVEYuIOGSoTnZREcdahSJUCLVCqw4ml35Bk4YkxcVRcC04+LFYdXBx1tXBVRAEP0D8A8RJ0UVKfC8ptIjxjuN+PPc+D3fvAUK9zDSrIwZoum2mEnExk10Vu14RpNmHAQzJzDLmJCkJ3/F1jwDf76I8y7/uz9Gr5iwGBETiGDNMm3iDeGbTNjjvE4dZUVaJz4knTLog8SPXFY/fOBdcFnhm2Eyn5onDxGKhjZU2ZkVTI54mjqiaTvlCxmOV8xZnrVxlzXvyF4Zy+soy12mNIoFFLEGCCAVVlFCGjSjtOikWUnQe9/GPuH6JXAq5SmDkWEAFGmTXD/4Hv3tr5acmvaRQHOh8cZyPMaBrF2jUHOf72HEaJ0DwGbjSW/5KHZj9JL3W0iJHQP82cHHd0pQ94HIHGH4yZFN2pSAtIZ8H3s/om7LA4C3Qs+b1rXmO0wcgTb1K3gAHh8B4gbLXfd7d3d63f2ua/fsBNgxyjt6uuLsAAAAJcEhZcwAALiMAAC4jAXilP3YAAAAHdElNRQfqAwMOEg/MywcyAAAAGXRFWHRDb21tZW50AENyZWF0ZWQgd2l0aCBHSU1QV4EOFwAAACJJREFUOMtj5HLLYqAGYGKgEhg1aNSgUYNGDRo1aNQg8gEAon8A6hfVTC8AAAAASUVORK5CYII=" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "imageids": [ "189" ] }, "id": 1 } ``` #### Create a custom script Create a custom script that will reboot a server. The script will require write access to the host and will prompt the user for manual input. Upon successful input submission, script will display confirmation message in the frontend. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "script.create", "params": { "name": "Reboot server", "command": "reboot server {MANUALINPUT}", "type": 0, "scope": 2, "confirmation": "Are you sure you would like to reboot the server {MANUALINPUT}?", "manualinput": 1, "manualinput_prompt": "Which server you want to reboot?", "manualinput_validator": "[1-9]", "manualinput_validator_type": 0, "manualinput_default_value": "1" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "scriptids": [ "4" ] }, "id": 1 } ``` #### Izveidot pielāgotu skriptu Izveidojiet pielāgotu skriptu, kas pārstartēs serveri. Skriptam būs nepieciešama rakstīšanas piekļuve hostam, un tas aicinās lietotāju ievadīt manuālu ievadi. Pēc veiksmīgas ievades iesniegšanas skripts parādīs apstiprinājuma ziņojumu lietotāja saskarnē. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "script.create", "params": { "name": "Reboot server", "command": "reboot server {MANUALINPUT}", "type": 0, "scope": 2, "confirmation": "Are you sure you would like to reboot the server {MANUALINPUT}?", "manualinput": 1, "manualinput_prompt": "Which server you want to reboot?", "manualinput_validator": "[1-9]", "manualinput_validator_type": 0, "manualinput_default_value": "1" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "scriptids": [ "4" ] }, "id": 1 } ``` #### Create a discovery action Create a discovery action that will link template "10001" to discovered hosts. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "action.create", "params": { "name": "Discovery action", "eventsource": 1, "filter": { "evaltype": 0, "conditions": [ { "conditiontype": 21, "operator": 0, "value": "1" }, { "conditiontype": 10, "operator": 0, "value": "2" } ] }, "operations": [ { "operationtype": 6, "optemplate": [ { "templateid": "10001" } ] } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "18" ] }, "id": 1 } ``` #### Izveidot atklāšanas darbību Izveidojiet atklāšanas darbību, kas piesaistīs veidni "10001" atklātajiem hostiem. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "action.create", "params": { "name": "Discovery action", "eventsource": 1, "filter": { "evaltype": 0, "conditions": [ { "conditiontype": 21, "operator": 0, "value": "1" }, { "conditiontype": 10, "operator": 0, "value": "2" } ] }, "operations": [ { "operationtype": 6, "optemplate": [ { "templateid": "10001" } ] } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "18" ] }, "id": 1 } ``` #### Create a discovery rule Create a discovery rule to find machines running the Zabbix agent in the local network. The rule must use a single Zabbix agent check on port 10050. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "drule.create", "params": { "name": "Zabbix agent discovery", "iprange": "192.168.1.1-255", "concurrency_max": "10", "dchecks": [ { "type": "9", "key_": "system.uname", "ports": "10050", "uniq": "0" } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "druleids": [ "6" ] }, "id": 1 } ``` #### Izveidot atklāšanas kārtulu Izveidojiet atklāšanas kārtulu, lai atrastu iekārtas, kurās lokālajā tīklā darbojas Zabbix aģents. Kārtulai jāizmanto viena Zabbix aģenta pārbaude portā 10050. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "drule.create", "params": { "name": "Zabbix agent discovery", "iprange": "192.168.1.1-255", "concurrency_max": "10", "dchecks": [ { "type": "9", "key_": "system.uname", "ports": "10050", "uniq": "0" } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "druleids": [ "6" ] }, "id": 1 } ``` #### Create agent autoregistration rule Create an autoregistration action that adds a host to host group "2" when the host name contains "SRV" or metadata contains "AlmaLinux". [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "action.create", "params": { "name": "Register Linux servers", "eventsource": "2", "filter": { "evaltype": "2", "conditions": [ { "conditiontype": "22", "operator": "2", "value": "SRV" }, { "conditiontype": "24", "operator": "2", "value": "AlmaLinux" } ] }, "operations": [ { "operationtype": "4", "opgroup": [ { "groupid": "2" } ] } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "actionids": [ 19 ] }, "id": 1 } ``` #### Izveidot aģenta automātiskās reģistrācijas kārtulu Izveidojiet automātiskās reģistrācijas darbību, kas pievieno hostu hostu grupai "2", ja hosta nosaukums satur "SRV" vai metadati satur "AlmaLinux". [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "action.create", "params": { "name": "Register Linux servers", "eventsource": "2", "filter": { "evaltype": "2", "conditions": [ { "conditiontype": "22", "operator": "2", "value": "SRV" }, { "conditiontype": "24", "operator": "2", "value": "AlmaLinux" } ] }, "operations": [ { "operationtype": "4", "opgroup": [ { "groupid": "2" } ] } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "actionids": [ 19 ] }, "id": 1 } ``` #### Create agent autoregistration rule with host tags Create an autoregistration action that adds a host to host group "2" and adds two host tags. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "action.create", "params": { "name": "Register Linux servers with tags", "eventsource": "2", "operations": [ { "operationtype": "4", "opgroup": [ { "groupid": "2" } ] }, { "operationtype": "13", "optag": [ { "tag": "location", "value": "office" }, { "tag": "city", "value": "Riga" } ] } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "actionids": [ 20 ] }, "id": 1 } ``` #### Izveidojiet aģenta automātiskās reģistrācijas kārtulu ar hostu tagiem Izveidojiet automātiskās reģistrācijas darbību, kas pievieno hostu hostu grupai "2" un pievieno divus hostu tagus. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "action.create", "params": { "name": "Register Linux servers with tags", "eventsource": "2", "operations": [ { "operationtype": "4", "opgroup": [ { "groupid": "2" } ] }, { "operationtype": "13", "optag": [ { "tag": "location", "value": "office" }, { "tag": "city", "value": "Riga" } ] } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "actionids": [ 20 ] }, "id": 1 } ``` #### Create a host 1\. Go to *Data collection* → [*Hosts*](/manual/web_interface/frontend_sections/data_collection/hosts). 2\. [Create](/manual/config/hosts/host) a host: - In the *Host name* field, enter a host name (for example, "VMware VMs"). - In the *Host groups* field, type or select a host group (for example, "Virtual machines"). {width="600"} - In the *Macros* tab, set the following host macros: - {$VMWARE.URL} - VMware service (ESXi hypervisor) SDK URL (https://servername/sdk) - {$VMWARE.USERNAME} - VMware service user name - {$VMWARE.PASSWORD} - VMware service {$VMWARE.USERNAME} user password {width="600"} 3\. Click the *Add* button to create the host. This host will represent your VMware environment. #### Izveidojiet hostu 1\. Dodieties uz *Datu ievākšana* → [*Hosti*](/manual/web_interface/frontend_sections/data_collection/hosts). 2\. [Izveidojiet](/manual/config/hosts/host) hostu: - Laukā *Host name* ievadiet hosta nosaukumu (piemēram, "VMware VMs"). - Laukā *Host groups* ierakstiet vai atlasiet hostu grupu (piemēram, "Virtual machines"). {width="600"} - Cilnē *Macros* iestatiet šādus hosta makrosus: - {$VMWARE.URL} - VMware pakalpojuma (ESXi hipervizora) SDK URL (https://servername/sdk) - {$VMWARE.USERNAME} - VMware pakalpojuma lietotājvārds - {$VMWARE.PASSWORD} - VMware pakalpojuma lietotāja {$VMWARE.USERNAME} parole {width="600"} 3\. Noklikšķiniet uz pogas *Add*, lai izveidotu hostu. Šis hosts attēlos jūsu VMware vidi. #### Create a host map Create a map with two host elements and a link between them. Note the use of temporary "selementid1" and "selementid2" values in the map link object to refer to map elements. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "map.create", "params": { "name": "Host map", "width": 600, "height": 600, "selements": [ { "selementid": "1", "elements": [ {"hostid": "1033"} ], "elementtype": 0, "iconid_off": "2" }, { "selementid": "2", "elements": [ {"hostid": "1037"} ], "elementtype": 0, "iconid_off": "2" } ], "links": [ { "selementid1": "1", "selementid2": "2" } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "sysmapids": [ "9" ] }, "id": 1 } ``` #### Izveidot hostu karti Izveidojiet karti ar diviem hosta elementiem un saiti starp tiem. Ņemiet vērā pagaidu "selementid1" un "selementid2" vērtību izmantošanu kartes saites objektā, lai atsauktos uz kartes elementiem. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "map.create", "params": { "name": "Host map", "width": 600, "height": 600, "selements": [ { "selementid": "1", "elements": [ {"hostid": "1033"} ], "elementtype": 0, "iconid_off": "2" }, { "selementid": "2", "elements": [ {"hostid": "1037"} ], "elementtype": 0, "iconid_off": "2" } ], "links": [ { "selementid1": "1", "selementid2": "2" } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "sysmapids": [ "9" ] }, "id": 1 } ``` #### Create a host prototype 1\. In the list of low-level discovery rules, click *Host prototypes* for the previously created low-level discovery rule. 2\. [Create](/manual/discovery/low_level_discovery/host_prototypes#configuration) a host prototype. Since host prototypes are blueprints for creating hosts through low-level discovery rules, most fields will contain [low-level discovery macros](/manual/config/macros/lld_macros). This ensures that the hosts are created with properties based on the [content retrieved](/manual/vm_monitoring/discovery_fields) by the previously created low-level discovery rule. - In the *Host name* field, enter the macro {#VM.UUID}. - In the *Visible name* field, enter the macro {#VM.NAME}. - In the *Templates* field, enter or select the "VMware Guest" template. This template contains [VMware items](/manual/vm_monitoring/vmware_keys) and discovery rules for monitoring the power state of a virtual machine, CPU usage, memory usage, network devices, etc. - In the *Host groups* field, enter or select a host group (for example, "Discovered hosts"). - In the *Interfaces* field, add a custom [host interface](/manual/discovery/low_level_discovery/host_prototypes#host-interfaces). Then, enter the macro {#VM.DNS} in the *DNS name* field, or enter the macro {#VM.IP} in the *IP address* field. Alternatively, if your VMware environment virtual machines have multiple interfaces, proceed to the [*Advanced host interface configuration*](#advanced-host-interface-configuration) section. Configuring a custom host interface is necessary for the correct functioning of the *VMware Guest* template. {width="600"} - In the *Macros* tab, set the {$VMWARE.VM.UUID} macro with the value {#VM.UUID}. This is necessary for the correct functioning of the *VMware Guest* template that uses this macro as a host-level user macro in item parameters (for example, *vmware.vm.net.if.discovery\[{$VMWARE.URL}, {$VMWARE.VM.UUID}\]*). {width="600"} 3\. Click the *Add* button to create the host prototype. This host prototype will be used to create hosts for virtual machines discovered by the previously created low-level discovery rule. #### Izveidot hosta prototipu 1\. Zema līmeņa atklāšanas noteikumu sarakstā noklikšķiniet uz *Host prototypes* iepriekš izveidotajam zema līmeņa atklāšanas noteikumam. 2\. [Izveidojiet](/manual/discovery/low_level_discovery/host_prototypes#configuration) hosta prototipu. Tā kā hostu prototipi ir paraugi hostu izveidei, izmantojot zema līmeņa atklāšanas noteikumus, lielākajā daļā lauku būs [zema līmeņa atklāšanas makrosi](/manual/config/macros/lld_macros). Tas nodrošina, ka hosti tiek izveidoti ar īpašībām, kuru pamatā ir [iegūtais saturs](/manual/vm_monitoring/discovery_fields), ko atgrieza iepriekš izveidotais zema līmeņa atklāšanas noteikums. - Laukā *Host name* ievadiet makrosu {#VM.UUID}. - Laukā *Visible name* ievadiet makrosu {#VM.NAME}. - Laukā *Templates* ievadiet vai atlasiet veidni "VMware Guest". Šī veidne satur [VMware vienumus](/manual/vm_monitoring/vmware_keys) un atklāšanas noteikumus virtuālās mašīnas barošanas stāvokļa, CPU lietojuma, atmiņas lietojuma, tīkla ierīču u.c. uzraudzībai. - Laukā *Host groups* ievadiet vai atlasiet hostu grupu (piemēram, "Discovered hosts"). - Laukā *Interfaces* pievienojiet pielāgotu [hosta saskarni](/manual/discovery/low_level_discovery/host_prototypes#host-interfaces). Pēc tam laukā *DNS name* ievadiet makrosu {#VM.DNS} vai laukā *IP address* ievadiet makrosu {#VM.IP}. Alternatīvi, ja jūsu VMware vides virtuālajām mašīnām ir vairākas saskarnes, pārejiet uz sadaļu [*Paplašinātā hosta saskarnes konfigurācija*](#advanced-host-interface-configuration). Pielāgotas hosta saskarnes konfigurēšana ir nepieciešama veidnes *VMware Guest* pareizai darbībai. {width="600"} - Cilnē *Macros* iestatiet makrosu {$VMWARE.VM.UUID} ar vērtību {#VM.UUID}. Tas ir nepieciešams veidnes *VMware Guest* pareizai darbībai, jo tā izmanto šo makrosu kā hosta līmeņa lietotāja makrosu vienumu parametros (piemēram, *vmware.vm.net.if.discovery\[{$VMWARE.URL}, {$VMWARE.VM.UUID}\]*). {width="600"} 3\. Noklikšķiniet uz pogas *Add*, lai izveidotu hosta prototipu. Šis hosta prototips tiks izmantots, lai izveidotu hostus virtuālajām mašīnām, ko atklāja iepriekš izveidotais zema līmeņa atklāšanas noteikums. #### Create a low-level discovery rule 1\. Click *Discovery* for the created host to go to the list of low-level discovery rules for that host. 2\. [Create](/manual/discovery/low_level_discovery#configuring-lowlevel-discovery) a low-level discovery rule: - In the *Name* field, enter a low-level discovery rule name (for example, "Discover VMware VMs"). - In the *Type* field, select "[Simple check](/manual/config/items/itemtypes/simple_checks)". - In the *Key* field, enter the built-in item key for discovering VMware virtual machines: [`vmware.vm.discovery[{$VMWARE.URL}]`](/manual/vm_monitoring/vmware_keys#vmware.vm.discovery) - In the *User name* and *Password* fields, enter the corresponding macros previously configured on the host. {width="600"} 3\. Click the *Add* button to create the low-level discovery rule. This discovery rule will discover virtual machines in your VMware environment. #### Izveidojiet zema līmeņa atklāšanas kārtulu 1\. Noklikšķiniet uz *Discovery* izveidotajam hostam, lai pārietu uz šī hosta zema līmeņa atklāšanas kārtulu sarakstu. 2\. [Izveidojiet](/manual/discovery/low_level_discovery#configuring-lowlevel-discovery) zema līmeņa atklāšanas kārtulu: - Laukā *Name* ievadiet zema līmeņa atklāšanas kārtulas nosaukumu (piemēram, "Atklāt VMware VM"). - Laukā *Type* atlasiet "[Simple check](/manual/config/items/itemtypes/simple_checks)". - Laukā *Key* ievadiet iebūvēto vienuma atslēgu VMware virtuālo mašīnu atklāšanai: [`vmware.vm.discovery[{$VMWARE.URL}]`](/manual/vm_monitoring/vmware_keys#vmware.vm.discovery) - Laukos *User name* un *Password* ievadiet atbilstošos makrosus, kas iepriekš konfigurēti hostā. {width="600"} 3\. Noklikšķiniet uz pogas *Add*, lai izveidotu zema līmeņa atklāšanas kārtulu. Šī atklāšanas kārtula atklās virtuālās mašīnas jūsu VMware vidē. ##### Create a menu section 1. Create a *Module.php* file in the *MyAddress* directory. This file implements a new *Module* class that extends the default *CModule* class. The *Module* class will insert a new *My Address* menu section into the main menu. The *setAction()* method specifies an action to be executed upon clicking on the menu section. To start with, you can use the predefined action *userprofile.edit*, which will open the *User profile* page. In [part III](#part-iii---module-action) of this tutorial, you will learn how to create a custom action. **ui/modules/MyAddress/Module.php** ```php <?php namespace Modules\MyAddress; use Zabbix\Core\CModule, APP, CMenuItem; class Module extends CModule { public function init(): void { APP::Component()->get('menu.main') ->add((new CMenuItem(_('My Address'))) ->setAction('userprofile.edit')); } } ``` :::noteclassic You can replace `'userprofile.edit'` with other actions, for example, `'charts.view'` (opens custom graphs), `'problems.view'` (opens *Monitoring → Problems*), or `'report.status'` (opens *System information* report). ::: 3. Refresh Zabbix frontend. There is now a new *My Address* section at the bottom of the Zabbix main menu. Click on *My Address* to open the *User profile* page. {width="600"} ##### Izveidot izvēlnes sadaļu 1. Izveidojiet *Module.php* failu *MyAddress* direktorijā. Šis fails ievieš jaunu *Module* klasi, kas paplašina noklusējuma *CModule* klasi. *Module* klase ievietos jaunu *My Address* izvēlnes sadaļu galvenajā izvēlnē. Metode *setAction()* norāda darbību, kas jāizpilda, noklikšķinot uz izvēlnes sadaļas. Sākumā varat izmantot iepriekš definēto darbību *userprofile.edit*, kas atvērs *User profile* lapu. Šīs pamācības [III daļā](#part-iii---module-action) jūs uzzināsiet, kā izveidot pielāgotu darbību. **ui/modules/MyAddress/Module.php** ```php <?php namespace Modules\MyAddress; use Zabbix\Core\CModule, APP, CMenuItem; class Module extends CModule { public function init(): void { APP::Component()->get('menu.main') ->add((new CMenuItem(_('My Address'))) ->setAction('userprofile.edit')); } } ``` :::noteclassic Varat aizstāt `'userprofile.edit'` ar citām darbībām, piemēram, `'charts.view'` (atver pielāgotās diagrammas), `'problems.view'` (atver *Monitoring → Problems*), vai `'report.status'` (atver *System information* pārskatu). ::: 3. Atsvaidziniet Zabbix lietotāja saskarni. Tagad Zabbix galvenās izvēlnes apakšā ir jauna *My Address* sadaļa. Noklikšķiniet uz *My Address*, lai atvērtu *User profile* lapu. {width="600"} # Create a module (tutorial) # Create a module (tutorial) #### Create an active proxy Create an action proxy "Active proxy" and assign a host to be monitored by it. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "proxy.create", "params": { "name": "Active proxy", "operating_mode": "0", "hosts": [ { "hostid": "10279" } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "proxyids": [ "10280" ] }, "id": 1 } ``` #### Izveidot aktīvu starpniekserveri Izveidojiet aktīvu starpniekserveri "Active proxy" un piešķiriet tam hostu uzraudzībai. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "proxy.create", "params": { "name": "Active proxy", "operating_mode": "0", "hosts": [ { "hostid": "10279" } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "proxyids": [ "10280" ] }, "id": 1 } ``` #### Create an empty map Create a map with no elements. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "map.create", "params": { "name": "Map", "width": 600, "height": 600 }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "sysmapids": [ "8" ] }, "id": 1 } ``` #### Izveidot tukšu karti Izveidojiet karti bez elementiem. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "map.create", "params": { "name": "Map", "width": 600, "height": 600 }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "sysmapids": [ "8" ] }, "id": 1 } ``` #### Create a new event tag correlation Create a correlation using evaluation method `AND/OR` with one condition and one operation. By default the correlation will be enabled. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "correlation.create", "params": { "name": "new event tag correlation", "filter": { "evaltype": 0, "conditions": [ { "type": 1, "tag": "ok" } ] }, "operations": [ { "type": 0 } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "correlationids": [ "1" ] }, "id": 1 } ``` #### Izveidot jaunu notikumu birku korelāciju Izveidojiet korelāciju, izmantojot novērtēšanas metodi `AND/OR` ar vienu nosacījumu un vienu darbību. Pēc noklusējuma korelācija būs iespējota. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "correlation.create", "params": { "name": "new event tag correlation", "filter": { "evaltype": 0, "conditions": [ { "type": 1, "tag": "ok" } ] }, "operations": [ { "type": 0 } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "correlationids": [ "1" ] }, "id": 1 } ``` #### Create a new interface Create a secondary IP agent interface on host "30052." [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "hostinterface.create", "params": { "hostid": "30052", "main": "0", "type": "1", "useip": "1", "ip": "127.0.0.1", "dns": "", "port": "10050" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "interfaceids": [ "30062" ] }, "id": 1 } ``` #### Izveidot jaunu saskarni Izveidojiet sekundāru IP aģenta saskarni hostam "30052". [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "hostinterface.create", "params": { "hostid": "30052", "main": "0", "type": "1", "useip": "1", "ip": "127.0.0.1", "dns": "", "port": "10050" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "interfaceids": [ "30062" ] }, "id": 1 } ``` #### Create an icon image Create a cloud icon. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "image.create", "params": { "imagetype": 1, "name": "Cloud_(24)", "image": "iVBORw0KGgoAAAANSUhEUgAAABgAAAANCAYAAACzbK7QAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAACmAAAApgBNtNH3wAAABl0RVh0U29mdHdhcmUAd3d3Lmlua3NjYXBlLm9yZ5vuPBoAAAIcSURBVDjLrZLbSxRRHMdPKiEiRQ89CD0s+N5j9BIMEf4Hg/jWexD2ZEXQbC9tWUFZimtLhswuZiVujK1UJmYXW9PaCUdtb83enL3P7s6ss5f5dc7EUsmqkPuFH3M4/Ob7+V0OAgC0UyDENFEU03rh1uNOs/lFG75o2i2/rkd9Y3Tgyj3HiaezbukdH9A/rP4E9vWi0u+Y4fuGnMf3DRgYc3Z/84YrQSkD3mgKhFAC+KAEK74Y2Lj3MjPoOokQ3Xyx/1GHeXCifbfO6lRPH/wi+AvZQhGSsgKxdB5CCRkCGPbDgMXBMbukTc4vK5/WRHizsq7fZl2LFuvE4T0BZDTXHtgv4TNUqlUolsqQL2qQwbDEXzBBTIJ7I4y/cfAENmHZF4XrY9Mc+X9HAFmoyXS2ddy1IOg6/KNyBcM0DFP/wFZFCcOy4N9Mw0YkCTOfhdL5AfZQXQBFn2t/ODXHC8FYVcoWjNEQ03qqwTJ5FdI44jg/msoB2Zd5ZKq3q6evA1FUS60bYyyj3AJf3V72HiLZJQxTtRLk1C2IYEg4mTNg63hPd1mOJd7Ict911OMNlWEf0nFxpCt16zcshTuLpGSwDDuPIfv0xzNyQYVGicC0cgUUDLM6Xp02lvvW/V2EBssnxlSGmWsxljw0znV9XfPLjTCW84r+cn7Jc8c2eWrbM6Wbe6/aTJbhJ/TNkWc9/xXW592Xb9iPkKnUfH8BKdLgFy0lDyQAAAAASUVORK5CYII=" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "imageids": [ "188" ] }, "id": 1 } ``` #### Izveidojiet ikonas attēlu Izveidojiet mākoņa ikonu. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "image.create", "params": { "imagetype": 1, "name": "Cloud_(24)", "image": "iVBORw0KGgoAAAANSUhEUgAAABgAAAANCAYAAACzbK7QAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAACmAAAApgBNtNH3wAAABl0RVh0U29mdHdhcmUAd3d3Lmlua3NjYXBlLm9yZ5vuPBoAAAIcSURBVDjLrZLbSxRRHMdPKiEiRQ89CD0s+N5j9BIMEf4Hg/jWexD2ZEXQbC9tWUFZimtLhswuZiVujK1UJmYXW9PaCUdtb83enL3P7s6ss5f5dc7EUsmqkPuFH3M4/Ob7+V0OAgC0UyDENFEU03rh1uNOs/lFG75o2i2/rkd9Y3Tgyj3HiaezbukdH9A/rP4E9vWi0u+Y4fuGnMf3DRgYc3Z/84YrQSkD3mgKhFAC+KAEK74Y2Lj3MjPoOokQ3Xyx/1GHeXCifbfO6lRPH/wi+AvZQhGSsgKxdB5CCRkCGPbDgMXBMbukTc4vK5/WRHizsq7fZl2LFuvE4T0BZDTXHtgv4TNUqlUolsqQL2qQwbDEXzBBTIJ7I4y/cfAENmHZF4XrY9Mc+X9HAFmoyXS2ddy1IOg6/KNyBcM0DFP/wFZFCcOy4N9Mw0YkCTOfhdL5AfZQXQBFn2t/ODXHC8FYVcoWjNEQ03qqwTJ5FdI44jg/msoB2Zd5ZKq3q6evA1FUS60bYyyj3AJf3V72HiLZJQxTtRLk1C2IYEg4mTNg63hPd1mOJd7Ict911OMNlWEf0nFxpCt16zcshTuLpGSwDDuPIfv0xzNyQYVGicC0cgUUDLM6Xp02lvvW/V2EBssnxlSGmWsxljw0znV9XfPLjTCW84r+cn7Jc8c2eWrbM6Wbe6/aTJbhJ/TNkWc9/xXW592Xb9iPkKnUfH8BKdLgFy0lDyQAAAAASUVORK5CYII=" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "imageids": [ "188" ] }, "id": 1 } ``` #### Create an icon map Create an icon map to display hosts of different types. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "iconmap.create", "params": { "name": "Type icons", "default_iconid": "2", "mappings": [ { "inventory_link": 1, "expression": "server", "iconid": "3" }, { "inventory_link": 1, "expression": "switch", "iconid": "4" } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "iconmapids": [ "2" ] }, "id": 1 } ``` #### Izveidot ikonu karti Izveidojiet ikonu karti, lai attēlotu dažādu tipu hostus. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "iconmap.create", "params": { "name": "Type icons", "default_iconid": "2", "mappings": [ { "inventory_link": 1, "expression": "server", "iconid": "3" }, { "inventory_link": 1, "expression": "switch", "iconid": "4" } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "iconmapids": [ "2" ] }, "id": 1 } ``` #### Create an interface with SNMP details [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "hostinterface.create", "params": { "hostid": "10456", "main": "0", "type": "2", "useip": "1", "ip": "127.0.0.1", "dns": "", "port": "1601", "details": { "version": "2", "bulk": "1", "community": "{$SNMP_COMMUNITY}" } }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "interfaceids": [ "30063" ] }, "id": 1 } ``` #### Izveidojiet saskarni ar SNMP informāciju [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "hostinterface.create", "params": { "hostid": "10456", "main": "0", "type": "2", "useip": "1", "ip": "127.0.0.1", "dns": "", "port": "1601", "details": { "version": "2", "bulk": "1", "community": "{$SNMP_COMMUNITY}" } }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "interfaceids": [ "30063" ] }, "id": 1 } ``` Create another child service of Zabbix cluster with name "Zabbix server node 2". Set the Problem tags as: - Name: component - Operation: Equals - Value: ha-node-2 Switch to the *Tags* tab and add a service tag: `zabbix-server:node-2`. Save the new service. Izveidojiet vēl vienu Zabbix klastera bērnservisu ar nosaukumu "Zabbix server node 2". Iestatiet problēmas birkas šādi: - Nosaukums: component - Darbība: Vienāds - Vērtība: ha-node-2 Pārslēdzieties uz cilni *Birkas* un pievienojiet servisa birku: `zabbix-server:node-2`. Saglabājiet jauno servisu. #### Create an SSH script Create an SSH script with public key authentication that can be executed on a host and has a context menu. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "script.create", "params": { "name": "SSH script", "command": "my script command", "type": 2, "authtype": 1, "username": "John", "publickey": "pub.key", "privatekey": "priv.key", "password": "secret", "port": "12345", "scope": 2, "menu_path": "All scripts/SSH", "usrgrpid": "7", "groupid": "4" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "scriptids": [ "5" ] }, "id": 1 } ``` #### Izveidot SSH skriptu Izveidojiet SSH skriptu ar publiskās atslēgas autentifikāciju, ko var izpildīt uz hosta un kam ir konteksta izvēlne. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "script.create", "params": { "name": "SSH script", "command": "my script command", "type": 2, "authtype": 1, "username": "John", "publickey": "pub.key", "privatekey": "priv.key", "password": "secret", "port": "12345", "scope": 2, "menu_path": "All scripts/SSH", "usrgrpid": "7", "groupid": "4" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "scriptids": [ "5" ] }, "id": 1 } ``` #### Create a passive proxy Create a passive proxy "Passive proxy" and assign two hosts to be monitored by it. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "proxy.create", "params": { "name": "Passive proxy", "operating_mode": "1", "address": "127.0.0.1", "port": "10051", "hosts": [ { "hostid": "10192" }, { "hostid": "10139" } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "proxyids": [ "10284" ] }, "id": 1 } ``` #### Izveidot pasīvu starpniekserveri Izveidojiet pasīvu starpniekserveri "Passive proxy" un piešķiriet tam divus hostus uzraudzībai. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "proxy.create", "params": { "name": "Passive proxy", "operating_mode": "1", "address": "127.0.0.1", "port": "10051", "hosts": [ { "hostid": "10192" }, { "hostid": "10139" } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "proxyids": [ "10284" ] }, "id": 1 } ``` # Create a plugin (tutorial) This is a step-by-step tutorial on how to create a simple loadable plugin for Zabbix agent 2. You can also use the [example repository](https://git.zabbix.com/projects/AP/repos/example/browse) as a template or guide for creating your own plugins. # Izveidot spraudni (pamācība) Šī ir soli pa solim pamācība par to, kā izveidot vienkāršu ielādējamu spraudni Zabbix aģentam 2. Varat arī izmantot [piemēra repozitoriju](https://git.zabbix.com/projects/AP/repos/example/browse) kā veidni vai ceļvedi savu spraudņu izveidei. #### Create a proxy group Create a proxy group with custom settings. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "proxygroup.create", "params": { "name": "Proxy group", "failover_delay": "5m", "min_online": "10" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "proxy_groupids": [ "5" ] }, "id": 1 } ``` #### Izveidot starpniekserveru grupu Izveidojiet starpniekserveru grupu ar pielāgotiem iestatījumiem. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "proxygroup.create", "params": { "name": "Proxy group", "failover_delay": "5m", "min_online": "10" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "proxy_groupids": [ "5" ] }, "id": 1 } ``` #### Create a token Create an enabled token that never expires and authenticates user of ID 2. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "token.create", "params": { "name": "Your token", "userid": "2" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "tokenids": [ "188" ] }, "id": 1 } ``` Create a disabled token that expires at January 21st, 2021. This token will authenticate current user. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "token.create", "params": { "name": "Your token", "status": "1", "expires_at": "1611238072" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "tokenids": [ "189" ] }, "id": 1 } ``` #### Izveidot tokenu Izveidojiet iespējotu tokenu, kam nekad nebeidzas derīguma termiņš un kas autentificē lietotāju ar ID 2. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "token.create", "params": { "name": "Your token", "userid": "2" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "tokenids": [ "188" ] }, "id": 1 } ``` Izveidojiet atspējotu tokenu, kura derīguma termiņš beidzas 2021. gada 21. janvārī. Šis tokens autentificēs pašreizējo lietotāju. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "token.create", "params": { "name": "Your token", "status": "1", "expires_at": "1611238072" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "tokenids": [ "189" ] }, "id": 1 } ``` #### Create a trigger action Create a trigger action that will begin once a trigger (with the word "memory" in its name) from host "10084" goes into a PROBLEM state. The action will have 4 configured operations. The first and immediate operation will send a message to all users in user group "7" via media type "1". If the event is not resolved in 30 minutes, the second operation will run [script](/manual/web_interface/frontend_sections/alerts/scripts#configuring-a-global-script) "5" (script with scope "Action operation") on all hosts in group "2". If the event is resolved, a recovery operation will notify all users who received any messages regarding the problem. If the event is updated, an acknowledge/update operation will notify (with a custom subject and message) all users who received any messages regarding the problem. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "action.create", "params": { "name": "Trigger action", "eventsource": 0, "esc_period": "30m", "filter": { "evaltype": 0, "conditions": [ { "conditiontype": 1, "operator": 0, "value": "10084" }, { "conditiontype": 3, "operator": 2, "value": "memory" } ] }, "operations": [ { "operationtype": 0, "esc_step_from": 1, "esc_step_to": 1, "opmessage_grp": [ { "usrgrpid": "7" } ], "opmessage": { "default_msg": 1, "mediatypeid": "1" } }, { "operationtype": 1, "esc_step_from": 2, "esc_step_to": 2, "opconditions": [ { "conditiontype": 14, "operator": 0, "value": "0" } ], "opcommand_grp": [ { "groupid": "2" } ], "opcommand": { "scriptid": "5" } } ], "recovery_operations": [ { "operationtype": "11", "opmessage": { "default_msg": 1 } } ], "update_operations": [ { "operationtype": "12", "opmessage": { "default_msg": 0, "message": "Custom update operation message body", "subject": "Custom update operation message subject" } } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "17" ] }, "id": 1 } ``` #### Izveidot trigera darbību Izveidojiet trigera darbību, kas sāksies, tiklīdz trigeris (ar vārdu "memory" tā nosaukumā) no hosta "10084" pāries PROBLEM stāvoklī. Darbībai būs konfigurētas 4 operācijas. Pirmā un tūlītējā operācija nosūtīs ziņojumu visiem lietotājiem lietotāju grupā "7", izmantojot medija tipu "1". Ja notikums netiek atrisināts 30 minūšu laikā, tiks izpildīta otrā operācija — [skripts](/manual/web_interface/frontend_sections/alerts/scripts#configuring-a-global-script) "5" (skripts ar tvērumu "Action operation") — visos hostos grupā "2". Ja notikums tiek atrisināts, atkopšanas operācija paziņos visiem lietotājiem, kuri saņēma jebkādus ziņojumus par problēmu. Ja notikums tiek atjaunināts, apstiprināšanas/atjaunināšanas operācija paziņos (ar pielāgotu tēmu un ziņojumu) visiem lietotājiem, kuri saņēma jebkādus ziņojumus par problēmu. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "action.create", "params": { "name": "Trigger action", "eventsource": 0, "esc_period": "30m", "filter": { "evaltype": 0, "conditions": [ { "conditiontype": 1, "operator": 0, "value": "10084" }, { "conditiontype": 3, "operator": 2, "value": "memory" } ] }, "operations": [ { "operationtype": 0, "esc_step_from": 1, "esc_step_to": 1, "opmessage_grp": [ { "usrgrpid": "7" } ], "opmessage": { "default_msg": 1, "mediatypeid": "1" } }, { "operationtype": 1, "esc_step_from": 2, "esc_step_to": 2, "opconditions": [ { "conditiontype": 14, "operator": 0, "value": "0" } ], "opcommand_grp": [ { "groupid": "2" } ], "opcommand": { "scriptid": "5" } } ], "recovery_operations": [ { "operationtype": "11", "opmessage": { "default_msg": 1 } } ], "update_operations": [ { "operationtype": "12", "opmessage": { "default_msg": 0, "message": "Custom update operation message body", "subject": "Custom update operation message subject" } } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "17" ] }, "id": 1 } ``` #### Create a trigger map Create a map with trigger element, which contains two triggers. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "map.create", "params": { "name": "Trigger map", "width": 600, "height": 600, "selements": [ { "elements": [ {"triggerid": "12345"}, {"triggerid": "67890"} ], "elementtype": 2, "iconid_off": "2" } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "sysmapids": [ "10" ] }, "id": 1 } ``` #### Izveidot trigeru karti Izveidojiet karti ar trigeru elementu, kurā ir divi trigeri. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "map.create", "params": { "name": "Trigger map", "width": 600, "height": 600, "selements": [ { "elements": [ {"triggerid": "12345"}, {"triggerid": "67890"} ], "elementtype": 2, "iconid_off": "2" } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "sysmapids": [ "10" ] }, "id": 1 } ``` #### Create a URL type script Create a URL type script for host scope that remains in the same window and has confirmation text. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "script.create", "params": { "name": "URL script", "type": 6, "scope": 2, "url": "http://zabbix/ui/zabbix.php?action=host.edit&hostid={HOST.ID}", "confirmation": "Edit host {HOST.NAME}?", "new_window": 0 }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "scriptids": [ "56" ] }, "id": 1 } ``` #### Izveidot URL tipa skriptu Izveidojiet URL tipa skriptu hosta tvērumam, kas paliek tajā pašā logā un kam ir apstiprinājuma teksts. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "script.create", "params": { "name": "URL script", "type": 6, "scope": 2, "url": "http://zabbix/ui/zabbix.php?action=host.edit&hostid={HOST.ID}", "confirmation": "Rediģēt hostu {HOST.NAME}?", "new_window": 0 }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "scriptids": [ "56" ] }, "id": 1 } ``` #### Create a URL type script with manual input Create a URL type script for event scope that opens in a new window and has manual input. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "script.create", "params": { "name": "URL script with manual input", "type": 6, "scope": 4, "url": "http://zabbix/ui/zabbix.php?action={MANUALINPUT}", "new_window": 1, "manualinput": 1, "manualinput_prompt": "Select a page to open:", "manualinput_validator": "dashboard.view,script.list,actionlog.list", "manualinput_validator_type": 1 }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "scriptids": [ "57" ] }, "id": 1 } ``` #### Izveidojiet URL tipa skriptu ar manuālu ievadi Izveidojiet URL tipa skriptu notikuma tvērumam, kas tiek atvērts jaunā logā un kam ir manuāla ievade. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "script.create", "params": { "name": "URL script with manual input", "type": 6, "scope": 4, "url": "http://zabbix/ui/zabbix.php?action={MANUALINPUT}", "new_window": 1, "manualinput": 1, "manualinput_prompt": "Select a page to open:", "manualinput_validator": "dashboard.view,script.list,actionlog.list", "manualinput_validator_type": 1 }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "scriptids": [ "57" ] }, "id": 1 } ``` #### Create a webhook script Create a webhook script that sends HTTP request to external service. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "script.create", "params": { "name": "Webhook script", "command": "try {\n var request = new HttpRequest(),\n response,\n data;\n\n request.addHeader('Content-Type: application/json');\n\n response = request.post('https://localhost/post', value);\n\n try {\n response = JSON.parse(response);\n }\n catch (error) {\n response = null;\n }\n\n if (request.getStatus() !== 200 || !('data' in response)) {\n throw 'Unexpected response.';\n }\n\n data = JSON.stringify(response.data);\n\n Zabbix.log(3, '[Webhook Script] response data: ' + data);\n\n return data;\n}\ncatch (error) {\n Zabbix.log(3, '[Webhook Script] script execution failed: ' + error);\n throw 'Execution failed: ' + error + '.';\n}", "scope": 1, "type": 5, "timeout": "40s", "parameters": [ { "name": "token", "value": "{$WEBHOOK.TOKEN}" }, { "name": "host", "value": "{HOST.HOST}" }, { "name": "v", "value": "2.2" } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "scriptids": [ "3" ] }, "id": 1 } ``` #### Izveidot webhook skriptu Izveidojiet webhook skriptu, kas nosūta HTTP pieprasījumu uz ārēju servisu. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "script.create", "params": { "name": "Webhook script", "command": "try {\n var request = new HttpRequest(),\n response,\n data;\n\n request.addHeader('Content-Type: application/json');\n\n response = request.post('https://localhost/post', value);\n\n try {\n response = JSON.parse(response);\n }\n catch (error) {\n response = null;\n }\n\n if (request.getStatus() !== 200 || !('data' in response)) {\n throw 'Unexpected response.';\n }\n\n data = JSON.stringify(response.data);\n\n Zabbix.log(3, '[Webhook Script] response data: ' + data);\n\n return data;\n}\ncatch (error) {\n Zabbix.log(3, '[Webhook Script] script execution failed: ' + error);\n throw 'Execution failed: ' + error + '.';\n}", "scope": 1, "type": 5, "timeout": "40s", "parameters": [ { "name": "token", "value": "{$WEBHOOK.TOKEN}" }, { "name": "host", "value": "{HOST.HOST}" }, { "name": "v", "value": "2.2" } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "scriptids": [ "3" ] }, "id": 1 } ``` # Create a widget (tutorial) # Create a widget (tutorial) #### Create host in Zabbix Now that you have the hostname from Zabbix agent and you're connected to Zabbix API, you can create a new host in Zabbix. 1\. Call the [`host.create()`](/manual/api/reference/host/create) API method on the `ZabbixAPI` instance and provide the host details: - `host` - set to the `hostname` variable containing the hostname you retrieved from Zabbix agent. - `interfaces` - contains connection details for Zabbix agent that's running on the host. - `groups` - contains at least one host group the host should belong to. 2\. Since Zabbix API returns the ID of the newly created host, save this ID in the `host_id` variable for later use. 3\. Print a message to confirm the host was created. ```python api.host.create( host=hostname, interfaces=[{ 'type': 1, 'main': 1, 'useip': 1, 'ip': '127.0.0.1', 'dns': '', 'port': '10050', }], groups=[{'groupid': '2'}] ) host_id = host['hostids'][0] print(f"Host '{hostname}' created with ID {host_id}") ``` #### Izveidojiet hostu Zabbix Tagad, kad esat ieguvis hosta nosaukumu no Zabbix aģenta un esat izveidojis savienojumu ar Zabbix API, varat izveidot jaunu hostu Zabbix. 1\. Izsauciet API metodi [`host.create()`](/manual/api/reference/host/create) `ZabbixAPI` instancē un norādiet hosta informāciju: - `host` — iestatiet uz mainīgo `hostname`, kas satur hosta nosaukumu, kuru ieguvāt no Zabbix aģenta. - `interfaces` — satur savienojuma informāciju par Zabbix aģentu, kas darbojas hostā. - `groups` — satur vismaz vienu hostu grupu, kurai hostam jāpieder. 2\. Tā kā Zabbix API atgriež jaunizveidotā hosta ID, saglabājiet šo ID mainīgajā `host_id`, lai to izmantotu vēlāk. 3\. Izdrukājiet ziņojumu, lai apstiprinātu, ka hosts tika izveidots. ```python api.host.create( host=hostname, interfaces=[{ 'type': 1, 'main': 1, 'useip': 1, 'ip': '127.0.0.1', 'dns': '', 'port': '10050', }], groups=[{'groupid': '2'}] ) host_id = host['hostids'][0] print(f"Host '{hostname}' created with ID {host_id}") ``` #### Create HTTP agent item Create POST request method item with JSON response preprocessing. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "item.create", "params": { "url":"http://127.0.0.1/http.php", "query_fields": [ { "name": "mode", "value": "json" }, { "name": "min", "value": "10" }, { "name": "max", "value": "100" } ], "interfaceid": "1", "type": 19, "hostid": "10254", "delay": "5s", "key_": "json", "name": "HTTP agent example JSON", "value_type": 0, "output_format": 1, "preprocessing": [ { "type": 12, "params": "$.random", "error_handler": 0, "error_handler_params": "" } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "23865" ] }, "id": 1 } ``` #### Izveidot HTTP aģenta vienumu Izveidojiet POST pieprasījuma metodes vienumu ar JSON atbildes priekšapstrādi. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "item.create", "params": { "url":"http://127.0.0.1/http.php", "query_fields": [ { "name": "mode", "value": "json" }, { "name": "min", "value": "10" }, { "name": "max", "value": "100" } ], "interfaceid": "1", "type": 19, "hostid": "10254", "delay": "5s", "key_": "json", "name": "HTTP agent example JSON", "value_type": 0, "output_format": 1, "preprocessing": [ { "type": 12, "params": "$.random", "error_handler": 0, "error_handler_params": "" } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "23865" ] }, "id": 1 } ``` #### Create HTTP agent item prototype Create item prototype with URL using user macro, query fields and custom headers. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "itemprototype.create", "params": { "type": "19", "hostid": "10254", "ruleid": "28256", "interfaceid": "2", "name": "api item prototype example", "key_": "api_http_item", "value_type": 3, "url": "{$URL_PROTOTYPE}", "query_fields": [ { "name": "min", "value": "10" }, { "name": "max", "value" "100" } ], "headers": [ { "name": "X-Source", "value": "api" } ], "delay": "35" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "28305" ] }, "id": 1 } ``` #### Izveidot HTTP aģenta vienuma prototipu Izveidojiet vienuma prototipu ar URL, izmantojot lietotāja makrosu, vaicājuma laukus un pielāgotas galvenes. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "itemprototype.create", "params": { "type": "19", "hostid": "10254", "ruleid": "28256", "interfaceid": "2", "name": "api item prototype example", "key_": "api_http_item", "value_type": 3, "url": "{$URL_PROTOTYPE}", "query_fields": [ { "name": "min", "value": "10" }, { "name": "max", "value" "100" } ], "headers": [ { "name": "X-Source", "value": "api" } ], "delay": "35" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "28305" ] }, "id": 1 } ``` ### Create items Follow the instructions on [creating an item](/manual/config/items/item) to add the items for traffic monitoring, namely: - [Incoming traffic](/manual/config/items/itemtypes/zabbix_agent#net.if.in) - [Outgoing traffic](/manual/config/items/itemtypes/zabbix_agent#net.if.out) - [Total traffic](/manual/config/items/itemtypes/zabbix_agent#net.if.total) A simple setup for the incoming traffic monitoring item with an active check would look as follows: {width="600"} To make the collected data suitable for practical use, you can set some [preprocessing](/manual/config/items/preprocessing) steps when creating the items. In the given case, those can be multiplication by 8 (to convert bytes to bits) and presentation as change per second. {width="600"} ### Izveidojiet vienumus Izpildiet norādījumus sadaļā [vienuma izveide](/manual/config/items/item), lai pievienotu vienumus datplūsmas uzraudzībai, proti: - [Ienākošā datplūsma](/manual/config/items/itemtypes/zabbix_agent#net.if.in) - [Izejošā datplūsma](/manual/config/items/itemtypes/zabbix_agent#net.if.out) - [Kopējā datplūsma](/manual/config/items/itemtypes/zabbix_agent#net.if.total) Vienkārša ienākošās datplūsmas uzraudzības vienuma konfigurācija ar aktīvo pārbaudi izskatītos šādi: {width="600"} Lai savāktie dati būtu piemēroti praktiskai izmantošanai, veidojot vienumus, varat iestatīt dažus [priekšapstrādes](/manual/config/items/preprocessing) soļus. Šajā gadījumā tie var būt reizināšana ar 8 (lai pārvērstu baitus bitos) un attēlošana kā izmaiņas sekundē. {width="600"} #### Create LLD rule with a specified time period for disabling and no deletion Create an LLD rule with custom time period for disabling entity after it is no longer discovered, with the setting that it will never be deleted. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "discoveryrule.create", "params": { "name": "lld disable after 1h", "key_": "lld.disable", "hostid": "10001", "type": 2, "lifetime_type": 1, "enabled_lifetime_type": 0, "enabled_lifetime": "1h" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "46864" ] }, "id": 1 } ``` #### Izveidot LLD kārtulu ar norādītu atspējošanas laika periodu un bez dzēšanas Izveidojiet LLD kārtulu ar pielāgotu laika periodu entītijas atspējošanai pēc tam, kad tā vairs netiek atklāta, ar iestatījumu, ka tā nekad netiks dzēsta. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "discoveryrule.create", "params": { "name": "lld disable after 1h", "key_": "lld.disable", "hostid": "10001", "type": 2, "lifetime_type": 1, "enabled_lifetime_type": 0, "enabled_lifetime": "1h" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "46864" ] }, "id": 1 } ``` #### Create new item in Zabbix After creating a host, you can add an item to it. 1\. Define a unique key for the item to be created. 2\. Call the [`item.create()`](/manual/api/reference/item/create) method on the `ZabbixAPI` instance and provide the item details: - `hostid` - set to the `host_id` variable containing the ID of the host you just created. - `name` - a name for the item. - `key_` - set to the `item_key` variable you just defined. - `type` - set to `2` ([trapper item](/manual/config/items/itemtypes/trapper)), required to receive values sent from your script in the following steps. - `value_type` - set to `3` (numeric unsigned), the type of data this item stores. 3\. Since Zabbix API returns the ID of the newly created item, save this ID in the `item_id` variable for later use. 4\. Print a message to confirm the item was created. ```python item_key = 'app.myservice.heartbeat' item = api.item.create( hostid=host_id, name='App heartbeat', key_=item_key, type=2, value_type=3, ) item_id = item['itemids'][0] print(f"Item '{item_key}' created with ID {item_id}") ``` #### Izveidojiet jaunu vienumu Zabbix Pēc hosta izveides varat tam pievienot vienumu. 1\. Definējiet unikālu atslēgu izveidojamajam vienumam. 2\. Izsauciet [`item.create()`](/manual/api/reference/item/create) metodi `ZabbixAPI` instancē un norādiet vienuma informāciju: - `hostid` - iestatiet uz `host_id` mainīgo, kas satur tikko izveidotā hosta ID. - `name` - vienuma nosaukums. - `key_` - iestatiet uz `item_key` mainīgo, kuru tikko definējāt. - `type` - iestatiet uz `2` ([trapper vienums](/manual/config/items/itemtypes/trapper)); tas ir nepieciešams, lai saņemtu vērtības, ko jūsu skripts nosūtīs nākamajās darbībās. - `value_type` - iestatiet uz `3` (bezparaksta skaitlisks), tas ir datu tips, ko šis vienums glabā. 3\. Tā kā Zabbix API atgriež jaunizveidotā vienuma ID, saglabājiet šo ID mainīgajā `item_id`, lai to izmantotu vēlāk. 4\. Izdrukājiet ziņojumu, lai apstiprinātu, ka vienums tika izveidots. ```python item_key = 'app.myservice.heartbeat' item = api.item.create( hostid=host_id, name='App heartbeat', key_=item_key, type=2, value_type=3, ) item_id = item['itemids'][0] print(f"Item '{item_key}' created with ID {item_id}") ``` #### Create script item Create a simple data collection using a script item. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "item.create", "params": { "name": "Script example", "key_": "custom.script.item", "hostid": "12345", "type": 21, "value_type": 4, "params": "var request = new HttpRequest();\nreturn request.post(\"https://postman-echo.com/post\", JSON.parse(value));", "parameters": [ { "name": "host", "value": "{HOST.CONN}" } ], "timeout": "6s", "delay": "30s" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "23865" ] }, "id": 1 } ``` #### Izveidot skripta vienumu Izveidojiet vienkāršu datu vākšanu, izmantojot skripta vienumu. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "item.create", "params": { "name": "Skripta piemērs", "key_": "custom.script.item", "hostid": "12345", "type": 21, "value_type": 4, "params": "var request = new HttpRequest();\nreturn request.post(\"https://postman-echo.com/post\", JSON.parse(value));", "parameters": [ { "name": "host", "value": "{HOST.CONN}" } ], "timeout": "6s", "delay": "30s" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "23865" ] }, "id": 1 } ``` #### Create script item prototype Create a simple data collection using a script item prototype. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "itemprototype.create", "params": { "name": "Script example", "key_": "custom.script.itemprototype", "hostid": "12345", "type": 21, "value_type": 4, "params": "var request = new HttpRequest();\nreturn request.post(\"https://postman-echo.com/post\", JSON.parse(value));", "parameters": [ { "name": "host", "value": "{HOST.CONN}" } ], "timeout": "6s", "delay": "30s" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "23865" ] }, "id": 1 } ``` #### Izveidot skripta vienuma prototipu Izveidojiet vienkāršu datu vākšanu, izmantojot skripta vienuma prototipu. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "itemprototype.create", "params": { "name": "Script example", "key_": "custom.script.itemprototype", "hostid": "12345", "type": 21, "value_type": 4, "params": "var request = new HttpRequest();\nreturn request.post(\"https://postman-echo.com/post\", JSON.parse(value));", "parameters": [ { "name": "host", "value": "{HOST.CONN}" } ], "timeout": "6s", "delay": "30s" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "23865" ] }, "id": 1 } ``` #### Create script LLD rule Create a simple data collection using a script LLD rule. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "discoveryrule.create", "params": { "name": "Script example", "key_": "custom.script.lldrule", "hostid": "12345", "type": 21, "params": "var request = new HttpRequest();\nreturn request.post(\"https://postman-echo.com/post\", JSON.parse(value));", "parameters": [{ "name": "host", "value": "{HOST.CONN}" }], "timeout": "6s", "delay": "30s" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "23865" ] }, "id": 1 } ``` #### Izveidot skripta LLD kārtulu Izveidojiet vienkāršu datu vākšanu, izmantojot skripta LLD kārtulu. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "discoveryrule.create", "params": { "name": "Script example", "key_": "custom.script.lldrule", "hostid": "12345", "type": 21, "params": "var request = new HttpRequest();\nreturn request.post(\"https://postman-echo.com/post\", JSON.parse(value));", "parameters": [{ "name": "host", "value": "{HOST.CONN}" }], "timeout": "6s", "delay": "30s" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "23865" ] }, "id": 1 } ``` #### Creating a connector Create a connector to export trigger events with a tag filter. HTTP authentication will be performed using Bearer token. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "connector.create", "params": [ { "name": "Export of events", "data_type": 1, "url": "{$DATA_EXPORT_URL}", "authtype": 5, "token": "{$DATA_EXPORT_BEARER_TOKEN}", "tags": [ { "tag": "service", "operator": 0, "value": "mysqld" } ] } ], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "connectorid": [ "3" ] }, "id": 1 } ``` #### Savienotāja izveide Izveidojiet savienotāju, lai eksportētu trigeru notikumus ar birku filtru. HTTP autentifikācija tiks veikta, izmantojot Bearer token. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "connector.create", "params": [ { "name": "Export of events", "data_type": 1, "url": "{$DATA_EXPORT_URL}", "authtype": 5, "token": "{$DATA_EXPORT_BEARER_TOKEN}", "tags": [ { "tag": "service", "operator": 0, "value": "mysqld" } ] } ], "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "connectorid": [ "3" ] }, "id": 1 } ``` #### Creating a dashboard Create a dashboard named "My dashboard" with one Problems widget with tags and using two types of sharing (user group and user) on a single dashboard page. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "problems", "x": 0, "y": 0, "width": 36, "height": 5, "view_mode": 0, "fields": [ { "type": 1, "name": "tags.0.tag", "value": "service" }, { "type": 0, "name": "tags.0.operator", "value": 1 }, { "type": 1, "name": "tags.0.value", "value": "zabbix_server" } ] } ] } ], "userGroups": [ { "usrgrpid": "7", "permission": 2 } ], "users": [ { "userid": "4", "permission": 3 } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "2" ] }, "id": 1 } ``` #### Informācijas paneļa izveide Izveidojiet informācijas paneli ar nosaukumu "My dashboard" ar vienu Problēmu logrīku ar tagiem un izmantojot divus koplietošanas veidus (lietotāju grupa un lietotājs) vienā informācijas paneļa lapā. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "problems", "x": 0, "y": 0, "width": 36, "height": 5, "view_mode": 0, "fields": [ { "type": 1, "name": "tags.0.tag", "value": "service" }, { "type": 0, "name": "tags.0.operator", "value": 1 }, { "type": 1, "name": "tags.0.value", "value": "zabbix_server" } ] } ] } ], "userGroups": [ { "usrgrpid": "7", "permission": 2 } ], "users": [ { "userid": "4", "permission": 3 } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "2" ] }, "id": 1 } ``` #### Creating a dashboard It is possible to create a new dashboard in two ways: - Click on *Create dashboard*, when viewing all dashboards - Select *Create new* from the action menu, when viewing a single dashboard You will be first asked to enter general dashboard parameters:  |Parameter|Description| |--|--------| |*Owner*|Select system user that will be the dashboard owner.| |*Name*|Enter dashboard name.| |*Default page display period*|Select period for how long a dashboard page is displayed before rotating to the next page in a [slideshow](#creating-a-slideshow).| |*Start slideshow automatically*|Mark this checkbox to run a slideshow automatically one more than one dashboard page exists.| When you click on *Apply*, an empty dashboard is opened: {width="600"} To populate the dashboard, you can add widgets and pages. Click on the *Save changes* button to save the dashboard. If you click on *Cancel*, the dashboard will not be created. #### Paneļa izveide Jaunu paneli var izveidot divos veidos: - Noklikšķiniet uz *Create dashboard*, skatot visus paneļus - Atlasiet *Create new* darbību izvēlnē, skatot vienu paneli Vispirms jums tiks lūgts ievadīt vispārīgos paneļa parametrus:  |Parametrs|Apraksts| |--|--------| |*Owner*|Atlasiet sistēmas lietotāju, kurš būs paneļa īpašnieks.| |*Name*|Ievadiet paneļa nosaukumu.| |*Default page display period*|Atlasiet periodu, cik ilgi paneļa lapa tiek rādīta pirms pārejas uz nākamo lapu [slīdrādē](#creating-a-slideshow).| |*Start slideshow automatically*|Atzīmējiet šo izvēles rūtiņu, lai slīdrādi palaistu automātiski, ja ir vairāk nekā viena paneļa lapa.| Kad noklikšķināsiet uz *Apply*, tiks atvērts tukšs panelis: {width="600"} Lai aizpildītu paneli, varat pievienot logrīkus un lapas. Noklikšķiniet uz pogas *Save changes*, lai saglabātu paneli. Ja noklikšķināsiet uz *Cancel*, panelis netiks izveidots. #### Creating a global macro Create a global macro "{$SNMP\_COMMUNITY}" with value "public". [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "usermacro.createglobal", "params": { "macro": "{$SNMP_COMMUNITY}", "value": "public" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "globalmacroids": [ "6" ] }, "id": 1 } ``` #### Globālas makrokomandas izveide Izveidojiet globālu makrokomandu "{$SNMP\_COMMUNITY}" ar vērtību "public". [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "usermacro.createglobal", "params": { "macro": "{$SNMP_COMMUNITY}", "value": "public" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "globalmacroids": [ "6" ] }, "id": 1 } ``` #### Creating a graph Create a graph with two items. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "graph.create", "params": { "name": "MySQL bandwidth", "width": 900, "height": 200, "gitems": [ { "itemid": "22828", "color": "00AA00" }, { "itemid": "22829", "color": "3333FF" } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "graphids": [ "652" ] }, "id": 1 } ``` #### Grafika izveide Izveidojiet grafiku ar diviem vienumiem. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "graph.create", "params": { "name": "MySQL bandwidth", "width": 900, "height": 200, "gitems": [ { "itemid": "22828", "color": "00AA00" }, { "itemid": "22829", "color": "3333FF" } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "graphids": [ "652" ] }, "id": 1 } ``` #### Creating a graph prototype Create a graph prototype with two items. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "graphprototype.create", "params": { "name": "Disk space usage {#FSNAME}", "width": 900, "height": 200, "gitems": [ { "itemid": "22828", "color": "00AA00" }, { "itemid": "22829", "color": "3333FF" } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "graphids": [ "652" ] }, "id": 1 } ``` #### Grafika prototipa izveide Izveidojiet grafika prototipu ar diviem vienumiem. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "graphprototype.create", "params": { "name": "Diska vietas izmantojums {#FSNAME}", "width": 900, "height": 200, "gitems": [ { "itemid": "22828", "color": "00AA00" }, { "itemid": "22829", "color": "3333FF" } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "graphids": [ "652" ] }, "id": 1 } ``` #### Creating a host Create a host called "Linux server" with an IP interface and tags, add it to a group, link a template to it and set the MAC addresses in the host inventory. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "host.create", "params": { "host": "Linux server", "interfaces": [ { "type": 1, "main": 1, "useip": 1, "ip": "192.168.3.1", "dns": "", "port": "10050" } ], "groups": [ { "groupid": "50" } ], "tags": [ { "tag": "host-name", "value": "linux-server" } ], "templates": [ { "templateid": "20045" } ], "macros": [ { "macro": "{$USER_ID}", "value": "123321" }, { "macro": "{$USER_LOCATION}", "value": "0:0:0", "description": "latitude, longitude and altitude coordinates" } ], "inventory_mode": 0, "inventory": { "macaddress_a": "01234", "macaddress_b": "56768" } }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "107819" ] }, "id": 1 } ``` #### Hosta izveide Izveidojiet hostu ar nosaukumu "Linux server" ar IP saskarni un tagiem, pievienojiet to grupai, piesaistiet tam veidni un iestatiet MAC adreses hosta inventārā. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "host.create", "params": { "host": "Linux server", "interfaces": [ { "type": 1, "main": 1, "useip": 1, "ip": "192.168.3.1", "dns": "", "port": "10050" } ], "groups": [ { "groupid": "50" } ], "tags": [ { "tag": "host-name", "value": "linux-server" } ], "templates": [ { "templateid": "20045" } ], "macros": [ { "macro": "{$USER_ID}", "value": "123321" }, { "macro": "{$USER_LOCATION}", "value": "0:0:0", "description": "platuma, garuma un augstuma koordinātas" } ], "inventory_mode": 0, "inventory": { "macaddress_a": "01234", "macaddress_b": "56768" } }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "107819" ] }, "id": 1 } ``` #### Creating a host group Create a host group called "Linux servers". [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "hostgroup.create", "params": { "name": "Linux servers" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "groupids": [ "107819" ] }, "id": 1 } ``` #### Hostu grupas izveide Izveidojiet hostu grupu ar nosaukumu "Linux servers". [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "hostgroup.create", "params": { "name": "Linux servers" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "groupids": [ "107819" ] }, "id": 1 } ``` #### Creating a host inventory item Create a Zabbix agent item to populate the host's "OS" inventory field. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "item.create", "params": { "name": "uname", "key_": "system.uname", "hostid": "30021", "type": 0, "interfaceid": "30007", "value_type": 1, "delay": "10s", "inventory_link": 5 }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "24759" ] }, "id": 1 } ``` #### Hosts inventarizācijas vienuma izveide Izveidojiet Zabbix aģents vienumu, lai aizpildītu hosta inventarizācijas lauku "OS". [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "item.create", "params": { "name": "uname", "key_": "system.uname", "hostid": "30021", "type": 0, "interfaceid": "30007", "value_type": 1, "delay": "10s", "inventory_link": 5 }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "24759" ] }, "id": 1 } ``` #### Creating a host macro Create a host macro "{$SNMP\_COMMUNITY}" with the value "public" on host "10198". [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "usermacro.create", "params": { "hostid": "10198", "macro": "{$SNMP_COMMUNITY}", "value": "public" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostmacroids": [ "11" ] }, "id": 1 } ``` #### Hosta makro izveide Izveidojiet hosta makro "{$SNMP\_COMMUNITY}" ar vērtību "public" hostam "10198". [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "usermacro.create", "params": { "hostid": "10198", "macro": "{$SNMP_COMMUNITY}", "value": "public" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "hostmacroids": [ "11" ] }, "id": 1 } ``` #### Creating a host monitored by a proxy Create a host that will be monitored by proxy with ID "1". [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "host.create", "params": { "host": "Host monitored by proxy", "groups": [ { "groupid": "2" } ], "monitored_by": 1, "proxyid": 1 }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10591" ] }, "id": 1 } ``` #### Hosta, ko uzrauga starpniekserveris, izveide Izveidojiet hostu, ko uzraudzīs starpniekserveris ar ID "1". [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "host.create", "params": { "host": "Host monitored by proxy", "groups": [ { "groupid": "2" } ], "monitored_by": 1, "proxyid": 1 }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10591" ] }, "id": 1 } ``` #### Creating a host monitored by a proxy group Create a host that will be monitored by proxy group with ID "1". [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "host.create", "params": { "host": "Host monitored by proxy group", "groups": [ { "groupid": "2" } ], "monitored_by": 2, "proxy_groupid": 1 }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10592" ] }, "id": 1 } ``` #### Hosta, ko uzrauga starpniekserveru grupa, izveide Izveidojiet hostu, ko uzraudzīs starpniekserveru grupa ar ID "1". [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "host.create", "params": { "host": "Host monitored by proxy group", "groups": [ { "groupid": "2" } ], "monitored_by": 2, "proxy_groupid": 1 }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10592" ] }, "id": 1 } ``` #### Creating a host prototype Create a host prototype "{\#VM.NAME}" on LLD rule "23542" with a group prototype "{\#HV.NAME}", tag pair "datacenter": "{\#DATACENTER.NAME}" and custom SNMPv2 interface 127.0.0.1:161 with community {$SNMP\_COMMUNITY}. Link it to host group "2". [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "hostprototype.create", "params": { "host": "{#VM.NAME}", "ruleid": "23542", "custom_interfaces": "1", "groupLinks": [ { "groupid": "2" } ], "groupPrototypes": [ { "name": "{#HV.NAME}" } ], "tags": [ { "tag": "datacenter", "value": "{#DATACENTER.NAME}" } ], "interfaces": [ { "main": "1", "type": "2", "useip": "1", "ip": "127.0.0.1", "dns": "", "port": "161", "details": { "version": "2", "bulk": "1", "community": "{$SNMP_COMMUNITY}" } } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10103" ] }, "id": 1 } ``` #### Hosts prototipa izveide Izveidojiet hosts prototipu "{\#VM.NAME}" LLD kārtulai "23542" ar grupas prototipu "{\#HV.NAME}", birkas pāri "datacenter": "{\#DATACENTER.NAME}" un pielāgotu SNMPv2 saskarni 127.0.0.1:161 ar kopienu {$SNMP\_COMMUNITY}. Saistiet to ar hostu grupu "2". [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "hostprototype.create", "params": { "host": "{#VM.NAME}", "ruleid": "23542", "custom_interfaces": "1", "groupLinks": [ { "groupid": "2" } ], "groupPrototypes": [ { "name": "{#HV.NAME}" } ], "tags": [ { "tag": "datacenter", "value": "{#DATACENTER.NAME}" } ], "interfaces": [ { "main": "1", "type": "2", "useip": "1", "ip": "127.0.0.1", "dns": "", "port": "161", "details": { "version": "2", "bulk": "1", "community": "{$SNMP_COMMUNITY}" } } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10103" ] }, "id": 1 } ``` #### Creating a host with PSK encryption Create a host called "PSK host" with PSK encryption configured. Note that the host has to be [pre-configured to use PSK](/manual/encryption/using_pre_shared_keys#configuring-psk-for-server-agent-communication-example). [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "host.create", "params": { "host": "PSK host", "interfaces": [ { "type": 1, "ip": "192.168.3.1", "dns": "", "port": "10050", "useip": 1, "main": 1 } ], "groups": [ { "groupid": "2" } ], "tls_accept": 2, "tls_connect": 2, "tls_psk_identity": "PSK 001", "tls_psk": "1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10590" ] }, "id": 1 } ``` #### Hosta izveide ar PSK šifrēšanu Izveidojiet hostu ar nosaukumu "PSK host", kuram ir konfigurēta PSK šifrēšana. Ņemiet vērā, ka hostam jābūt [iepriekš konfigurētam PSK izmantošanai](/manual/encryption/using_pre_shared_keys#configuring-psk-for-server-agent-communication-example). [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "host.create", "params": { "host": "PSK host", "interfaces": [ { "type": 1, "ip": "192.168.3.1", "dns": "", "port": "10050", "useip": 1, "main": 1 } ], "groups": [ { "groupid": "2" } ], "tls_accept": 2, "tls_connect": 2, "tls_psk_identity": "PSK 001", "tls_psk": "1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10590" ] }, "id": 1 } ``` #### Creating a host with SNMP interface Create a host called "SNMP host" with an SNMPv3 interface with details. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "host.create", "params": { "host": "SNMP host", "interfaces": [ { "type": 2, "main": 1, "useip": 1, "ip": "127.0.0.1", "dns": "", "port": "161", "details": { "version": 3, "bulk": 0, "securityname": "mysecurityname", "contextname": "", "securitylevel": 1 } } ], "groups": [ { "groupid": "4" } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10658" ] }, "id": 1 } ``` #### Hosta izveide ar SNMP saskarni Izveidojiet hostu ar nosaukumu "SNMP host" ar SNMPv3 saskarni un detalizētu informāciju. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "host.create", "params": { "host": "SNMP host", "interfaces": [ { "type": 2, "main": 1, "useip": 1, "ip": "127.0.0.1", "dns": "", "port": "161", "details": { "version": 3, "bulk": 0, "securityname": "mysecurityname", "contextname": "", "securitylevel": 1 } } ], "groups": [ { "groupid": "4" } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10658" ] }, "id": 1 } ``` #### Creating a maintenance Create a maintenance with data collection for host group with ID "2" and with problem tags **service:mysqld** and **error**. It must be active from 17.03.2026 till 17.03.2027, come in effect each Sunday at 18:00 and last for one hour. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "maintenance.create", "params": { "name": "Sunday maintenance", "active_since": 1773720240, "active_till": 1805256240, "tags_evaltype": 0, "groups": [ {"groupid": "2"} ], "timeperiods": [ { "period": 3600, "timeperiod_type": 3, "start_time": 64800, "every": 1, "dayofweek": 64 } ], "tags": [ { "tag": "service", "operator": "0", "value": "mysqld" }, { "tag": "error", "operator": "2", "value": "" } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "maintenanceids": [ "3" ] }, "id": 1 } ``` #### Uzturēšanas izveide Izveidojiet uzturēšanu ar datu vākšanu hostu grupai ar ID "2" un ar problēmu tagiem **service:mysqld** un **error**. Tai jābūt aktīvai no 17.03.2026 līdz 17.03.2027, jāstājas spēkā katru svētdienu plkst. 18:00 un jāturpinās vienu stundu. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "maintenance.create", "params": { "name": "Sunday maintenance", "active_since": 1773720240, "active_till": 1805256240, "tags_evaltype": 0, "groups": [ {"groupid": "2"} ], "timeperiods": [ { "period": 3600, "timeperiod_type": 3, "start_time": 64800, "every": 1, "dayofweek": 64 } ], "tags": [ { "tag": "service", "operator": "0", "value": "mysqld" }, { "tag": "error", "operator": "2", "value": "" } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "maintenanceids": [ "3" ] }, "id": 1 } ``` #### Creating a map To create a map, do the following: - Go to *Monitoring > Maps* - Go to the view with all maps - Click on *Create map* You can also use the *Clone* button in the configuration form of an existing map to create a new map. This map will have all of the properties of the existing map, including general layout attributes, as well as the elements of the existing map. The **Map** tab contains general map attributes:  All mandatory input fields are marked with a red asterisk. General map attributes: |Parameter|Description| |--|--------| |*Owner*|Name of map owner.| |*Name*|Unique map name.| |*Width*|Map width in pixels.| |*Height*|Map height in pixels.| |*Background image*|Use background image:<br>**No image** - no background image (white background)<br>**Image** - selected image to be used as a background image. No scaling is performed. You may use a geographical map or any other image to enhance your map.| |*Automatic icon mapping*|You can set to use an automatic icon mapping, configured in *Administration → General → Icon mapping*. Icon mapping allows mapping certain icons against certain host inventory fields.| |*Icon highlight*|If you check this box, map elements will be highlighted.<br>Elements with an active trigger will receive a round background, in the same color as the highest severity trigger. Moreover, a thick green line will be displayed around the circle if all problems are acknowledged.<br>Elements with "disabled" or "in maintenance" status will get a square background, gray and orange respectively.<br>See also: [Viewing maps](/manual/web_interface/frontend_sections/monitoring/maps#viewing-maps)| |*Mark elements on trigger status change*|A recent change of trigger status (recent problem or resolution) will be highlighted with markers (inward-pointing red triangles) on the three sides of the element icon that are free of the label. Markers are displayed for 30 minutes.| |*Display problems*|Select how problems are displayed with a map element:<br>**Expand single problem** - if there is only one problem, the problem name is displayed. Otherwise, the total number of problems is displayed.<br>**Number of problems** - the total number of problems is displayed<br>**Number of problems and expand most critical one** - the name of the most critical problem and the total number of problems is displayed.<br>'Most critical' is determined based on problem severity and, if equal, problem event ID (higher ID or later problem displayed first). For a *trigger map element* it is based on problem severity and if equal, trigger position in the trigger list. In case of multiple problems of the same trigger, the most recent one will be displayed.| |*Advanced labels*|If you check this box you will be able to define separate label types for separate element types.| |*Map element label type*|Label type used for map elements:<br>**Label** - map element label<br>**IP address** - IP address<br>**Element name** - element name (for example, host name)<br>**Status only** - status only (OK or PROBLEM)<br>**Nothing** - no labels are displayed| |*Map element label location*|Label location in relation to the map element:<br>**Bottom** - beneath the map element<br>**Left** - to the left<br>**Right** - to the right<br>**Top** - above the map element| |*Problem display*|Display problem count as:<br>**All** - full problem count will be displayed<br>**Separated** - unacknowledged problem count will be displayed separated as a number of the total problem count<br>**Unacknowledged only** - only the unacknowledged problem count will be displayed| |*Minimum trigger severity*|Problems below the selected minimum severity level will not be displayed on the map.<br>For example, with *Warning* selected, changes with *Information* and *Not classified* level triggers will not be reflected in the map.| |*Show suppressed problems*|Mark the checkbox to display problems that would otherwise be suppressed (not shown) because of host maintenance.| |*URLs*|URLs (up to 2048 characters) for each element type can be defined. A label for the URL can also be defined. These will be displayed as links when a user clicks on the element in the map viewing mode.<br>Macros can be used in map URL names and values. For a full list, see [supported macros](/manual/appendix/macros/supported_by_location) and search for 'map URL names and values'.| #### Kartes izveide Lai izveidotu karti, rīkojieties šādi: - Dodieties uz *Monitoring > Maps* - Dodieties uz skatu ar visām kartēm - Noklikšķiniet uz *Create map* Varat arī izmantot pogu *Clone* esošas kartes konfigurācijas formā, lai izveidotu jaunu karti. Šai kartei būs visas esošās kartes īpašības, tostarp vispārīgie izkārtojuma atribūti, kā arī esošās kartes elementi. Cilne **Map** satur vispārīgos kartes atribūtus:  Visi obligātie ievades lauki ir atzīmēti ar sarkanu zvaigznīti. Vispārīgie kartes atribūti: |Parameter|Description| |--|--------| |*Owner*|Kartes īpašnieka nosaukums.| |*Name*|Unikāls kartes nosaukums.| |*Width*|Kartes platums pikseļos.| |*Height*|Kartes augstums pikseļos.| |*Background image*|Izmantot fona attēlu:<br>**No image** - nav fona attēla (balts fons)<br>**Image** - atlasītais attēls, kas tiks izmantots kā fona attēls. Mērogošana netiek veikta. Varat izmantot ģeogrāfisku karti vai jebkuru citu attēlu, lai uzlabotu savas kartes vizuālo noformējumu.| |*Automatic icon mapping*|Varat iestatīt automātisku ikonu kartēšanu, kas konfigurēta sadaļā *Administration → General → Icon mapping*. Ikonu kartēšana ļauj piesaistīt noteiktas ikonas noteiktiem host inventāra laukiem.| |*Icon highlight*|Ja atzīmēsiet šo izvēles rūtiņu, kartes elementi tiks izcelti.<br>Elementiem ar aktīvu trigeri būs apaļš fons tādā pašā krāsā kā augstākās nopietnības trigerim. Turklāt ap apli tiks parādīta bieza zaļa līnija, ja visas problēmas ir apstiprinātas.<br>Elementiem ar statusu "disabled" vai "in maintenance" būs kvadrātveida fons attiecīgi pelēkā un oranžā krāsā.<br>Skatiet arī: [Kartes skatīšana](/manual/web_interface/frontend_sections/monitoring/maps#viewing-maps)| |*Mark elements on trigger status change*|Nesenās trigeris statusa izmaiņas (nesena problēma vai atrisinājums) tiks izceltas ar marķieriem (uz iekšu vērstiem sarkaniem trijstūriem) trijās elementa ikonas pusēs, kur nav etiķetes. Marķieri tiek rādīti 30 minūtes.| |*Display problems*|Atlasiet, kā problēmas tiek rādītas ar kartes elementu:<br>**Expand single problem** - ja ir tikai viena problēma, tiek rādīts problēmas nosaukums. Pretējā gadījumā tiek rādīts kopējais problēmu skaits.<br>**Number of problems** - tiek rādīts kopējais problēmu skaits<br>**Number of problems and expand most critical one** - tiek rādīts viskritiskākās problēmas nosaukums un kopējais problēmu skaits.<br>"Most critical" tiek noteikts, pamatojoties uz problēmas nopietnību un, ja tā ir vienāda, problēmas notikuma ID (vispirms tiek rādīts lielāks ID vai vēlākā problēma). Attiecībā uz *trigger map element* tas tiek noteikts, pamatojoties uz problēmas nopietnību un, ja tā ir vienāda, trigeris pozīciju trigeris sarakstā. Ja ir vairākas vienas un tās pašas trigeris problēmas, tiks rādīta jaunākā.| |*Advanced labels*|Ja atzīmēsiet šo izvēles rūtiņu, varēsiet definēt atsevišķus etiķešu tipus atsevišķiem elementu tipiem.| |*Map element label type*|Etiķetes tips, ko izmanto kartes elementiem:<br>**Label** - kartes elementa etiķete<br>**IP address** - IP adrese<br>**Element name** - elementa nosaukums (piemēram, host nosaukums)<br>**Status only** - tikai statuss (OK vai PROBLEM)<br>**Nothing** - etiķetes netiek rādītas| |*Map element label location*|Etiķetes atrašanās vieta attiecībā pret kartes elementu:<br>**Bottom** - zem kartes elementa<br>**Left** - pa kreisi<br>**Right** - pa labi<br>**Top** - virs kartes elementa| |*Problem display*|Rādīt problēmu skaitu kā:<br>**All** - tiks rādīts pilns problēmu skaits<br>**Separated** - tiks rādīts neapstiprināto problēmu skaits, atdalīts no kopējā problēmu skaita<br>**Unacknowledged only** - tiks rādīts tikai neapstiprināto problēmu skaits| |*Minimum trigger severity*|Problēmas, kas ir zemākas par atlasīto minimālo nopietnības līmeni, kartē netiks rādītas.<br>Piemēram, ja ir atlasīts *Warning*, izmaiņas ar *Information* un *Not classified* līmeņa trigeris kartē netiks atspoguļotas.| |*Show suppressed problems*|Atzīmējiet izvēles rūtiņu, lai rādītu problēmas, kas citādi tiktu slēptas (nerādītas) host uzturēšanas dēļ.| |*URLs*|Katram elementa tipam var definēt URL (līdz 2048 rakstzīmēm). Var definēt arī URL etiķeti. Tie tiks rādīti kā saites, kad lietotājs kartes skatīšanas režīmā noklikšķinās uz elementa.<br>Kartes URL nosaukumos un vērtībās var izmantot makro. Pilnu sarakstu skatiet [supported macros](/manual/appendix/macros/supported_by_location) un meklējiet 'map URL names and values'.| #### Creating an email media type Create a new email media type with a custom SMTP port and message templates. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "mediatype.create", "params": { "type": "0", "name": "Email", "smtp_server": "mail.example.com", "smtp_helo": "example.com", "smtp_email": "zabbix@example.com", "smtp_port": "587", "message_format": "1", "message_templates": [ { "eventsource": "0", "recovery": "0", "subject": "Problem: {EVENT.NAME}", "message": "Problem \"{EVENT.NAME}\" on host \"{HOST.NAME}\" started at {EVENT.TIME}." }, { "eventsource": "0", "recovery": "1", "subject": "Resolved in {EVENT.DURATION}: {EVENT.NAME}", "message": "Problem \"{EVENT.NAME}\" on host \"{HOST.NAME}\" has been resolved at {EVENT.RECOVERY.TIME} on {EVENT.RECOVERY.DATE}." }, { "eventsource": "0", "recovery": "2", "subject": "Updated problem in {EVENT.AGE}: {EVENT.NAME}", "message": "{USER.FULLNAME} {EVENT.UPDATE.ACTION} problem \"{EVENT.NAME}\" on host \"{HOST.NAME}\" at {EVENT.UPDATE.DATE} {EVENT.UPDATE.TIME}." } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "mediatypeids": [ "7" ] }, "id": 1 } ``` #### E-pasta medija tipa izveide Izveidojiet jaunu e-pasta medija tipu ar pielāgotu SMTP portu un ziņojumu veidnēm. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "mediatype.create", "params": { "type": "0", "name": "Email", "smtp_server": "mail.example.com", "smtp_helo": "example.com", "smtp_email": "zabbix@example.com", "smtp_port": "587", "message_format": "1", "message_templates": [ { "eventsource": "0", "recovery": "0", "subject": "Problēma: {EVENT.NAME}", "message": "Problēma \"{EVENT.NAME}\" hostā \"{HOST.NAME}\" sākās {EVENT.TIME}." }, { "eventsource": "0", "recovery": "1", "subject": "Atrisināts {EVENT.DURATION}: {EVENT.NAME}", "message": "Problēma \"{EVENT.NAME}\" hostā \"{HOST.NAME}\" tika atrisināta {EVENT.RECOVERY.TIME} {EVENT.RECOVERY.DATE}." }, { "eventsource": "0", "recovery": "2", "subject": "Atjaunināta problēma {EVENT.AGE}: {EVENT.NAME}", "message": "{USER.FULLNAME} {EVENT.UPDATE.ACTION} problēmu \"{EVENT.NAME}\" hostā \"{HOST.NAME}\" {EVENT.UPDATE.DATE} {EVENT.UPDATE.TIME}." } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "mediatypeids": [ "7" ] }, "id": 1 } ``` #### Creating a new global regular expression. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "regexp.create", "params": { "name": "Storage devices for SNMP discovery", "test_string": "/boot", "expressions": [ { "expression": "^(Physical memory|Virtual memory|Memory buffers|Cached memory|Swap space)$", "expression_type": "4", "case_sensitive": "1" } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "regexpids": [ "16" ] }, "id": 1 } ``` #### Jaunas globālās regulārās izteiksmes izveide. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "regexp.create", "params": { "name": "Storage devices for SNMP discovery", "test_string": "/boot", "expressions": [ { "expression": "^(Physical memory|Virtual memory|Memory buffers|Cached memory|Swap space)$", "expression_type": "4", "case_sensitive": "1" } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "regexpids": [ "16" ] }, "id": 1 } ``` #### Creating a new item Now, create a new [item](/manual/api/reference/item/object) on the host "Zabbix server" using the data you have obtained from the previous `host.get` request. This can be done using the [`item.create`](/manual/api/reference/item/create) method: ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \ --header 'Content-Type: application/json-rpc' \ --data '{"jsonrpc":"2.0","method":"item.create","params":{"name":"Free disk space on /home/joe/","key_":"vfs.fs.size[/home/joe/,free]","hostid":"10084","type":0,"value_type":3,"interfaceid":"1","delay":30},"id":3}' ``` A successful response will contain the ID of the newly created item, which can be used to reference the item in the following requests: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "24759" ] }, "id": 3 } ``` ::: notetip The `item.create` method as well as other *create methods* can also accept arrays of objects and create multiple items with one API call. ::: #### Jauna vienuma izveide Tagad izveidojiet jaunu [vienumu](/manual/api/reference/item/object) hostā "Zabbix server", izmantojot datus, ko ieguvāt no iepriekšējā `host.get` pieprasījuma. To var izdarīt, izmantojot [`item.create`](/manual/api/reference/item/create) metodi: ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \ --header 'Content-Type: application/json-rpc' \ --data '{"jsonrpc":"2.0","method":"item.create","params":{"name":"Free disk space on /home/joe/","key_":"vfs.fs.size[/home/joe/,free]","hostid":"10084","type":0,"value_type":3,"interfaceid":"1","delay":30},"id":3}' ``` Veiksmīga atbilde saturēs jaunizveidotā vienuma ID, ko var izmantot, lai atsauktos uz vienumu turpmākajos pieprasījumos: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "24759" ] }, "id": 3 } ``` ::: notetip Metode `item.create`, tāpat kā citas *izveides metodes*, var pieņemt arī objektu masīvus un izveidot vairākus vienumus ar vienu API izsaukumu. ::: #### Creating an item Create a numeric Zabbix agent item with 2 item tags to monitor free disk space on host with ID "30074". [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "item.create", "params": { "name": "Free disk space on /home/joe/", "key_": "vfs.fs.size[/home/joe/,free]", "hostid": "30074", "type": 0, "value_type": 3, "interfaceid": "30084", "tags": [ { "tag": "component", "value": "storage" }, { "tag": "equipment", "value": "workstation" } ], "delay": "30s" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "24758" ] }, "id": 1 } ``` #### Vienuma izveide Izveidojiet skaitlisku Zabbix aģenta vienumu ar 2 vienuma tagiem, lai uzraudzītu brīvo diska vietu hostā ar ID "30074". [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "item.create", "params": { "name": "Free disk space on /home/joe/", "key_": "vfs.fs.size[/home/joe/,free]", "hostid": "30074", "type": 0, "value_type": 3, "interfaceid": "30084", "tags": [ { "tag": "component", "value": "storage" }, { "tag": "equipment", "value": "workstation" } ], "delay": "30s" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "24758" ] }, "id": 1 } ``` #### Creating an item prototype Create an item prototype to monitor free disk space on a discovered file system. Discovered items should be numeric Zabbix agent items updated every 30 seconds. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "itemprototype.create", "params": { "name": "Free disk space on {#FSNAME}", "key_": "vfs.fs.size[{#FSNAME},free]", "hostid": "10197", "ruleid": "27665", "type": 0, "value_type": 3, "interfaceid": "112", "delay": "30s" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "27666" ] }, "id": 1 } ``` #### Vienuma prototipa izveide Izveidojiet vienuma prototipu, lai uzraudzītu brīvo diska vietu atklātajā failu sistēmā. Atklātajiem vienumiem jābūt skaitliskiem Zabbix aģenta vienumiem, kas tiek atjaunināti ik pēc 30 sekundēm. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "itemprototype.create", "params": { "name": "Brīvā diska vieta uz {#FSNAME}", "key_": "vfs.fs.size[{#FSNAME},free]", "hostid": "10197", "ruleid": "27665", "type": 0, "value_type": 3, "interfaceid": "112", "delay": "30s" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "27666" ] }, "id": 1 } ``` #### Creating an item prototype with preprocessing Create an item using change per second and a custom multiplier as a second step. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "itemprototype.create", "params": { "name": "Incoming network traffic on {#IFNAME}", "key_": "net.if.in[{#IFNAME}]", "hostid": "10001", "ruleid": "27665", "type": 0, "value_type": 3, "delay": "60s", "units": "bps", "interfaceid": "1155", "preprocessing": [ { "type": 10, "params": "", "error_handler": 0, "error_handler_params": "" }, { "type": 1, "params": "8", "error_handler": 2, "error_handler_params": "10" } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "44211" ] }, "id": 1 } ``` #### Vienuma prototipa izveide ar priekšapstrādi Izveidojiet vienumu, izmantojot izmaiņas sekundē un pielāgotu reizinātāju kā otro soli. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "itemprototype.create", "params": { "name": "Ienākošā tīkla datplūsma uz {#IFNAME}", "key_": "net.if.in[{#IFNAME}]", "hostid": "10001", "ruleid": "27665", "type": 0, "value_type": 3, "delay": "60s", "units": "bps", "interfaceid": "1155", "preprocessing": [ { "type": 10, "params": "", "error_handler": 0, "error_handler_params": "" }, { "type": 1, "params": "8", "error_handler": 2, "error_handler_params": "10" } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "44211" ] }, "id": 1 } ``` #### Creating an item with preprocessing Create an item using custom multiplier. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "item.create", "params": { "name": "Device uptime", "key_": "sysUpTime", "hostid": "10084", "type": 20, "snmp_oid": "SNMPv2-MIB::sysUpTime.0", "value_type": 1, "delay": "60s", "interfaceid": "83", "preprocessing": [ { "type": 1, "params": "0.01", "error_handler": 1, "error_handler_params": "" } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "44210" ] }, "id": 1 } ``` #### Vienuma izveide ar priekšapstrādi Izveidojiet vienumu, izmantojot pielāgotu reizinātāju. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "item.create", "params": { "name": "Ierīces darbības laiks", "key_": "sysUpTime", "hostid": "10084", "type": 20, "snmp_oid": "SNMPv2-MIB::sysUpTime.0", "value_type": 1, "delay": "60s", "interfaceid": "83", "preprocessing": [ { "type": 1, "params": "0.01", "error_handler": 1, "error_handler_params": "" } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "44210" ] }, "id": 1 } ``` #### Creating an LLD rule Create a Zabbix agent LLD rule to discover mounted file systems. Discovered items will be updated every 30 seconds. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "discoveryrule.create", "params": { "name": "Mounted filesystem discovery", "key_": "vfs.fs.discovery", "hostid": "10197", "type": 0, "interfaceid": "112", "delay": "30s" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "27665" ] }, "id": 1 } ``` #### LLD kārtulas izveide Izveidojiet Zabbix aģenta LLD kārtulu, lai atklātu piemontētās failu sistēmas. Atklātie vienumi tiks atjaunināti ik pēc 30 sekundēm. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "discoveryrule.create", "params": { "name": "Mounted filesystem discovery", "key_": "vfs.fs.discovery", "hostid": "10197", "type": 0, "interfaceid": "112", "delay": "30s" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "27665" ] }, "id": 1 } ``` #### Creating an LLD rule with macro paths [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "discoveryrule.create", "params": { "name": "LLD rule with LLD macro paths", "key_": "lld", "hostid": "10116", "type": 0, "interfaceid": "13", "delay": "30s", "lld_macro_paths": [ { "lld_macro": "{#MACRO1}", "path": "$.path.1" }, { "lld_macro": "{#MACRO2}", "path": "$.path.2" } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "27665" ] }, "id": 1 } ``` #### LLD kārtulas izveide ar makro ceļiem [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "discoveryrule.create", "params": { "name": "LLD kārtula ar LLD makro ceļiem", "key_": "lld", "hostid": "10116", "type": 0, "interfaceid": "13", "delay": "30s", "lld_macro_paths": [ { "lld_macro": "{#MACRO1}", "path": "$.path.1" }, { "lld_macro": "{#MACRO2}", "path": "$.path.2" } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "27665" ] }, "id": 1 } ``` #### Creating an LLD rule with overrides [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "discoveryrule.create", "params": { "name": "Discover database host", "key_": "lld.with.overrides", "hostid": "10001", "type": 0, "delay": "60s", "interfaceid": "1155", "overrides": [ { "name": "Discover MySQL host", "step": "1", "stop": "1", "filter": { "evaltype": "2", "conditions": [ { "macro": "{#UNIT.NAME}", "operator": "8", "value": "^mysqld\\.service$" }, { "macro": "{#UNIT.NAME}", "operator": "8", "value": "^mariadb\\.service$" } ] }, "operations": [ { "operationobject": "3", "operator": "2", "value": "Database host", "opstatus": { "status": "0" }, "optemplate": [ { "templateid": "10170" } ], "optag": [ { "tag": "database", "value": "mysql" } ] } ] }, { "name": "Discover PostgreSQL host", "step": "2", "stop": "1", "filter": { "evaltype": "0", "conditions": [ { "macro": "{#UNIT.NAME}", "operator": "8", "value": "^postgresql\\.service$" } ] }, "operations": [ { "operationobject": "3", "operator": "2", "value": "Database host", "opstatus": { "status": "0" }, "optemplate": [ { "templateid": "10263" } ], "optag": [ { "tag": "database", "value": "postgresql" } ] } ] } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "30980" ] }, "id": 1 } ``` #### LLD kārtulas izveide ar ignorēšanas noteikumiem [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "discoveryrule.create", "params": { "name": "Atklāt datubāzes hostu", "key_": "lld.with.overrides", "hostid": "10001", "type": 0, "delay": "60s", "interfaceid": "1155", "overrides": [ { "name": "Atklāt MySQL hostu", "step": "1", "stop": "1", "filter": { "evaltype": "2", "conditions": [ { "macro": "{#UNIT.NAME}", "operator": "8", "value": "^mysqld\\.service$" }, { "macro": "{#UNIT.NAME}", "operator": "8", "value": "^mariadb\\.service$" } ] }, "operations": [ { "operationobject": "3", "operator": "2", "value": "Datubāzes hosts", "opstatus": { "status": "0" }, "optemplate": [ { "templateid": "10170" } ], "optag": [ { "tag": "database", "value": "mysql" } ] } ] }, { "name": "Atklāt PostgreSQL hostu", "step": "2", "stop": "1", "filter": { "evaltype": "0", "conditions": [ { "macro": "{#UNIT.NAME}", "operator": "8", "value": "^postgresql\\.service$" } ] }, "operations": [ { "operationobject": "3", "operator": "2", "value": "Datubāzes hosts", "opstatus": { "status": "0" }, "optemplate": [ { "templateid": "10263" } ], "optag": [ { "tag": "database", "value": "postgresql" } ] } ] } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "30980" ] }, "id": 1 } ``` #### Creating an LLD rule with preprocessing [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "discoveryrule.create", "params": { "name": "Discovery rule with preprocessing", "key_": "lld.with.preprocessing", "hostid": "10001", "ruleid": "27665", "type": 0, "delay": "60s", "interfaceid": "1155", "preprocessing": [ { "type": 20, "params": "20", "error_handler": 0, "error_handler_params": "" } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "44211" ] }, "id": 1 } ``` #### LLD kārtulas izveide ar priekšapstrādi [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "discoveryrule.create", "params": { "name": "Atklāšanas kārtula ar priekšapstrādi", "key_": "lld.with.preprocessing", "hostid": "10001", "ruleid": "27665", "type": 0, "delay": "60s", "interfaceid": "1155", "preprocessing": [ { "type": 20, "params": "20", "error_handler": 0, "error_handler_params": "" } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "44211" ] }, "id": 1 } ``` #### Creating an SLA Instruct to create an SLA entry for: * tracking uptime for SQL-engine related services; * custom schedule of all weekdays excluding last hour on Saturday; * an effective date of the last day of the year 2022; * with 1 hour and 15 minutes long planned downtime starting at midnight on the 4th of July; * SLA weekly report calculation will be on; * the minimum acceptable SLO will be 99.9995%. #### SLA izveide Norādiet izveidot SLA ierakstu šādam mērķim: * darbspējas laika uzskaite ar SQL dzini saistītiem pakalpojumiem; * pielāgots grafiks visām darba dienām, izņemot pēdējo stundu sestdienā; * spēkā stāšanās datums — 2022. gada pēdējā diena; * ar 1 stundu un 15 minūtes ilgu plānoto dīkstāvi, kas sākas 4. jūlijā pusnaktī; * SLA nedēļas pārskata aprēķināšana būs ieslēgta; * minimālais pieļaujamais SLO būs 99.9995%. ##### Creating application 1\. Log into Microsoft Entra admin center at [Microsoft Entra ID](https://entra.microsoft.com). For testing purposes, you may create a free trial account in Microsoft Entra ID. 2\. In Microsoft Entra admin center select *Applications* -> *Enterprise applications* -> *New application* -> *Create your own application*. 3\. Add the name of your app and select the *Integrate any other application...* option. After that, click on *Create*. {width="550"} ##### Lietotnes izveide 1\. Piesakieties Microsoft Entra administrēšanas centrā vietnē [Microsoft Entra ID](https://entra.microsoft.com). Testēšanas nolūkos varat izveidot bezmaksas izmēģinājuma kontu Microsoft Entra ID. 2\. Microsoft Entra administrēšanas centrā atlasiet *Applications* -> *Enterprise applications* -> *New application* -> *Create your own application*. 3\. Pievienojiet savas lietotnes nosaukumu un atlasiet opciju *Integrate any other application...*. Pēc tam noklikšķiniet uz *Create*. {width="550"} ##### Creating application 1\. Log into your account at OneLogin. For testing purposes, you may create a free developer account in OneLogin. 2\. In the OneLogin web interface navigate to *Applications → Applications*. 3\. Click on "Add App" and search for the appropriate app. The guidelines in this page are based on the *SCIM Provisioner with SAML (SCIM v2 Enterprise, full SAML)* app example. 4\. To begin with, you may want to customize the display name of your app. You may also want to add the icon and app details. After that, click on *Save*. ##### Lietotnes izveide 1\. Piesakieties savā OneLogin kontā. Testēšanas nolūkos varat izveidot bezmaksas izstrādātāja kontu OneLogin. 2\. OneLogin lietotāja saskarnē pārejiet uz *Applications → Applications*. 3\. Noklikšķiniet uz "Add App" un meklējiet atbilstošo lietotni. Šajā lapā sniegtās vadlīnijas ir balstītas uz lietotnes *SCIM Provisioner with SAML (SCIM v2 Enterprise, full SAML)* piemēru. 4\. Vispirms, iespējams, vēlēsities pielāgot savas lietotnes attēlojamo nosaukumu. Varat arī pievienot ikonu un lietotnes informāciju. Pēc tam noklikšķiniet uz *Save*. #### Creating a proxy and adding it to a proxy group Create an active proxy "Active proxy" and add it to proxy group with ID "1". [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "proxy.create", "params": { "name": "Active proxy", "proxy_groupid": "1", "operating_mode": "0" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "proxyids": [ "5" ] }, "id": 1 } ``` #### Starpniekservera izveide un tā pievienošana starpniekserveru grupai Izveidojiet aktīvu starpniekserveri "Active proxy" un pievienojiet to starpniekserveru grupai ar ID "1". [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "proxy.create", "params": { "name": "Active proxy", "proxy_groupid": "1", "operating_mode": "0" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "proxyids": [ "5" ] }, "id": 1 } ``` #### Creating a proxy with certificate-based encryption Create an active proxy with certificate-based [encryption](/manual/encryption/using_certificates#zabbix-proxy). The proxy is configured to monitor host "10785". [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "proxy.create", "params": { "name": "Active proxy", "operating_mode": "0", "hosts": [ { "hostid": "10785" } ], "tls_accept": "4", "tls_issuer": "CN=Signing CA,OU=Development group,O=Zabbix SIA,DC=zabbix,DC=com", "tls_subject": "CN=Zabbix server,OU=Development group,O=Zabbix SIA,DC=zabbix,DC=com" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "proxyids": [ "2" ] }, "id": 1 } ``` #### Starpniekservera izveide ar šifrēšanu, kas balstīta uz sertifikātiem Izveidojiet aktīvu starpniekserveri ar uz sertifikātiem balstītu [šifrēšanu](/manual/encryption/using_certificates#zabbix-proxy). Starpniekserveris ir konfigurēts, lai uzraudzītu hostu "10785". [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "proxy.create", "params": { "name": "Active proxy", "operating_mode": "0", "hosts": [ { "hostid": "10785" } ], "tls_accept": "4", "tls_issuer": "CN=Signing CA,OU=Development group,O=Zabbix SIA,DC=zabbix,DC=com", "tls_subject": "CN=Zabbix server,OU=Development group,O=Zabbix SIA,DC=zabbix,DC=com" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "proxyids": [ "2" ] }, "id": 1 } ``` #### Creating a role Create a role with type "User" and denied access to two UI elements. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "role.create", "params": { "name": "Operator", "type": "1", "rules": { "ui": [ { "name": "monitoring.hosts", "status": "0" }, { "name": "monitoring.maps", "status": "0" } ] } }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "roleids": [ "5" ] }, "id": 1 } ``` #### Lomas izveide Izveidojiet lomu ar tipu "Lietotājs" un liegtu piekļuvi diviem lietotāja saskarnes elementiem. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "role.create", "params": { "name": "Operator", "type": "1", "rules": { "ui": [ { "name": "monitoring.hosts", "status": "0" }, { "name": "monitoring.maps", "status": "0" } ] } }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "roleids": [ "5" ] }, "id": 1 } ``` #### Creating a scheduled report Create a weekly report that will be prepared for the previous week every Monday-Friday at 12:00 from 2021-04-01 to 2021-08-31. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "report.create", "params": { "userid": "1", "name": "Weekly report", "dashboardid": "1", "period": "1", "cycle": "1", "start_time": "43200", "weekdays": "31", "active_since": "2021-04-01", "active_till": "2021-08-31", "subject": "Weekly report", "message": "Report accompanying text", "status": "1", "description": "Report description", "users": [ { "userid": "1", "access_userid": "1", "exclude": "0" }, { "userid": "2", "access_userid": "0", "exclude": "1" } ], "user_groups": [ { "usrgrpid": "7", "access_userid": "0" } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "reportids": [ "1" ] }, "id": 1 } ``` #### Ieplānota pārskata izveide Izveidojiet nedēļas pārskatu, kas tiks sagatavots par iepriekšējo nedēļu katru pirmdienu–piektdienu plkst. 12:00 no 2021-04-01 līdz 2021-08-31. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "report.create", "params": { "userid": "1", "name": "Weekly report", "dashboardid": "1", "period": "1", "cycle": "1", "start_time": "43200", "weekdays": "31", "active_since": "2021-04-01", "active_till": "2021-08-31", "subject": "Weekly report", "message": "Report accompanying text", "status": "1", "description": "Report description", "users": [ { "userid": "1", "access_userid": "1", "exclude": "0" }, { "userid": "2", "access_userid": "0", "exclude": "1" } ], "user_groups": [ { "usrgrpid": "7", "access_userid": "0" } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "reportids": [ "1" ] }, "id": 1 } ``` #### Creating a script media type Create a new script media type with a custom value for the number of attempts and the interval between them. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "mediatype.create", "params": { "type": "1", "name": "Push notifications", "exec_path": "push-notification.sh", "maxattempts": "5", "attempt_interval": "11s", "parameters": [ { "sortorder": "0", "value": "{ALERT.SENDTO}" }, { "sortorder": "1", "value": "{ALERT.SUBJECT}" }, { "sortorder": "2", "value": "{ALERT.MESSAGE}" } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "mediatypeids": [ "8" ] }, "id": 1 } ``` #### Skripta mediju tipa izveide Izveidojiet jaunu skripta mediju tipu ar pielāgotu vērtību mēģinājumu skaitam un intervālam starp tiem. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "mediatype.create", "params": { "type": "1", "name": "Push notifications", "exec_path": "push-notification.sh", "maxattempts": "5", "attempt_interval": "11s", "parameters": [ { "sortorder": "0", "value": "{ALERT.SENDTO}" }, { "sortorder": "1", "value": "{ALERT.SUBJECT}" }, { "sortorder": "2", "value": "{ALERT.MESSAGE}" } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "mediatypeids": [ "8" ] }, "id": 1 } ``` #### Creating a service Create a service that will be switched to problem state, if at least one child has a problem. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "service.create", "params": { "name": "Server 1", "algorithm": 1, "sortorder": 1 }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "serviceids": [ "5" ] }, "id": 1 } ``` #### Pakalpojuma izveide Izveidojiet pakalpojumu, kas tiks pārslēgts problēmas stāvoklī, ja vismaz vienam apakšpakalpojumam būs problēma. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "service.create", "params": { "name": "Server 1", "algorithm": 1, "sortorder": 1 }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "serviceids": [ "5" ] }, "id": 1 } ``` #### Creating a slideshow A slideshow will run automatically if the dashboard contains two or more pages (see [Adding pages](#adding-pages)) and if one of the following is true: - The *Start slideshow automatically* option is marked in dashboard properties - The dashboard URL contains a `slideshow=1` parameter The pages rotate according to the intervals given in the properties of the dashboard and individual pages. Click on: - *Stop slideshow* - to stop the slideshow - *Start slideshow* - to start the slideshow  Slideshow-related controls are also available in [kiosk mode](#viewing-a-dashboard) (where only the page content is shown): -  - stop slideshow -  - start slideshow -  - go back one page -  - go to the next page #### Slaidrādes izveide Slaidrāde tiks palaista automātiski, ja informācijas panelī ir divas vai vairāk lapas (skatiet [Lapu pievienošana](#adding-pages)) un ja ir spēkā viens no šiem nosacījumiem: - informācijas paneļa īpašībās ir atzīmēta opcija *Automātiski sākt slaidrādi* - informācijas paneļa URL satur parametru `slideshow=1` Lapas tiek pārslēgtas atbilstoši intervāliem, kas norādīti informācijas paneļa un atsevišķu lapu īpašībās. Noklikšķiniet uz: - *Apturēt slaidrādi* - lai apturētu slaidrādi - *Sākt slaidrādi* - lai sāktu slaidrādi  Ar slaidrādi saistītās vadīklas ir pieejamas arī [kioska režīmā](#viewing-a-dashboard) (kur tiek rādīts tikai lapas saturs): -  - apturēt slaidrādi -  - sākt slaidrādi -  - atgriezties vienu lapu atpakaļ -  - pāriet uz nākamo lapu #### Creating a task Create an 'Execute now' task for an item and a low-level discovery rule. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "task.create", "params": [ { "type": 6, "request": { "itemid": "10092" } }, { "type": 6, "request": { "itemid": "10093" } } ], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "taskids": [ "1", "2" ] }, "id": 1 } ``` Create a 'Refresh proxy configuration' task for two proxies. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "task.create", "params": [ { "type": 2, "request": { "proxyids": ["10459", "10460"] } } ], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "taskids": [ "1" ] }, "id": 1 } ``` Create a 'Diagnostic information' task. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "task.create", "params": [ { "type": 1, "request": { "alerting": { "stats": [ "alerts" ], "top": { "media.alerts": 10 } }, "lld": { "stats": "extend", "top": { "values": 5 } } }, "proxyid": 0 } ], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "taskids": [ "3" ] }, "id": 1 } ``` #### Uzdevuma izveide Izveidojiet uzdevumu 'Execute now' vienumam un zema līmeņa atklāšanas kārtulai. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "task.create", "params": [ { "type": 6, "request": { "itemid": "10092" } }, { "type": 6, "request": { "itemid": "10093" } } ], "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "taskids": [ "1", "2" ] }, "id": 1 } ``` Izveidojiet uzdevumu 'Refresh proxy configuration' diviem starpniekserveriem. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "task.create", "params": [ { "type": 2, "request": { "proxyids": ["10459", "10460"] } } ], "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "taskids": [ "1" ] }, "id": 1 } ``` Izveidojiet uzdevumu 'Diagnostic information'. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "task.create", "params": [ { "type": 1, "request": { "alerting": { "stats": [ "alerts" ], "top": { "media.alerts": 10 } }, "lld": { "stats": "extend", "top": { "values": 5 } } }, "proxyid": 0 } ], "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "taskids": [ "3" ] }, "id": 1 } ``` #### Creating a template Create a template with tags and link two templates to this template. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "template.create", "params": { "host": "Linux template", "groups": { "groupid": 1 }, "templates": [ { "templateid": "11115" }, { "templateid": "11116" } ], "tags": [ { "tag": "host-name", "value": "{HOST.NAME}" } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "templateids": [ "11117" ] }, "id": 1 } ``` #### Veidnes izveide Izveidojiet veidni ar tagiem un piesaistiet šai veidnei divas veidnes. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "template.create", "params": { "host": "Linux template", "groups": { "groupid": 1 }, "templates": [ { "templateid": "11115" }, { "templateid": "11116" } ], "tags": [ { "tag": "host-name", "value": "{HOST.NAME}" } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "templateids": [ "11117" ] }, "id": 1 } ``` #### Creating a template dashboard Create a template dashboard named "Graphs" with one Graph widget on a single dashboard page. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "templatedashboard.create", "params": { "templateid": "10318", "name": "Graphs", "pages": [ { "widgets": [ { "type": "graph", "x": 0, "y": 0, "width": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 6, "name": "graphid", "value": "1123" } ] } ] } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "32" ] }, "id": 1 } ``` #### Veidnes informācijas paneļa izveide Izveidojiet veidnes informācijas paneli ar nosaukumu "Graphs" ar vienu Graph logrīku vienā informācijas paneļa lapā. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "templatedashboard.create", "params": { "templateid": "10318", "name": "Graphs", "pages": [ { "widgets": [ { "type": "graph", "x": 0, "y": 0, "width": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 6, "name": "graphid", "value": "1123" } ] } ] } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "32" ] }, "id": 1 } ``` #### Creating a template group Create a template group called "Templates/Databases". [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "templategroup.create", "params": { "name": "Templates/Databases" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "groupids": [ "107820" ] }, "id": 1 } ``` #### Veidņu grupas izveide Izveidojiet veidņu grupu ar nosaukumu "Templates/Databases". [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "templategroup.create", "params": { "name": "Templates/Databases" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "groupids": [ "107820" ] }, "id": 1 } ``` #### Creating a template To create a template, do the following: 1. Go to *Data collection* → *Templates*. 2. Click on *Create template*. 3. Edit template attributes. The **Template** tab contains general template attributes. {width="600"} All mandatory input fields are marked with a red asterisk. Template attributes: |Parameter|Description| |--|--------| |*Template name*|Unique template name.<br>Alphanumerics, spaces, dots, dashes, and underscores are allowed.<br>Leading and trailing spaces are not allowed.| |*Visible name*|If you set this name, it will be the one visible in lists, maps, etc.| |*Templates*|Link one or more templates to this template. All entities (items, triggers, etc.) will be inherited from the linked templates.<br>To link a new template, type its name in the *Templates* field—this will display a drop-down list of matching templates. Alternatively, click *Select* to open the *Templates* pop-up, which initially shows no templates. To populate the list, either type a template group name in the *Template group* field (and select one from the suggested list) or press the *Select* button next to the *Template group* field to open a *Template groups* pop-up. Once you choose a template group, the *Templates* pop-up is updated to show the templates belonging to that group. The selected templates will be linked when the configuration is saved or updated. <br>To unlink a template, use one of the two options in the *Templates* block:<br>*Unlink* - unlink the template, but preserve its entities (items, triggers, etc.);<br>*Unlink and clear* - unlink the template and remove all of its entities (items, triggers, etc.).| |*Template groups*|[Template groups](/manual/config/templates/template_groups) the template belongs to.| |*Description*|Template description.| |*Vendor and version*|Template vendor and version; displayed only when updating existing templates ([out-of-the-box templates](/manual/config/templates_out_of_the_box) provided by Zabbix, [imported templates](/manual/xml_export_import/templates#importing), or templates modified through the [Template API](/manual/api/reference/template)) if the template configuration contains such information.<br>Cannot be modified in Zabbix frontend.<br>For out-of-the-box templates, version is displayed as follows: major version of Zabbix, delimiter ("-"), revision number (increased with each new version of the template, and reset with each major version of Zabbix). For example, 6.4-0, 6.4-5, 7.0-0, 7.0-3.| The **Tags** tab allows you to define template-level [tags](/manual/config/tagging). All problems of hosts linked to this template will be tagged with the values entered here. {width="600"} User macros, {INVENTORY.\*} macros, {HOST.HOST}, {HOST.NAME}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {HOST.PORT} and {HOST.ID} macros are supported in tags. The **Macros** tab allows you to define template-level [user macros](/manual/config/macros/user_macros) as a name-value pairs. Note that macro values can be kept as plain text, secret text, or Vault secret. Adding a description is also supported. {width="600"} If you select the *Inherited and template macros* option, you may also view macros from linked templates and global macros that the template will inherit, as well as the values that the macros will resolve to. {width="600"} For convenience, links to the respective templates, as well as a link to global macro configuration is provided. It is also possible to edit a linked template macro or global macro on the template level, effectively creating a copy of the macro on the template. The **Value mapping** tab allows to configure human-friendly representation of item data in [value mappings](/manual/config/items/mapping). Buttons: | | | |--|--------| ||Add the template. The added template should appear in the list.| ||Update the properties of an existing template.| ||Create another template based on the properties of the current template. This **includes** the entities (items, triggers, etc.) both inherited from linked templates and directly attached to the current template, but **excludes** the current template's vendor and version for the cloned template to be distinguishable from the original.| ||Delete the template; entities of the template (items, triggers, etc.) remain with the linked hosts.| ||Delete the template and all its entities from linked hosts.| ||Cancel the editing of template properties.| #### Veidnes izveide Lai izveidotu veidni, rīkojieties šādi: 1. Dodieties uz *Data collection* → *Templates*. 2. Noklikšķiniet uz *Create template*. 3. Rediģējiet veidnes atribūtus. Cilnē **Template** ir ietverti vispārīgie veidnes atribūti. {width="600"} Visi obligātie ievades lauki ir atzīmēti ar sarkanu zvaigznīti. Veidnes atribūti: |Parameter|Description| |--|--------| |*Template name*|Unikāls veidnes nosaukums.<br>Atļauti ir burti un cipari, atstarpes, punkti, domuzīmes un pasvītras.<br>Vadošās un noslēdzošās atstarpes nav atļautas.| |*Visible name*|Ja iestatīsiet šo nosaukumu, tas būs redzams sarakstos, kartēs u. c.| |*Templates*|Saistiet ar šo veidni vienu vai vairākas veidnes. Visi objekti (vienumi, trigeri u. c.) tiks mantoti no saistītajām veidnēm.<br>Lai saistītu jaunu veidni, ievadiet tās nosaukumu laukā *Templates* — tiks parādīts atbilstošo veidņu nolaižamais saraksts. Varat arī noklikšķināt uz *Select*, lai atvērtu uznirstošo logu *Templates*, kurā sākotnēji nav nevienas veidnes. Lai aizpildītu sarakstu, laukā *Template group* ievadiet veidņu grupas nosaukumu (un izvēlieties vienu no ieteiktā saraksta) vai nospiediet pogu *Select* blakus laukam *Template group*, lai atvērtu uznirstošo logu *Template groups*. Kad būsiet izvēlējies veidņu grupu, uznirstošais logs *Templates* tiks atjaunināts un parādīs šai grupai piederošās veidnes. Atlasītās veidnes tiks saistītas, kad konfigurācija tiks saglabāta vai atjaunināta. <br>Lai atsaistītu veidni, izmantojiet vienu no divām opcijām blokā *Templates*:<br>*Unlink* - atsaistīt veidni, bet saglabāt tās objektus (vienumus, trigerus u. c.);<br>*Unlink and clear* - atsaistīt veidni un noņemt visus tās objektus (vienumus, trigerus u. c.).| |*Template groups*|[Template groups](/manual/config/templates/template_groups), pie kurām veidne pieder.| |*Description*|Veidnes apraksts.| |*Vendor and version*|Veidnes piegādātājs un versija; tiek rādīts tikai, atjauninot esošas veidnes ([standarta veidnes](/manual/config/templates_out_of_the_box), ko nodrošina Zabbix, [importētās veidnes](/manual/xml_export_import/templates#importing) vai veidnes, kas modificētas, izmantojot [Template API](/manual/api/reference/template)), ja veidnes konfigurācijā ir šāda informācija.<br>Nav modificējams Zabbix lietotāja saskarne.<br>Standarta veidnēm versija tiek rādīta šādi: Zabbix galvenā versija, atdalītājs ("-"), revīzijas numurs (palielinās ar katru jaunu veidnes versiju un tiek atiestatīts ar katru Zabbix galveno versiju). Piemēram, 6.4-0, 6.4-5, 7.0-0, 7.0-3.| Cilnē **Tags** var definēt veidnes līmeņa [tagus](/manual/config/tagging). Visas problēmas hosts, kas ir saistīti ar šo veidni, tiks atzīmētas ar šeit ievadītajām vērtībām. {width="600"} Tagos tiek atbalstīti lietotāja makrosi, {INVENTORY.\*} makrosi, {HOST.HOST}, {HOST.NAME}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {HOST.PORT} un {HOST.ID} makrosi. Cilnē **Macros** var definēt veidnes līmeņa [lietotāja makrosus](/manual/config/macros/user_macros) kā nosaukuma un vērtības pārus. Ņemiet vērā, ka makrosu vērtības var glabāt kā vienkāršu tekstu, slepenu tekstu vai Vault slepeno vērtību. Tiek atbalstīta arī apraksta pievienošana. {width="600"} Ja atlasāt opciju *Inherited and template macros*, varat arī skatīt makrosus no saistītajām veidnēm un globālos makrosus, ko veidne mantos, kā arī vērtības, uz kurām makrosi tiks atrisināti. {width="600"} Ērtībai ir pieejamas saites uz attiecīgajām veidnēm, kā arī saite uz globālo makrosu konfigurāciju. Ir iespējams arī rediģēt saistītās veidnes makrosu vai globālo makrosu veidnes līmenī, faktiski izveidojot makrosa kopiju veidnē. Cilnē **Value mapping** var konfigurēt cilvēkam saprotamu vienuma datu attēlojumu [vērtību kartējumos](/manual/config/items/mapping). Pogas: | | | |--|--------| ||Pievienot veidni. Pievienotajai veidnei vajadzētu parādīties sarakstā.| ||Atjaunināt esošas veidnes īpašības.| ||Izveidot citu veidni, pamatojoties uz pašreizējās veidnes īpašībām. Tas **ietver** gan no saistītajām veidnēm mantotos objektus (vienumus, trigerus u. c.), gan tos, kas tieši pievienoti pašreizējai veidnei, bet **neietver** pašreizējās veidnes piegādātāju un versiju, lai klonētā veidne būtu atšķirama no oriģināla.| ||Dzēst veidni; veidnes objekti (vienumi, trigeri u. c.) paliek saistītajos hosts.| ||Dzēst veidni un visus tās objektus no saistītajiem hosts.| ||Atcelt veidnes īpašību rediģēšanu.| #### Creating a trigger Create two triggers, each depending on one other trigger. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "trigger.create", "params": [ { "description": "Processor load is too high on {HOST.NAME}", "expression": "last(/Linux server/system.cpu.load[percpu,avg1])>5", "dependencies": [ { "triggerid": "17367" } ] }, { "description": "Service has stopped", "expression": "length(last(/Linux server/log[/var/log/system,Service .* has stopped]))<>0", "dependencies": [ { "triggerid": "17368" } ], "tags": [ { "tag": "service", "value": "{{ITEM.VALUE}.regsub(\"Service (.*) has stopped\", \"\\1\")}" }, { "tag": "error", "value": "" } ] } ], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "17369", "17370" ] }, "id": 1 } ``` #### Trigera izveide Izveidojiet divus trigerus, no kuriem katrs ir atkarīgs no viena cita trigera. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "trigger.create", "params": [ { "description": "Procesora slodze ir pārāk augsta uz {HOST.NAME}", "expression": "last(/Linux server/system.cpu.load[percpu,avg1])>5", "dependencies": [ { "triggerid": "17367" } ] }, { "description": "Pakalpojums ir apstājies", "expression": "length(last(/Linux server/log[/var/log/system,Service .* has stopped]))<>0", "dependencies": [ { "triggerid": "17368" } ], "tags": [ { "tag": "service", "value": "{{ITEM.VALUE}.regsub(\"Service (.*) has stopped\", \"\\1\")}" }, { "tag": "error", "value": "" } ] } ], "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "17369", "17370" ] }, "id": 1 } ``` #### Creating a trigger prototype Create a trigger prototype to detect when a file system has less than 20% free disk space. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "triggerprototype.create", "params": { "description": "Free disk space is less than 20% on volume {#FSNAME}", "expression": "last(/Zabbix server/vfs.fs.size[{#FSNAME},pfree])<20", "tags": [ { "tag": "volume", "value": "{#FSNAME}" }, { "tag": "type", "value": "{#FSTYPE}" } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "17372" ] }, "id": 1 } ``` #### Trigera prototipa izveide Izveidojiet trigera prototipu, lai noteiktu, kad failu sistēmā ir mazāk nekā 20% brīvas diska vietas. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "triggerprototype.create", "params": { "description": "Brīvā diska vieta ir mazāka par 20% sējumā {#FSNAME}", "expression": "last(/Zabbix server/vfs.fs.size[{#FSNAME},pfree])<20", "tags": [ { "tag": "volume", "value": "{#FSNAME}" }, { "tag": "type", "value": "{#FSTYPE}" } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "17372" ] }, "id": 1 } ``` #### Creating a user Create a new user, add him to a user group and create a new media for him. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "user.create", "params": { "username": "John", "passwd": "Doe123", "roleid": "5", "usrgrps": [ { "usrgrpid": "7" } ], "medias": [ { "mediatypeid": "1", "sendto": [ "support@company.com" ], "active": 0, "severity": 63, "period": "1-7,00:00-24:00" } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "userids": [ "12" ] }, "id": 1 } ``` #### Lietotāja izveide Izveidojiet jaunu lietotāju, pievienojiet viņu lietotāju grupai un izveidojiet viņam jaunu mediju. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "user.create", "params": { "username": "John", "passwd": "Doe123", "roleid": "5", "usrgrps": [ { "usrgrpid": "7" } ], "medias": [ { "mediatypeid": "1", "sendto": [ "support@company.com" ], "active": 0, "severity": 63, "period": "1-7,00:00-24:00" } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "userids": [ "12" ] }, "id": 1 } ``` ##### Creating a user directory Create a user directory to authenticate users with StartTLS over LDAP. Note that to authenticate users over LDAP, [LDAP authentication](/manual/api/reference/authentication/object#authentication-object) must be enabled. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "userdirectory.create", "params": { "idp_type": "1", "name": "LDAP API server #1", "host": "ldap://local.ldap", "port": "389", "base_dn": "ou=Users,dc=example,dc=org", "bind_dn": "cn=ldap_search,dc=example,dc=org", "bind_password": "ldapsecretpassword", "search_attribute": "uid", "start_tls": "1" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "userdirectoryids": [ "3" ] }, "id": 1 } ``` ##### Lietotāju direktorija izveide Izveidojiet lietotāju direktoriju, lai autentificētu lietotājus ar StartTLS, izmantojot LDAP. Ņemiet vērā, ka, lai autentificētu lietotājus, izmantojot LDAP, jābūt iespējotai [LDAP autentifikācijai](/manual/api/reference/authentication/object#authentication-object). [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "userdirectory.create", "params": { "idp_type": "1", "name": "LDAP API server #1", "host": "ldap://local.ldap", "port": "389", "base_dn": "ou=Users,dc=example,dc=org", "bind_dn": "cn=ldap_search,dc=example,dc=org", "bind_password": "ldapsecretpassword", "search_attribute": "uid", "start_tls": "1" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "userdirectoryids": [ "3" ] }, "id": 1 } ``` ##### Creating a user directory (JIT provisioning enabled) Create a user directory to authenticate users over LDAP (with JIT provisioning enabled). Note that to authenticate users over LDAP, [LDAP authentication](/manual/api/reference/authentication/object#authentication-object) must be enabled. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "userdirectory.create", "params": { "idp_type": "1", "name": "AD server", "provision_status": "1", "description": "", "host": "host.example.com", "port": "389", "base_dn": "DC=zbx,DC=local", "search_attribute": "sAMAccountName", "bind_dn": "CN=Admin,OU=Users,OU=Zabbix,DC=zbx,DC=local", "start_tls": "0", "search_filter": "", "group_basedn": "OU=Zabbix,DC=zbx,DC=local", "group_name": "CN", "group_member": "member", "group_filter": "(%{groupattr}=CN=%{ref},OU=Users,OU=Zabbix,DC=zbx,DC=local)", "group_membership": "", "user_username": "givenName", "user_lastname": "sn", "user_ref_attr": "CN", "provision_media": [ { "name": "example.com", "mediatypeid": "1", "attribute": "user@example.com" } ], "provision_groups": [ { "name": "*", "roleid": "4", "user_groups": [ { "usrgrpid": "8" } ] }, { "name": "Zabbix administrators", "roleid": "2", "user_groups": [ { "usrgrpid": "7" }, { "usrgrpid": "8" } ] } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "userdirectoryids": [ "2" ] }, "id": 1 } ``` ##### Lietotāju direktorija izveide (JIT nodrošināšana iespējota) Izveidojiet lietotāju direktoriju, lai autentificētu lietotājus, izmantojot LDAP (ar iespējotu JIT nodrošināšanu). Ņemiet vērā, ka, lai autentificētu lietotājus, izmantojot LDAP, jābūt iespējotai [LDAP autentifikācijai](/manual/api/reference/authentication/object#authentication-object). [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "userdirectory.create", "params": { "idp_type": "1", "name": "AD server", "provision_status": "1", "description": "", "host": "host.example.com", "port": "389", "base_dn": "DC=zbx,DC=local", "search_attribute": "sAMAccountName", "bind_dn": "CN=Admin,OU=Users,OU=Zabbix,DC=zbx,DC=local", "start_tls": "0", "search_filter": "", "group_basedn": "OU=Zabbix,DC=zbx,DC=local", "group_name": "CN", "group_member": "member", "group_filter": "(%{groupattr}=CN=%{ref},OU=Users,OU=Zabbix,DC=zbx,DC=local)", "group_membership": "", "user_username": "givenName", "user_lastname": "sn", "user_ref_attr": "CN", "provision_media": [ { "name": "example.com", "mediatypeid": "1", "attribute": "user@example.com" } ], "provision_groups": [ { "name": "*", "roleid": "4", "user_groups": [ { "usrgrpid": "8" } ] }, { "name": "Zabbix administrators", "roleid": "2", "user_groups": [ { "usrgrpid": "7" }, { "usrgrpid": "8" } ] } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "userdirectoryids": [ "2" ] }, "id": 1 } ``` #### Creating a user group Create a user group *Operation managers* with denied access to host group "2", and add a user to it. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "usergroup.create", "params": { "name": "Operation managers", "hostgroup_rights": { "id": "2", "permission": 0 }, "users": [ { "userid": "12" } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "usrgrpids": [ "20" ] }, "id": 1 } ``` #### Lietotāju grupas izveide Izveidojiet lietotāju grupu *Operation managers* ar liegtu piekļuvi hostu grupai "2" un pievienojiet tai lietotāju. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "usergroup.create", "params": { "name": "Operation managers", "hostgroup_rights": { "id": "2", "permission": 0 }, "users": [ { "userid": "12" } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "usrgrpids": [ "20" ] }, "id": 1 } ``` #### Creating a value map Create one value map with two mappings. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "valuemap.create", "params": { "hostid": "50009", "name": "Service state", "mappings": [ { "type": "1", "value": "1", "newvalue": "Up" }, { "type": "5", "newvalue": "Down" } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "valuemapids": [ "1" ] }, "id": 1 } ``` #### Vērtību kartes izveide Izveidojiet vienu vērtību karti ar divām atbilstībām. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "valuemap.create", "params": { "hostid": "50009", "name": "Pakalpojuma stāvoklis", "mappings": [ { "type": "1", "value": "1", "newvalue": "Darbojas" }, { "type": "5", "newvalue": "Nedarbojas" } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "valuemapids": [ "1" ] }, "id": 1 } ``` #### Creating a webhook media type Create a new webhook media type. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "mediatype.create", "params": { "type": "4", "name": "Webhook", "script": "var Webhook = {\r\n token: null,\r\n to: null,\r\n subject: null,\r\n message: null,\r\n\r\n sendMessage: function() {\r\n // some logic\r\n }\r\n}", "parameters": [ { "name": "Message", "value": "{ALERT.MESSAGE}" }, { "name": "Subject", "value": "{ALERT.SUBJECT}" }, { "name": "To", "value": "{ALERT.SENDTO}" }, { "name": "Token", "value": "<Token>" } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "mediatypeids": [ "9" ] }, "id": 1 } ``` #### Webhook paziņojumu veida izveide Izveidojiet jaunu webhook paziņojumu veidu. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "mediatype.create", "params": { "type": "4", "name": "Webhook", "script": "var Webhook = {\r\n token: null,\r\n to: null,\r\n subject: null,\r\n message: null,\r\n\r\n sendMessage: function() {\r\n // some logic\r\n }\r\n}", "parameters": [ { "name": "Message", "value": "{ALERT.MESSAGE}" }, { "name": "Subject", "value": "{ALERT.SUBJECT}" }, { "name": "To", "value": "{ALERT.SENDTO}" }, { "name": "Token", "value": "<Token>" } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "mediatypeids": [ "9" ] }, "id": 1 } ``` #### Creating a web scenario Create a web scenario to monitor the company home page. The scenario will have two steps, to check the home page and the "About" page and make sure they return the HTTP status code 200. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "httptest.create", "params": { "name": "Homepage check", "hostid": "10085", "steps": [ { "name": "Homepage", "url": "http://example.com", "status_codes": "200", "no": 1 }, { "name": "Homepage / About", "url": "http://example.com/about", "status_codes": "200", "no": 2 } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "httptestids": [ "5" ] }, "id": 1 } ``` #### Tīmekļa scenārija izveide Izveidojiet tīmekļa scenāriju, lai uzraudzītu uzņēmuma mājaslapu. Scenārijam būs divi soļi, lai pārbaudītu sākumlapu un lapu "Par mums", kā arī pārliecinātos, ka tās atgriež HTTP statusa kodu 200. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "httptest.create", "params": { "name": "Homepage check", "hostid": "10085", "steps": [ { "name": "Homepage", "url": "http://example.com", "status_codes": "200", "no": 1 }, { "name": "Homepage / About", "url": "http://example.com/about", "status_codes": "200", "no": 2 } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "httptestids": [ "5" ] }, "id": 1 } ``` #### Creating dependent item Create a dependent item for the master item with ID 24759. Only dependencies on the same host are allowed, therefore master and the dependent item should have the same hostid. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "item.create", "params": { "hostid": "30074", "name": "Dependent test item", "key_": "dependent.item", "type": 18, "master_itemid": "24759", "value_type": 2 }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "44211" ] }, "id": 1 } ``` #### Atkarīgā vienuma izveide Izveidojiet atkarīgo vienumu galvenajam vienumam ar ID 24759. Ir atļautas tikai atkarības uz tā paša hosta, tādēļ galvenajam un atkarīgajam vienumam jābūt ar vienādu hostid. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "item.create", "params": { "hostid": "30074", "name": "Dependent test item", "key_": "dependent.item", "type": 18, "master_itemid": "24759", "value_type": 2 }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "44211" ] }, "id": 1 } ``` #### Creating dependent item prototype Create Dependent item prototype for Master item prototype with ID 44211. Only dependencies on same host (template/discovery rule) are allowed, therefore Master and Dependent item should have same hostid and ruleid. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "itemprototype.create", "params": { "hostid": "10001", "ruleid": "27665", "name": "Dependent test item prototype", "key_": "dependent.prototype", "type": 18, "master_itemid": "44211", "value_type": 3 }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "44212" ] }, "id": 1 } ``` #### Atkarīgā vienuma prototipa izveide Izveidojiet atkarīgā vienuma prototipu galvenā vienuma prototipam ar ID 44211. Ir atļautas tikai atkarības uz tā paša hosta (veidnes/atklāšanas kārtulas), tādēļ galvenajam un atkarīgajam vienumam jābūt vienādam hostid un ruleid. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "itemprototype.create", "params": { "hostid": "10001", "ruleid": "27665", "name": "Dependent test item prototype", "key_": "dependent.prototype", "type": 18, "master_itemid": "44211", "value_type": 3 }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "44212" ] }, "id": 1 } ``` #### Creating host subgroups A host subgroup (or nested host group) is a child of the parent host group that contains it. A subgroup is created by using the forward slash '/' in the group name input field to denote its relation to the parent group(s). For example: - inputting `Europe/Latvia` creates the `Europe/Latvia` subgroup of the parent group `Europe`. - inputting `Europe/Latvia/Riga/Zabbix servers` creates the respective subgroup within the nested parent groups `Europe`, `Europe/Latvia`, `Europe/Latvia/Riga`. When creating a subgroup, using leading or trailing slashes, or several slashes in a row is not allowed. Escaping of '/' is not supported. It is not required to create any parent host group(s) before creating a subgroup. You can choose whether to start by creating a subgroup (for example, `Europe/Latvia`) or any parent host group(s) (in our example, `Europe`). If you start by creating a subgroup, parent host group(s) will **not** be created automatically. #### Hosts apakšgrupu izveide Hosts apakšgrupa (vai ligzdota hosts grupa) ir tās vecākas hosts grupas bērnelements, kurā tā atrodas. Apakšgrupa tiek izveidota, grupas nosaukuma ievades laukā izmantojot slīpsvītru '/' , lai norādītu tās saistību ar vecāko grupu(-ām). Piemēram: - ievadot `Europe/Latvia`, tiek izveidota `Europe/Latvia` apakšgrupa vecākajai grupai `Europe`. - ievadot `Europe/Latvia/Riga/Zabbix servers`, tiek izveidota attiecīgā apakšgrupa ligzdotajās vecākajās grupās `Europe`, `Europe/Latvia`, `Europe/Latvia/Riga`. Veidojot apakšgrupu, nav atļauts izmantot sākuma vai beigu slīpsvītras, kā arī vairākas slīpsvītras pēc kārtas. '/' atsoļošana netiek atbalstīta. Pirms apakšgrupas izveides nav obligāti jāizveido neviena vecākā hosts grupa(-as). Varat izvēlēties, vai sākt ar apakšgrupas izveidi (piemēram, `Europe/Latvia`) vai ar jebkuru vecāko hosts grupu(-ām) (mūsu piemērā `Europe`). Ja sākat ar apakšgrupas izveidi, vecākā hosts grupa(-as) **netiks** izveidota(-as) automātiski. #### Creating interfaces Create an interface on two hosts. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "hostinterface.massadd", "params": { "hosts": [ { "hostid": "30050" }, { "hostid": "30052" } ], "interfaces": { "dns": "", "ip": "127.0.0.1", "main": 0, "port": "10050", "type": 1, "useip": 1 } }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "interfaceids": [ "30069", "30070" ] }, "id": 1 } ``` #### Saskarņu izveide Izveidojiet saskarni divos hostos. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "hostinterface.massadd", "params": { "hosts": [ { "hostid": "30050" }, { "hostid": "30052" } ], "interfaces": { "dns": "", "ip": "127.0.0.1", "main": 0, "port": "10050", "type": 1, "useip": 1 } }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "interfaceids": [ "30069", "30070" ] }, "id": 1 } ``` #### Creating MFA methods Create a "Zabbix TOTP" MFA method utilizing time-based one-time passwords (TOTP), with the hash function for generating TOTP codes set to SHA-1 and the verification code length set to 6 digits. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "mfa.create", "params": { "type": 1, "name": "Zabbix TOTP", "hash_function": 1, "code_length": 6 }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "mfaids": [ "1" ] }, "id": 1 } ``` #### MFA metožu izveide Izveidojiet "Zabbix TOTP" MFA metodi, izmantojot uz laiku balstītas vienreizējās paroles (TOTP), kur TOTP kodu ģenerēšanas jaucējfunkcija ir iestatīta uz SHA-1 un verifikācijas koda garums ir iestatīts uz 6 cipariem. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "mfa.create", "params": { "type": 1, "name": "Zabbix TOTP", "hash_function": 1, "code_length": 6 }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "mfaids": [ "1" ] }, "id": 1 } ``` #### Creating multiple triggers Thus, if *create methods* accept arrays, you can add multiple [triggers](/manual/api/reference/trigger/object), for example, this one: ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \ --header 'Content-Type: application/json-rpc' \ --data '{"jsonrpc":"2.0","method":"trigger.create","params":[{"description":"Processor load is too high on {HOST.NAME}","expression":"last(/Linux server/system.cpu.load[percpu,avg1])>5"},{"description":"Too many processes on {HOST.NAME}","expression":"avg(/Linux server/proc.num[],5m)>300"}],"id":4}' ``` The successful response will contain the IDs of the newly created triggers: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "17369", "17370" ] }, "id": 4 } ``` #### Vairāku trigeru izveide Tādējādi, ja *izveides metodes* pieņem masīvus, varat pievienot vairākus [trigerus](/manual/api/reference/trigger/object), piemēram, šo: ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \ --header 'Content-Type: application/json-rpc' \ --data '{"jsonrpc":"2.0","method":"trigger.create","params":[{"description":"Processor load is too high on {HOST.NAME}","expression":"last(/Linux server/system.cpu.load[percpu,avg1])>5"},{"description":"Too many processes on {HOST.NAME}","expression":"avg(/Linux server/proc.num[],5m)>300"}],"id":4}' ``` Veiksmīga atbilde saturēs jaunizveidoto trigeru ID: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "17369", "17370" ] }, "id": 4 } ``` #### Creating template subgroups A template subgroup (or nested template group) is a child of the parent template group that contains it. A subgroup is created by using the forward slash '/' in the group name input field to denote its relation to the parent group(s). For example: - inputting `Linux servers/Databases` creates the `Linux servers/Databases` subgroup of the parent group `Linux servers`. - inputting `Linux servers/Databases/MySQL/Tokyo` creates the respective subgroup within the nested parent groups `Linux servers`, `Linux servers/Databases`, `Linux servers/Databases/MySQL`. When creating a subgroup, using leading or trailing slashes, or several slashes in a row is not allowed. Escaping of '/' is not supported. It is not required to create any parent template group(s) before creating a subgroup. You can choose whether to start by creating a subgroup (for example, `Linux servers/Databases`) or any parent template group(s) (in our example, `Linux servers`). If you start by creating a subgroup, parent template group(s) will **not** be created automatically. #### Veidņu apakšgrupu izveide Veidnes apakšgrupa (vai ligzdota veidņu grupa) ir tās vecākgrupas bērnelementa grupa, kurā tā ietilpst. Apakšgrupa tiek izveidota, grupas nosaukuma ievades laukā izmantojot slīpsvītru '/' lai norādītu tās saistību ar vecākgrupu(-ām). Piemēram: - ievadot `Linux servers/Databases`, tiek izveidota `Linux servers/Databases` apakšgrupa vecākgrupai `Linux servers`. - ievadot `Linux servers/Databases/MySQL/Tokyo`, tiek izveidota attiecīgā apakšgrupa ligzdotajās vecākgrupās `Linux servers`, `Linux servers/Databases`, `Linux servers/Databases/MySQL`. Veidojot apakšgrupu, nav atļauts izmantot sākuma vai beigu slīpsvītras, kā arī vairākas slīpsvītras pēc kārtas. '/' aizstāšana netiek atbalstīta. Pirms apakšgrupas izveides nav obligāti jāizveido neviena vecākveidņu grupa(-as). Jūs varat izvēlēties, vai sākt ar apakšgrupas izveidi (piemēram, `Linux servers/Databases`) vai ar jebkuru vecākveidņu grupu(-ām) (mūsu piemērā — `Linux servers`). Ja sākat ar apakšgrupas izveidi, vecākveidņu grupa(-as) **netiks** izveidota(-as) automātiski. ##### Credentials (login:password) System: - root:zabbix Zabbix frontend: - Admin:zabbix Database: - root:<random> - zabbix:<random> ::: noteclassic Database passwords are randomly generated during the installation process.<br> Root password is stored inside the /root/.my.cnf file. It is not required to input a password under the "root" account. ::: To change the database user password, changes have to be made in the following locations: - MySQL; - /etc/zabbix/zabbix\_server.conf; - /etc/zabbix/web/zabbix.conf.php. ::: noteclassic Separate users `zabbix_srv` and `zabbix_web` are defined for the server and the frontend respectively. ::: ##### Akreditācijas dati (login:password) Sistēma: - root:zabbix Zabbix lietotāja saskarne: - Admin:zabbix Datubāze: - root:<random> - zabbix:<random> ::: noteclassic Datubāzes paroles instalēšanas procesa laikā tiek ģenerētas nejauši.<br> Root parole tiek glabāta failā /root/.my.cnf. Nav nepieciešams ievadīt paroli kontam "root". ::: Lai mainītu datubāzes lietotāja paroli, izmaiņas jāveic šādās vietās: - MySQL; - /etc/zabbix/zabbix\_server.conf; - /etc/zabbix/web/zabbix.conf.php. ::: noteclassic Serverim un lietotāja saskarnei attiecīgi ir definēti atsevišķi lietotāji `zabbix_srv` un `zabbix_web`. ::: #### CRL expired or expires during server operation [*OpenSSL*]{.underline}, in server log: - before expiration: ```{=html} <!-- --> ``` cannot connect to proxy "proxy-openssl-1.0.1e": TCP successful, cannot establish TLS to [[127.0.0.1]:20004]:\ SSL_connect() returned SSL_ERROR_SSL: file s3_clnt.c line 1253: error:14090086:\ SSL routines:ssl3_get_server_certificate:certificate verify failed:\ TLS write fatal alert "certificate revoked" - after expiration: ```{=html} <!-- --> ``` cannot connect to proxy "proxy-openssl-1.0.1e": TCP successful, cannot establish TLS to [[127.0.0.1]:20004]:\ SSL_connect() returned SSL_ERROR_SSL: file s3_clnt.c line 1253: error:14090086:\ SSL routines:ssl3_get_server_certificate:certificate verify failed:\ TLS write fatal alert "certificate expired" The point here is that with valid CRL a revoked certificate is reported as "certificate revoked". When CRL expires the error message changes to "certificate expired" which is quite misleading. [*GnuTLS*]{.underline}, in server log: - before and after expiration the same: ```{=html} <!-- --> ``` cannot connect to proxy "proxy-openssl-1.0.1e": TCP successful, cannot establish TLS to [[127.0.0.1]:20004]:\ invalid peer certificate: The certificate is NOT trusted. The certificate chain is revoked. #### CRL derīguma termiņš ir beidzies vai tas beidzas servera darbības laikā [*OpenSSL*]{.underline}, servera žurnālā: - pirms derīguma termiņa beigām: ```{=html} <!-- --> ``` cannot connect to proxy "proxy-openssl-1.0.1e": TCP successful, cannot establish TLS to [[127.0.0.1]:20004]:\ SSL_connect() returned SSL_ERROR_SSL: file s3_clnt.c line 1253: error:14090086:\ SSL routines:ssl3_get_server_certificate:certificate verify failed:\ TLS write fatal alert "certificate revoked" - pēc derīguma termiņa beigām: ```{=html} <!-- --> ``` cannot connect to proxy "proxy-openssl-1.0.1e": TCP successful, cannot establish TLS to [[127.0.0.1]:20004]:\ SSL_connect() returned SSL_ERROR_SSL: file s3_clnt.c line 1253: error:14090086:\ SSL routines:ssl3_get_server_certificate:certificate verify failed:\ TLS write fatal alert "certificate expired" Būtība ir tāda, ka ar derīgu CRL atsaukts sertifikāts tiek ziņots kā "certificate revoked". Kad CRL derīguma termiņš beidzas, kļūdas ziņojums mainās uz "certificate expired", kas ir diezgan maldinoši. [*GnuTLS*]{.underline}, servera žurnālā: - pirms un pēc derīguma termiņa beigām tas pats: ```{=html} <!-- --> ``` cannot connect to proxy "proxy-openssl-1.0.1e": TCP successful, cannot establish TLS to [[127.0.0.1]:20004]:\ invalid peer certificate: The certificate is NOT trusted. The certificate chain is revoked. ##### CSS styles CSS files may contain a custom attribute `theme` to define different style for a specific frontend themes. Available themes and their attribute values: - **Blue** - [theme='blue-theme'] - **Dark** - [theme='dark-theme'] - **High-contrast light** - [theme='hc-light'] - **High-contrast dark** - [theme='hc-dark'] Example: ```css .widget { background-color: red; } [theme='dark-theme'] .widget { background-color: green; } ``` ##### CSS stili CSS faili var saturēt pielāgotu atribūtu `theme`, lai definētu atšķirīgu stilu konkrētai lietotāja saskarnei tēmai. Pieejamās tēmas un to atribūtu vērtības: - **Blue** - [theme='blue-theme'] - **Dark** - [theme='dark-theme'] - **High-contrast light** - [theme='hc-light'] - **High-contrast dark** - [theme='hc-dark'] Piemērs: ```css .widget { background-color: red; } [theme='dark-theme'] .widget { background-color: green; } ``` ##### CSV to JSON {#csvtojson} Convert CSV file data into JSON format. For more information, see: [CSV to JSON preprocessing](/manual/config/items/preprocessing/csv_to_json#csv-header-processing). ##### CSV uz JSON {#csvtojson} Pārveidojiet CSV faila datus JSON formātā. Papildinformāciju skatiet: [CSV uz JSON priekšapstrāde](/manual/config/items/preprocessing/csv_to_json#csv-header-processing). ##### Current distributions Sensor readings are obtained from `/sys/class/hwmon` directory: - **device** - device name (non-regular expression). The device name could be the actual name of the device (e.g `0000:00:18.3`) or the name acquired using sensors program (e.g. `k8temp-pci-00c3`). It is up to the user to choose which name to use. - **sensor** - sensor name (non-regular expression). - **mode** - possible values: `avg`, `max`, `min` (if this parameter is omitted, device and sensor are treated verbatim). Example keys: `sensor[k8temp-pci-00c3,temp,max]` or `sensor[0000:00:18.3,temp1]`. `sensor[smsc47b397-isa-0880,in,avg]` or `sensor[smsc47b397.2176,in1]`. ##### Pašreizējās distribūcijas Sensora rādījumi tiek iegūti no direktorija `/sys/class/hwmon`: - **device** - ierīces nosaukums (neregulārā izteiksme). Ierīces nosaukums var būt faktiskais ierīces nosaukums (piemēram, `0000:00:18.3`) vai nosaukums, kas iegūts, izmantojot programmu sensors (piemēram, `k8temp-pci-00c3`). Lietotājs pats izvēlas, kuru nosaukumu izmantot. - **sensor** - sensora nosaukums (neregulārā izteiksme). - **mode** - iespējamās vērtības: `avg`, `max`, `min` (ja šis parametrs ir izlaists, device un sensor tiek apstrādāti burtiski). Atslēgu piemēri: `sensor[k8temp-pci-00c3,temp,max]` vai `sensor[0000:00:18.3,temp1]`. `sensor[smsc47b397-isa-0880,in,avg]` vai `sensor[smsc47b397.2176,in1]`. ### Custom interface Custom interfaces are supported if `custom_interfaces` of [Host prototype object](#host-prototype) is set to "use host prototypes custom interfaces". The custom interface object has the following properties. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |type|integer|Interface type.<br><br>Possible values:<br>1 - Agent;<br>2 - SNMP;<br>3 - IPMI;<br>4 - JMX.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |useip|integer|Whether the connection should be made via IP.<br><br>Possible values:<br>0 - connect using host DNS name;<br>1 - connect using host IP address.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |ip|string|IP address used by the interface.<br>Can contain macros.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `useip` is set to "connect using host IP address"| |dns|string|DNS name used by the interface.<br>Can contain macros.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `useip` is set to "connect using host DNS name"| |port|string|Port number used by the interface.<br>Can contain user and LLD macros.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |main|integer|Whether the interface is used as default on the host.<br>Only one interface of some type can be set as default on a host.<br><br>Possible values:<br>0 - not default;<br>1 - default.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |details|object|Additional object for [custom interface details](#custom-interface-details).<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "SNMP"| ### Pielāgota saskarne Pielāgotas saskarnes tiek atbalstītas, ja [Host prototype object](#host-prototype) parametrs `custom_interfaces` ir iestatīts uz "izmantot hostu prototipu pielāgotās saskarnes". Pielāgotās saskarnes objektam ir šādas īpašības. |Īpašība|[Type](/manual/api/reference_commentary#data-types)|Apraksts| |--|--|------| |type|integer|Saskarnes tips.<br><br>Iespējamās vērtības:<br>1 - Aģents;<br>2 - SNMP;<br>3 - IPMI;<br>4 - JMX.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |useip|integer|Vai savienojums jāveido, izmantojot IP.<br><br>Iespējamās vērtības:<br>0 - savienoties, izmantojot hosta DNS nosaukumu;<br>1 - savienoties, izmantojot hosta IP adresi.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |ip|string|Saskarnes izmantotā IP adrese.<br>Var saturēt makrosus.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* ja `useip` ir iestatīts uz "savienoties, izmantojot hosta IP adresi"| |dns|string|Saskarnes izmantotais DNS nosaukums.<br>Var saturēt makrosus.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* ja `useip` ir iestatīts uz "savienoties, izmantojot hosta DNS nosaukumu"| |port|string|Saskarnes izmantotais porta numurs.<br>Var saturēt lietotāja un LLD makrosus.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |main|integer|Vai saskarne tiek izmantota kā noklusējuma saskarne hostā.<br>Hostā tikai viena noteikta tipa saskarne var būt iestatīta kā noklusējuma saskarne.<br><br>Iespējamās vērtības:<br>0 - nav noklusējuma;<br>1 - noklusējuma.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |details|object|Papildu objekts [pielāgotās saskarnes informācijai](#custom-interface-details).<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* ja `type` ir iestatīts uz "SNMP"| #### Custom interface details The details object has the following properties. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |version|integer|SNMP interface version.<br><br>Possible values:<br>1 - SNMPv1;<br>2 - SNMPv2c;<br>3 - SNMPv3.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |bulk|integer|Whether to use bulk SNMP requests.<br><br>Possible values:<br>0 - don't use bulk requests;<br>1 - *(default)* - use bulk requests.| |community|string|SNMP community.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `version` is set to "SNMPv1" or "SNMPv2c"| |max_repetitions|integer|Max repetition value for [native SNMP bulk requests](#native-snmp-bulk-requests) (GetBulkRequest-PDUs).<br>Used only for `discovery[]` and `walk[]` items in SNMPv2 and v3.<br><br>Default: 10.| |securityname|string|SNMPv3 security name.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `version` is set to "SNMPv3"| |securitylevel|integer|SNMPv3 security level.<br><br>Possible values:<br>0 - *(default)* - noAuthNoPriv;<br>1 - authNoPriv;<br>2 - authPriv.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `version` is set to "SNMPv3"| |authpassphrase|string|SNMPv3 authentication passphrase.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `version` is set to "SNMPv3" and `securitylevel` is set to "authNoPriv" or "authPriv"| |privpassphrase|string|SNMPv3 privacy passphrase.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `version` is set to "SNMPv3" and `securitylevel` is set to "authPriv"| |authprotocol|integer|SNMPv3 authentication protocol.<br><br>Possible values:<br>0 - *(default)* - MD5;<br>1 - SHA1;<br>2 - SHA224;<br>3 - SHA256;<br>4 - SHA384;<br>5 - SHA512.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `version` is set to "SNMPv3" and `securitylevel` is set to "authNoPriv" or "authPriv"| |privprotocol|integer|SNMPv3 privacy protocol. Used only by SNMPv3 interfaces.<br><br>Possible values:<br>0 - *(default)* - DES;<br>1 - AES128;<br>2 - AES192;<br>3 - AES256;<br>4 - AES192C;<br>5 - AES256C.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `version` is set to "SNMPv3" and `securitylevel` is set to "authPriv"| |contextname|string|SNMPv3 context name.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `version` is set to "SNMPv3"| #### Pielāgotās saskarnes informācija Objektam details ir šādas īpašības. |Īpašība|[Tips](/manual/api/reference_commentary#data-types)|Apraksts| |--|--|------| |version|integer|SNMP saskarnes versija.<br><br>Iespējamās vērtības:<br>1 - SNMPv1;<br>2 - SNMPv2c;<br>3 - SNMPv3.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāta*| |bulk|integer|Vai izmantot SNMP lielapjoma pieprasījumus.<br><br>Iespējamās vērtības:<br>0 - neizmantot lielapjoma pieprasījumus;<br>1 - *(noklusējums)* - izmantot lielapjoma pieprasījumus.| |community|string|SNMP kopiena.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāta*, ja `version` ir iestatīts uz "SNMPv1" vai "SNMPv2c"| |max_repetitions|integer|Maksimālā atkārtojumu vērtība [vietējiem SNMP lielapjoma pieprasījumiem](#native-snmp-bulk-requests) (GetBulkRequest-PDUs).<br>Izmanto tikai `discovery[]` un `walk[]` vienumiem SNMPv2 un v3.<br><br>Noklusējums: 10.| |securityname|string|SNMPv3 drošības nosaukums.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *atbalstīta*, ja `version` ir iestatīts uz "SNMPv3"| |securitylevel|integer|SNMPv3 drošības līmenis.<br><br>Iespējamās vērtības:<br>0 - *(noklusējums)* - noAuthNoPriv;<br>1 - authNoPriv;<br>2 - authPriv.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *atbalstīta*, ja `version` ir iestatīts uz "SNMPv3"| |authpassphrase|string|SNMPv3 autentifikācijas parole.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *atbalstīta*, ja `version` ir iestatīts uz "SNMPv3" un `securitylevel` ir iestatīts uz "authNoPriv" vai "authPriv"| |privpassphrase|string|SNMPv3 privātuma parole.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *atbalstīta*, ja `version` ir iestatīts uz "SNMPv3" un `securitylevel` ir iestatīts uz "authPriv"| |authprotocol|integer|SNMPv3 autentifikācijas protokols.<br><br>Iespējamās vērtības:<br>0 - *(noklusējums)* - MD5;<br>1 - SHA1;<br>2 - SHA224;<br>3 - SHA256;<br>4 - SHA384;<br>5 - SHA512.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *atbalstīta*, ja `version` ir iestatīts uz "SNMPv3" un `securitylevel` ir iestatīts uz "authNoPriv" vai "authPriv"| |privprotocol|integer|SNMPv3 privātuma protokols. Izmanto tikai SNMPv3 saskarnes.<br><br>Iespējamās vērtības:<br>0 - *(noklusējums)* - DES;<br>1 - AES128;<br>2 - AES192;<br>3 - AES256;<br>4 - AES192C;<br>5 - AES256C.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *atbalstīta*, ja `version` ir iestatīts uz "SNMPv3" un `securitylevel` ir iestatīts uz "authPriv"| |contextname|string|SNMPv3 konteksta nosaukums.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *atbalstīta*, ja `version` ir iestatīts uz "SNMPv3"| #### Custom macros The **LLD macros** tab allows to specify custom low-level discovery macros. Custom macros are useful in cases when the returned JSON does not have the required macros already defined. So, for example: - The native `vfs.fs.discovery` key for filesystem discovery returns a JSON with some pre-defined LLD macros such as `{#FSNAME}`, `{#FSTYPE}`. These macros can be used in item, trigger prototypes (see subsequent sections of the page) directly; defining custom macros is not needed; - The `vfs.fs.get` agent item also returns a JSON with [filesystem data](/manual/discovery/low_level_discovery/examples/mounted_filesystems), but without any pre-defined LLD macros. In this case you may define the macros yourself, and map them to the values in the JSON using JSONPath:  The extracted values can be used in discovered items, triggers, etc. Note that values will be extracted from the result of discovery and any preprocessing steps so far. |Parameter|Description| |--|--------| |*LLD macro*|Name of the low-level discovery macro, using the following syntax: `{#MACRO}`.| |*JSONPath*|Path that is used to extract LLD macro value from an LLD row, using JSONPath syntax.<br>The values extracted from the returned JSON are used to replace the LLD macros in item, trigger, etc. prototype fields.<br>JSONPath can be specified using the dot notation or the bracket notation. Bracket notation should be used in case of any special characters and Unicode, like `$['unicode + special chars #1']['unicode + special chars #2']`.<br><br>For example, `$.foo` will extract "bar" and "baz" from this JSON: `[{"foo":"bar"}, {"foo":"baz"}]`<br>Note that `$.foo` will extract "bar" and "baz" also from this JSON: `{"data":[{"foo":"bar"}, {"foo":"baz"}]}` because a single "data" object is processed automatically (for [backwards compatibility](#overview) with the low-level discovery implementation in Zabbix versions before 4.2).| #### Pielāgotie makrosi Cilne **LLD makrosi** ļauj norādīt pielāgotus zemā līmeņa atklāšanas makrosus. Pielāgotie makrosi ir noderīgi gadījumos, kad atgrieztajā JSON jau nav definēti nepieciešamie makrosi. Piemēram: - Iebūvētais `vfs.fs.discovery` atslēgas vienums failu sistēmas atklāšanai atgriež JSON ar dažiem iepriekš definētiem LLD makrosiem, piemēram, `{#FSNAME}`, `{#FSTYPE}`. Šos makrosus var izmantot tieši vienumos, trigeru prototipos (skatiet turpmākās lapas sadaļas); pielāgotu makrosu definēšana nav nepieciešama; - `vfs.fs.get` aģenta vienums arī atgriež JSON ar [failu sistēmas datiem](/manual/discovery/low_level_discovery/examples/mounted_filesystems), taču bez jebkādiem iepriekš definētiem LLD makrosiem. Šajā gadījumā jūs varat definēt makrosus paši un, izmantojot JSONPath, piesaistīt tos JSON vērtībām:  Izvilktās vērtības var izmantot atklātajos vienumos, trigeros utt. Ņemiet vērā, ka vērtības tiks izvilktas no atklāšanas rezultāta un visām līdz šim veiktajām priekšapstrādes darbībām. |Parameter|Description| |--|--------| |*LLD macro*|Zemā līmeņa atklāšanas makrosa nosaukums, izmantojot šādu sintaksi: `{#MACRO}`.| |*JSONPath*|Ceļš, kas tiek izmantots, lai no LLD rindas izvilktu LLD makrosa vērtību, izmantojot JSONPath sintaksi.<br>No atgrieztā JSON izvilktās vērtības tiek izmantotas, lai aizstātu LLD makrosus vienumu, trigeru u.c. prototipu laukos.<br>JSONPath var norādīt, izmantojot punktu notāciju vai iekavu notāciju. Iekavu notācija jāizmanto gadījumos, kad ir īpašas rakstzīmes un Unicode, piemēram, `$['unicode + special chars #1']['unicode + special chars #2']`.<br><br>Piemēram, `$.foo` no šī JSON izvilks "bar" un "baz": `[{"foo":"bar"}, {"foo":"baz"}]`<br>Ņemiet vērā, ka `$.foo` no šī JSON izvilks "bar" un "baz" arī: `{"data":[{"foo":"bar"}, {"foo":"baz"}]}` jo viens "data" objekts tiek apstrādāts automātiski (savietojamībai ar iepriekšējām versijām) (#overview) ar zemā līmeņa atklāšanas ieviešanu Zabbix versijās pirms 4.2).| ##### Custom multiplier {#multiplier} Multiply the value by the specified integer or floating-point value. Comments: - Use this option to convert values received in KB, MBps, etc., into B, Bps. Otherwise, Zabbix cannot correctly set [prefixes](/manual/appendix/suffixes) (K, M, G, etc.).<br> - Note that if the item type of information is *Numeric (unsigned)*, incoming values with a fractional part will be trimmed (i.e., '0.9' will become '0') before the custom multiplier is applied;<br> - If you use a custom multiplier or store value as *Change per second* for items with the type of information set to *Numeric (unsigned)* and the resulting calculated value is actually a float number, the calculated value is still accepted as a correct one by trimming the decimal part and storing the value as an integer;<br> - Supported: scientific notation, for example, `1e+70`; user macros and LLD macros; strings that include macros, for example, `{#MACRO}e+10`, `{$MACRO1}e+{$MACRO2}`. The macros must resolve to an integer or a floating-point number. - If you mark the *Custom on fail* checkbox, it is possible to specify custom error-handling options: either to discard the value, set a specified value, or set a specified error message. In case of a failed preprocessing step, the item will not become unsupported if the option to discard the value or set a specified value is selected. ##### Pielāgots reizinātājs {#multiplier} Reiziniet vērtību ar norādīto veselo skaitli vai peldošā komata skaitli. Komentāri: - Izmantojiet šo opciju, lai pārvērstu saņemtās vērtības KB, MBps u.c. vienībās uz B, Bps. Pretējā gadījumā Zabbix nevarēs pareizi iestatīt [prefiksus](/manual/appendix/suffixes) (K, M, G u.c.).<br> - Ņemiet vērā, ka, ja vienuma informācijas tips ir *Numeric (unsigned)*, ienākošajām vērtībām ar daļskaitļa daļu tā tiks noņemta (t.i., '0.9' kļūs par '0') pirms pielāgotā reizinātāja piemērošanas;<br> - Ja izmantojat pielāgotu reizinātāju vai saglabājat vērtību kā *Change per second* vienumiem, kuriem informācijas tips ir iestatīts uz *Numeric (unsigned)*, un iegūtā aprēķinātā vērtība faktiski ir peldošā komata skaitlis, aprēķinātā vērtība joprojām tiek pieņemta kā korekta, noņemot decimāldaļu un saglabājot vērtību kā veselu skaitli;<br> - Tiek atbalstīts: zinātniskais pieraksts, piemēram, `1e+70`; lietotāja makrosi un LLD makrosi; virknes, kas ietver makrosus, piemēram, `{#MACRO}e+10`, `{$MACRO1}e+{$MACRO2}`. Makrosiem ir jāatrisinās par veselu skaitli vai peldošā komata skaitli. - Ja atzīmējat izvēles rūtiņu *Custom on fail*, ir iespējams norādīt pielāgotas kļūdu apstrādes opcijas: vai nu atmest vērtību, iestatīt norādītu vērtību vai iestatīt norādītu kļūdas ziņojumu. Neveiksmīga priekšapstrādes soļa gadījumā vienums nekļūs neatbalstīts, ja ir atlasīta opcija atmest vērtību vai iestatīt norādītu vērtību. #### Custom script limit Available custom script length depends on the database used: |Database|Limit in characters|Limit in bytes| |---|---|---| |*MySQL*|65535|65535| |*PostgreSQL*|65535|not limited| |*Oracle*|2048|4000| |*SQLite (only Zabbix proxy)*|65535|not limited| #### Pielāgota skripta ierobežojums Pieejamais pielāgotā skripta garums ir atkarīgs no izmantotās datubāzes: |Database|Limit in characters|Limit in bytes| |---|---|---| |*MySQL*|65535|65535| |*PostgreSQL*|65535|not limited| |*Oracle*|2048|4000| |*SQLite (only Zabbix proxy)*|65535|not limited| ##### Custom scripts The following custom script types are not supported by Zabbix Cloud: - Alert scripts (`AlertScriptsPath`) - External scripts (`ExternalScripts`) - Frontend scripts on Zabbix Server Community-developed frontend modules cannot be installed. ##### Pielāgoti skripti Zabbix Cloud neatbalsta šādus pielāgoto skriptu tipus: - Brīdinājumu skripti (`AlertScriptsPath`) - Ārējie skripti (`ExternalScripts`) - Lietotāja saskarnes skripti Zabbix serverī Kopienas izstrādātos lietotāja saskarnes moduļus nevar instalēt. ##### Custom themes It is possible to change Zabbix frontend visual appearance by using custom themes. See the [instructions](/manual/web_interface/theming) on creating and applying your own themes. ##### Pielāgotas tēmas Ir iespējams mainīt Zabbix lietotāja saskarne vizuālo izskatu, izmantojot pielāgotas tēmas. Skatiet [instructions](/manual/web_interface/theming) par savu tēmu izveidi un piemērošanu. ### CWidgetField The *CWidgetField* class is a base class from which all form field classes (*CWidgetFieldCheckBox*, *CWidgetFieldTextArea*, *CWidgetFieldRadioButtonList*, etc.) are inherited. Classes extending *CWidgetField* are responsible for receiving, saving, and validating widget configuration values. The following *CWidgetField* classes are available. |CWidgetField class|Database field type|Description| |----|----|----------| |*CWidgetFieldCheckBox*|int32|Single checkbox.| |*CWidgetFieldCheckBoxList*|array of int32|Multiple checkboxes under a single configuration field.| |*CWidgetFieldColor*|string|Color selection field.| |*CWidgetFieldColumnsList*|array of (multiple mixed)|Stores a table with custom columns of allowed types for use in the *Top hosts* widget.| |*CWidgetFieldDatePicker*|string|Date selection field.| |*CWidgetFieldIntegerBox*|int32|Field to enter an integer. Can be used to configure minimum and maximum values.| |*CWidgetFieldLatLng*|string|Text box that allows to enter comma-separated latitude, longitude, and map zoom level.| |*CWidgetFieldMultiSelect*|-|Base class for multiselect fields, extended by all *CWidgetFieldMultiSelect\** classes.| |*CWidgetFieldMultiSelectAction*|ID|Multiselect field for selecting actions from the list of actions defined in *Alerts → Actions*.| |*CWidgetFieldMultiSelectGraph*|ID|Multiselect field for selecting custom graphs.| |*CWidgetFieldMultiSelectGraphPrototype*|ID|Multiselect field for selecting custom graph prototypes.| |*CWidgetFieldMultiSelectGroup*|ID|Multiselect field for selecting host groups.| |*CWidgetFieldMultiSelectHost*|ID|Multiselect field for selecting hosts.| |*CWidgetFieldMultiSelectItem*|ID|Multiselect field for selecting items.| |*CWidgetFieldMultiSelectItemPrototype*|ID|Multiselect field for selecting item prototypes.| |*CWidgetFieldMultiSelectMap*|ID|Multiselect field for selecting maps.| |*CWidgetFieldMultiSelectMediaType*|ID|Multiselect field for selecting media types.| |*CWidgetFieldMultiSelectOverrideHost*|ID|Multiselect field for selecting a data source for hosts from a dashboard or another widget.| |*CWidgetFieldMultiSelectService*|ID|Multiselect field for selecting services.| |*CWidgetFieldMultiSelectSla*|ID|Multiselect field for selecting SLAs.| |*CWidgetFieldMultiSelectUser*|ID|Multiselect field for selecting users.| |*CWidgetFieldNavTree*|array of (multiple mixed)|Stores a navigation tree structure of maps for use in the *Map navigation tree* widget.| |*CWidgetFieldNumericBox*|string|Field to enter a float number.| |*CWidgetFieldPatternSelect*|-|Base class for pattern select fields, extended by all *CWidgetPatternSelect\** classes.| |*CWidgetFieldPatternSelectHost*|string|Multiselect field for selecting hosts. Supports host name patterns.| |*CWidgetFieldPatternSelectItem*|string|Multiselect field for selecting items. Supports item name patterns.| |*CWidgetFieldRadioButtonList*|int32|Radio box group that consists of one or more radio boxes.| |*CWidgetFieldRangeControl*|int32|Slider to select an integer type value.| |*CWidgetFieldReference*|string|Stores a unique identifier for this widget on the dashboard; used for widget communication.| |*CWidgetFieldSelect*|int32|Dropdown select box.| |*CWidgetFieldSeverities*|array of int32|*CWidgetFieldCheckBoxList* preset with trigger severities.| |*CWidgetFieldTags*|array of (string, int32, string)|Allows to configure one or more tag filter rows.| |*CWidgetFieldTextArea*|string|Text area for entering multi-line text.| |*CWidgetFieldTextBox*|string|Text box for entering single-line text.| |*CWidgetFieldThresholds*|array of (string, string)|Allows configuring color and number pairs.| |*CWidgetFieldTimePeriod*|array of string|Time period selecting field.| |*CWidgetFieldTimeZone*|string|Dropdown with timezones.| |*CWidgetFieldUrl*|string|Text box that allows to enter URLs.| ::: noteclassic The maximum length for `int32` fields is 10 characters, `ID` fields 20 characters, and `string` fields 2048 characters. For composite types (e.g., `array of (string, int32, string)`), the limit applies to each element individually. Field-specific length restrictions can be set using methods such as `setMaxLength()`. ::: ### CWidgetField Klase *CWidgetField* ir bāzes klase, no kuras tiek mantotas visas formas lauku klases (*CWidgetFieldCheckBox*, *CWidgetFieldTextArea*, *CWidgetFieldRadioButtonList* u.c.). Klases, kas paplašina *CWidgetField*, ir atbildīgas par logrīka konfigurācijas vērtību saņemšanu, saglabāšanu un validēšanu. Ir pieejamas šādas *CWidgetField* klases. |CWidgetField class|Database field type|Description| |----|----|----------| |*CWidgetFieldCheckBox*|int32|Viena izvēles rūtiņa.| |*CWidgetFieldCheckBoxList*|array of int32|Vairākas izvēles rūtiņas vienā konfigurācijas laukā.| |*CWidgetFieldColor*|string|Krāsas izvēles lauks.| |*CWidgetFieldColumnsList*|array of (multiple mixed)|Saglabā tabulu ar pielāgotām atļauto tipu kolonnām izmantošanai *Top hosts* logrīkā.| |*CWidgetFieldDatePicker*|string|Datuma izvēles lauks.| |*CWidgetFieldIntegerBox*|int32|Lauks vesela skaitļa ievadei. Var izmantot minimālo un maksimālo vērtību konfigurēšanai.| |*CWidgetFieldLatLng*|string|Teksta lauks, kas ļauj ievadīt ar komatiem atdalītu platumu, garumu un kartes tālummaiņas līmeni.| |*CWidgetFieldMultiSelect*|-|Bāzes klase vairākatlases laukiem, ko paplašina visas *CWidgetFieldMultiSelect\** klases.| |*CWidgetFieldMultiSelectAction*|ID|Vairākatlases lauks darbību izvēlei no darbību saraksta, kas definēts sadaļā *Alerts → Actions*.| |*CWidgetFieldMultiSelectGraph*|ID|Vairākatlases lauks pielāgoto grafiku izvēlei.| |*CWidgetFieldMultiSelectGraphPrototype*|ID|Vairākatlases lauks pielāgoto grafiku prototipu izvēlei.| |*CWidgetFieldMultiSelectGroup*|ID|Vairākatlases lauks hostu grupu izvēlei.| |*CWidgetFieldMultiSelectHost*|ID|Vairākatlases lauks hostu izvēlei.| |*CWidgetFieldMultiSelectItem*|ID|Vairākatlases lauks vienumu izvēlei.| |*CWidgetFieldMultiSelectItemPrototype*|ID|Vairākatlases lauks vienumu prototipu izvēlei.| |*CWidgetFieldMultiSelectMap*|ID|Vairākatlases lauks karšu izvēlei.| |*CWidgetFieldMultiSelectMediaType*|ID|Vairākatlases lauks mediju tipu izvēlei.| |*CWidgetFieldMultiSelectOverrideHost*|ID|Vairākatlases lauks datu avota izvēlei hostiem no informācijas paneļa vai cita logrīka.| |*CWidgetFieldMultiSelectService*|ID|Vairākatlases lauks pakalpojumu izvēlei.| |*CWidgetFieldMultiSelectSla*|ID|Vairākatlases lauks SLA izvēlei.| |*CWidgetFieldMultiSelectUser*|ID|Vairākatlases lauks lietotāju izvēlei.| |*CWidgetFieldNavTree*|array of (multiple mixed)|Saglabā karšu navigācijas koka struktūru izmantošanai *Map navigation tree* logrīkā.| |*CWidgetFieldNumericBox*|string|Lauks peldošā komata skaitļa ievadei.| |*CWidgetFieldPatternSelect*|-|Bāzes klase raksta izvēles laukiem, ko paplašina visas *CWidgetPatternSelect\** klases.| |*CWidgetFieldPatternSelectHost*|string|Vairākatlases lauks hostu izvēlei. Atbalsta hostu nosaukumu rakstus.| |*CWidgetFieldPatternSelectItem*|string|Vairākatlases lauks vienumu izvēlei. Atbalsta vienumu nosaukumu rakstus.| |*CWidgetFieldRadioButtonList*|int32|Radio pogu grupa, kas sastāv no vienas vai vairākām radio pogām.| |*CWidgetFieldRangeControl*|int32|Slīdnis vesela skaitļa vērtības izvēlei.| |*CWidgetFieldReference*|string|Saglabā unikālu šī logrīka identifikatoru informācijas panelī; tiek izmantots logrīku saziņai.| |*CWidgetFieldSelect*|int32|Nolaižamais izvēles lodziņš.| |*CWidgetFieldSeverities*|array of int32|*CWidgetFieldCheckBoxList* ar iepriekš iestatītām trigeru nopietnības pakāpēm.| |*CWidgetFieldTags*|array of (string, int32, string)|Ļauj konfigurēt vienu vai vairākas tagu filtra rindas.| |*CWidgetFieldTextArea*|string|Teksta apgabals vairākrindu teksta ievadei.| |*CWidgetFieldTextBox*|string|Teksta lauks vienas rindas teksta ievadei.| |*CWidgetFieldThresholds*|array of (string, string)|Ļauj konfigurēt krāsu un skaitļu pārus.| |*CWidgetFieldTimePeriod*|array of string|Laika perioda izvēles lauks.| |*CWidgetFieldTimeZone*|string|Nolaižamais saraksts ar laika joslām.| |*CWidgetFieldUrl*|string|Teksta lauks, kas ļauj ievadīt URL.| ::: noteclassic Maksimālais `int32` lauku garums ir 10 rakstzīmes, `ID` laukiem - 20 rakstzīmes, bet `string` laukiem - 2048 rakstzīmes. Saliktiem tipiem (piemēram, `array of (string, int32, string)`) ierobežojums attiecas uz katru elementu atsevišķi. Konkrētam laukam paredzētus garuma ierobežojumus var iestatīt, izmantojot tādas metodes kā `setMaxLength()`. ::: ### CWidgetFormView The *CWidgetFormView* class is required for specifying the presentation logic of the fields defined in the *WidgetForm* class, determining their appearance and behavior when rendered in the configuration view. The *CWidgetFormView* class supports the following methods: - *addField()* - receives an instance of the *CWidgetFieldView* class as a parameter; each [*CWidgetField*](#cwidgetfield) class, has a respective *CWidgetFieldView* class for using in the widget configuration view. - *addFieldset()* - receives an instance of the *CWidgetFieldsGroupView* class that combines fields into a collapsible container. - *addFieldsGroup()* - receives an instance of *CWidgetFormFieldsetCollapsibleView* that visually (with a border) combines fields into a group. - *includeJsFile()* - allows to add a JavaScript file to the widget configuration view. - *addJavaScript()* - allows to add inline JavaScript that will be executed as soon as the widget configuration view is loaded. The *CWidgetFormView* class should be located in the *views* directory. **views/widget.edit.php example** ```php <?php /** * My custom widget form view. * * @var CView $this * @var array $data */ use Modules\MyCustomWidget\Includes\WidgetForm; (new CWidgetFormView($data)) ->addField( (new CWidgetFieldMultiSelectItemView($data['fields']['itemid']))->setPopupParameter('numeric', true) ) ->addFieldset( (new CWidgetFormFieldsetCollapsibleView(_('Advanced configuration'))) ->addField( new CWidgetFieldTextBoxView($data['fields']['description']) ) ->addField( new CWidgetFieldColorView($data['fields']['chart_color']) ) ) ->includeJsFile('widget.edit.js.php') ->addJavaScript('my_custom_widget_form.init('.json_encode([ 'color_palette' => WidgetForm::DEFAULT_COLOR_PALETTE ]).');') ->show(); ``` ### CWidgetFormView Klase *CWidgetFormView* ir nepieciešama, lai norādītu klasē *WidgetForm* definēto lauku attēlošanas loģiku, nosakot to izskatu un darbību, kad tie tiek atveidoti konfigurācijas skatā. Klase *CWidgetFormView* atbalsta šādas metodes: - *addField()* — kā parametru saņem klases *CWidgetFieldView* instanci; katrai [*CWidgetField*](#cwidgetfield) klasei ir atbilstoša *CWidgetFieldView* klase izmantošanai logrīka konfigurācijas skatā. - *addFieldset()* — kā parametru saņem klases *CWidgetFieldsGroupView* instanci, kas apvieno laukus sakļaujamā konteinerā. - *addFieldsGroup()* — kā parametru saņem *CWidgetFormFieldsetCollapsibleView* instanci, kas vizuāli (ar apmali) apvieno laukus grupā. - *includeJsFile()* — ļauj pievienot JavaScript failu logrīka konfigurācijas skatam. - *addJavaScript()* — ļauj pievienot iekļautu JavaScript, kas tiks izpildīts, tiklīdz logrīka konfigurācijas skats tiks ielādēts. Klasei *CWidgetFormView* jāatrodas direktorijā *views*. **views/widget.edit.php piemērs** ```php <?php /** * Mana pielāgotā logrīka formas skats. * * @var CView $this * @var array $data */ use Modules\MyCustomWidget\Includes\WidgetForm; (new CWidgetFormView($data)) ->addField( (new CWidgetFieldMultiSelectItemView($data['fields']['itemid']))->setPopupParameter('numeric', true) ) ->addFieldset( (new CWidgetFormFieldsetCollapsibleView(_('Papildu konfigurācija'))) ->addField( new CWidgetFieldTextBoxView($data['fields']['description']) ) ->addField( new CWidgetFieldColorView($data['fields']['chart_color']) ) ) ->includeJsFile('widget.edit.js.php') ->addJavaScript('my_custom_widget_form.init('.json_encode([ 'color_palette' => WidgetForm::DEFAULT_COLOR_PALETTE ]).');') ->show(); ``` # dashboard.create # dashboard.create # dashboard.delete # dashboard.delete # dashboard.get # dashboard.get # Dashboard object The following objects are directly related to the `dashboard` API. # Paneļa objekts Tālāk norādītie objekti ir tieši saistīti ar `dashboard` API. ### Dashboard page The dashboard page object has the following properties. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |dashboard\_pageid|ID|ID of the dashboard page.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |name|string|Dashboard page name.<br><br>Default: empty string.| |display\_period|integer|Dashboard page display period (in seconds).<br><br>Possible values: 0, 10, 30, 60, 120, 600, 1800, 3600.<br><br>Default: 0 (will use the default page display period).| |widgets|array|Array of the [dashboard widget](object#dashboard-widget) objects.| ### Paneļa lapa Paneļa lapas objektam ir šādas īpašības. |Īpašība|[Tips](/manual/api/reference_commentary#data-types)|Apraksts| |--|--|------| |dashboard\_pageid|ID|Paneļa lapas ID.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *tikai lasāms*| |name|string|Paneļa lapas nosaukums.<br><br>Noklusējums: tukša virkne.| |display\_period|integer|Paneļa lapas attēlošanas periods (sekundēs).<br><br>Iespējamās vērtības: 0, 10, 30, 60, 120, 600, 1800, 3600.<br><br>Noklusējums: 0 (tiks izmantots noklusējuma lapas attēlošanas periods).| |widgets|array|[Paneļa logrīka](object#dashboard-widget) objektu masīvs.| ##### Dashboard size The minimum width of a dashboard is 1200 pixels. The dashboard will not shrink below this width; instead a horizontal scrollbar is displayed if the browser window is smaller than that. The maximum width of a dashboard is the browser window width. Dashboard widgets stretch horizontally to fit the window. At the same time, a dashboard widget cannot be stretched horizontally beyond the window limits. Horizontally, the dashboard is made up of 72 columns of always equal width that stretch/shrink dynamically (but not to less than 1200 pixels total). Vertically, the dashboard may contain a maximum of 64 rows; each row has a fixed height of 70 pixels. A widget may be therefore be up to 72 columns wide and 64 rows high. ##### Paneļa izmērs Paneļa minimālais platums ir 1200 pikseļi. Panelis nesamazināsies zem šī platuma; tā vietā, ja pārlūkprogrammas logs ir mazāks, tiks parādīta horizontāla ritjosla. Paneļa maksimālais platums ir pārlūkprogrammas loga platums. Paneļa sīkrīki horizontāli izstiepjas, lai pielāgotos logam. Tajā pašā laikā paneļa sīkrīku nevar horizontāli izstiept ārpus loga robežām. Horizontāli panelis sastāv no 72 vienāda platuma kolonnām, kas dinamiski izstiepjas/sarūk (bet kopā ne mazāk kā 1200 pikseļi). Vertikāli panelī var būt ne vairāk kā 64 rindas; katras rindas fiksētais augstums ir 70 pikseļi. Tādējādi sīkrīks var būt līdz 72 kolonnas plats un 64 rindas augsts. #### Dashboards Manage dashboards and make scheduled reports based on them. [Dashboard API](/manual/api/reference/dashboard) | [Template dashboard API](/manual/api/reference/templatedashboard) | [Report API](/manual/api/reference/report) #### Paneļi Pārvaldiet paneļus un veidojiet uz tiem balstītus ieplānotus pārskatus. [Paneļu API](/manual/api/reference/dashboard) | [Veidņu paneļu API](/manual/api/reference/templatedashboard) | [Pārskatu API](/manual/api/reference/report) ### Dashboard The dashboard object has the following properties. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |dashboardid|ID|ID of the dashboard.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*<br>- *required* for update operations| |name|string|Name of the dashboard.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |userid|ID|ID of the user that is the owner of the dashboard.| |private|integer|Type of dashboard sharing.<br><br>Possible values:<br>0 - public dashboard;<br>1 - *(default)* private dashboard.| |display\_period|integer|Default page display period (in seconds).<br><br>Possible values: 10, 30, 60, 120, 600, 1800, 3600.<br><br>Default: 30.| |auto\_start|integer|Auto start slideshow.<br><br>Possible values:<br>0 - do not auto start slideshow;<br>1 - *(default)* auto start slideshow.| ### Panelis Paneļa objektam ir šādas īpašības. |Īpašība|[Tips](/manual/api/reference_commentary#data-types)|Apraksts| |--|--|------| |dashboardid|ID|Paneļa ID.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *tikai lasāms*<br>- *obligāts* atjaunināšanas darbībām| |name|string|Paneļa nosaukums.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāts* izveides darbībām| |userid|ID|Tā lietotāja ID, kurš ir paneļa īpašnieks.| |private|integer|Paneļa koplietošanas tips.<br><br>Iespējamās vērtības:<br>0 - publisks panelis;<br>1 - *(noklusējums)* privāts panelis.| |display\_period|integer|Noklusējuma lapas attēlošanas periods (sekundēs).<br><br>Iespējamās vērtības: 10, 30, 60, 120, 600, 1800, 3600.<br><br>Noklusējums: 30.| |auto\_start|integer|Automātiski sākt slaidrādi.<br><br>Iespējamās vērtības:<br>0 - nesākt slaidrādi automātiski;<br>1 - *(noklusējums)* sākt slaidrādi automātiski.| # Dashboard This class is designed to work with dashboards. Object references: - [Dashboard](/manual/api/reference/dashboard/object#dashboard) - [Dashboard page](/manual/api/reference/dashboard/object#dashboard-page) - [Dashboard widget](/manual/api/reference/dashboard/object#dashboard-widget) - [Dashboard widget field](/manual/api/reference/dashboard/object#dashboard-widget-field) - [Dashboard user group](/manual/api/reference/dashboard/object#dashboard-user-group) - [Dashboard user](/manual/api/reference/dashboard/object#dashboard-user) Available methods: - [dashboard.create](/manual/api/reference/dashboard/create) - create new dashboards - [dashboard.delete](/manual/api/reference/dashboard/delete) - delete dashboards - [dashboard.get](/manual/api/reference/dashboard/get) - retrieve dashboards - [dashboard.update](/manual/api/reference/dashboard/update) - update dashboards # Panelis Šī klase ir paredzēta darbam ar paneļiem. Objektu atsauces: - [Panelis](/manual/api/reference/dashboard/object#dashboard) - [Paneļa lapa](/manual/api/reference/dashboard/object#dashboard-page) - [Paneļa logrīks](/manual/api/reference/dashboard/object#dashboard-widget) - [Paneļa logrīka lauks](/manual/api/reference/dashboard/object#dashboard-widget-field) - [Paneļa lietotāju grupa](/manual/api/reference/dashboard/object#dashboard-user-group) - [Paneļa lietotājs](/manual/api/reference/dashboard/object#dashboard-user) Pieejamās metodes: - [dashboard.create](/manual/api/reference/dashboard/create) - izveidot jaunus paneļus - [dashboard.delete](/manual/api/reference/dashboard/delete) - dzēst paneļus - [dashboard.get](/manual/api/reference/dashboard/get) - izgūt paneļus - [dashboard.update](/manual/api/reference/dashboard/update) - atjaunināt paneļus # dashboard.update # dashboard.update ### Dashboard user group List of dashboard permissions based on user groups. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |usrgrpid|ID|ID of the user group.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |permission|integer|Type of permission level.<br><br>Possible values:<br>2 - read only;<br>3 - read-write.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| ### Paneļa lietotāju grupa Paneļa atļauju saraksts, pamatojoties uz lietotāju grupām. Tam ir šādas īpašības. |Īpašība|[Type](/manual/api/reference_commentary#data-types)|Apraksts| |--|--|------| |usrgrpid|ID|Lietotāju grupas ID.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *required*| |permission|integer|Atļauju līmeņa tips.<br><br>Iespējamās vērtības:<br>2 - tikai lasīšana;<br>3 - lasīšana-rakstīšana.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *required*| ### Dashboard user List of dashboard permissions based on users. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |userid|ID|ID of the user.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |permission|integer|Type of permission level.<br><br>Possible values:<br>2 - read only;<br>3 - read-write.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| ### Paneļa lietotājs Paneļa atļauju saraksts, pamatojoties uz lietotājiem. Tam ir šādas īpašības. |Īpašība|[Tips](/manual/api/reference_commentary#data-types)|Apraksts| |--|--|------| |userid|ID|Lietotāja ID.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāta*| |permission|integer|Atļaujas līmeņa tips.<br><br>Iespējamās vērtības:<br>2 - tikai lasīšana;<br>3 - lasīšana-rakstīšana.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāta*| # Dashboard widget fields # Paneļa logrīka lauki ##### Dashboard widget field The dashboard widget field object has the following properties. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |type|integer|Type of the widget field.<br><br>Possible values:<br>0 - Integer;<br>1 - String;<br>2 - Host group;<br>3 - Host;<br>4 - Item;<br>5 - Item prototype;<br>6 - Graph;<br>7 - Graph prototype;<br>8 - Map;<br>9 - Service;<br>10 - SLA;<br>11 - User;<br>12 - Action;<br>13 - Media type.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |name|string|Widget field name.<br><br>Possible values: see [Dashboard widget fields](/manual/api/reference/dashboard/widget_fields).<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |value|mixed|Widget field value depending on the type.<br><br>Possible values: see [Dashboard widget fields](/manual/api/reference/dashboard/widget_fields).<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| ##### Informācijas paneļa logrīka lauks Informācijas paneļa logrīka lauka objektam ir šādas īpašības. |Īpašība|[Tips](/manual/api/reference_commentary#data-types)|Apraksts| |--|--|------| |type|integer|Logrīka lauka tips.<br><br>Iespējamās vērtības:<br>0 - Vesels skaitlis;<br>1 - Virkne;<br>2 - Hostu grupa;<br>3 - Hosts;<br>4 - Vienums;<br>5 - Vienuma prototips;<br>6 - Grafiks;<br>7 - Grafika prototips;<br>8 - Karte;<br>9 - Pakalpojums;<br>10 - SLA;<br>11 - Lietotājs;<br>12 - Darbība;<br>13 - Medija tips.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāts*| |name|string|Logrīka lauka nosaukums.<br><br>Iespējamās vērtības: skatiet [Informācijas paneļa logrīku laukus](/manual/api/reference/dashboard/widget_fields).<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāts*| |value|mixed|Logrīka lauka vērtība atkarībā no tipa.<br><br>Iespējamās vērtības: skatiet [Informācijas paneļa logrīku laukus](/manual/api/reference/dashboard/widget_fields).<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāts*| #### Dashboard widget The dashboard widget object has the following properties. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |widgetid|ID|ID of the dashboard widget.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |type|string|Type of the dashboard widget.<br><br>Possible values:<br>actionlog - Action log;<br>clock - Clock;<br>*(deprecated)* dataover - Data overview;<br>discovery - Discovery status;<br>favgraphs - Favorite graphs;<br>favmaps - Favorite maps;<br>gauge - Gauge;<br>geomap - Geomap;<br>graph - Graph (classic);<br>graphprototype - Graph prototype;<br>honeycomb - Honeycomb;<br>hostavail - Host availability;<br>hostnavigator - Host navigator;<br>itemhistory - Item history;<br>itemnavigator - Item navigator;<br>item - Item value;<br>map - Map;<br>navtree - Map Navigation Tree;<br>piechart - Pie chart;<br>problemhosts - Problem hosts;<br>problems - Problems;<br>problemsbysv - Problems by severity;<br>slareport - SLA report;<br>svggraph - Graph;<br>systeminfo - System information;<br>tophosts - Top hosts;<br>toptriggers - Top triggers;<br>trigover - Trigger overview;<br>url - URL;<br>web - Web monitoring.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |name|string|Custom widget name.| |x|integer|A horizontal position from the left side of the dashboard.<br><br>Possible values range from 0 to 71.| |y|integer|A vertical position from the top of the dashboard.<br><br>Possible values range from 0 to 63.| |width|integer|The widget width.<br><br>Possible values range from 1 to 72.| |height|integer|The widget height.<br><br>Possible values range from 1 to 64.| |view\_mode|integer|The widget view mode.<br><br>Possible values:<br>0 - *(default)* default widget view;<br>1 - with hidden header;| |fields|array|Array of the [dashboard widget field](object#dashboard-widget-field) objects.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- see individual widgets in [Dashboard widget fields](/manual/api/reference/dashboard/widget_fields)| #### Informācijas paneļa sīkrīks Informācijas paneļa sīkrīka objektam ir šādas īpašības. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |widgetid|ID|Informācijas paneļa sīkrīka ID.<br><br>[Īpašības uzvedība](/manual/api/reference_commentary#property-behavior):<br>- *tikai lasāms*| |type|string|Informācijas paneļa sīkrīka tips.<br><br>Iespējamās vērtības:<br>actionlog - Darbību žurnāls;<br>clock - Pulkstenis;<br>*(deprecated)* dataover - Datu pārskats;<br>discovery - Atklāšanas statuss;<br>favgraphs - Izlases grafiki;<br>favmaps - Izlases kartes;<br>gauge - Mērītājs;<br>geomap - Ģeokarte;<br>graph - Grafiks (klasisks);<br>graphprototype - Grafika prototips;<br>honeycomb - Honeycomb;<br>hostavail - Host pieejamība;<br>hostnavigator - Host navigators;<br>itemhistory - Vienuma vēsture;<br>itemnavigator - Vienuma navigators;<br>item - Vienuma vērtība;<br>map - Karte;<br>navtree - Kartes navigācijas koks;<br>piechart - Sektoru diagramma;<br>problemhosts - Problemātiskie hosti;<br>problems - Problēmas;<br>problemsbysv - Problēmas pēc nopietnības;<br>slareport - SLA pārskats;<br>svggraph - Grafiks;<br>systeminfo - Sistēmas informācija;<br>tophosts - Top hosti;<br>toptriggers - Top trigeri;<br>trigover - Trigeru pārskats;<br>url - URL;<br>web - Tīmekļa uzraudzība.<br><br>[Īpašības uzvedība](/manual/api/reference_commentary#property-behavior):<br>- *obligāts*| |name|string|Pielāgots sīkrīka nosaukums.| |x|integer|Horizontālā pozīcija no informācijas paneļa kreisās malas.<br><br>Iespējamās vērtības ir no 0 līdz 71.| |y|integer|Vertikālā pozīcija no informācijas paneļa augšas.<br><br>Iespējamās vērtības ir no 0 līdz 63.| |width|integer|Sīkrīka platums.<br><br>Iespējamās vērtības ir no 1 līdz 72.| |height|integer|Sīkrīka augstums.<br><br>Iespējamās vērtības ir no 1 līdz 64.| |view\_mode|integer|Sīkrīka skatīšanas režīms.<br><br>Iespējamās vērtības:<br>0 - *(noklusējums)* noklusējuma sīkrīka skats;<br>1 - ar paslēptu galveni;| |fields|array|[Informācijas paneļa sīkrīka lauka](object#dashboard-widget-field) objektu masīvs.<br><br>[Īpašības uzvedība](/manual/api/reference_commentary#property-behavior):<br>- skatīt atsevišķos sīkrīkus sadaļā [Informācijas paneļa sīkrīka lauki](/manual/api/reference/dashboard/widget_fields)| #### dashboard [ZBX-25929](https://support.zabbix.com/browse/ZBX-25929) Removed dashboard widget fields `date_size`, `time_size`, `tzone_size` in [`clock`](/manual/api/reference/dashboard/widget_fields/clock) widget. #### informācijas panelis [ZBX-25929](https://support.zabbix.com/browse/ZBX-25929) No [`clock`](/manual/api/reference/dashboard/widget_fields/clock) logrīka tika noņemti informācijas paneļa logrīka lauki `date_size`, `time_size`, `tzone_size`. #### dashboard [ZBXNEXT-10143](https://support.zabbix.com/browse/ZBXNEXT-10143) Added new dashboard widget field `highlight_row` in [problems](/manual/api/reference/dashboard/widget_fields/problems) widget. #### informācijas panelis [ZBXNEXT-10143](https://support.zabbix.com/browse/ZBXNEXT-10143) Pievienots jauns informācijas paneļa logrīka lauks `highlight_row` logrīkā [problems](/manual/api/reference/dashboard/widget_fields/problems). #### dashboard [ZBXNEXT-8316](https://support.zabbix.com/browse/ZBXNEXT-8316), [ZBXNEXT-9193](https://support.zabbix.com/browse/ZBXNEXT-9193), [ZBX-24488](https://support.zabbix.com/browse/ZBX-24488), [ZBX-24490](https://support.zabbix.com/browse/ZBX-24490) Renamed [dashboard widget](/manual/api/reference/dashboard/object#dashboard-widget) type `plaintext` to [`itemhistory`](/manual/api/reference/dashboard/widget_fields/item_history), replaced its dashboard widget fields `itemids.0`, `style`, `show_as_html` with `columns.0.itemid`, `layout`, `columns.0.display`, and added new dashboard widget fields.<br> [ZBXNEXT-8496](https://support.zabbix.com/browse/ZBXNEXT-8496) Replaced dashboard widget fields `columns.0.timeshift`, `columns.0.aggregate_interval` with `columns.0.time_period._reference`, `columns.0.time_period.from`, `columns.0.time_period.from` in [`tophosts`](/manual/api/reference/dashboard/widget_fields/top_hosts#item-value) widget.<br> [ZBXNEXT-2299](https://support.zabbix.com/browse/ZBXNEXT-2299) Replaced dashboard widget field `unacknowledged` with two new fields `acknowledgement_status` and `acknowledged_by_me` in [`problems`](/manual/api/reference/dashboard/widget_fields/problems#parameters) widget.<br> [ZBXNEXT-8245](https://support.zabbix.com/browse/ZBXNEXT-8245) Removed dashboard widget field `adv_conf` in [`clock`](/manual/api/reference/dashboard/widget_fields/clock#parameters) and [`item`](/manual/api/reference/dashboard/widget_fields/item_value#parameters) widgets.<br> [ZBXNEXT-8145](https://support.zabbix.com/browse/ZBXNEXT-8145) Changed dashboard widget field naming: complex data fields renamed from `str.str.index1.index2` to `str.index1.str.index2` (e.g. `thresholds.0.threshold.1`, `ds.0.hosts.1`); fields referencing database objects renamed from `str` to `str.index1` (e.g. `itemid.0`, `severities.0`).<br> [ZBXNEXT-8145](https://support.zabbix.com/browse/ZBXNEXT-8145) Replaced dashboard widget field `filter_widget_reference` with `sysmapid._reference`, and removed field `source_type` in [`map`](/manual/api/reference/dashboard/widget_fields/map#parameters) widget.<br> [ZBXNEXT-8145](https://support.zabbix.com/browse/ZBXNEXT-8145) Replaced dashboard widget field `dynamic` with `override_hostid._reference` in [`gauge`](/manual/api/reference/dashboard/widget_fields/gauge#parameters), [`graph`](/manual/api/reference/dashboard/widget_fields/graph_classic#parameters), [`graphprototype`](/manual/api/reference/dashboard/widget_fields/graph_prototype#parameters), [`item`](/manual/api/reference/dashboard/widget_fields/item_value#parameters), [`plaintext`](/manual/api/reference/dashboard/widget_fields/plain_text#parameters), and [`url`](/manual/api/reference/dashboard/widget_fields/url#parameters) widgets.<br> [ZBXNEXT-8145](https://support.zabbix.com/browse/ZBXNEXT-8145) Replaced dashboard widget fields `graph_time` with `time_period._reference`, `time_from` with `time_period.from`, `time_to` with `time_period.to` in [`svggraph`](/manual/api/reference/dashboard/widget_fields/graph#time-period) widget.<br> [ZBXNEXT-9044](https://support.zabbix.com/browse/ZBXNEXT-9044) Changed the value range of the dashboard widget parameters `x` (from 0-23 to 0-71 ) and `y` (from 0-62 to 0-63) as well as `width` (from 1-24 to 1-72) and `height` (from 2-32 to 1-64). #### dashboard [ZBXNEXT-8316](https://support.zabbix.com/browse/ZBXNEXT-8316), [ZBXNEXT-9193](https://support.zabbix.com/browse/ZBXNEXT-9193), [ZBX-24488](https://support.zabbix.com/browse/ZBX-24488), [ZBX-24490](https://support.zabbix.com/browse/ZBX-24490) Pārdēvēts [dashboard widget](/manual/api/reference/dashboard/object#dashboard-widget) tips `plaintext` uz [`itemhistory`](/manual/api/reference/dashboard/widget_fields/item_history), tā dashboard widget lauki `itemids.0`, `style`, `show_as_html` aizstāti ar `columns.0.itemid`, `layout`, `columns.0.display`, kā arī pievienoti jauni dashboard widget lauki.<br> [ZBXNEXT-8496](https://support.zabbix.com/browse/ZBXNEXT-8496) Dashboard widget lauki `columns.0.timeshift`, `columns.0.aggregate_interval` aizstāti ar `columns.0.time_period._reference`, `columns.0.time_period.from`, `columns.0.time_period.from` [`tophosts`](/manual/api/reference/dashboard/widget_fields/top_hosts#item-value) widgetā.<br> [ZBXNEXT-2299](https://support.zabbix.com/browse/ZBXNEXT-2299) Dashboard widget lauks `unacknowledged` [`problems`](/manual/api/reference/dashboard/widget_fields/problems#parameters) widgetā aizstāts ar diviem jauniem laukiem `acknowledgement_status` un `acknowledged_by_me`.<br> [ZBXNEXT-8245](https://support.zabbix.com/browse/ZBXNEXT-8245) Noņemts dashboard widget lauks `adv_conf` [`clock`](/manual/api/reference/dashboard/widget_fields/clock#parameters) un [`item`](/manual/api/reference/dashboard/widget_fields/item_value#parameters) widgetos.<br> [ZBXNEXT-8145](https://support.zabbix.com/browse/ZBXNEXT-8145) Mainīta dashboard widget lauku nosaukumu piešķiršana: sarežģītie datu lauki pārdēvēti no `str.str.index1.index2` uz `str.index1.str.index2` (piem., `thresholds.0.threshold.1`, `ds.0.hosts.1`); lauki, kas atsaucas uz datubāzes objektiem, pārdēvēti no `str` uz `str.index1` (piem., `itemid.0`, `severities.0`).<br> [ZBXNEXT-8145](https://support.zabbix.com/browse/ZBXNEXT-8145) Dashboard widget lauks `filter_widget_reference` aizstāts ar `sysmapid._reference`, un [`map`](/manual/api/reference/dashboard/widget_fields/map#parameters) widgetā noņemts lauks `source_type`.<br> [ZBXNEXT-8145](https://support.zabbix.com/browse/ZBXNEXT-8145) Dashboard widget lauks `dynamic` aizstāts ar `override_hostid._reference` [`gauge`](/manual/api/reference/dashboard/widget_fields/gauge#parameters), [`graph`](/manual/api/reference/dashboard/widget_fields/graph_classic#parameters), [`graphprototype`](/manual/api/reference/dashboard/widget_fields/graph_prototype#parameters), [`item`](/manual/api/reference/dashboard/widget_fields/item_value#parameters), [`plaintext`](/manual/api/reference/dashboard/widget_fields/plain_text#parameters) un [`url`](/manual/api/reference/dashboard/widget_fields/url#parameters) widgetos.<br> [ZBXNEXT-8145](https://support.zabbix.com/browse/ZBXNEXT-8145) Dashboard widget lauki `graph_time` aizstāti ar `time_period._reference`, `time_from` ar `time_period.from`, `time_to` ar `time_period.to` [`svggraph`](/manual/api/reference/dashboard/widget_fields/graph#time-period) widgetā.<br> [ZBXNEXT-9044](https://support.zabbix.com/browse/ZBXNEXT-9044) Mainīts dashboard widget parametru `x` vērtību diapazons (no 0-23 uz 0-71) un `y` (no 0-62 uz 0-63), kā arī `width` (no 1-24 uz 1-72) un `height` (no 2-32 uz 1-64). #### dashboard [ZBXNEXT-8956](https://support.zabbix.com/browse/ZBXNEXT-8956) Added new dashboard widget fields `groupids._reference`, `hostids._reference`, `itemid._reference`, `graphid._reference`, `reference` in multiple widgets.<br> [ZBXNEXT-9057](https://support.zabbix.com/browse/ZBXNEXT-9057) Added new dashboard widget field `show_software_update_check_details` in [`systeminfo`](/manual/api/reference/dashboard/widget_fields/system) widget.<br> [ZBXNEXT-8686](https://support.zabbix.com/browse/ZBXNEXT-8686) Added new [dashboard widget](/manual/api/reference/dashboard/object#dashboard-widget) type [`itemnavigator`](/manual/api/reference/dashboard/widget_fields/item_navigator).<br> [ZBXNEXT-8685](https://support.zabbix.com/browse/ZBXNEXT-8685) Added new [dashboard widget](/manual/api/reference/dashboard/object#dashboard-widget) type [`hostnavigator`](/manual/api/reference/dashboard/widget_fields/host_navigator).<br> [ZBXNEXT-8683](https://support.zabbix.com/browse/ZBXNEXT-8683) Added new [dashboard widget](/manual/api/reference/dashboard/object#dashboard-widget) type [`honeycomb`](/manual/api/reference/dashboard/widget_fields/honeycomb).<br> [ZBXNEXT-8907](https://support.zabbix.com/browse/ZBXNEXT-8907) Added new dashboard widget field `legend_lines_mode` in [`graph`](/manual/api/reference/dashboard/widget_fields/graph#legend) widget.<br> [ZBXNEXT-8496](https://support.zabbix.com/browse/ZBXNEXT-8496) Added new dashboard widget fields `aggregate_function`, `history`, `time_period._reference`, `time_period.from`, `time_period.from` in [`item`](/manual/api/reference/dashboard/widget_fields/item_value#advanced-configuration) widget.<br> [ZBXNEXT-7736](https://support.zabbix.com/browse/ZBXNEXT-7736) Added new dashboard widget field `interface_type` value (5 - Zabbix Agent(active checks)) in [`hostavail`](/manual/api/reference/dashboard/widget_fields/host_availability#parameters) widget.<br> [ZBXNEXT-7736](https://support.zabbix.com/browse/ZBXNEXT-7736) Added new dashboard widget field `only_totals` in [`hostavail`](/manual/api/reference/dashboard/widget_fields/host_availability#parameters) widget.<br> [ZBXNEXT-7687](https://support.zabbix.com/browse/ZBXNEXT-7687) Added new dashboard widget field `maintenance` in [`tophosts`](/manual/api/reference/dashboard/widget_fields/top_hosts#parameters) widget.<br> [ZBXNEXT-6974](https://support.zabbix.com/browse/ZBXNEXT-6974) Added new [dashboard widget](/manual/api/reference/dashboard/object#dashboard-widget) type [`toptriggers`](/manual/api/reference/dashboard/widget_fields/top_triggers).<br> [ZBXNEXT-743](https://support.zabbix.com/browse/ZBXNEXT-743) Added new [dashboard widget](/manual/api/reference/dashboard/object#dashboard-widget) type [`gauge`](/manual/api/reference/dashboard/widget_fields/gauge).<br> [ZBXNEXT-8331](https://support.zabbix.com/browse/ZBXNEXT-8331), [ZBXNEXT-8145](https://support.zabbix.com/browse/ZBXNEXT-8145), [ZBXNEXT-8908](https://support.zabbix.com/browse/ZBXNEXT-8908), [ZBXNEXT-8907](https://support.zabbix.com/browse/ZBXNEXT-8907) Added new [dashboard widget](/manual/api/reference/dashboard/object#dashboard-widget) type [`piechart`](/manual/api/reference/dashboard/widget_fields/pie_chart).<br> [ZBXNEXT-8331](https://support.zabbix.com/browse/ZBXNEXT-8331) Added new dashboard widget field `legend_aggregation` in [`graph`](/manual/api/reference/dashboard/widget_fields/graph#legend) widget.<br> [ZBXNEXT-8145](https://support.zabbix.com/browse/ZBXNEXT-8145) Added new dashboard widget field `reference` in [`svggraph`](/manual/api/reference/dashboard/widget_fields/graph#parameters), [`graph`](/manual/api/reference/dashboard/widget_fields/graph_classic#parameters), and [`graphprototype`](/manual/api/reference/dashboard/widget_fields/graph_prototype#parameters) widgets.<br> [ZBXNEXT-8145](https://support.zabbix.com/browse/ZBXNEXT-8145) Added new dashboard widget fields `time_period._reference`, `time_period.from`, `time_period.to` in [`actionlog`](/manual/api/reference/dashboard/widget_fields/action_log#parameters), [`graph`](/manual/api/reference/dashboard/widget_fields/graph_classic#parameters), [`graphprototype`](/manual/api/reference/dashboard/widget_fields/graph_prototype#parameters), and [`toptriggers`](/manual/api/reference/dashboard/widget_fields/top_triggers#parameters) widgets. #### informācijas panelis [ZBXNEXT-8956](https://support.zabbix.com/browse/ZBXNEXT-8956) Pievienoti jauni informācijas paneļa logrīka lauki `groupids._reference`, `hostids._reference`, `itemid._reference`, `graphid._reference`, `reference` vairākos logrīkos.<br> [ZBXNEXT-9057](https://support.zabbix.com/browse/ZBXNEXT-9057) Pievienots jauns informācijas paneļa logrīka lauks `show_software_update_check_details` [`systeminfo`](/manual/api/reference/dashboard/widget_fields/system) logrīkā.<br> [ZBXNEXT-8686](https://support.zabbix.com/browse/ZBXNEXT-8686) Pievienots jauns [informācijas paneļa logrīks](/manual/api/reference/dashboard/object#dashboard-widget) tips [`itemnavigator`](/manual/api/reference/dashboard/widget_fields/item_navigator).<br> [ZBXNEXT-8685](https://support.zabbix.com/browse/ZBXNEXT-8685) Pievienots jauns [informācijas paneļa logrīks](/manual/api/reference/dashboard/object#dashboard-widget) tips [`hostnavigator`](/manual/api/reference/dashboard/widget_fields/host_navigator).<br> [ZBXNEXT-8683](https://support.zabbix.com/browse/ZBXNEXT-8683) Pievienots jauns [informācijas paneļa logrīks](/manual/api/reference/dashboard/object#dashboard-widget) tips [`honeycomb`](/manual/api/reference/dashboard/widget_fields/honeycomb).<br> [ZBXNEXT-8907](https://support.zabbix.com/browse/ZBXNEXT-8907) Pievienots jauns informācijas paneļa logrīka lauks `legend_lines_mode` [`graph`](/manual/api/reference/dashboard/widget_fields/graph#legend) logrīkā.<br> [ZBXNEXT-8496](https://support.zabbix.com/browse/ZBXNEXT-8496) Pievienoti jauni informācijas paneļa logrīka lauki `aggregate_function`, `history`, `time_period._reference`, `time_period.from`, `time_period.from` [`item`](/manual/api/reference/dashboard/widget_fields/item_value#advanced-configuration) logrīkā.<br> [ZBXNEXT-7736](https://support.zabbix.com/browse/ZBXNEXT-7736) Pievienota jauna informācijas paneļa logrīka lauka `interface_type` vērtība (5 - Zabbix aģents(active checks)) [`hostavail`](/manual/api/reference/dashboard/widget_fields/host_availability#parameters) logrīkā.<br> [ZBXNEXT-7736](https://support.zabbix.com/browse/ZBXNEXT-7736) Pievienots jauns informācijas paneļa logrīka lauks `only_totals` [`hostavail`](/manual/api/reference/dashboard/widget_fields/host_availability#parameters) logrīkā.<br> [ZBXNEXT-7687](https://support.zabbix.com/browse/ZBXNEXT-7687) Pievienots jauns informācijas paneļa logrīka lauks `maintenance` [`tophosts`](/manual/api/reference/dashboard/widget_fields/top_hosts#parameters) logrīkā.<br> [ZBXNEXT-6974](https://support.zabbix.com/browse/ZBXNEXT-6974) Pievienots jauns [informācijas paneļa logrīks](/manual/api/reference/dashboard/object#dashboard-widget) tips [`toptriggers`](/manual/api/reference/dashboard/widget_fields/top_triggers).<br> [ZBXNEXT-743](https://support.zabbix.com/browse/ZBXNEXT-743) Pievienots jauns [informācijas paneļa logrīks](/manual/api/reference/dashboard/object#dashboard-widget) tips [`gauge`](/manual/api/reference/dashboard/widget_fields/gauge).<br> [ZBXNEXT-8331](https://support.zabbix.com/browse/ZBXNEXT-8331), [ZBXNEXT-8145](https://support.zabbix.com/browse/ZBXNEXT-8145), [ZBXNEXT-8908](https://support.zabbix.com/browse/ZBXNEXT-8908), [ZBXNEXT-8907](https://support.zabbix.com/browse/ZBXNEXT-8907) Pievienots jauns [informācijas paneļa logrīks](/manual/api/reference/dashboard/object#dashboard-widget) tips [`piechart`](/manual/api/reference/dashboard/widget_fields/pie_chart).<br> [ZBXNEXT-8331](https://support.zabbix.com/browse/ZBXNEXT-8331) Pievienots jauns informācijas paneļa logrīka lauks `legend_aggregation` [`graph`](/manual/api/reference/dashboard/widget_fields/graph#legend) logrīkā.<br> [ZBXNEXT-8145](https://support.zabbix.com/browse/ZBXNEXT-8145) Pievienots jauns informācijas paneļa logrīka lauks `reference` [`svggraph`](/manual/api/reference/dashboard/widget_fields/graph#parameters), [`graph`](/manual/api/reference/dashboard/widget_fields/graph_classic#parameters) un [`graphprototype`](/manual/api/reference/dashboard/widget_fields/graph_prototype#parameters) logrīkos.<br> [ZBXNEXT-8145](https://support.zabbix.com/browse/ZBXNEXT-8145) Pievienoti jauni informācijas paneļa logrīka lauki `time_period._reference`, `time_period.from`, `time_period.to` [`actionlog`](/manual/api/reference/dashboard/widget_fields/action_log#parameters), [`graph`](/manual/api/reference/dashboard/widget_fields/graph_classic#parameters), [`graphprototype`](/manual/api/reference/dashboard/widget_fields/graph_prototype#parameters) un [`toptriggers`](/manual/api/reference/dashboard/widget_fields/top_triggers#parameters) logrīkos. #### dashboard [ZBXNEXT-9215](https://support.zabbix.com/browse/ZBXNEXT-9215) Added new dashboard widget field `ds.0.itemids.0._reference` in [`svggraph`](/manual/api/reference/dashboard/widget_fields/graph#data-set) and [`piechart`](/manual/api/reference/dashboard/widget_fields/pie_chart#data-set) widgets.<br> [ZBXNEXT-8331](https://support.zabbix.com/browse/ZBXNEXT-8331) Added new dashboard widget field `stroke` in [`piechart`](/manual/api/reference/dashboard/widget_fields/pie_chart) widget. #### informācijas panelis [ZBXNEXT-9215](https://support.zabbix.com/browse/ZBXNEXT-9215) Pievienots jauns informācijas paneļa logrīka lauks `ds.0.itemids.0._reference` [`svggraph`](/manual/api/reference/dashboard/widget_fields/graph#data-set) un [`piechart`](/manual/api/reference/dashboard/widget_fields/pie_chart#data-set) logrīkos.<br> [ZBXNEXT-8331](https://support.zabbix.com/browse/ZBXNEXT-8331) Pievienots jauns informācijas paneļa logrīka lauks `stroke` [`piechart`](/manual/api/reference/dashboard/widget_fields/pie_chart) logrīkā. #### Database changes A slow template cloning issue has been resolved by adding indexes for the uuid field. This change may cause long upgrade times on large datasets. #### Datu bāzes izmaiņas Lēnas veidnes klonēšanas problēma ir novērsta, pievienojot indeksus uuid laukam. Šīs izmaiņas var izraisīt ilgāku atjaunināšanas laiku lielām datu kopām. #### Database connection parameters [DBPort](/manual/appendix/config/zabbix_server#dbport) and [DBSocket](/manual/appendix/config/zabbix_server#dbsocket) are now mutually exclusive. When specifying database connection parameters, you may define either DBPort or DBSocket, or leave both undefined to use defaults. #### Datu bāzes savienojuma parametri [DBPort](/manual/appendix/config/zabbix_server#dbport) un [DBSocket](/manual/appendix/config/zabbix_server#dbsocket) tagad ir savstarpēji izslēdzoši. Norādot datu bāzes savienojuma parametrus, varat definēt vai nu DBPort, vai DBSocket, vai arī atstāt abus nedefinētus, lai izmantotu noklusējuma vērtības. #### Database creation We assume that a *zabbix* database user with *password* password exists and has permissions to create database objects in ORCL service located on the *host* Oracle database server. Zabbix requires a Unicode database character set and a `UTF8` national character set. Check current settings: sqlplus> select parameter,value from v$nls_parameters where parameter='NLS_CHARACTERSET' or parameter='NLS_NCHAR_CHARACTERSET'; Now prepare the database: cd /path/to/zabbix-sources/database/oracle sqlplus zabbix/password@oracle_host/ORCL sqlplus> @schema.sql # stop here if you are creating database for Zabbix proxy sqlplus> @images.sql sqlplus> @data.sql ::: notetip Please set the initialization parameter CURSOR\_SHARING=FORCE for best performance. ::: #### Datu bāzes izveide Pieņemam, ka pastāv *zabbix* datubāzes lietotājs ar paroli *password* un ka tam ir tiesības izveidot datubāzes objektus ORCL servisā, kas atrodas uz *host* Oracle datubāzes servera. Zabbix nepieciešams Unicode datubāzes rakstzīmju kopums un `UTF8` nacionālais rakstzīmju kopums. Pārbaudiet pašreizējos iestatījumus: sqlplus> select parameter,value from v$nls_parameters where parameter='NLS_CHARACTERSET' or parameter='NLS_NCHAR_CHARACTERSET'; Tagad sagatavojiet datubāzi: cd /path/to/zabbix-sources/database/oracle sqlplus zabbix/password@oracle_host/ORCL sqlplus> @schema.sql # apstājieties šeit, ja veidojat datubāzi Zabbix starpniekserverim sqlplus> @images.sql sqlplus> @data.sql ::: notetip Lūdzu, iestatiet inicializācijas parametru CURSOR\_SHARING=FORCE, lai nodrošinātu vislabāko veiktspēju. ::: ### Database credentials Access to a secret with database credentials is configured for each Zabbix component separately. #### Server and proxies To obtain database credentials from the vault for Zabbix [server](/manual/appendix/config/zabbix_server) or [proxy](/manual/appendix/config/zabbix_proxy), specify the following configuration parameters in the configuration file: - `Vault` - which vault provider should be used; - `VaultURL` - vault server HTTP\[S\] URL; - `VaultDBPath` - query to the vault secret containing database credentials which will be retrieved by keys "Content" and "UserName" (this option can only be used if DBUser and DBPassword are not specified); - `VaultTLSCertFile`, `VaultTLSKeyFile` - SSL certificate and key file names; setting up these options is not mandatory, but highly recommended; - `VaultPrefix` - custom prefix for the vault path or query, depending on the vault; if not specified, the most suitable default will be used. :::noteimportant Zabbix server also uses the `Vault`, `VaultURL`, `VaultTLSCertFile`, `VaultTLSKeyFile`, and `VaultPrefix` configuration parameters for vault authentication when processing vault secret macros. ::: Zabbix server and Zabbix proxy read the vault-related configuration parameters from *zabbix_server.conf* and *zabbix_proxy.conf* files upon startup. ### Datubāzes akreditācijas dati Piekļuve noslēpumam ar datubāzes akreditācijas datiem tiek konfigurēta katram Zabbix komponentam atsevišķi. #### Serveris un starpniekserveri Lai iegūtu datubāzes akreditācijas datus no seifa Zabbix [serverim](/manual/appendix/config/zabbix_server) vai [starpniekserverim](/manual/appendix/config/zabbix_proxy), konfigurācijas failā norādiet šādus konfigurācijas parametrus: - `Vault` - kurš seifa nodrošinātājs jāizmanto; - `VaultURL` - seifa servera HTTP\[S\] URL; - `VaultDBPath` - vaicājums uz seifa noslēpumu, kas satur datubāzes akreditācijas datus un tiks izgūts pēc atslēgām "Content" un "UserName" (šo opciju var izmantot tikai tad, ja nav norādīti DBUser un DBPassword); - `VaultTLSCertFile`, `VaultTLSKeyFile` - SSL sertifikāta un atslēgas failu nosaukumi; šo opciju iestatīšana nav obligāta, taču ir ļoti ieteicama; - `VaultPrefix` - pielāgots prefikss seifa ceļam vai vaicājumam atkarībā no seifa; ja tas nav norādīts, tiks izmantots vispiemērotākais noklusējums. :::noteimportant Zabbix serveris, apstrādājot seifa noslēpumu makro, seifa autentifikācijai izmanto arī konfigurācijas parametrus `Vault`, `VaultURL`, `VaultTLSCertFile`, `VaultTLSKeyFile` un `VaultPrefix`. ::: Zabbix serveris un Zabbix starpniekserveris, startējoties, nolasa ar seifu saistītos konfigurācijas parametrus no failiem *zabbix_server.conf* un *zabbix_proxy.conf*. #### Database patch removing redundant index An optional database patch has been added for removing a redundant `userdirectory_usrgrp_3` index during the upgrade. #### Datu bāzes ielāps lieka indeksa noņemšanai Jaunināšanas laikā ir pievienots izvēles datu bāzes ielāps, lai noņemtu lieko `userdirectory_usrgrp_3` indeksu. #### Database restore error with PostgreSQL/TimescaleDB after upgrade from 7.0.0-7.0.4 Using [`pg_restore`](https://www.postgresql.org/docs/current/app-pgrestore.html) to restore a PostgreSQL or TimescaleDB backup created in Zabbix 7.0.0-7.0.4 will result in a missing `base36_decode` function error, causing the restore to fail: ```sql ERROR: function base36_decode(text) does not exist LINE 1: CAST(base36_decode(substring(cuid FROM 2 FOR 8))/1000 AS int... ^ HINT: No function matches the given name and argument types. You might need to add explicit type casts. ``` This error occurs when restoring a backup created with [`pg_dump`](https://www.postgresql.org/docs/current/app-pgdump.html). To fix this issue, please replace the `cuid_timestamp` function in your Zabbix database **before** creating the backup (stopping PostgreSQL/TimescaleDB before running the script is recommended): ```sql CREATE OR REPLACE FUNCTION cuid_timestamp(cuid varchar(25)) RETURNS integer AS $$ DECLARE base36 varchar; a char[]; ret bigint; i int; val int; chars varchar; BEGIN base36 := substring(cuid FROM 2 FOR 8); chars := '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ'; FOR i IN REVERSE char_length(base36)..1 LOOP a := a || substring(upper(base36) FROM i FOR 1)::char; END LOOP; i := 0; ret := 0; WHILE i < (array_length(a, 1)) LOOP val := position(a[i + 1] IN chars) - 1; ret := ret + (val * (36 ^ i)); i := i + 1; END LOOP; RETURN CAST(ret/1000 AS integer); END; $$ LANGUAGE 'plpgsql' IMMUTABLE; DROP FUNCTION IF EXISTS base36_decode(character varying); ``` See also [ZBX-24955](https://support.zabbix.com/browse/ZBX-24955) (for additional details on the error) and [TimescaleDB documentation](https://docs.timescale.com/self-hosted/latest/backup-and-restore/) (for additional backup and restore options). #### Datu bāzes atjaunošanas kļūda ar PostgreSQL/TimescaleDB pēc jaunināšanas no 7.0.0-7.0.4 Izmantojot [`pg_restore`](https://www.postgresql.org/docs/current/app-pgrestore.html), lai atjaunotu PostgreSQL vai TimescaleDB dublējumu, kas izveidots Zabbix 7.0.0-7.0.4, tiks parādīta kļūda par trūkstošu `base36_decode` funkciju, un atjaunošana neizdosies: ```sql ERROR: function base36_decode(text) does not exist LINE 1: CAST(base36_decode(substring(cuid FROM 2 FOR 8))/1000 AS int... ^ HINT: No function matches the given name and argument types. You might need to add explicit type casts. ``` Šī kļūda rodas, atjaunojot dublējumu, kas izveidots ar [`pg_dump`](https://www.postgresql.org/docs/current/app-pgdump.html). Lai novērstu šo problēmu, lūdzu, aizstājiet `cuid_timestamp` funkciju savā Zabbix datubāzē **pirms** dublējuma izveides (ieteicams pirms skripta palaišanas apturēt PostgreSQL/TimescaleDB): ```sql CREATE OR REPLACE FUNCTION cuid_timestamp(cuid varchar(25)) RETURNS integer AS $$ DECLARE base36 varchar; a char[]; ret bigint; i int; val int; chars varchar; BEGIN base36 := substring(cuid FROM 2 FOR 8); chars := '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ'; FOR i IN REVERSE char_length(base36)..1 LOOP a := a || substring(upper(base36) FROM i FOR 1)::char; END LOOP; i := 0; ret := 0; WHILE i < (array_length(a, 1)) LOOP val := position(a[i + 1] IN chars) - 1; ret := ret + (val * (36 ^ i)); i := i + 1; END LOOP; RETURN CAST(ret/1000 AS integer); END; $$ LANGUAGE 'plpgsql' IMMUTABLE; DROP FUNCTION IF EXISTS base36_decode(character varying); ``` Skatiet arī [ZBX-24955](https://support.zabbix.com/browse/ZBX-24955) (papildu informācijai par kļūdu) un [TimescaleDB dokumentāciju](https://docs.timescale.com/self-hosted/latest/backup-and-restore/) (papildu dublēšanas un atjaunošanas iespējām). #### Database restore error with PostgreSQL/TimescaleDB after upgrade from 7.0.0-7.0.4 Using [`pg_restore`](https://www.postgresql.org/docs/current/app-pgrestore.html) to restore a PostgreSQL or TimescaleDB backup created in Zabbix 7.0.0-7.0.4 will result in a missing `base36_decode` function error, causing the restore to fail. This error occurs when restoring a backup created with [`pg_dump`](https://www.postgresql.org/docs/current/app-pgdump.html). See [known issues](/manual/installation/known_issues#database-restore-error-with-postgresqltimescaledb-after-upgrade-from-7.0.0-7.0.4) for details on fixing this issue manually **before** creating the backup. If you have not upgraded to Zabbix 7.0.0 yet, note that there should be no such issues for upgrades from pre-7.0 Zabbix versions to 7.0.5. For upgrade instructions, see [Upgrading TimescaleDB schema](/manual/appendix/install/timescaledb#upgrading-timescaledb-schema). #### Datu bāzes atjaunošanas kļūda ar PostgreSQL/TimescaleDB pēc jaunināšanas no 7.0.0-7.0.4 Izmantojot [`pg_restore`](https://www.postgresql.org/docs/current/app-pgrestore.html), lai atjaunotu PostgreSQL vai TimescaleDB rezerves kopiju, kas izveidota Zabbix 7.0.0-7.0.4, tiks parādīta kļūda par trūkstošu `base36_decode` funkciju, kā rezultātā atjaunošana neizdosies. Šī kļūda rodas, atjaunojot rezerves kopiju, kas izveidota ar [`pg_dump`](https://www.postgresql.org/docs/current/app-pgdump.html). Skatiet [zināmās problēmas](/manual/installation/known_issues#database-restore-error-with-postgresqltimescaledb-after-upgrade-from-7.0.0-7.0.4), lai uzzinātu, kā šo problēmu novērst manuāli **pirms** rezerves kopijas izveides. Ja vēl neesat jauninājis uz Zabbix 7.0.0, ņemiet vērā, ka, jauninot no Zabbix versijām pirms 7.0 uz 7.0.5, šādu problēmu nevajadzētu būt. Jaunināšanas norādījumus skatiet sadaļā [TimescaleDB shēmas jaunināšana](/manual/appendix/install/timescaledb#upgrading-timescaledb-schema). #### Database restore error with PostgreSQL/TimescaleDB after upgrade from 7.0.0-7.0.4 Using [`pg_restore`](https://www.postgresql.org/docs/current/app-pgrestore.html) to restore a PostgreSQL or TimescaleDB backup created in Zabbix 7.0.0-7.0.4 will result in a missing `base36_decode` function error, causing the restore to fail. This error occurs when restoring a backup created with [`pg_dump`](https://www.postgresql.org/docs/current/app-pgdump.html). See [known issues](/manual/installation/known_issues#database-restore-error-with-postgresqltimescaledb-after-upgrade-from-7.0.0-7.0.4) for details on fixing this issue manually **before** creating the backup. If you have not upgraded to Zabbix 7.0.0 yet, note that there should be no such issues for upgrades from pre-7.0 Zabbix versions to 7.0.5. For upgrade instructions, see [Upgrading TimescaleDB schema](/manual/appendix/install/timescaledb#upgrading-timescaledb-schema). #### Datu bāzes atjaunošanas kļūda ar PostgreSQL/TimescaleDB pēc jaunināšanas no 7.0.0-7.0.4 Izmantojot [`pg_restore`](https://www.postgresql.org/docs/current/app-pgrestore.html), lai atjaunotu PostgreSQL vai TimescaleDB rezerves kopiju, kas izveidota Zabbix 7.0.0-7.0.4, tiks parādīta kļūda par trūkstošu `base36_decode` funkciju, kā rezultātā atjaunošana neizdosies. Šī kļūda rodas, atjaunojot rezerves kopiju, kas izveidota ar [`pg_dump`](https://www.postgresql.org/docs/current/app-pgdump.html). Skatiet [zināmās problēmas](/manual/installation/known_issues#database-restore-error-with-postgresqltimescaledb-after-upgrade-from-7.0.0-7.0.4), lai uzzinātu, kā manuāli novērst šo problēmu **pirms** rezerves kopijas izveides. Ja vēl neesat jauninājis uz Zabbix 7.0.0, ņemiet vērā, ka, ja jaunināšana notiek no Zabbix versijām pirms 7.0 uz 7.0.5, šādu problēmu nevajadzētu būt. Jaunināšanas norādījumus skatiet sadaļā [TimescaleDB shēmas jaunināšana](/manual/appendix/install/timescaledb#upgrading-timescaledb-schema). #### Database restore error with PostgreSQL/TimescaleDB after upgrade from 7.0.0-7.0.4 Using [`pg_restore`](https://www.postgresql.org/docs/current/app-pgrestore.html) to restore a PostgreSQL or TimescaleDB backup created in Zabbix 7.0.0-7.0.4 will result in a missing `base36_decode` function error, causing the restore to fail. This error occurs when restoring a backup created with [`pg_dump`](https://www.postgresql.org/docs/current/app-pgdump.html). See [known issues](/manual/installation/known_issues#database-restore-error-with-postgresqltimescaledb-after-upgrade-from-7.0.0-7.0.4) for details on fixing this issue manually **before** creating the backup. If you have not upgraded to Zabbix 7.0.0 yet, note that there should be no such issues for upgrades from pre-7.0 Zabbix versions to 7.0.5. For upgrade instructions, see [Upgrading TimescaleDB schema](/manual/appendix/install/timescaledb#upgrading-timescaledb-schema). #### Datu bāzes atjaunošanas kļūda ar PostgreSQL/TimescaleDB pēc jaunināšanas no 7.0.0-7.0.4 Izmantojot [`pg_restore`](https://www.postgresql.org/docs/current/app-pgrestore.html), lai atjaunotu PostgreSQL vai TimescaleDB rezerves kopiju, kas izveidota Zabbix 7.0.0-7.0.4, tiks saņemta kļūda par trūkstošu `base36_decode` funkciju, kā rezultātā atjaunošana neizdosies. Šī kļūda rodas, atjaunojot rezerves kopiju, kas izveidota ar [`pg_dump`](https://www.postgresql.org/docs/current/app-pgdump.html). Skatiet [zināmās problēmas](/manual/installation/known_issues#database-restore-error-with-postgresqltimescaledb-after-upgrade-from-7.0.0-7.0.4), lai uzzinātu, kā manuāli novērst šo problēmu **pirms** rezerves kopijas izveides. Ja vēl neesat jauninājis uz Zabbix 7.0.0, ņemiet vērā, ka, ja jaunināšana notiek no Zabbix versijām pirms 7.0 uz 7.0.5, šādu problēmu nevajadzētu būt. Norādījumus par jaunināšanu skatiet sadaļā [TimescaleDB shēmas jaunināšana](/manual/appendix/install/timescaledb#upgrading-timescaledb-schema). #### Database restore error with PostgreSQL/TimescaleDB after upgrade from 7.0.0-7.0.4 Using [`pg_restore`](https://www.postgresql.org/docs/current/app-pgrestore.html) to restore a PostgreSQL or TimescaleDB backup created in Zabbix 7.0.0-7.0.4 will result in a missing `base36_decode` function error, causing the restore to fail. This error occurs when restoring a backup created with [`pg_dump`](https://www.postgresql.org/docs/current/app-pgdump.html). See [known issues](/manual/installation/known_issues#database-restore-error-with-postgresqltimescaledb-after-upgrade-from-7.0.0-7.0.4) for details on fixing this issue manually **before** creating the backup. If you have not upgraded to Zabbix 7.0.0 yet, note that there should be no such issues for upgrades from pre-7.0 Zabbix versions to 7.0.5. For upgrade instructions, see [Upgrading TimescaleDB schema](/manual/appendix/install/timescaledb#upgrading-timescaledb-schema). #### Datu bāzes atjaunošanas kļūda ar PostgreSQL/TimescaleDB pēc jaunināšanas no 7.0.0-7.0.4 Izmantojot [`pg_restore`](https://www.postgresql.org/docs/current/app-pgrestore.html), lai atjaunotu PostgreSQL vai TimescaleDB rezerves kopiju, kas izveidota Zabbix 7.0.0-7.0.4, tiks parādīta kļūda par trūkstošu `base36_decode` funkciju, un atjaunošana neizdosies. Šī kļūda rodas, atjaunojot rezerves kopiju, kas izveidota ar [`pg_dump`](https://www.postgresql.org/docs/current/app-pgdump.html). Skatiet [zināmās problēmas](/manual/installation/known_issues#database-restore-error-with-postgresqltimescaledb-after-upgrade-from-7.0.0-7.0.4), lai uzzinātu, kā manuāli novērst šo problēmu **pirms** rezerves kopijas izveides. Ja vēl neesat jauninājis uz Zabbix 7.0.0, ņemiet vērā, ka, ja jaunināšana notiek no Zabbix versijām pirms 7.0 uz 7.0.5, šādu problēmu nevajadzētu būt. Jaunināšanas norādījumus skatiet sadaļā [TimescaleDB shēmas jaunināšana](/manual/appendix/install/timescaledb#upgrading-timescaledb-schema). #### Database restore error with PostgreSQL/TimescaleDB after upgrade from 7.0.0-7.0.4 Using [`pg_restore`](https://www.postgresql.org/docs/current/app-pgrestore.html) to restore a PostgreSQL or TimescaleDB backup created in Zabbix 7.0.0-7.0.4 will result in a missing `base36_decode` function error, causing the restore to fail. This error occurs when restoring a backup created with [`pg_dump`](https://www.postgresql.org/docs/current/app-pgdump.html). See [known issues](/manual/installation/known_issues#database-restore-error-with-postgresqltimescaledb-after-upgrade-from-7.0.0-7.0.4) for details on fixing this issue manually **before** creating the backup. If you have not upgraded to Zabbix 7.0.0 yet, note that there should be no such issues for upgrades from pre-7.0 Zabbix versions to 7.0.5. For upgrade instructions, see [Upgrading TimescaleDB schema](/manual/appendix/install/timescaledb#upgrading-timescaledb-schema). #### Datu bāzes atjaunošanas kļūda ar PostgreSQL/TimescaleDB pēc jaunināšanas no 7.0.0-7.0.4 Izmantojot [`pg_restore`](https://www.postgresql.org/docs/current/app-pgrestore.html), lai atjaunotu PostgreSQL vai TimescaleDB rezerves kopiju, kas izveidota Zabbix 7.0.0-7.0.4, tiks parādīta kļūda par trūkstošu `base36_decode` funkciju, kā rezultātā atjaunošana neizdosies. Šī kļūda rodas, atjaunojot rezerves kopiju, kas izveidota ar [`pg_dump`](https://www.postgresql.org/docs/current/app-pgdump.html). Skatiet [zināmās problēmas](/manual/installation/known_issues#database-restore-error-with-postgresqltimescaledb-after-upgrade-from-7.0.0-7.0.4), lai uzzinātu, kā manuāli novērst šo problēmu **pirms** rezerves kopijas izveides. Ja vēl neesat jauninājis uz Zabbix 7.0.0, ņemiet vērā, ka, ja jaunināšana notiek no Zabbix versijām pirms 7.0 uz 7.0.5, šādu problēmu nevajadzētu būt. Jaunināšanas norādījumus skatiet sadaļā [TimescaleDB shēmas jaunināšana](/manual/appendix/install/timescaledb#upgrading-timescaledb-schema). #### Database restore error with PostgreSQL/TimescaleDB after upgrade from 7.0.0-7.0.4 Using [`pg_restore`](https://www.postgresql.org/docs/current/app-pgrestore.html) to restore a PostgreSQL or TimescaleDB backup created in Zabbix 7.0.0-7.0.4 will result in a missing `base36_decode` function error, causing the restore to fail. This error occurs when restoring a backup created with [`pg_dump`](https://www.postgresql.org/docs/current/app-pgdump.html). See [known issues](/manual/installation/known_issues#database-restore-error-with-postgresqltimescaledb-after-upgrade-from-7.0.0-7.0.4) for details on fixing this issue manually **before** creating the backup. If you have not upgraded to Zabbix 7.0.0 yet, note that there should be no such issues for upgrades from pre-7.0 Zabbix versions to 7.0.5. For upgrade instructions, see [Upgrading TimescaleDB schema](/manual/appendix/install/timescaledb#upgrading-timescaledb-schema). #### Datu bāzes atjaunošanas kļūda ar PostgreSQL/TimescaleDB pēc jaunināšanas no 7.0.0-7.0.4 Izmantojot [`pg_restore`](https://www.postgresql.org/docs/current/app-pgrestore.html), lai atjaunotu PostgreSQL vai TimescaleDB dublējumu, kas izveidots Zabbix 7.0.0-7.0.4, tiks parādīta kļūda par trūkstošu `base36_decode` funkciju, kā rezultātā atjaunošana neizdosies. Šī kļūda rodas, atjaunojot dublējumu, kas izveidots ar [`pg_dump`](https://www.postgresql.org/docs/current/app-pgdump.html). Skatiet [zināmās problēmas](/manual/installation/known_issues#database-restore-error-with-postgresqltimescaledb-after-upgrade-from-7.0.0-7.0.4), lai uzzinātu, kā manuāli novērst šo problēmu **pirms** dublējuma izveides. Ja vēl neesat jauninājis uz Zabbix 7.0.0, ņemiet vērā, ka, ja jaunināšana notiek no Zabbix versijām pirms 7.0 uz 7.0.5, šādu problēmu nevajadzētu būt. Jaunināšanas norādījumus skatiet sadaļā [TimescaleDB shēmas jaunināšana](/manual/appendix/install/timescaledb#upgrading-timescaledb-schema). ## Databases ## Datubāzes ## Databases ## Datubāzes ## Databases ## Datubāzes ## Databases ## Datubāzes ## Databases ## Datubāzes #### Database size Zabbix configuration data require a fixed amount of disk space and do not grow much. Zabbix database size mainly depends on these variables, which define the amount of stored historical data: - Number of processed values per second This is the average number of new values Zabbix server receives every second. For example, if we have 3000 items for monitoring with a refresh rate of 60 seconds, the number of values per second is calculated as 3000/60 = **50**. It means that 50 new values are added to Zabbix database every second. - Housekeeper settings for history Zabbix keeps values for a fixed period of time, normally several weeks or months. Each new value requires a certain amount of disk space for data and index. So, if we would like to keep 30 days of history and we receive 50 values per second, the total number of values will be around (**30**\*24\*3600)\* **50** = 129.600.000, or about 130M of values. Depending on the database engine used, type of received values (floats, integers, strings, log files, etc), the disk space for keeping a single value may vary from 40 bytes to hundreds of bytes. Normally it is around 90 bytes per value for numeric items^**2**^. In our case, it means that 130M of values will require 130M \* 90 bytes = **10.9GB** of disk space. ::: noteclassic The size of text/log item values is impossible to predict exactly, but you may expect around 500 bytes per value. ::: - Housekeeper setting for trends Zabbix keeps a 1-hour max/min/avg/count set of values for each item in the table **trends**. The data is used for trending and long period graphs. The one hour period cannot be customized. Zabbix database, depending on the database type, requires about 90 bytes per each total. Suppose we would like to keep trend data for 5 years. Values for 3000 items will require 3000\*24\*365\* **90** = **2.2GB** per year, or **11GB** for 5 years. - Housekeeper settings for events Each Zabbix event requires approximately 250 bytes of disk space^**1**^. It is hard to estimate the number of events generated by Zabbix daily. In the worst-case scenario, we may assume that Zabbix generates one event per second. For each recovered event, an event\_recovery record is created. Normally most of the events will be recovered so we can assume one event\_recovery record per event. That means additional 80 bytes per event. Optionally events can have tags, each tag record requiring approximately 100 bytes of disk space^**1**^. The number of tags per event (\#tags) depends on configuration. So each will need an additional \#tags \* 100 bytes of disk space. It means that if we want to keep 3 years of events, this would require 3\*365\*24\*3600\* (250+80+\#tags\*100) = **\~30GB**+\#tags\*100B disk space^**2**^. ::: noteclassic ^**1**^ More when having non-ASCII event names, tags and values.<br> ^**2**^ The size approximations are based on MySQL and might be different for other databases. ::: The table contains formulas that can be used to calculate the disk space required for Zabbix system: |Parameter|Formula for required disk space (in bytes)| |---------|------------------------------------------| |*Zabbix configuration*|Fixed size. Normally 10MB or less.| |*History*|days\*(items/refresh rate)\*24\*3600\*bytes<br>items : number of items<br>days : number of days to keep history<br>refresh rate : average refresh rate of items<br>bytes : number of bytes required to keep single value, depends on database engine, normally \~90 bytes.| |*Trends*|days\*(items/3600)\*24\*3600\*bytes<br>items : number of items<br>days : number of days to keep history<br>bytes : number of bytes required to keep single trend, depends on the database engine, normally \~90 bytes.| |*Events*|days\*events\*24\*3600\*bytes<br>events : number of event per second. One (1) event per second in worst-case scenario.<br>days : number of days to keep history<br>bytes : number of bytes required to keep single event, depends on the database engine, normally \~330 + average number of tags per event \* 100 bytes.| So, the total required disk space can be calculated as: **Configuration + History + Trends + Events** The disk space will NOT be used immediately after Zabbix installation. Database size will grow then it will stop growing at some point, which depends on housekeeper settings. #### Datubāzes lielums Zabbix konfigurācijas datiem ir nepieciešams noteikts diska vietas apjoms, un tie būtiski nepalielinās. Zabbix datubāzes lielums galvenokārt ir atkarīgs no šiem mainīgajiem, kas nosaka saglabāto vēsturisko datu apjomu: - Apstrādāto vērtību skaits sekundē Tas ir vidējais jauno vērtību skaits, ko Zabbix serveris saņem katru sekundi. Piemēram, ja mums ir 3000 vienumi uzraudzībai ar atjaunināšanas intervālu 60 sekundes, vērtību skaits sekundē tiek aprēķināts šādi: 3000/60 = **50**. Tas nozīmē, ka Zabbix datubāzei katru sekundi tiek pievienotas 50 jaunas vērtības. - Housekeeper iestatījumi vēsturei Zabbix saglabā vērtības noteiktu laika periodu, parasti vairākas nedēļas vai mēnešus. Katrai jaunai vērtībai ir nepieciešams noteikts diska vietas apjoms datiem un indeksam. Tātad, ja mēs vēlamies saglabāt 30 dienu vēsturi un saņemam 50 vērtības sekundē, kopējais vērtību skaits būs aptuveni (**30**\*24\*3600)\* **50** = 129.600.000 jeb aptuveni 130M vērtību. Atkarībā no izmantotās datubāzes dzinēja, saņemto vērtību tipa (peldošā komata skaitļi, veseli skaitļi, virknes, žurnālfaili utt.) diska vieta vienas vērtības glabāšanai var svārstīties no 40 baitiem līdz simtiem baitu. Parasti skaitliskiem vienumiem tas ir apmēram 90 baiti uz vērtību^**2**^. Mūsu gadījumā tas nozīmē, ka 130M vērtību būs nepieciešami 130M \* 90 baiti = **10.9GB** diska vietas. ::: noteclassic Teksta/žurnāla vienumu vērtību lielumu nav iespējams precīzi paredzēt, taču var rēķināties ar aptuveni 500 baitiem uz vērtību. ::: - Housekeeper iestatījums tendencēm Zabbix tabulā **trends** katram vienumam saglabā 1 stundas max/min/avg/count vērtību kopu. Šie dati tiek izmantoti tendenču analīzei un ilgtermiņa grafikiem. Vienas stundas periodu nevar pielāgot. Zabbix datubāzei atkarībā no datubāzes tipa ir nepieciešami aptuveni 90 baiti katram šādam ierakstam. Pieņemsim, ka mēs vēlamies saglabāt tendenču datus 5 gadus. Vērtībām no 3000 vienumiem būs nepieciešami 3000\*24\*365\* **90** = **2.2GB** gadā jeb **11GB** 5 gados. - Housekeeper iestatījumi notikumiem Katram Zabbix notikumam ir nepieciešami aptuveni 250 baiti diska vietas^**1**^. Ir grūti novērtēt, cik notikumu Zabbix ģenerē dienā. Sliktākajā gadījumā var pieņemt, ka Zabbix ģenerē vienu notikumu sekundē. Katram atjaunotajam notikumam tiek izveidots event\_recovery ieraksts. Parasti lielākā daļa notikumu tiks atjaunoti, tāpēc var pieņemt vienu event\_recovery ierakstu uz vienu notikumu. Tas nozīmē papildu 80 baitus uz notikumu. Pēc izvēles notikumiem var būt birkas, un katram birkas ierakstam ir nepieciešami aptuveni 100 baiti diska vietas^**1**^. Birkas skaits uz notikumu (\#tags) ir atkarīgs no konfigurācijas. Tātad katram notikumam papildus būs nepieciešams \#tags \* 100 baitu diska vietas. Tas nozīmē, ka, ja mēs vēlamies saglabāt 3 gadu notikumus, tam būs nepieciešama 3\*365\*24\*3600\* (250+80+\#tags\*100) = **\~30GB**+\#tags\*100B diska vieta^**2**^. ::: noteclassic ^**1**^ Vairāk, ja notikumu nosaukumos, birkās un vērtībās ir rakstzīmes, kas nav ASCII.<br> ^**2**^ Lieluma aptuvenie aprēķini ir balstīti uz MySQL un citām datubāzēm var atšķirties. ::: Tabulā ir formulas, kuras var izmantot, lai aprēķinātu Zabbix sistēmai nepieciešamo diska vietu: |Parameter|Formula for required disk space (in bytes)| |---------|------------------------------------------| |*Zabbix configuration*|Fiksēts lielums. Parasti 10MB vai mazāk.| |*History*|days\*(items/refresh rate)\*24\*3600\*bytes<br>items : vienumu skaits<br>days : dienu skaits, cik ilgi saglabāt vēsturi<br>refresh rate : vienumu vidējais atjaunināšanas intervāls<br>bytes : baitu skaits, kas nepieciešams vienas vērtības glabāšanai; atkarīgs no datubāzes dzinēja, parasti \~90 baiti.| |*Trends*|days\*(items/3600)\*24\*3600\*bytes<br>items : vienumu skaits<br>days : dienu skaits, cik ilgi saglabāt vēsturi<br>bytes : baitu skaits, kas nepieciešams vienas tendences glabāšanai; atkarīgs no datubāzes dzinēja, parasti \~90 baiti.| |*Events*|days\*events\*24\*3600\*bytes<br>events : notikumu skaits sekundē. Sliktākajā gadījumā viens (1) notikums sekundē.<br>days : dienu skaits, cik ilgi saglabāt vēsturi<br>bytes : baitu skaits, kas nepieciešams viena notikuma glabāšanai; atkarīgs no datubāzes dzinēja, parasti \~330 + vidējais birku skaits uz notikumu \* 100 baiti.| Tātad kopējo nepieciešamo diska vietu var aprēķināt šādi: **Configuration + History + Trends + Events** Diska vieta NETIKS izmantota uzreiz pēc Zabbix instalēšanas. Datubāzes lielums pieaugs, un pēc tam kādā brīdī pārstās pieaugt, atkarībā no housekeeper iestatījumiem. ##### Database storage All configuration information as well as the data gathered by Zabbix is stored in a database. ##### Datu bāzes krātuve Visa konfigurācijas informācija, kā arī Zabbix savāktie dati tiek glabāti datu bāzē. #### Database TLS connection with MariaDB Database TLS connection is not supported with the 'verify\_ca' option for the DBTLSConnect [parameter](/manual/appendix/config/zabbix_server) if MariaDB is used. #### Datubāzes TLS savienojums ar MariaDB Datubāzes TLS savienojums netiek atbalstīts ar opciju 'verify\_ca' DBTLSConnect [parametram](/manual/appendix/config/zabbix_server), ja tiek izmantota MariaDB. ## Data collection The Zabbix API allows you to manage the configuration of your monitoring system. ## Datu vākšana Zabbix API ļauj pārvaldīt jūsu uzraudzības sistēmas konfigurāciju. #### Data collection Virtual machine monitoring consists of two steps: 1. Zabbix *vmware collector* processes collect virtual machine data - the processes obtain necessary information from VMware web services over the SOAP protocol, pre-process it, and store it in Zabbix server shared memory. 2. Zabbix *poller* processes retrieve data using Zabbix simple check [VMware monitoring item keys](/manual/vm_monitoring/vmware_keys). Zabbix divides collected data into VMware configuration data and VMware performance counter data. Both types of data are collected independently by the *vmware collector* processes. The following statistics are available based on the VMware performance counter information: - Datastore - Disk device - CPU - Power - Network interface - Custom performance counter items For the complete list of items that obtain data from VMware performance counters, see [*VMware monitoring item keys*](/manual/vm_monitoring/vmware_keys#footnotes). Note that the frequency of VMware event retrieval depends on the polling interval of [vmware.eventlog](/manual/vm_monitoring/vmware_keys#vmware.eventlog), but cannot be less then 5 seconds. #### Datu vākšana Virtuālo mašīnu uzraudzība sastāv no diviem soļiem: 1. Zabbix *vmware collector* procesi apstrādā virtuālo mašīnu datus — procesi iegūst nepieciešamo informāciju no VMware tīmekļa pakalpojumiem, izmantojot SOAP protokolu, to iepriekš apstrādā un saglabā Zabbix servera koplietojamajā atmiņā. 2. Zabbix *poller* procesi izgūst datus, izmantojot Zabbix vienkāršo pārbaudi [VMware monitoring item keys](/manual/vm_monitoring/vmware_keys). Zabbix sadala savāktos datus VMware konfigurācijas datos un VMware veiktspējas skaitītāju datos. Abu veidu datus neatkarīgi vāc *vmware collector* procesi. Pamatojoties uz VMware veiktspējas skaitītāju informāciju, ir pieejama šāda statistika: - Datu krātuve - Diska ierīce - CPU - Barošana - Tīkla saskarne - Pielāgotie veiktspējas skaitītāju vienumi Pilnu vienumu sarakstu, kas iegūst datus no VMware veiktspējas skaitītājiem, skatiet [*VMware monitoring item keys*](/manual/vm_monitoring/vmware_keys#footnotes). Ņemiet vērā, ka VMware notikumu izgūšanas biežums ir atkarīgs no [vmware.eventlog](/manual/vm_monitoring/vmware_keys#vmware.eventlog) aptaujas intervāla, taču tas nevar būt mazāks par 5 sekundēm. #### Data collection with custom commands #### Datu vākšana ar pielāgotām komandām ##### Data collection with parameters Collect the content of a specific page and make use of parameters: - Create an item with type "Script" and two parameters: - **url : {$DOMAIN}** (the user macro {$DOMAIN} should be defined, preferably on the host level) - **subpage : /release_notes** {width=600} - In the *Script* field, enter: ```javascript var obj = JSON.parse(value); var url = obj.url; var subpage = obj.subpage; var request = new HttpRequest(); return request.get(url + subpage); ``` ##### Datu vākšana ar parametriem Savāciet konkrētas lapas saturu un izmantojiet parametrus: - Izveidojiet vienumu ar tipu "Script" un diviem parametriem: - **url : {$DOMAIN}** (lietotāja makro {$DOMAIN} ir jābūt definētam, vēlams hosta līmenī) - **subpage : /release_notes** {width=600} - Laukā *Script* ievadiet: ```javascript var obj = JSON.parse(value); var url = obj.url; var subpage = obj.subpage; var request = new HttpRequest(); return request.get(url + subpage); ``` #### Data flow In addition it is important to take a step back and have a look at the overall data flow within Zabbix. In order to create an item that gathers data you must first create a host. Moving to the other end of the Zabbix spectrum you must first have an item to create a trigger. You must have a trigger to create an action. Thus if you want to receive an alert that your CPU load is too high on *Server X* you must first create a host entry for *Server X* followed by an item for monitoring its CPU, then a trigger which activates if the CPU is too high, followed by an action which sends you an email. While that may seem like a lot of steps, with the use of templating it really isn't. However, due to this design it is possible to create a very flexible setup. #### Datu plūsma Turklāt ir svarīgi atkāpties soli atpakaļ un aplūkot kopējo datu plūsmu Zabbix sistēmā. Lai izveidotu vienumu, kas apkopo datus, vispirms ir jāizveido hosts. Pārejot uz otru Zabbix spektra galu, vispirms ir nepieciešams vienums, lai izveidotu trigeri. Lai izveidotu darbību, jums ir nepieciešams trigeris. Tādējādi, ja vēlaties saņemt brīdinājumu, ka jūsu CPU noslodze ir pārāk augsta uz *Server X*, vispirms ir jāizveido hosts ieraksts *Server X*, pēc tam vienums tā CPU uzraudzībai, tad trigeris, kas aktivizējas, ja CPU noslodze ir pārāk augsta, un pēc tam darbība, kas nosūta jums e-pastu. Lai gan tas var šķist daudz soļu, izmantojot veidnes, tā patiesībā nav. Tomēr šī dizaina dēļ ir iespējams izveidot ļoti elastīgu konfigurāciju. #### Data limits for return values There is no limit for low-level discovery rule JSON data if it is received directly by Zabbix server. This is because the return values are processed without being stored in a database. There is also no limit for custom low-level discovery rules. However, if custom low-level discovery rule data is retrieved using a user parameter, the user parameter [return value limit](/manual/config/items/userparameters#command-result) applies. If data has to go through Zabbix proxy, it has to store this data in the database. In such a case, [database limits](/manual/config/items/item#text-data-limits) apply. #### Datu atgrieztajām vērtībām noteiktie limiti Zema līmeņa atklāšanas noteikuma JSON datiem nav ierobežojuma, ja tie tiek saņemti tieši no Zabbix serveris. Tas ir tāpēc, ka atgrieztās vērtības tiek apstrādātas, tās neuzglabājot datubāzē. Arī pielāgotiem zema līmeņa atklāšanas noteikumiem ierobežojuma nav. Tomēr, ja pielāgota zema līmeņa atklāšanas noteikuma dati tiek izgūti, izmantojot lietotāja parametru, tiek piemērots lietotāja parametra [atgrieztās vērtības limits](/manual/config/items/userparameters#command-result). Ja datiem ir jāiet caur Zabbix starpniekserveris, tam šie dati ir jāuzglabā datubāzē. Šādā gadījumā tiek piemēroti [datubāzes limiti](/manual/config/items/item#text-data-limits). ##### Data request The `proxy data` request is sent by proxy to provide host interface availability, history, discovery and autoregistration data. This request is sent every `DataSenderFrequency` (proxy configuration parameter) seconds. Note that active proxy will still poll Zabbix server every second for remote command tasks (with an empty `proxy data` request). |name|<|value type|description| |-|----------|----------|----------------------------------------| |proxy→server:|<|<|<| |**request**|<|*string*|'proxy data'| |**host**|<|*string*|Proxy name.| |**session**|<|*string*|Data session token.| |**interface availability**|<|*array*|*(optional)* Array of interface availability data objects.| | |**interfaceid**|*number*|Interface identifier.| |^|**available**|*number*|Interface availability:<br><br>**0**, *INTERFACE\_AVAILABLE\_UNKNOWN* - unknown<br>**1**, *INTERFACE\_AVAILABLE\_TRUE* - available<br>**2**, *INTERFACE\_AVAILABLE\_FALSE* - unavailable| |^|**error**|*string*|Interface error message or empty string.| |**history data**|<|*array*|*(optional)* Array of history data objects.| | |**itemid**|*number*|Item identifier.| |^|**clock**|*number*|Item value timestamp (seconds).| |^|**ns**|*number*|Item value timestamp (nanoseconds).| |^|**value**|*string*|*(optional)* Item value.| |^|**id**|*number*|Value identifier (ascending counter, unique within one data session).| |^|**timestamp**|*number*|*(optional)* Timestamp of log type items.| |^|**source**|*string*|*(optional)* Eventlog item source value.| |^|**severity**|*number*|*(optional)* Eventlog item severity value.| |^|**eventid**|*number*|*(optional)* Eventlog item eventid value.| |^|**state**|*string*|*(optional)* Item state:<br>**0**, *ITEM\_STATE\_NORMAL*<br>**1**, *ITEM\_STATE\_NOTSUPPORTED*| |^|**lastlogsize**|*number*|*(optional)* Last log size of log type items.| |^|**mtime**|*number*|*(optional)* Modification time of log type items.| |**discovery data**|<|*array*|*(optional)* Array of discovery data objects.| | |**clock**|*number*|Discovery data timestamp.| |^|**druleid**|*number*|Discovery rule identifier.| |^|**dcheckid**|*number*|Discovery check identifier or null for discovery rule data.| |^|**type**|*number*|Discovery check type:<br><br>**-1** discovery rule data<br>**0**, *SVC\_SSH* - SSH service check<br>**1**, *SVC\_LDAP* - LDAP service check<br>**2**, *SVC\_SMTP* - SMTP service check<br>**3**, *SVC\_FTP* - FTP service check<br>**4**, *SVC\_HTTP* - HTTP service check<br>**5**, *SVC\_POP* - POP service check<br>**6**, *SVC\_NNTP* - NNTP service check<br>**7**, *SVC\_IMAP* - IMAP service check<br>**8**, *SVC\_TCP* - TCP port availability check<br>**9**, *SVC\_AGENT* - Zabbix agent<br>**10**, *SVC\_SNMPv1* - SNMPv1 agent<br>**11**, *SVC\_SNMPv2* - SNMPv2 agent<br>**12**, *SVC\_ICMPPING* - ICMP ping<br>**13**, *SVC\_SNMPv3* - SNMPv3 agent<br>**14**, *SVC\_HTTPS* - HTTPS service check<br>**15**, *SVC\_TELNET* - Telnet availability check| |^|**ip**|*string*|Host IP address.| |^|**dns**|*string*|Host DNS name.| |^|**port**|*number*|*(optional)* Service port number.| |^|**key\_**|*string*|*(optional)* Item key for discovery check of type **9** *SVC\_AGENT*| |^|**value**|*string*|*(optional)* Value received from the service, can be empty for most services.| |^|**status**|*number*|*(optional)* Service status:<br><br>**0**, *DOBJECT\_STATUS\_UP* - Service UP<br>**1**, *DOBJECT\_STATUS\_DOWN* - Service DOWN| |**autoregistration**|<|*array*|*(optional)* Array of autoregistration data objects.| | |**clock**|*number*|Autoregistration data timestamp.| |^|**host**|*string*|Host name.| |^|**ip**|*string*|*(optional)* Host IP address.| |^|**dns**|*string*|*(optional)* Resolved DNS name from IP address.| |^|**port**|*string*|*(optional)* Host port.| |^|**host\_metadata**|*string*|*(optional)* Host metadata sent by agent (based on HostMetadata or HostMetadataItem agent configuration parameter).| |**tasks**|<|*array*|*(optional)* Array of tasks.| | |**type**|*number*|Task type:<br><br>**0**, *ZBX\_TM\_TASK\_PROCESS\_REMOTE\_COMMAND\_RESULT* - remote command result| |^|**status**|*number*|Remote-command execution status:<br><br>**0**, *ZBX\_TM\_REMOTE\_COMMAND\_COMPLETED* - remote command completed successfully<br>**1**, *ZBX\_TM\_REMOTE\_COMMAND\_FAILED* - remote command failed| |^|**error**|*string*|*(optional)* Error message.| |^|**parent\_taskid**|*number*|Parent task ID.| |**more**|<|*number*|*(optional)* 1 - there are more history data to send| |**clock**|<|*number*|*(optional)* Data transfer timestamp (seconds).| |**ns**|<|*number*|*(optional)* Data transfer timestamp (nanoseconds).| |**version**|<|*string*|Proxy version (<major>.<minor>.<build>).| |server→proxy:|<|<|<| |**response**|<|*string*|Request success information ('success' or 'failed').| |**upload**|<|*string*|Upload control for historical data (history, autoregistration, host availability, network discovery).<br><br>Possible values:<br>**enabled** - normal operation<br>**disabled** - server is not accepting data (possibly due to internal cache over limit)| |**tasks**|<|*array*|*(optional)* Array of tasks.| | |**type**|*number*|Task type:<br><br>**1**, *ZBX\_TM\_TASK\_PROCESS\_REMOTE\_COMMAND* - remote command| |^|**clock**|*number*|Task creation time.| |^|**ttl**|*number*|Time in seconds after which the task expires.| |^|**commandtype**|*number*|Remote-command type:<br><br>**0**, *ZBX\_SCRIPT\_TYPE\_CUSTOM\_SCRIPT* - use custom script<br>**1**, *ZBX\_SCRIPT\_TYPE\_IPMI* - use IPMI<br>**2**, *ZBX\_SCRIPT\_TYPE\_SSH* - use SSH<br>**3**, *ZBX\_SCRIPT\_TYPE\_TELNET* - use Telnet<br>**4**, *ZBX\_SCRIPT\_TYPE\_GLOBAL\_SCRIPT* - use global script (currently functionally equivalent to custom script)| |^|**command**|*string*|Remote command to execute.| |^|**execute\_on**|*number*|Execution target for custom scripts:<br><br>**0**, *ZBX\_SCRIPT\_EXECUTE\_ON\_AGENT* - execute script on agent<br>**1**, *ZBX\_SCRIPT\_EXECUTE\_ON\_SERVER* - execute script on server<br>**2**, *ZBX\_SCRIPT\_EXECUTE\_ON\_PROXY* - execute script on proxy| |^|**port**|*number*|*(optional)* Port for Telnet and SSH commands.| |^|**authtype**|*number*|*(optional)* Authentication type for SSH commands.| |^|**username**|*string*|*(optional)* User name for Telnet and SSH commands.| |^|**password**|*string*|*(optional)* Password for Telnet and SSH commands.| |^|**publickey**|*string*|*(optional)* Public key for SSH commands.| |^|**privatekey**|*string*|*(optional)* Private key for SSH commands.| |^|**parent\_taskid**|*number*|Parent task ID.| |^|**hostid**|*number*|Target host ID.| Example: proxy→server: ``` {.javascript} { "request": "proxy data", "host": "Zabbix proxy", "session": "818cdd1b537bdc5e50c09ed4969235b6", "interface availability": [{ "interfaceid": 1, "available": 1, "error": "" }], "history data": [{ "id": 1114, "itemid": 44162, "clock": 1665730632, "ns": 798953105, "value": "1" }, { "id": 1115, "itemid": 44161, "clock": 1665730633, "ns": 811684663, "value": "58" }], "auto registration": [{ "clock": 1665730633, "host": "Zabbix server", "ip": "127.0.0.1", "dns": "localhost", "port": "10053", "host_metadata": "58", "tls_accepted": 1 }], "discovery data": [{ "clock": 1665732232, "drule": 2, "dcheck": 2, "ip": "127.0.0.1", "dns": "localhost", "port": 10052, "status": 1 }, { "clock": 1665732232, "drule": 2, "dcheck": null, "ip": "127.0.0.1", "dns": "localhost", "status": 1 }], "host data": [{ "hostid": 10084, "active_status": 1 }], "tasks": [{ "type": 3, "clock": 1665730985, "ttl": 0, "status": -1, "info": "Remote commands are not enabled", "parent_taskid": 3 }], "version": "7.0.0", "clock": 1665730643, "ns": 65389964 } ``` server→proxy: ``` {.javascript} { "upload": "enabled", "response": "success", "tasks": [{ "type": 2, "clock": 1665730986, "ttl": 600, "commandtype": 0, "command": "ping -c 3 127.0.0.1; case $? in [01]) true;; *) false;; esac", "execute_on": 2, "port": 0, "authtype": 0, "username": "", "password": "", "publickey": "", "privatekey": "", "alertid": 0, "parent_taskid": 4, "hostid": 10084 }] } ``` ##### Datu pieprasījums `proxy data` pieprasījumu starpniekserveris nosūta, lai nodrošinātu hostu interfeisu pieejamības, vēstures, atklāšanas un automātiskās reģistrācijas datus. Šis pieprasījums tiek nosūtīts ik pēc `DataSenderFrequency` (starpniekservera konfigurācijas parametrs) sekundēm. Ņemiet vērā, ka aktīvais starpniekserveris joprojām katru sekundi aptaujās Zabbix serveri par attālināto komandu uzdevumiem (ar tukšu `proxy data` pieprasījumu). |name|<|value type|description| |-|----------|----------|----------------------------------------| |proxy→server:|<|<|<| |**request**|<|*string*|'proxy data'| |**host**|<|*string*|Starpniekservera nosaukums.| |**session**|<|*string*|Datu sesijas marķieris.| |**interface availability**|<|*array*|*(optional)* Interfeisu pieejamības datu objektu masīvs.| | |**interfaceid**|*number*|Interfeisa identifikators.| |^|**available**|*number*|Interfeisa pieejamība:<br><br>**0**, *INTERFACE\_AVAILABLE\_UNKNOWN* - nezināms<br>**1**, *INTERFACE\_AVAILABLE\_TRUE* - pieejams<br>**2**, *INTERFACE\_AVAILABLE\_FALSE* - nav pieejams| |^|**error**|*string*|Interfeisa kļūdas ziņojums vai tukša virkne.| |**history data**|<|*array*|*(optional)* Vēstures datu objektu masīvs.| | |**itemid**|*number*|Vienuma identifikators.| |^|**clock**|*number*|Vienuma vērtības laikspiedols (sekundēs).| |^|**ns**|*number*|Vienuma vērtības laikspiedols (nanosekundēs).| |^|**value**|*string*|*(optional)* Vienuma vērtība.| |^|**id**|*number*|Vērtības identifikators (augošs skaitītājs, unikāls vienas datu sesijas ietvaros).| |^|**timestamp**|*number*|*(optional)* Žurnāla tipa vienumu laikspiedols.| |^|**source**|*string*|*(optional)* Eventlog vienuma avota vērtība.| |^|**severity**|*number*|*(optional)* Eventlog vienuma nopietnības vērtība.| |^|**eventid**|*number*|*(optional)* Eventlog vienuma eventid vērtība.| |^|**state**|*string*|*(optional)* Vienuma stāvoklis:<br>**0**, *ITEM\_STATE\_NORMAL*<br>**1**, *ITEM\_STATE\_NOTSUPPORTED*| |^|**lastlogsize**|*number*|*(optional)* Žurnāla tipa vienumu pēdējais žurnāla izmērs.| |^|**mtime**|*number*|*(optional)* Žurnāla tipa vienumu modificēšanas laiks.| |**discovery data**|<|*array*|*(optional)* Atklāšanas datu objektu masīvs.| | |**clock**|*number*|Atklāšanas datu laikspiedols.| |^|**druleid**|*number*|Atklāšanas noteikuma identifikators.| |^|**dcheckid**|*number*|Atklāšanas pārbaudes identifikators vai null atklāšanas noteikuma datiem.| |^|**type**|*number*|Atklāšanas pārbaudes tips:<br><br>**-1** atklāšanas noteikuma dati<br>**0**, *SVC\_SSH* - SSH pakalpojuma pārbaude<br>**1**, *SVC\_LDAP* - LDAP pakalpojuma pārbaude<br>**2**, *SVC\_SMTP* - SMTP pakalpojuma pārbaude<br>**3**, *SVC\_FTP* - FTP pakalpojuma pārbaude<br>**4**, *SVC\_HTTP* - HTTP pakalpojuma pārbaude<br>**5**, *SVC\_POP* - POP pakalpojuma pārbaude<br>**6**, *SVC\_NNTP* - NNTP pakalpojuma pārbaude<br>**7**, *SVC\_IMAP* - IMAP pakalpojuma pārbaude<br>**8**, *SVC\_TCP* - TCP porta pieejamības pārbaude<br>**9**, *SVC\_AGENT* - Zabbix aģents<br>**10**, *SVC\_SNMPv1* - SNMPv1 aģents<br>**11**, *SVC\_SNMPv2* - SNMPv2 aģents<br>**12**, *SVC\_ICMPPING* - ICMP ping<br>**13**, *SVC\_SNMPv3* - SNMPv3 aģents<br>**14**, *SVC\_HTTPS* - HTTPS pakalpojuma pārbaude<br>**15**, *SVC\_TELNET* - Telnet pieejamības pārbaude| |^|**ip**|*string*|Hosta IP adrese.| |^|**dns**|*string*|Hosta DNS nosaukums.| |^|**port**|*number*|*(optional)* Pakalpojuma porta numurs.| |^|**key\_**|*string*|*(optional)* Vienuma atslēga atklāšanas pārbaudei ar tipu **9** *SVC\_AGENT*| |^|**value**|*string*|*(optional)* No pakalpojuma saņemtā vērtība, vairumam pakalpojumu var būt tukša.| |^|**status**|*number*|*(optional)* Pakalpojuma statuss:<br><br>**0**, *DOBJECT\_STATUS\_UP* - pakalpojums darbojas<br>**1**, *DOBJECT\_STATUS\_DOWN* - pakalpojums nedarbojas| |**autoregistration**|<|*array*|*(optional)* Automātiskās reģistrācijas datu objektu masīvs.| | |**clock**|*number*|Automātiskās reģistrācijas datu laikspiedols.| |^|**host**|*string*|Hosta nosaukums.| |^|**ip**|*string*|*(optional)* Hosta IP adrese.| |^|**dns**|*string*|*(optional)* No IP adreses noteiktais DNS nosaukums.| |^|**port**|*string*|*(optional)* Hosta ports.| |^|**host\_metadata**|*string*|*(optional)* Hosta metadati, ko nosūtījis aģents (pamatojoties uz aģenta konfigurācijas parametru HostMetadata vai HostMetadataItem).| |**tasks**|<|*array*|*(optional)* Uzdevumu masīvs.| | |**type**|*number*|Uzdevuma tips:<br><br>**0**, *ZBX\_TM\_TASK\_PROCESS\_REMOTE\_COMMAND\_RESULT* - attālinātas komandas rezultāts| |^|**status**|*number*|Attālinātās komandas izpildes statuss:<br><br>**0**, *ZBX\_TM\_REMOTE\_COMMAND\_COMPLETED* - attālinātā komanda veiksmīgi pabeigta<br>**1**, *ZBX\_TM\_REMOTE\_COMMAND\_FAILED* - attālinātās komandas izpilde neizdevās| |^|**error**|*string*|*(optional)* Kļūdas ziņojums.| |^|**parent\_taskid**|*number*|Vecāka uzdevuma ID.| |**more**|<|*number*|*(optional)* 1 - vēl ir nosūtāmi vēstures dati| |**clock**|<|*number*|*(optional)* Datu pārsūtīšanas laikspiedols (sekundēs).| |**ns**|<|*number*|*(optional)* Datu pārsūtīšanas laikspiedols (nanosekundēs).| |**version**|<|*string*|Starpniekservera versija (<major>.<minor>.<build>).| |server→proxy:|<|<|<| |**response**|<|*string*|Pieprasījuma izpildes informācija ('success' vai 'failed').| |**upload**|<|*string*|Augšupielādes kontrole vēsturiskajiem datiem (vēsture, automātiskā reģistrācija, hostu pieejamība, tīkla atklāšana).<br><br>Iespējamās vērtības:<br>**enabled** - normāla darbība<br>**disabled** - serveris nepieņem datus (iespējams, iekšējās kešatmiņas limita pārsnieguma dēļ)| |**tasks**|<|*array*|*(optional)* Uzdevumu masīvs.| | |**type**|*number*|Uzdevuma tips:<br><br>**1**, *ZBX\_TM\_TASK\_PROCESS\_REMOTE\_COMMAND* - attālināta komanda| |^|**clock**|*number*|Uzdevuma izveides laiks.| |^|**ttl**|*number*|Laiks sekundēs, pēc kura uzdevums beidzas.| |^|**commandtype**|*number*|Attālinātās komandas tips:<br><br>**0**, *ZBX\_SCRIPT\_TYPE\_CUSTOM\_SCRIPT* - izmantot pielāgotu skriptu<br>**1**, *ZBX\_SCRIPT\_TYPE\_IPMI* - izmantot IPMI<br>**2**, *ZBX\_SCRIPT\_TYPE\_SSH* - izmantot SSH<br>**3**, *ZBX\_SCRIPT\_TYPE\_TELNET* - izmantot Telnet<br>**4**, *ZBX\_SCRIPT\_TYPE\_GLOBAL\_SCRIPT* - izmantot globālo skriptu (šobrīd funkcionāli ekvivalents pielāgotam skriptam)| |^|**command**|*string*|Izpildāmā attālinātā komanda.| |^|**execute\_on**|*number*|Izpildes mērķis pielāgotiem skriptiem:<br><br>**0**, *ZBX\_SCRIPT\_EXECUTE\_ON\_AGENT* - izpildīt skriptu aģentā<br>**1**, *ZBX\_SCRIPT\_EXECUTE\_ON\_SERVER* - izpildīt skriptu serverī<br>**2**, *ZBX\_SCRIPT\_EXECUTE\_ON\_PROXY* - izpildīt skriptu starpniekserverī| |^|**port**|*number*|*(optional)* Ports Telnet un SSH komandām.| |^|**authtype**|*number*|*(optional)* Autentifikācijas tips SSH komandām.| |^|**username**|*string*|*(optional)* Lietotājvārds Telnet un SSH komandām.| |^|**password**|*string*|*(optional)* Parole Telnet un SSH komandām.| |^|**publickey**|*string*|*(optional)* Publiskā atslēga SSH komandām.| |^|**privatekey**|*string*|*(optional)* Privātā atslēga SSH komandām.| |^|**parent\_taskid**|*number*|Vecāka uzdevuma ID.| |^|**hostid**|*number*|Mērķa hosta ID.| Piemērs: proxy→server: ``` {.javascript} { "request": "proxy data", "host": "Zabbix proxy", "session": "818cdd1b537bdc5e50c09ed4969235b6", "interface availability": [{ "interfaceid": 1, "available": 1, "error": "" }], "history data": [{ "id": 1114, "itemid": 44162, "clock": 1665730632, "ns": 798953105, "value": "1" }, { "id": 1115, "itemid": 44161, "clock": 1665730633, "ns": 811684663, "value": "58" }], "auto registration": [{ "clock": 1665730633, "host": "Zabbix server", "ip": "127.0.0.1", "dns": "localhost", "port": "10053", "host_metadata": "58", "tls_accepted": 1 }], "discovery data": [{ "clock": 1665732232, "drule": 2, "dcheck": 2, "ip": "127.0.0.1", "dns": "localhost", "port": 10052, "status": 1 }, { "clock": 1665732232, "drule": 2, "dcheck": null, "ip": "127.0.0.1", "dns": "localhost", "status": 1 }], "host data": [{ "hostid": 10084, "active_status": 1 }], "tasks": [{ "type": 3, "clock": 1665730985, "ttl": 0, "status": -1, "info": "Remote commands are not enabled", "parent_taskid": 3 }], "version": "7.0.0", "clock": 1665730643, "ns": 65389964 } ``` server→proxy: ``` {.javascript} { "upload": "enabled", "response": "success", "tasks": [{ "type": 2, "clock": 1665730986, "ttl": 600, "commandtype": 0, "command": "ping -c 3 127.0.0.1; case $? in [01]) true;; *) false;; esac", "execute_on": 2, "port": 0, "authtype": 0, "username": "", "password": "", "publickey": "", "privatekey": "", "alertid": 0, "parent_taskid": 4, "hostid": 10084 }] } ``` ##### Data request The `proxy data` request is used to obtain host interface availability, historical, discovery and autoregistration data from proxy. This request is sent every `ProxyDataFrequency` (server configuration parameter) seconds. |name|<|value type|description| |-|----------|----------|----------------------------------------| |server→proxy:|<|<|<| |**request**|<|*string*|'proxy data'| |proxy→server:|<|<|<| |**session**|<|*string*|Data session token.| |**interface availability**|<|*array*|*(optional)* Array of interface availability data objects.| | |**interfaceid**|*number*|Interface identifier.| |^|**available**|*number*|Interface availability:<br><br>**0**, *INTERFACE\_AVAILABLE\_UNKNOWN* - unknown<br>**1**, *INTERFACE\_AVAILABLE\_TRUE* - available<br>**2**, *INTERFACE\_AVAILABLE\_FALSE* - unavailable| |^|**error**|*string*|Interface error message or empty string.| |**history data**|<|*array*|*(optional)* Array of history data objects.| | |**itemid**|*number*|Item identifier.| |^|**clock**|*number*|Item value timestamp (seconds).| |^|**ns**|*number*|Item value timestamp (nanoseconds).| |^|**value**|*string*|*(optional)* Item value.| |^|**id**|*number*|Value identifier (ascending counter, unique within one data session).| |^|**timestamp**|*number*|*(optional)* Timestamp of log type items.| |^|**source**|*string*|*(optional)* Eventlog item source value.| |^|**severity**|*number*|*(optional)* Eventlog item severity value.| |^|**eventid**|*number*|*(optional)* Eventlog item eventid value.| |^|**state**|*string*|*(optional)* Item state:<br>**0**, *ITEM\_STATE\_NORMAL*<br>**1**, *ITEM\_STATE\_NOTSUPPORTED*| |^|**lastlogsize**|*number*|*(optional)* Last log size of log type items.| |^|**mtime**|*number*|*(optional)* Modification time of log type items.| |**discovery data**|<|*array*|*(optional)* Array of discovery data objects.| | |**clock**|*number*|Discovery data timestamp.| |^|**druleid**|*number*|Discovery rule identifier.| |^|**dcheckid**|*number*|Discovery check identifier or null for discovery rule data.| |^|**type**|*number*|Discovery check type:<br><br>**-1** discovery rule data<br>**0**, *SVC\_SSH* - SSH service check<br>**1**, *SVC\_LDAP* - LDAP service check<br>**2**, *SVC\_SMTP* - SMTP service check<br>**3**, *SVC\_FTP* - FTP service check<br>**4**, *SVC\_HTTP* - HTTP service check<br>**5**, *SVC\_POP* - POP service check<br>**6**, *SVC\_NNTP* - NNTP service check<br>**7**, *SVC\_IMAP* - IMAP service check<br>**8**, *SVC\_TCP* - TCP port availability check<br>**9**, *SVC\_AGENT* - Zabbix agent<br>**10**, *SVC\_SNMPv1* - SNMPv1 agent<br>**11**, *SVC\_SNMPv2* - SNMPv2 agent<br>**12**, *SVC\_ICMPPING* - ICMP ping<br>**13**, *SVC\_SNMPv3* - SNMPv3 agent<br>**14**, *SVC\_HTTPS* - HTTPS service check<br>**15**, *SVC\_TELNET* - Telnet availability check| |^|**ip**|*string*|Host IP address.| |^|**dns**|*string*|Host DNS name.| |^|**port**|*number*|*(optional)* Service port number.| |^|**key\_**|*string*|*(optional)* Item key for discovery check of type **9** *SVC\_AGENT*| |^|**value**|*string*|*(optional)* Value received from the service, can be empty for most of services.| |^|**status**|*number*|*(optional)* Service status:<br><br>**0**, *DOBJECT\_STATUS\_UP* - Service UP<br>**1**, *DOBJECT\_STATUS\_DOWN* - Service DOWN| |**auto registration**|<|*array*|*(optional)* Array of autoregistration data objects.| | |**clock**|*number*|Autoregistration data timestamp.| |^|**host**|*string*|Host name.| |^|**ip**|*string*|*(optional)* Host IP address.| |^|**dns**|*string*|*(optional)* Resolved DNS name from IP address.| |^|**port**|*string*|*(optional)* Host port.| |^|**host\_metadata**|*string*|*(optional)* Host metadata sent by agent (based on HostMetadata or HostMetadataItem agent configuration parameter).| |**tasks**|<|*array*|*(optional)* Array of tasks.| | |**type**|*number*|Task type:<br><br>**0**, *ZBX\_TM\_TASK\_PROCESS\_REMOTE\_COMMAND\_RESULT* - remote command result| |^|**status**|*number*|Remote-command execution status:<br><br>**0**, *ZBX\_TM\_REMOTE\_COMMAND\_COMPLETED* - remote command completed successfully<br>**1**, *ZBX\_TM\_REMOTE\_COMMAND\_FAILED* - remote command failed| |^|**error**|*string*|*(optional)* Error message.| |^|**parent\_taskid**|*number*|Parent task ID.| |**more**|<|*number*|*(optional)* 1 - there are more history data to send.| |**clock**|<|*number*|*(optional)* Data transfer timestamp (seconds).| |**ns**|<|*number*|*(optional)* Data transfer timestamp (nanoseconds).| |**version**|<|*string*|Proxy version (<major>.<minor>.<build>).| |server→proxy:|<|<|<| |**response**|<|*string*|Request success information ('success' or 'failed').| |**tasks**|<|*array*|*(optional)* Array of tasks.| | |**type**|*number*|Task type:<br><br>**1**, *ZBX\_TM\_TASK\_PROCESS\_REMOTE\_COMMAND* - remote command| |^|**clock**|*number*|Task creation time.| |^|**ttl**|*number*|Time in seconds after which the task expires.| |^|**commandtype**|*number*|Remote-command type:<br><br>**0**, *ZBX\_SCRIPT\_TYPE\_CUSTOM\_SCRIPT* - use custom script<br>**1**, *ZBX\_SCRIPT\_TYPE\_IPMI* - use IPMI<br>**2**, *ZBX\_SCRIPT\_TYPE\_SSH* - use SSH<br>**3**, *ZBX\_SCRIPT\_TYPE\_TELNET* - use Telnet<br>**4**, *ZBX\_SCRIPT\_TYPE\_GLOBAL\_SCRIPT* - use global script (currently functionally equivalent to custom script)| |^|**command**|*string*|Remote command to execute.| |^|**execute\_on**|*number*|Execution target for custom scripts:<br><br>**0**, *ZBX\_SCRIPT\_EXECUTE\_ON\_AGENT* - execute script on agent<br>**1**, *ZBX\_SCRIPT\_EXECUTE\_ON\_SERVER* - execute script on server<br>**2**, *ZBX\_SCRIPT\_EXECUTE\_ON\_PROXY* - execute script on proxy| |^|**port**|*number*|*(optional)* Port for Telnet and SSH commands.| |^|**authtype**|*number*|*(optional)* Authentication type for SSH commands.| |^|**username**|*string*|*(optional)* User name for Telnet and SSH commands.| |^|**password**|*string*|*(optional)* Password for Telnet and SSH commands.| |^|**publickey**|*string*|*(optional)* Public key for SSH commands.| |^|**privatekey**|*string*|*(optional)* Private key for SSH commands.| |^|**parent\_taskid**|*number*|Parent task ID.| |^|**hostid**|*number*|Target host ID.| Example: server→proxy: ``` {.javascript} { "request": "proxy data" } ``` proxy→server: ``` {.javascript} { "session": "12345678901234567890123456789012" "interface availability": [ { "interfaceid": 1, "available": 1, "error": "" }, { "interfaceid": 2, "available": 2, "error": "Get value from agent failed: cannot connect to [[127.0.0.1]:10049]: [111] Connection refused" }, { "interfaceid": 3, "available": 1, "error": "" }, { "interfaceid": 4, "available": 1, "error": "" } ], "history data":[ { "itemid":"12345", "clock":1478609647, "ns":332510044, "value":"52956612", "id": 1 }, { "itemid":"12346", "clock":1478609647, "ns":330690279, "state":1, "value":"Cannot find information for this network interface in /proc/net/dev.", "id": 2 } ], "discovery data":[ { "clock":1478608764, "drule":2, "dcheck":3, "type":12, "ip":"10.3.0.10", "dns":"vdebian", "status":1 }, { "clock":1478608764, "drule":2, "dcheck":null, "type":-1, "ip":"10.3.0.10", "dns":"vdebian", "status":1 } ], "auto registration":[ { "clock":1478608371, "host":"Logger1", "ip":"10.3.0.1", "dns":"localhost", "port":"10050" }, { "clock":1478608381, "host":"Logger2", "ip":"10.3.0.2", "dns":"localhost", "port":"10050" } ], "tasks":[ { "type": 0, "status": 0, "parent_taskid": 10 }, { "type": 0, "status": 1, "error": "No permissions to execute task.", "parent_taskid": 20 } ], "version":"7.0.0" } ``` server→proxy: ``` {.javascript} { "response": "success", "tasks":[ { "type": 1, "clock": 1478608371, "ttl": 600, "commandtype": 2, "command": "restart_service1.sh", "execute_on": 2, "port": 80, "authtype": 0, "username": "userA", "password": "password1", "publickey": "MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCqGKukO1De7zhZj6+H0qtjTkVxwTCpvKe", "privatekey": "lsuusFncCzWBQ7RKNUSesmQRMSGkVb1/3j+skZ6UtW+5u09lHNsj6tQ5QCqGKukO1De7zhd", "parent_taskid": 10, "hostid": 10070 }, { "type": 1, "clock": 1478608381, "ttl": 600, "commandtype": 1, "command": "restart_service2.sh", "execute_on": 0, "authtype": 0, "username": "", "password": "", "publickey": "", "privatekey": "", "parent_taskid": 20, "hostid": 10084 } ] } ``` ##### Datu pieprasījums `proxy data` pieprasījums tiek izmantots, lai iegūtu hosta interfeisa pieejamības, vēstures, atklāšanas un automātiskās reģistrācijas datus no starpniekserveris. Šis pieprasījums tiek nosūtīts ik pēc `ProxyDataFrequency` (serveris konfigurācijas parametrs) sekundēm. |name|<|value type|description| |-|----------|----------|----------------------------------------| |server→proxy:|<|<|<| |**request**|<|*string*|'proxy data'| |proxy→server:|<|<|<| |**session**|<|*string*|Datu sesijas marķieris.| |**interface availability**|<|*array*|*(optional)* Interfeisa pieejamības datu objektu masīvs.| | |**interfaceid**|*number*|Interfeisa identifikators.| |^|**available**|*number*|Interfeisa pieejamība:<br><br>**0**, *INTERFACE_AVAILABLE_UNKNOWN* - nezināms<br>**1**, *INTERFACE_AVAILABLE_TRUE* - pieejams<br>**2**, *INTERFACE_AVAILABLE_FALSE* - nepieejams| |^|**error**|*string*|Interfeisa kļūdas ziņojums vai tukša virkne.| |**history data**|<|*array*|*(optional)* Vēstures datu objektu masīvs.| | |**itemid**|*number*|Vienuma identifikators.| |^|**clock**|*number*|Vienuma vērtības laikspiedols (sekundēs).| |^|**ns**|*number*|Vienuma vērtības laikspiedols (nanosekundēs).| |^|**value**|*string*|*(optional)* Vienuma vērtība.| |^|**id**|*number*|Vērtības identifikators (augošs skaitītājs, unikāls vienas datu sesijas ietvaros).| |^|**timestamp**|*number*|*(optional)* Log tipa vienumu laikspiedols.| |^|**source**|*string*|*(optional)* Eventlog vienuma avota vērtība.| |^|**severity**|*number*|*(optional)* Eventlog vienuma smaguma pakāpes vērtība.| |^|**eventid**|*number*|*(optional)* Eventlog vienuma eventid vērtība.| |^|**state**|*string*|*(optional)* Vienuma stāvoklis:<br>**0**, *ITEM_STATE_NORMAL*<br>**1**, *ITEM_STATE_NOTSUPPORTED*| |^|**lastlogsize**|*number*|*(optional)* Log tipa vienumu pēdējais loga lielums.| |^|**mtime**|*number*|*(optional)* Log tipa vienumu modificēšanas laiks.| |**discovery data**|<|*array*|*(optional)* Atklāšanas datu objektu masīvs.| | |**clock**|*number*|Atklāšanas datu laikspiedols.| |^|**druleid**|*number*|Atklāšanas noteikuma identifikators.| |^|**dcheckid**|*number*|Atklāšanas pārbaudes identifikators vai null atklāšanas noteikuma datiem.| |^|**type**|*number*|Atklāšanas pārbaudes tips:<br><br>**-1** atklāšanas noteikuma dati<br>**0**, *SVC_SSH* - SSH pakalpojuma pārbaude<br>**1**, *SVC_LDAP* - LDAP pakalpojuma pārbaude<br>**2**, *SVC_SMTP* - SMTP pakalpojuma pārbaude<br>**3**, *SVC_FTP* - FTP pakalpojuma pārbaude<br>**4**, *SVC_HTTP* - HTTP pakalpojuma pārbaude<br>**5**, *SVC_POP* - POP pakalpojuma pārbaude<br>**6**, *SVC_NNTP* - NNTP pakalpojuma pārbaude<br>**7**, *SVC_IMAP* - IMAP pakalpojuma pārbaude<br>**8**, *SVC_TCP* - TCP porta pieejamības pārbaude<br>**9**, *SVC_AGENT* - Zabbix aģents<br>**10**, *SVC_SNMPv1* - SNMPv1 aģents<br>**11**, *SVC_SNMPv2* - SNMPv2 aģents<br>**12**, *SVC_ICMPPING* - ICMP ping<br>**13**, *SVC_SNMPv3* - SNMPv3 aģents<br>**14**, *SVC_HTTPS* - HTTPS pakalpojuma pārbaude<br>**15**, *SVC_TELNET* - Telnet pieejamības pārbaude| |^|**ip**|*string*|Hosta IP adrese.| |^|**dns**|*string*|Hosta DNS nosaukums.| |^|**port**|*number*|*(optional)* Pakalpojuma porta numurs.| |^|**key_**|*string*|*(optional)* Vienuma atslēga atklāšanas pārbaudei ar tipu **9** *SVC_AGENT*| |^|**value**|*string*|*(optional)* No pakalpojuma saņemtā vērtība, vairumam pakalpojumu var būt tukša.| |^|**status**|*number*|*(optional)* Pakalpojuma statuss:<br><br>**0**, *DOBJECT_STATUS_UP* - pakalpojums darbojas<br>**1**, *DOBJECT_STATUS_DOWN* - pakalpojums nedarbojas| |**auto registration**|<|*array*|*(optional)* Automātiskās reģistrācijas datu objektu masīvs.| | |**clock**|*number*|Automātiskās reģistrācijas datu laikspiedols.| |^|**host**|*string*|Hosta nosaukums.| |^|**ip**|*string*|*(optional)* Hosta IP adrese.| |^|**dns**|*string*|*(optional)* No IP adreses noteiktais DNS nosaukums.| |^|**port**|*string*|*(optional)* Hosta ports.| |^|**host_metadata**|*string*|*(optional)* Hosta metadati, ko nosūtījis aģents (pamatojoties uz aģenta konfigurācijas parametru HostMetadata vai HostMetadataItem).| |**tasks**|<|*array*|*(optional)* Uzdevumu masīvs.| | |**type**|*number*|Uzdevuma tips:<br><br>**0**, *ZBX_TM_TASK_PROCESS_REMOTE_COMMAND_RESULT* - attālā komanda rezultāts| |^|**status**|*number*|Attālās komandas izpildes statuss:<br><br>**0**, *ZBX_TM_REMOTE_COMMAND_COMPLETED* - attālā komanda veiksmīgi pabeigta<br>**1**, *ZBX_TM_REMOTE_COMMAND_FAILED* - attālā komanda neizdevās| |^|**error**|*string*|*(optional)* Kļūdas ziņojums.| |^|**parent_taskid**|*number*|Vecāka uzdevuma ID.| |**more**|<|*number*|*(optional)* 1 - ir vēl vēstures dati, ko nosūtīt.| |**clock**|<|*number*|*(optional)* Datu pārsūtīšanas laikspiedols (sekundēs).| |**ns**|<|*number*|*(optional)* Datu pārsūtīšanas laikspiedols (nanosekundēs).| |**version**|<|*string*|Starpniekserveris versija (<major>.<minor>.<build>).| |server→proxy:|<|<|<| |**response**|<|*string*|Pieprasījuma izpildes informācija ('success' vai 'failed').| |**tasks**|<|*array*|*(optional)* Uzdevumu masīvs.| | |**type**|*number*|Uzdevuma tips:<br><br>**1**, *ZBX_TM_TASK_PROCESS_REMOTE_COMMAND* - attālā komanda| |^|**clock**|*number*|Uzdevuma izveides laiks.| |^|**ttl**|*number*|Laiks sekundēs, pēc kura uzdevums beidzas.| |^|**commandtype**|*number*|Attālās komandas tips:<br><br>**0**, *ZBX_SCRIPT_TYPE_CUSTOM_SCRIPT* - izmantot pielāgotu skriptu<br>**1**, *ZBX_SCRIPT_TYPE_IPMI* - izmantot IPMI<br>**2**, *ZBX_SCRIPT_TYPE_SSH* - izmantot SSH<br>**3**, *ZBX_SCRIPT_TYPE_TELNET* - izmantot Telnet<br>**4**, *ZBX_SCRIPT_TYPE_GLOBAL_SCRIPT* - izmantot globālo skriptu (šobrīd funkcionāli ekvivalents pielāgotam skriptam)| |^|**command**|*string*|Izpildāmā attālā komanda.| |^|**execute_on**|*number*|Izpildes mērķis pielāgotiem skriptiem:<br><br>**0**, *ZBX_SCRIPT_EXECUTE_ON_AGENT* - izpildīt skriptu uz aģents<br>**1**, *ZBX_SCRIPT_EXECUTE_ON_SERVER* - izpildīt skriptu uz serveris<br>**2**, *ZBX_SCRIPT_EXECUTE_ON_PROXY* - izpildīt skriptu uz starpniekserveris| |^|**port**|*number*|*(optional)* Ports Telnet un SSH komandām.| |^|**authtype**|*number*|*(optional)* Autentifikācijas tips SSH komandām.| |^|**username**|*string*|*(optional)* Lietotājvārds Telnet un SSH komandām.| |^|**password**|*string*|*(optional)* Parole Telnet un SSH komandām.| |^|**publickey**|*string*|*(optional)* Publiskā atslēga SSH komandām.| |^|**privatekey**|*string*|*(optional)* Privātā atslēga SSH komandām.| |^|**parent_taskid**|*number*|Vecāka uzdevuma ID.| |^|**hostid**|*number*|Mērķa hosta ID.| Piemērs: server→proxy: ``` {.javascript} { "request": "proxy data" } ``` proxy→server: ``` {.javascript} { "session": "12345678901234567890123456789012" "interface availability": [ { "interfaceid": 1, "available": 1, "error": "" }, { "interfaceid": 2, "available": 2, "error": "Get value from agent failed: cannot connect to [[127.0.0.1]:10049]: [111] Connection refused" }, { "interfaceid": 3, "available": 1, "error": "" }, { "interfaceid": 4, "available": 1, "error": "" } ], "history data":[ { "itemid":"12345", "clock":1478609647, "ns":332510044, "value":"52956612", "id": 1 }, { "itemid":"12346", "clock":1478609647, "ns":330690279, "state":1, "value":"Cannot find information for this network interface in /proc/net/dev.", "id": 2 } ], "discovery data":[ { "clock":1478608764, "drule":2, "dcheck":3, "type":12, "ip":"10.3.0.10", "dns":"vdebian", "status":1 }, { "clock":1478608764, "drule":2, "dcheck":null, "type":-1, "ip":"10.3.0.10", "dns":"vdebian", "status":1 } ], "auto registration":[ { "clock":1478608371, "host":"Logger1", "ip":"10.3.0.1", "dns":"localhost", "port":"10050" }, { "clock":1478608381, "host":"Logger2", "ip":"10.3.0.2", "dns":"localhost", "port":"10050" } ], "tasks":[ { "type": 0, "status": 0, "parent_taskid": 10 }, { "type": 0, "status": 1, "error": "No permissions to execute task.", "parent_taskid": 20 } ], "version":"7.0.0" } ``` server→proxy: ``` {.javascript} { "response": "success", "tasks":[ { "type": 1, "clock": 1478608371, "ttl": 600, "commandtype": 2, "command": "restart_service1.sh", "execute_on": 2, "port": 80, "authtype": 0, "username": "userA", "password": "password1", "publickey": "MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCqGKukO1De7zhZj6+H0qtjTkVxwTCpvKe", "privatekey": "lsuusFncCzWBQ7RKNUSesmQRMSGkVb1/3j+skZ6UtW+5u09lHNsj6tQ5QCqGKukO1De7zhd", "parent_taskid": 10, "hostid": 10070 }, { "type": 1, "clock": 1478608381, "ttl": 600, "commandtype": 1, "command": "restart_service2.sh", "execute_on": 0, "authtype": 0, "username": "", "password": "", "publickey": "", "privatekey": "", "parent_taskid": 20, "hostid": 10084 } ] } ``` ##### DataSenderFrequency The proxy will send collected data to the server every N seconds. Note that an active proxy will still poll Zabbix server every second for remote command tasks.<br>Active proxy parameter. Ignored for passive proxies (see ProxyMode parameter). Default: `1`<br> Range: 1-3600 ##### DataSenderFrequency Starpniekserveris nosūtīs savāktos datus uz serveri ik pēc N sekundēm. Ņemiet vērā, ka aktīvs starpniekserveris joprojām aptaujās Zabbix serveri katru sekundi attālo komandu uzdevumu dēļ.<br>Aktīva starpniekservera parametrs. Netiek ņemts vērā pasīvajiem starpniekserveriem (skatiet parametru ProxyMode). Noklusējums: `1`<br> Diapazons: 1-3600 ##### Data set configuration details Existing data sets are displayed in a list. You can rearrange, expand/collapse, change colors, and clone these data sets. For more information, see data set configuration details in the [*Graph*](/manual/web_interface/frontend_sections/dashboards/widgets/graph#data-set-configuration-details) widget. These details also apply to the *Pie chart* widget. ##### Datu kopas konfigurācijas informācija Esošās datu kopas tiek parādītas sarakstā. Varat pārkārtot, izvērst/sakļaut, mainīt krāsas un klonēt šīs datu kopas. Papildinformāciju skatiet datu kopas konfigurācijas informācijā [*Graph*](/manual/web_interface/frontend_sections/dashboards/widgets/graph#data-set-configuration-details) logrīkā. Šī informācija attiecas arī uz *Pie chart* logrīku. ##### Data set configuration details Existing data sets are displayed in a list. You may: - Click on the  move icon and drag a data set to a new place in the list. - Click on the  expand icon to expand data set details. When expanded, this icon turns into a  collapse icon. - Click on the  color icon to change the color, either from the color picker or manually. For *Item patterns* data set, the color is used to calculate different color shades for each item. For *Item list* data set, the color is used for the specified item. - Click on the *Add new data set* button to add an empty data set allowing to select host and item patterns. If you click on the downward pointing icon next to the *Add new data set* button, a drop-down menu appears, allowing you to add a new *Item patterns* or *Item list* data set or allowing you to *Clone* the currently open data set. If all data sets are collapsed, the *Clone* option is not available.  ##### Datu kopas konfigurācijas detaļas Esošās datu kopas tiek parādītas sarakstā. Varat: - Noklikšķināt uz  pārvietošanas ikonas un vilkt datu kopu uz jaunu vietu sarakstā. - Noklikšķināt uz  izvēršanas ikonas, lai izvērstu datu kopas detaļas. Kad tā ir izvērsta, šī ikona pārvēršas par  sakļaušanas ikonu. - Noklikšķināt uz  krāsas ikonas, lai mainītu krāsu, izvēloties to krāsu atlasītājā vai ievadot manuāli. *Item patterns* datu kopai krāsa tiek izmantota, lai aprēķinātu dažādus krāsu toņus katram vienumam. *Item list* datu kopai krāsa tiek izmantota norādītajam vienumam. - Noklikšķināt uz pogas *Add new data set*, lai pievienotu tukšu datu kopu, kas ļauj atlasīt hosts un vienumu modeļus. Ja noklikšķināt uz lejupvērstās ikonas blakus pogai *Add new data set*, tiek parādīta nolaižamā izvēlne, kas ļauj pievienot jaunu *Item patterns* vai *Item list* datu kopu, kā arī *Clone* pašlaik atvērto datu kopu. Ja visas datu kopas ir sakļautas, opcija *Clone* nav pieejama.  #### Data set The **Data set** tab allows selecting data for the graph by adding data sets. Two types of data sets can be added: - *Item patterns* - data from matching items is displayed. The graph is drawn using different shades of single color for each item. - *Item list* - data from selected items is displayed. The graph is drawn using different colors for each item. By default, an *Item patterns* data set is added. | | | | |-|----------|----------------------------------------| |*Data set*|<|For **Item patterns** data set:<br>Select or enter host and item patterns; data of items that match these patterns will be displayed on the graph; up to 50 items may be displayed.<br>Wildcard patterns may be used for selection (for example, `*` will return results that match zero or more characters).<br>To specify a wildcard pattern, enter the string manually and press *Enter*.<br>The wildcard symbol is always interpreted, so it is not possible to add, for example, an item named *item\** individually if there are other matching items (for example, *item2*, *item3*).<br>Specifying host and item patterns is mandatory for "Item patterns" data sets.<br>See also: [Data set configuration details](#data-set-configuration-details).<br><br>For **Item list** data set:<br>Select items for the graph by clicking on the *Add item* button.<br>Since Zabbix 7.0.1, you may also select compatible widgets as the [data source](/manual/web_interface/frontend_sections/dashboards/widgets#dynamic-parameters) for items by clicking on the *Add widget* button.<br>Specifying items or widgets is mandatory for "Item list" data sets.<br>See also: [Data set configuration details](#data-set-configuration-details).<br><br>Note that only numeric item types are allowed.<br><br>When configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards), the parameter for specifying host patterns is not available, and the parameter for specifying an item list allows to select only the [items configured on the template](/manual/config/templates/template#adding-items-triggers-graphs).| | |*Draw*|Choose the draw type of the metric.<br>Possible draw types: *Line* (set by default), *Points*, *Staircase*, and *Bar*.<br>Note that if there is only one data point in the line/staircase graph, it is drawn as a point regardless of the draw type. The point size is calculated from the line width, but it cannot be smaller than 3 pixels, even if the line width is less.| |^|*Stacked*|Mark the checkbox to display data as stacked (filled areas displayed).<br>This option is disabled when *Points* draw type is selected.| |^|*Width*|Set the line width.<br>This option is available when *Line* or *Staircase* draw type is selected.| |^|*Point size*|Set the point size.<br>This option is available when *Points* draw type is selected.| |^|*Transparency*|Set the transparency level.| |^|*Fill*|Set the fill level.<br>This option is available when *Line* or *Staircase* draw type is selected.| |^|*Missing data*|Select the option for displaying missing data:<br>**None** - the gap is left empty;<br>**Connected** - two border values are connected;<br>**Treat as 0** - the missing data is displayed as 0 values;<br>**Last known** - the missing data is displayed with the same value as the last known value; not applicable for the *Points* and *Bar* draw type.| |^|*Y-axis*|Select the side of the graph where the Y-axis will be displayed.| |^|*Time shift*|Specify time shift if required.<br>You may use [time suffixes](/manual/appendix/suffixes#time-suffixes) in this field. Negative values are allowed.| |^|*Aggregation function*|Specify which aggregation function to use for each item or for an entire data set within the selected *Aggregation interval*:<br>**min** - display the smallest value;<br>**max** - display the largest value;<br>**avg** - display the average value;<br>**sum** - display the sum of values;<br>**count** - display the count of values;<br>**first** - display the first value;<br>**last** - display the last value.<br>If **not used** is selected, all values are displayed (no aggregation).<br><br>Only numeric data can be displayed for *min*, *max*, *avg* and *sum*. For *count*, non-numeric data will be changed to numeric.<br>See also: [Aggregation in graphs](#aggregation-in-graphs).| |^|*Aggregation interval*|Specify the interval for aggregating values.<br>You may use [time suffixes](/manual/appendix/suffixes#time-suffixes) in this field. A numeric value without a suffix will be regarded as seconds.<br><br>Note that if the widget is configured to display historical data based on [trends](/manual/config/items/history_and_trends#keeping-trends) (*History data selection* is set to *Trends* or *Auto*), it is recommended to use an aggregation interval that is a multiple of 1 hour (e.g., 3600, 60m, 1h, 3h, etc.). Trends store hourly aggregated values, so using an aggregation interval that is not a multiple of 1 hour (e.g., 100s, 7min, 15min, 90min, etc.) may lead to results that are hard to interpret.| |^|*Aggregate*|Specify whether to aggregate:<br>**Each item** - each item in the dataset will be aggregated and displayed separately;<br>**Data set** - all dataset items will be aggregated and displayed as one value.| |^|*Approximation*|Specify what value to display when more than one value exists per vertical graph pixel:<br>**all** - display the smallest, the largest and the average values;<br>**min** - display the smallest value;<br>**max** - display the largest value;<br>**avg** - display the average value.<br><br>This setting is useful when displaying a graph for a large time period with frequent update interval (such as one year of values collected every 10 minutes).| |^|*Data set label*|Specify the data set label that is displayed in graph *Data set* configuration and in graph *Legend* (for aggregated data sets).<br>All data sets are numbered including those with a specified *Data set label*. If no label is specified, the data set will be labeled automatically according to its number (e.g. "Data set #2", "Data set #3", etc.). Data set numbering is recalculated after reordering/dragging data sets.<br>Data set labels that are too long will be shortened to fit where displayed (e.g. "Number of proc...").| #### Datu kopa Cilne **Datu kopa** ļauj atlasīt datus grafikam, pievienojot datu kopas. Var pievienot divu veidu datu kopas: - *Vienumu paraugi* - tiek parādīti dati no atbilstošajiem vienumiem. Grafiks tiek zīmēts, katram vienumam izmantojot dažādus vienas krāsas toņus. - *Vienumu saraksts* - tiek parādīti dati no atlasītajiem vienumiem. Grafiks tiek zīmēts, katram vienumam izmantojot dažādas krāsas. Pēc noklusējuma tiek pievienota *Vienumu paraugi* datu kopa. | | | | |-|----------|----------------------------------------| |*Datu kopa*|<|**Vienumu paraugi** datu kopai:<br>Atlasiet vai ievadiet hosts un vienumu paraugus; tiks parādīti to vienumu dati, kas atbilst šiem paraugiem; var tikt parādīti līdz 50 vienumiem.<br>Atlasīšanai var izmantot aizstājējzīmju paraugus (piemēram, `*` atgriezīs rezultātus, kas atbilst nullei vai vairākiem simboliem).<br>Lai norādītu aizstājējzīmes paraugu, ievadiet virkni manuāli un nospiediet *Enter*.<br>Aizstājējzīmes simbols vienmēr tiek interpretēts, tāpēc nav iespējams, piemēram, pievienot vienumu ar nosaukumu *item\** atsevišķi, ja ir citi atbilstoši vienumi (piemēram, *item2*, *item3*).<br>Hosts un vienumu paraugu norādīšana ir obligāta "Vienumu paraugi" datu kopām.<br>Skatiet arī: [Datu kopas konfigurācijas informācija](#data-set-configuration-details).<br><br>**Vienumu saraksts** datu kopai:<br>Atlasiet vienumus grafikam, noklikšķinot uz pogas *Pievienot vienumu*.<br>Kopš Zabbix 7.0.1, varat arī atlasīt saderīgus logrīkus kā [datu avotu](/manual/web_interface/frontend_sections/dashboards/widgets#dynamic-parameters) vienumiem, noklikšķinot uz pogas *Pievienot logrīku*.<br>Vienumu vai logrīku norādīšana ir obligāta "Vienumu saraksts" datu kopām.<br>Skatiet arī: [Datu kopas konfigurācijas informācija](#data-set-configuration-details).<br><br>Ņemiet vērā, ka ir atļauti tikai skaitliski vienumu tipi.<br><br>Konfigurējot logrīku [veidnes informācijas panelī](/manual/config/templates/template#adding-dashboards), parametrs hostu paraugu norādīšanai nav pieejams, un parametrs vienumu saraksta norādīšanai ļauj atlasīt tikai [veidnē konfigurētos vienumus](/manual/config/templates/template#adding-items-triggers-graphs).| | |*Zīmēt*|Izvēlieties metrikas zīmēšanas tipu.<br>Iespējamie zīmēšanas tipi: *Līnija* (iestatīts pēc noklusējuma), *Punkti*, *Kāpnes* un *Josla*.<br>Ņemiet vērā: ja līnijas/kāpņu grafikā ir tikai viens datu punkts, tas tiek zīmēts kā punkts neatkarīgi no zīmēšanas tipa. Punkta izmērs tiek aprēķināts no līnijas platuma, taču tas nevar būt mazāks par 3 pikseļiem, pat ja līnijas platums ir mazāks.| |^|*Sakrauts*|Atzīmējiet izvēles rūtiņu, lai datus attēlotu kā sakrautus (tiek rādītas aizpildītas zonas).<br>Šī opcija ir atspējota, ja ir atlasīts zīmēšanas tips *Punkti*.| |^|*Platums*|Iestatiet līnijas platumu.<br>Šī opcija ir pieejama, ja ir atlasīts zīmēšanas tips *Līnija* vai *Kāpnes*.| |^|*Punkta izmērs*|Iestatiet punkta izmēru.<br>Šī opcija ir pieejama, ja ir atlasīts zīmēšanas tips *Punkti*.| |^|*Caurspīdīgums*|Iestatiet caurspīdīguma līmeni.| |^|*Aizpildījums*|Iestatiet aizpildījuma līmeni.<br>Šī opcija ir pieejama, ja ir atlasīts zīmēšanas tips *Līnija* vai *Kāpnes*.| |^|*Trūkstošie dati*|Atlasiet trūkstošo datu attēlošanas opciju:<br>**Nav** - atstarpe tiek atstāta tukša;<br>**Savienots** - tiek savienotas divas robežvērtības;<br>**Uzskatīt par 0** - trūkstošie dati tiek attēloti kā 0 vērtības;<br>**Pēdējā zināmā** - trūkstošie dati tiek attēloti ar tādu pašu vērtību kā pēdējā zināmā vērtība; nav piemērojams zīmēšanas tipiem *Punkti* un *Josla*.| |^|*Y ass*|Atlasiet grafika pusi, kurā tiks attēlota Y ass.| |^|*Laika nobīde*|Ja nepieciešams, norādiet laika nobīdi.<br>Šajā laukā var izmantot [laika sufiksus](/manual/appendix/suffixes#time-suffixes). Ir atļautas negatīvas vērtības.| |^|*Apkopošanas funkcija*|Norādiet, kuru apkopošanas funkciju izmantot katram vienumam vai visai datu kopai atlasītajā *Apkopošanas intervālā*:<br>**min** - attēlot mazāko vērtību;<br>**max** - attēlot lielāko vērtību;<br>**avg** - attēlot vidējo vērtību;<br>**sum** - attēlot vērtību summu;<br>**count** - attēlot vērtību skaitu;<br>**first** - attēlot pirmo vērtību;<br>**last** - attēlot pēdējo vērtību.<br>Ja ir atlasīts **not used**, visas vērtības tiek attēlotas (bez apkopošanas).<br><br>Tikai skaitliskus datus var attēlot ar *min*, *max*, *avg* un *sum*. Funkcijai *count* neskaitliskie dati tiks pārveidoti par skaitliskiem.<br>Skatiet arī: [Apkopošana grafikos](#aggregation-in-graphs).| |^|*Apkopošanas intervāls*|Norādiet intervālu vērtību apkopošanai.<br>Šajā laukā var izmantot [laika sufiksus](/manual/appendix/suffixes#time-suffixes). Skaitliska vērtība bez sufiksa tiks uzskatīta par sekundēm.<br><br>Ņemiet vērā: ja logrīks ir konfigurēts vēsturisko datu attēlošanai, pamatojoties uz [tendencēm](/manual/config/items/history_and_trends#keeping-trends) (*Vēsturisko datu atlase* ir iestatīta uz *Tendences* vai *Automātiski*), ieteicams izmantot apkopošanas intervālu, kas ir 1 stundas reizinājums (piemēram, 3600, 60m, 1h, 3h utt.). Tendences glabā stundas apkoptās vērtības, tāpēc apkopošanas intervāla izmantošana, kas nav 1 stundas reizinājums (piemēram, 100s, 7min, 15min, 90min utt.), var radīt rezultātus, kurus ir grūti interpretēt.| |^|*Apkopot*|Norādiet, vai apkopot:<br>**Katrs vienums** - katrs datu kopas vienums tiks apkopots un attēlots atsevišķi;<br>**Datu kopa** - visi datu kopas vienumi tiks apkopoti un attēloti kā viena vērtība.| |^|*Aptuvenojums*|Norādiet, kādu vērtību attēlot, ja uz vienu vertikālo grafika pikseli ir vairāk nekā viena vērtība:<br>**all** - attēlot mazāko, lielāko un vidējo vērtību;<br>**min** - attēlot mazāko vērtību;<br>**max** - attēlot lielāko vērtību;<br>**avg** - attēlot vidējo vērtību.<br><br>Šis iestatījums ir noderīgs, attēlojot grafiku lielam laika periodam ar biežu atjaunināšanas intervālu (piemēram, viena gada vērtības, kas vāktas ik pēc 10 minūtēm).| |^|*Datu kopas etiķete*|Norādiet datu kopas etiķeti, kas tiek attēlota grafika *Datu kopa* konfigurācijā un grafika *Leģenda* (apkopotām datu kopām).<br>Visas datu kopas tiek numurētas, tostarp tās, kurām ir norādīta *Datu kopas etiķete*. Ja etiķete nav norādīta, datu kopa tiks automātiski marķēta atbilstoši tās numuram (piem., "Datu kopa #2", "Datu kopa #3" utt.). Datu kopu numerācija tiek pārrēķināta pēc datu kopu pārkārtošanas/pārvilkšanas.<br>Pārāk garas datu kopas etiķetes tiks saīsinātas, lai tās ietilptu vietā, kur tās tiek attēlotas (piem., "Proc... skaits").| #### Data set The **Data set** tab allows selecting data for the pie chart by adding data sets. Two types of data sets can be added: - *Item patterns* - data from matching items is displayed. The chart is drawn using different shades of single color for each item. - *Item list* - data from selected items is displayed. The chart is drawn using different colors for each item. By default, an *Item patterns* data set is added. | | | | |-|----------|----------------------------------------| |*Data set*|<|For **Item patterns** data set:<br>Select or enter host and item patterns; data of items that match the entered patterns will be displayed on the pie chart; up to 50 items may be displayed.<br>Wildcard patterns may be used for selection (for example, `*` will return results that match zero or more characters).<br>To specify a wildcard pattern, enter the string manually and press *Enter*.<br>The wildcard symbol is always interpreted, so it is not possible to add, for example, an item named *item\** individually if there are other matching items (for example, *item2*, *item3*).<br>Specifying host and item patterns is mandatory for "Item patterns" data sets.<br>See also: [Data set configuration details](#data-set-configuration-details).<br><br>For **Item list** data set:<br>Select items for the pie chart by clicking on the *Add item* button.<br>The *Type* dropdown after the item name allows to select the display type for each item:<br>**Normal** - item value is represented proportionally on the pie chart (default);<br>**Total** - item value takes up the whole pie chart. Note that only one "Total" item can exist per pie chart, and it will be placed first on the pie chart legend. If an item is set to "Total", the *Data set aggregation* parameter (see below) will be disabled and set to "not used".<br>Since Zabbix 7.0.1, you may also select compatible widgets as the [data source](/manual/web_interface/frontend_sections/dashboards/widgets#dynamic-parameters) for items by clicking on the *Add widget* button. The same options apply to widgets as to individual items.<br>Specifying items or widgets is mandatory for "Item list" data sets.<br>See also: [Data set configuration details](#data-set-configuration-details).<br><br>Note that only numeric item types are allowed.<br><br>When configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards), the parameter for specifying host patterns is not available, and the parameter for specifying an item list allows to select only the [items configured on the template](/manual/config/templates/template#adding-items-triggers-graphs).| | |*Aggregation function*|Specify which aggregation function to use for each item in the data set within the selected [*Time period*](#time-period):<br>**min** - display the smallest value;<br>**max** - display the largest value;<br>**avg** - display the average value;<br>**sum** - display the sum of values;<br>**count** - display the count of values;<br>**first** - display the first value;<br>**last** - display the last value (default).<br><br>Aggregation allows to display an aggregated value for the chosen interval (5 minutes, an hour, a day).<br>Only numeric data can be displayed for *min*, *max*, *avg* and *sum*. For *count*, non-numeric data will be changed to numeric.| |^|*Data set aggregation*|Specify which aggregation function to use for the whole data set:<br>**not used** - no aggregation, items are displayed separately (default);<br>**min** - display the smallest value;<br>**max** - display the largest value;<br>**avg** - display the average value;<br>**sum** - display the sum of values;<br>**count** - display the count of values.<br><br>Aggregation allows to display an aggregated value for the interval (5 minutes, an hour, a day) selected in the *Time period* tab or used for the whole dashboard.| |^|*Data set label*|Specify a custom label for the data set.<br>The label is displayed in the data set configuration and the pie chart legend (for aggregated data sets).<br>All data sets are numbered including those with a specified *Data set label*. If no label is specified, the data set will be labeled automatically according to its number (e.g. "Data set #2", "Data set #3", etc.). Data set numbering is recalculated after reordering/dragging data sets.<br>Data set labels that are too long will be shortened to fit where displayed (e.g. "Number of proc...").| #### Datu kopa Cilne **Datu kopa** ļauj atlasīt datus sektoru diagrammai, pievienojot datu kopas. Var pievienot divu veidu datu kopas: - *Vienumu paraugi* - tiek parādīti dati no atbilstošajiem vienumiem. Diagramma tiek zīmēta, katram vienumam izmantojot dažādus vienas krāsas toņus. - *Vienumu saraksts* - tiek parādīti dati no atlasītajiem vienumiem. Diagramma tiek zīmēta, katram vienumam izmantojot dažādas krāsas. Pēc noklusējuma tiek pievienota *Vienumu paraugi* datu kopa. | | | | |-|----------|----------------------------------------| |*Datu kopa*|<|Datu kopai **Vienumu paraugi**:<br>Atlasiet vai ievadiet hosts un vienumu paraugus; tiks parādīti to vienumu dati, kas atbilst ievadītajiem paraugiem, sektoru diagrammā var parādīt līdz 50 vienumiem.<br>Atlasei var izmantot aizstājējzīmju paraugus (piemēram, `*` atgriezīs rezultātus, kas atbilst nullei vai vairākiem simboliem).<br>Lai norādītu aizstājējzīmes paraugu, ievadiet virkni manuāli un nospiediet *Enter*.<br>Aizstājējzīmes simbols vienmēr tiek interpretēts, tāpēc, piemēram, nav iespējams atsevišķi pievienot vienumu ar nosaukumu *item\** , ja pastāv citi atbilstoši vienumi (piemēram, *item2*, *item3*).<br>Hosta un vienuma paraugu norādīšana ir obligāta datu kopām "Vienumu paraugi".<br>Skatiet arī: [Datu kopas konfigurācijas informācija](#data-set-configuration-details).<br><br>Datu kopai **Vienumu saraksts**:<br>Atlasiet vienumus sektoru diagrammai, noklikšķinot uz pogas *Pievienot vienumu*.<br>Izvēlne *Type* pēc vienuma nosaukuma ļauj atlasīt katra vienuma attēlošanas veidu:<br>**Normal** - vienuma vērtība tiek attēlota proporcionāli sektoru diagrammā (noklusējums);<br>**Total** - vienuma vērtība aizņem visu sektoru diagrammu. Ņemiet vērā, ka katrā sektoru diagrammā var būt tikai viens vienums "Total", un tas tiks novietots pirmais sektoru diagrammas leģendā. Ja vienumam ir iestatīts "Total", parametrs *Data set aggregation* (skatiet tālāk) tiks atspējots un iestatīts uz "not used".<br>Kopš Zabbix 7.0.1 jūs varat arī atlasīt saderīgus logrīkus kā [datu avotu](/manual/web_interface/frontend_sections/dashboards/widgets#dynamic-parameters) vienumiem, noklikšķinot uz pogas *Pievienot logrīku*. Uz logrīkiem attiecas tās pašas opcijas, kas uz atsevišķiem vienumiem.<br>Vienumu vai logrīku norādīšana ir obligāta datu kopām "Vienumu saraksts".<br>Skatiet arī: [Datu kopas konfigurācijas informācija](#data-set-configuration-details).<br><br>Ņemiet vērā, ka ir atļauti tikai skaitliski vienumu tipi.<br><br>Konfigurējot logrīku [veidnes informācijas panelī](/manual/config/templates/template#adding-dashboards), parametrs hosta paraugu norādīšanai nav pieejams, un parametrs vienumu saraksta norādīšanai ļauj atlasīt tikai [veidnē konfigurētos vienumus](/manual/config/templates/template#adding-items-triggers-graphs).| | |*Aggregation function*|Norādiet, kuru apkopošanas funkciju izmantot katram vienumam datu kopā izvēlētajā [*Time period*](#time-period):<br>**min** - parādīt mazāko vērtību;<br>**max** - parādīt lielāko vērtību;<br>**avg** - parādīt vidējo vērtību;<br>**sum** - parādīt vērtību summu;<br>**count** - parādīt vērtību skaitu;<br>**first** - parādīt pirmo vērtību;<br>**last** - parādīt pēdējo vērtību (noklusējums).<br><br>Apkopošana ļauj parādīt apkopotu vērtību izvēlētajam intervālam (5 minūtes, stunda, diena).<br>Tikai skaitliskus datus var parādīt ar *min*, *max*, *avg* un *sum*. Ar *count* neskaitliskie dati tiks pārveidoti par skaitliskiem.| |^|*Data set aggregation*|Norādiet, kuru apkopošanas funkciju izmantot visai datu kopai:<br>**not used** - apkopošana netiek veikta, vienumi tiek rādīti atsevišķi (noklusējums);<br>**min** - parādīt mazāko vērtību;<br>**max** - parādīt lielāko vērtību;<br>**avg** - parādīt vidējo vērtību;<br>**sum** - parādīt vērtību summu;<br>**count** - parādīt vērtību skaitu.<br><br>Apkopošana ļauj parādīt apkopotu vērtību intervālam (5 minūtes, stunda, diena), kas atlasīts cilnē *Time period* vai izmantots visam informācijas panelim.| |^|*Data set label*|Norādiet pielāgotu datu kopas etiķeti.<br>Etiķete tiek parādīta datu kopas konfigurācijā un sektoru diagrammas leģendā (apkopotām datu kopām).<br>Visas datu kopas tiek numurētas, tostarp tās, kurām ir norādīta *Data set label*. Ja etiķete nav norādīta, datu kopa tiks automātiski apzīmēta atbilstoši tās numuram (piem., "Data set #2", "Data set #3" utt.). Datu kopu numerācija tiek pārrēķināta pēc datu kopu pārkārtošanas/pārvilkšanas.<br>Pārāk garas datu kopu etiķetes tiks saīsinātas, lai tās ietilptu vietā, kur tās tiek rādītas (piem., "Number of proc...").| #### Data set The following parameters are supported for configuring a *Data set*. ::: noteclassic The first number in the property name (e.g. ds.0.hosts.0, ds.0.items.0) represents the particular data set, while the second number, if present, represents the configured host or item. ::: |Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-|--------|--|--------|-------------------------------| |*Data set type*|<|0|ds.0.dataset_type|0 - Item list;<br>1 - *(default)* Item patterns.| |<|*Items*|4|ds.0.itemids.0|[Item](/manual/api/reference/item/get) ID.<br><br>When configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object), only items configured on the template should be set.<br><br>Note: To configure multiple items, create a dashboard widget field object for each item with an incremented number in the property name.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if *Data set type* is set to "Item list" and *Items (Widget)* is not set| |^|*Items (Widget)*|1|ds.0.itemids.0.\_reference|Instead of [Item](/manual/api/reference/item/get) ID:<br>`ABCDE._itemid` - set a [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (with its *Reference* parameter set to "`ABCDE`") as the data source for items.<br><br>Note: To configure multiple widgets, create a dashboard widget field object for each widget with an incremented number in the property name.<br><br>This parameter is supported since Zabbix 7.0.1.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if *Data set type* is set to "Item list" and *Items* is not set| |^|*Color*|1|ds.0.color.0|Hexadecimal color code (e.g. `FF0000`).<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if *Data set type* is set to "Item list"| |^|*Host patterns*|1|ds.0.hosts.0|[Host](/manual/api/reference/host/get) name or pattern (e.g., "Zabbix\*").<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if *Data set type* is set to "Item patterns"<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |^|*Item patterns*|1|ds.0.items.0|[Item](/manual/api/reference/item/get) name or pattern (e.g., "\*: Number of processed \*values per second").<br><br>When configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object), only the patterns for items configured on the template should be set.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if *Data set type* is set to "Item patterns"| |^|*Color*|1|ds.0.color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `FF465C`.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Data set type* is set to "Item patterns"| |*Draw*|<|0|ds.0.type|0 - *(default)* Line;<br>1 - Points;<br>2 - Staircase;<br>3 - Bar.| |*Stacked*|<|0|ds.0.stacked|0 - *(default)* Disabled;<br>1 - Enabled.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Draw* is set to "Line", "Staircase", or "Bar"| |*Width*|<|0|ds.0.width|Possible values range from 1-10.<br><br>Default: 1.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Draw* is set to "Line" or "Staircase"| |*Point size*|<|0|ds.0.pointsize|Possible values range from 1-10.<br><br>Default: 3.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Draw* is set to "Points"| |*Transparency*|<|0|ds.0.transparency|Possible values range from 1-10.<br><br>Default: 5.| |*Fill*|<|0|ds.0.fill|Possible values range from 1-10.<br><br>Default: 3.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Draw* is set to "Line" or "Staircase"| |*Missing data*|<|0|ds.0.missingdatafunc|0 - *(default)* None;<br>1 - Connected;<br>2 - Treat as 0;<br>3 - Last known.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Draw* is set to "Line" or "Staircase"| |*Y-axis*|<|0|ds.0.axisy|0 - *(default)* Left;<br>1 - Right.| |*Time shift*|<|1|ds.0.timeshift|Valid time string (e.g. `3600`, `1h`, etc.).<br>You may use [time suffixes](/manual/appendix/suffixes#time-suffixes). Negative values are also allowed.<br><br>Default: `""` (empty).| |*Aggregation function*|<|0|ds.0.aggregate_function|0 - *(default)* not used;<br>1 - min;<br>2 - max;<br>3 - avg;<br>4 - count;<br>5 - sum;<br>6 - first;<br>7 - last.| |*Aggregation interval*|<|1|ds.0.aggregate_interval|Valid time string (e.g. `3600`, `1h`, etc.).<br>You may use [time suffixes](/manual/appendix/suffixes#time-suffixes).<br><br>Default: `1h`.| |*Aggregate*|<|0|ds.0.aggregate_grouping|0 - *(default)* Each item;<br>1 - Data set.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Aggregation function* is set to "min", "max", "avg", "count", "sum", "first", or "last"| |*Approximation*|<|0|ds.0.approximation|1 - min;<br>2 - *(default)* avg;<br>4 - max;<br>7 - all.| |*Data set label*|<|1|ds.0.data_set_label|Any string value.<br><br>Default: `""` (empty).| #### Datu kopa Tālāk norādītie parametri tiek atbalstīti *Datu kopas* konfigurēšanai. ::: noteclassic Pirmais skaitlis īpašuma nosaukumā (piem., ds.0.hosts.0, ds.0.items.0) apzīmē konkrēto datu kopu, savukārt otrais skaitlis, ja tāds ir, apzīmē konfigurēto hostu vai vienumu. ::: |Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-|--------|--|--------|-------------------------------| |*Datu kopas tips*|<|0|ds.0.dataset_type|0 - Vienumu saraksts;<br>1 - *(noklusējums)* Vienumu paraugi.| |<|*Vienumi*|4|ds.0.itemids.0|[Vienuma](/manual/api/reference/item/get) ID.<br><br>Konfigurējot logrīku [veidnes informācijas panelī](/manual/api/reference/templatedashboard/object), jānorāda tikai tie vienumi, kas konfigurēti veidnē.<br><br>Piezīme: lai konfigurētu vairākus vienumus, izveidojiet informācijas paneļa logrīka lauka objektu katram vienumam, palielinot numuru īpašuma nosaukumā.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *obligāts*, ja *Datu kopas tips* ir iestatīts uz "Vienumu saraksts" un *Vienumi (Logrīks)* nav iestatīts| |^|*Vienumi (Logrīks)*|1|ds.0.itemids.0.\_reference|[Vienuma](/manual/api/reference/item/get) ID vietā:<br>`ABCDE._itemid` - iestatiet [saderīgu logrīku](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (ar tā *Reference* parametru iestatītu uz "`ABCDE`") kā vienumu datu avotu.<br><br>Piezīme: lai konfigurētu vairākus logrīkus, izveidojiet informācijas paneļa logrīka lauka objektu katram logrīkam, palielinot numuru īpašuma nosaukumā.<br><br>Šis parametrs tiek atbalstīts kopš Zabbix 7.0.1.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *obligāts*, ja *Datu kopas tips* ir iestatīts uz "Vienumu saraksts" un *Vienumi* nav iestatīts| |^|*Krāsa*|1|ds.0.color.0|Heksadecimāls krāsas kods (piem., `FF0000`).<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *obligāts*, ja *Datu kopas tips* ir iestatīts uz "Vienumu saraksts"| |^|*Hostu paraugi*|1|ds.0.hosts.0|[Hosta](/manual/api/reference/host/get) nosaukums vai paraugs (piem., "Zabbix\*").<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *obligāts*, ja *Datu kopas tips* ir iestatīts uz "Vienumu paraugi"<br><br>Šis parametrs netiek atbalstīts, konfigurējot logrīku [veidnes informācijas panelī](/manual/api/reference/templatedashboard/object).| |^|*Vienumu paraugi*|1|ds.0.items.0|[Vienuma](/manual/api/reference/item/get) nosaukums vai paraugs (piem., "\*: Number of processed \*values per second").<br><br>Konfigurējot logrīku [veidnes informācijas panelī](/manual/api/reference/templatedashboard/object), jānorāda tikai to vienumu paraugi, kas konfigurēti veidnē.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *obligāts*, ja *Datu kopas tips* ir iestatīts uz "Vienumu paraugi"| |^|*Krāsa*|1|ds.0.color|Heksadecimāls krāsas kods (piem., `FF0000`).<br><br>Noklusējums: `FF465C`.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja *Datu kopas tips* ir iestatīts uz "Vienumu paraugi"| |*Zīmējums*|<|0|ds.0.type|0 - *(noklusējums)* Līnija;<br>1 - Punkti;<br>2 - Kāpnes;<br>3 - Josla.| |*Sakrauts*|<|0|ds.0.stacked|0 - *(noklusējums)* Atspējots;<br>1 - Iespējots.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja *Zīmējums* ir iestatīts uz "Līnija", "Kāpnes" vai "Josla"| |*Platums*|<|0|ds.0.width|Iespējamās vērtības diapazonā no 1 līdz 10.<br><br>Noklusējums: 1.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja *Zīmējums* ir iestatīts uz "Līnija" vai "Kāpnes"| |*Punkta izmērs*|<|0|ds.0.pointsize|Iespējamās vērtības diapazonā no 1 līdz 10.<br><br>Noklusējums: 3.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja *Zīmējums* ir iestatīts uz "Punkti"| |*Caurspīdīgums*|<|0|ds.0.transparency|Iespējamās vērtības diapazonā no 1 līdz 10.<br><br>Noklusējums: 5.| |*Aizpildījums*|<|0|ds.0.fill|Iespējamās vērtības diapazonā no 1 līdz 10.<br><br>Noklusējums: 3.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja *Zīmējums* ir iestatīts uz "Līnija" vai "Kāpnes"| |*Trūkstoši dati*|<|0|ds.0.missingdatafunc|0 - *(noklusējums)* Nav;<br>1 - Savienots;<br>2 - Uzskatīt par 0;<br>3 - Pēdējais zināmais.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja *Zīmējums* ir iestatīts uz "Līnija" vai "Kāpnes"| |*Y ass*|<|0|ds.0.axisy|0 - *(noklusējums)* Kreisā;<br>1 - Labā.| |*Laika nobīde*|<|1|ds.0.timeshift|Derīga laika virkne (piem., `3600`, `1h` utt.).<br>Var izmantot [laika sufiksus](/manual/appendix/suffixes#time-suffixes). Ir atļautas arī negatīvas vērtības.<br><br>Noklusējums: `""` (tukšs).| |*Agregācijas funkcija*|<|0|ds.0.aggregate_function|0 - *(noklusējums)* netiek izmantots;<br>1 - min;<br>2 - max;<br>3 - avg;<br>4 - count;<br>5 - sum;<br>6 - first;<br>7 - last.| |*Agregācijas intervāls*|<|1|ds.0.aggregate_interval|Derīga laika virkne (piem., `3600`, `1h` utt.).<br>Var izmantot [laika sufiksus](/manual/appendix/suffixes#time-suffixes).<br><br>Noklusējums: `1h`.| |*Agregēt*|<|0|ds.0.aggregate_grouping|0 - *(noklusējums)* Katrs vienums;<br>1 - Datu kopa.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja *Agregācijas funkcija* ir iestatīta uz "min", "max", "avg", "count", "sum", "first" vai "last"| |*Aptuvenošana*|<|0|ds.0.approximation|1 - min;<br>2 - *(noklusējums)* avg;<br>4 - max;<br>7 - all.| |*Datu kopas etiķete*|<|1|ds.0.data_set_label|Jebkura teksta vērtība.<br><br>Noklusējums: `""` (tukšs).| #### Data set The following parameters are supported for configuring a *Data set*. ::: noteclassic The first number in the property name (e.g. ds.0.hosts.0, ds.0.items.0) represents the particular data set, while the second number, if present, represents the configured host or item. ::: |Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-|--------|--|--------|-------------------------------| |*Data set type*|<|0|ds.0.dataset_type|0 - Item list;<br>1 - *(default)* Item patterns.| |<|*Items*|4|ds.0.itemids.0|[Item](/manual/api/reference/item/get) ID.<br>When configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object), only items configured on the template should be set.<br><br>Note: To configure multiple items, create a dashboard widget field object for each item with an incremented number in the property name.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if *Data set type* is set to "Item list" and *Items (Widget)* is not set| |^|*Items (Widget)*|1|ds.0.itemids.0.\_reference|Instead of [Item](/manual/api/reference/item/get) ID:<br>`ABCDE._itemid` - set a [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (with its *Reference* parameter set to "`ABCDE`") as the data source for items.<br><br>Note: To configure multiple widgets, create a dashboard widget field object for each widget with an incremented number in the property name.<br><br>This parameter is supported since Zabbix 7.0.1.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if *Data set type* is set to "Item list" and *Items* is not set| |^|*Color*|1|ds.0.color.0|Hexadecimal color code (e.g. `FF0000`).<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if *Data set type* is set to "Item list"| |^|*Item type*|0|ds.0.type.0|0 - *(default)* Normal;<br>1 - Total.<br><br>The value "Total" can be set only for one item in the whole chart.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Data set type* is set to "Item list"| |^|*Host patterns*|1|ds.0.hosts.0|[Host](/manual/api/reference/host/get) name or pattern (e.g., "Zabbix\*").<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if *Data set type* is set to "Item patterns"<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |^|*Item patterns*|1|ds.0.items.0|[Item](/manual/api/reference/item/get) name or pattern (e.g., "\*: Number of processed \*values per second").<br><br>When configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object), only the patterns for items configured on the template should be set.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if *Data set type* is set to "Item patterns"| |^|*Color*|1|ds.0.color|Hexadecimal color code (e.g. `FF0000`).<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Data set type* is set to "Item patterns"| |*Aggregation function*|<|0|ds.0.aggregate_function|1 - min;<br>2 - max;<br>3 - avg;<br>4 - count;<br>5 - sum;<br>6 - first;<br>7 - *(default)* last.| |*Data set aggregation*|<|0|ds.0.dataset_aggregation|0 - *(default)* none;<br>1 - min;<br>2 - max;<br>3 - avg;<br>4 - count;<br>5 - sum.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Item type* is set to "Total"| |*Data set label*|<|1|ds.0.data_set_label|Any string value.<br><br>Default: `""` (empty).| #### Datu kopa Tālāk norādītie parametri tiek atbalstīti *Datu kopas* konfigurēšanai. ::: noteclassic Pirmais skaitlis īpašuma nosaukumā (piem., ds.0.hosts.0, ds.0.items.0) apzīmē konkrēto datu kopu, savukārt otrais skaitlis, ja tāds ir, apzīmē konfigurēto hostu vai vienumu. ::: |Parametrs|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|nosaukums|vērtība| |-|--------|--|--------|-------------------------------| |*Datu kopas tips*|<|0|ds.0.dataset_type|0 - Vienumu saraksts;<br>1 - *(noklusējums)* Vienumu raksti.| |<|*Vienumi*|4|ds.0.itemids.0|[Vienuma](/manual/api/reference/item/get) ID.<br>Konfigurējot logrīku [veidnes informācijas panelī](/manual/api/reference/templatedashboard/object), jānorāda tikai tie vienumi, kas konfigurēti veidnē.<br><br>Piezīme: lai konfigurētu vairākus vienumus, izveidojiet atsevišķu informācijas paneļa logrīka lauka objektu katram vienumam, palielinot numuru īpašuma nosaukumā.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *obligāts*, ja *Datu kopas tips* ir iestatīts uz "Vienumu saraksts" un *Vienumi (logrīks)* nav iestatīts| |^|*Vienumi (logrīks)*|1|ds.0.itemids.0.\_reference|[Vienuma](/manual/api/reference/item/get) ID vietā:<br>`ABCDE._itemid` - iestatiet [saderīgu logrīku](/manual/api/reference_commentary#parameter-behavior) (ar tā *Atsauces* parametru iestatītu uz "`ABCDE`") kā datu avotu vienumiem.<br><br>Piezīme: lai konfigurētu vairākus logrīkus, izveidojiet atsevišķu informācijas paneļa logrīka lauka objektu katram logrīkam, palielinot numuru īpašuma nosaukumā.<br><br>Šis parametrs tiek atbalstīts kopš Zabbix 7.0.1.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *obligāts*, ja *Datu kopas tips* ir iestatīts uz "Vienumu saraksts" un *Vienumi* nav iestatīts| |^|*Krāsa*|1|ds.0.color.0|Heksadecimāls krāsas kods (piem., `FF0000`).<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *obligāts*, ja *Datu kopas tips* ir iestatīts uz "Vienumu saraksts"| |^|*Vienuma tips*|0|ds.0.type.0|0 - *(noklusējums)* Parasts;<br>1 - Kopā.<br><br>Vērtību "Kopā" var iestatīt tikai vienam vienumam visā diagrammā.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja *Datu kopas tips* ir iestatīts uz "Vienumu saraksts"| |^|*Hostu raksti*|1|ds.0.hosts.0|[Hosta](/manual/api/reference/host/get) nosaukums vai raksts (piem., "Zabbix\*").<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *obligāts*, ja *Datu kopas tips* ir iestatīts uz "Vienumu raksti"<br><br>Šis parametrs netiek atbalstīts, konfigurējot logrīku [veidnes informācijas panelī](/manual/api/reference/templatedashboard/object).| |^|*Vienumu raksti*|1|ds.0.items.0|[Vienuma](/manual/api/reference/item/get) nosaukums vai raksts (piem., "\*: Number of processed \*values per second").<br><br>Konfigurējot logrīku [veidnes informācijas panelī](/manual/api/reference/templatedashboard/object), jānorāda tikai tie vienumu raksti, kas konfigurēti veidnē.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *obligāts*, ja *Datu kopas tips* ir iestatīts uz "Vienumu raksti"| |^|*Krāsa*|1|ds.0.color|Heksadecimāls krāsas kods (piem., `FF0000`).<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja *Datu kopas tips* ir iestatīts uz "Vienumu raksti"| |*Agregācijas funkcija*|<|0|ds.0.aggregate_function|1 - min;<br>2 - max;<br>3 - avg;<br>4 - count;<br>5 - sum;<br>6 - first;<br>7 - *(noklusējums)* last.| |*Datu kopas agregācija*|<|0|ds.0.dataset_aggregation|0 - *(noklusējums)* nav;<br>1 - min;<br>2 - max;<br>3 - avg;<br>4 - count;<br>5 - sum.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja *Vienuma tips* ir iestatīts uz "Kopā"| |*Datu kopas etiķete*|<|1|ds.0.data_set_label|Jebkura teksta vērtība.<br><br>Noklusējums: `""` (tukšs).| #### Data types The Zabbix API supports the following data types as input: |Type|Description| |--|--------| |ID|A unique identifier used to reference an entity.| |boolean|A boolean value (either `true` or `false`).| |flag|A value that is considered to be `true` if passed and not equal to `null`; otherwise, the value is considered to be `false`.| |integer|A whole number.| |float|A floating point number.| |string|A text string.| |text|A longer text string.| |timestamp|A Unix timestamp.| |array|An ordered sequence of values (a plain array).| |object|An associative array.| |query|A value that defines the data to be returned. The value can be defined as an array of property names (to return only specific properties), or as one of the predefined values:<br>`extend` - returns all object properties;<br>`count` - returns the number of retrieved records, supported only by certain subselects.| ::: noteimportant Zabbix API always returns values as strings or arrays only. ::: #### Datu tipi Zabbix API atbalsta šādus datu tipus kā ievadi: |Type|Description| |--|--------| |ID|Unikāls identifikators, ko izmanto, lai atsauktos uz entītiju.| |boolean|Būla vērtība (`true` vai `false`).| |flag|Vērtība, kas tiek uzskatīta par `true`, ja tā ir nodota un nav vienāda ar `null`; pretējā gadījumā vērtība tiek uzskatīta par `false`.| |integer|Vesels skaitlis.| |float|Peldošā komata skaitlis.| |string|Teksta virkne.| |text|Garāka teksta virkne.| |timestamp|Unix laikspiedols.| |array|Sakārtota vērtību secība (parasts masīvs).| |object|Asociatīvs masīvs.| |query|Vērtība, kas nosaka atgriežamos datus. Vērtību var definēt kā īpašību nosaukumu masīvu (lai atgrieztu tikai noteiktas īpašības) vai kā vienu no iepriekš definētajām vērtībām:<br>`extend` - atgriež visas objekta īpašības;<br>`count` - atgriež iegūto ierakstu skaitu; to atbalsta tikai noteikti apakšatlases vaicājumi.| ::: noteimportant Zabbix API vienmēr atgriež vērtības tikai kā virknes vai masīvus. ::: ### Date and time |Macro|Supported in|Description| |--|--------|--------| |{DATE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Discovery notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands|*Current date in yyyy.mm.dd format.*| |{TIME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Discovery notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications<br>→ Trigger event names<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands<br>→ Scheduled reports subject/message fields|*Current time in hh:mm:ss.*| ### Datums un laiks |Makro|Atbalstīts|Apraksts| |--|--------|--------| |{DATE}|→ Uz trigeri balstīti paziņojumi un komandas<br>→ Problēmu atjauninājumu paziņojumi un komandas<br>→ Uz pakalpojumu balstīti paziņojumi un komandas<br>→ Pakalpojumu atjauninājumu paziņojumi un komandas<br>→ Atklāšanas paziņojumi un komandas<br>→ Autoreģistrācijas paziņojumi un komandas<br>→ Iekšējie paziņojumi<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas|*Pašreizējais datums formātā yyyy.mm.dd.*| |{TIME}|→ Uz trigeri balstīti paziņojumi un komandas<br>→ Problēmu atjauninājumu paziņojumi un komandas<br>→ Uz pakalpojumu balstīti paziņojumi un komandas<br>→ Pakalpojumu atjauninājumu paziņojumi un komandas<br>→ Atklāšanas paziņojumi un komandas<br>→ Autoreģistrācijas paziņojumi un komandas<br>→ Iekšējie paziņojumi<br>→ Trigera notikumu nosaukumi<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas<br>→ Plānoto pārskatu tēmas/ziņojuma lauki|*Pašreizējais laiks formātā hh:mm:ss.*| ##### date The current date in YYYYMMDD format. Example: date()<20220101 ##### date Pašreizējais datums YYYYMMDD formātā. Piemērs: date()<20220101 ##### Date The following advanced configuration parameters are supported if *Clock type* is set to "Digital", and *Show* is set to "Date". |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Bold*|0|date_bold|0 - *(default)* Disabled;<br>1 - Enabled.| |*Color*|1|date_color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `""` (empty).| ##### Datums Tālāk norādītie paplašinātās konfigurācijas parametri tiek atbalstīti, ja *Clock type* ir iestatīts uz "Digital" un *Show* ir iestatīts uz "Date". |Parametrs|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Treknraksts*|0|date_bold|0 - *(noklusējums)* Atspējots;<br>1 - Iespējots.| |*Krāsa*|1|date_color|Heksadecimālais krāsas kods (piemēram, `FF0000`).<br><br>Noklusējums: `""` (tukšs).| ##### dayofmonth The day of month in range of 1 to 31. Example: dayofmonth()=1 ##### dayofmonth Mēneša diena diapazonā no 1 līdz 31. Piemērs: dayofmonth()=1 ##### dayofweek The day of week in range of 1 to 7 (Mon - 1, Sun - 7). Example (only weekdays): dayofweek()<6 Example (only weekend): dayofweek()>5 ##### dayofweek Nedēļas diena diapazonā no 1 līdz 7 (Pirmd. - 1, Svētd. - 7). Piemērs (tikai darba dienas): dayofweek()<6 Piemērs (tikai nedēļas nogale): dayofweek()>5 ##### DBHost The host (or socket directory) of the Zabbix database. For MySQL: - `localhost` or an empty string uses the default UNIX-domain socket. For PostgreSQL: - `localhost` is resolved via DNS (typically to 127.0.0.1). - An empty string uses the default UNIX-domain socket. - A path (for example, `/var/run/pgbouncer`) results in using the UNIX socket at that path. - A comma-separated list can contain multiple `host:port` values. Each host is tried in order until a read-write connection is established. Example: `DBHost=localhost:5431,127.0.0.1:20051,zabbix.domain,[::1]:30051,[12fc::1]` With [Oracle](/manual/appendix/install/oracle#connection-set-up) empty string results in using the Net Service Name connection method; in this case consider using the TNS_ADMIN environment variable to specify the directory of the `tnsnames.ora` file. Default: `localhost` ##### DBHost Zabbix datubāzes hosts (vai ligzdas direktorijs). MySQL gadījumā: - `localhost` vai tukša virkne izmanto noklusējuma UNIX domēna ligzdu. PostgreSQL gadījumā: - `localhost` tiek atrisināts, izmantojot DNS (parasti uz 127.0.0.1). - Tukša virkne izmanto noklusējuma UNIX domēna ligzdu. - Ceļš (piemēram, `/var/run/pgbouncer`) nozīmē UNIX ligzdas izmantošanu šajā ceļā. - Ar komatiem atdalīts saraksts var saturēt vairākas `host:port` vērtības. Katrs hosts tiek mēģināts secīgi, līdz tiek izveidots lasīšanas-rakstīšanas savienojums. Piemērs: `DBHost=localhost:5431,127.0.0.1:20051,zabbix.domain,[::1]:30051,[12fc::1]` Ar [Oracle](/manual/appendix/install/oracle#connection-set-up) tukša virkne nozīmē Net Service Name savienojuma metodes izmantošanu; šajā gadījumā apsveriet TNS_ADMIN vides mainīgā izmantošanu, lai norādītu `tnsnames.ora` faila direktoriju. Noklusējums: `localhost` ##### DBHost The host (or socket directory) of the Zabbix database. For MySQL: - `localhost` or an empty string uses the default UNIX-domain socket. For PostgreSQL: - `localhost` is resolved via DNS (typically to 127.0.0.1). - An empty string uses the default UNIX-domain socket. - A path (for example, `/var/run/pgbouncer`) results in using the UNIX socket at that path. - A comma-separated list can contain multiple `host:port` values. Each host is tried in order until a read-write connection is established. Example: `DBHost=localhost:5431,127.0.0.1:20051,zabbix.domain,[::1]:30051,[12fc::1]` With [Oracle](/manual/appendix/install/oracle#connection_set_up) empty string results in using the Net Service Name connection method; in this case consider using the TNS_ADMIN environment variable to specify the directory of the `tnsnames.ora` file. Default: `localhost` ##### DBHost Zabbix datubāzes hosts (vai socket direktorija). MySQL gadījumā: - `localhost` vai tukša virkne izmanto noklusējuma UNIX domēna socket. PostgreSQL gadījumā: - `localhost` tiek atrisināts, izmantojot DNS (parasti uz 127.0.0.1). - Tukša virkne izmanto noklusējuma UNIX domēna socket. - Ceļš (piemēram, `/var/run/pgbouncer`) nozīmē UNIX socket izmantošanu šajā ceļā. - Ar komatiem atdalīts saraksts var saturēt vairākas `host:port` vērtības. Katrs hosts tiek mēģināts pēc kārtas, līdz tiek izveidots lasīšanas-rakstīšanas savienojums. Piemērs: `DBHost=localhost:5431,127.0.0.1:20051,zabbix.domain,[::1]:30051,[12fc::1]` Ar [Oracle](/manual/appendix/install/oracle#connection_set_up) tukša virkne nozīmē Net Service Name savienojuma metodes izmantošanu; šajā gadījumā apsveriet TNS_ADMIN vides mainīgā izmantošanu, lai norādītu `tnsnames.ora` faila direktoriju. Noklusējums: `localhost` ##### DBName The database name.<br>With [Oracle](/manual/appendix/install/oracle#connection-set-up), if the Net Service Name connection method is used, specify the service name from tnsnames.ora or set to empty string; set the TWO\_TASK environment variable if DBName is set to empty string. Mandatory: Yes ##### DBName Datubāzes nosaukums.<br>Izmantojot [Oracle](/manual/appendix/install/oracle#connection-set-up), ja tiek izmantota Net Service Name savienojuma metode, norādiet pakalpojuma nosaukumu no tnsnames.ora vai iestatiet tukšu virkni; iestatiet TWO\_TASK vides mainīgo, ja DBName ir iestatīts kā tukša virkne. Obligāts: Jā ##### DBName The database name or path to the database file for SQLite3 (the multi-process architecture of Zabbix does not allow to use [in-memory database](https://www.sqlite.org/inmemorydb.html), e.g. `:memory:`, `file::memory:?cache=shared` or `file:memdb1?mode=memory&cache=shared`).<br>*Warning*: Do not attempt to use the same database the Zabbix server is using.<br>With [Oracle](/manual/appendix/install/oracle#connection_set_up), if the Net Service Name connection method is used, specify the service name from tnsnames.ora or set to empty string; set the TWO\_TASK environment variable if DBName is set to empty string. Mandatory: Yes ##### DBName SQLite3 datubāzes nosaukums vai ceļš uz datubāzes failu (Zabbix vairāku procesu arhitektūra neļauj izmantot [atmiņā esošu datubāzi](https://www.sqlite.org/inmemorydb.html), piemēram, `:memory:`, `file::memory:?cache=shared` vai `file:memdb1?mode=memory&cache=shared`).<br>*Brīdinājums*: Nemēģiniet izmantot to pašu datubāzi, ko izmanto Zabbix serveris.<br>Izmantojot [Oracle](/manual/appendix/install/oracle#connection_set_up), ja tiek lietota Net Service Name savienojuma metode, norādiet pakalpojuma nosaukumu no tnsnames.ora vai atstājiet tukšu virkni; iestatiet TWO\_TASK vides mainīgo, ja DBName ir iestatīts kā tukša virkne. Obligāts: Jā ##### db.odbc.discovery[<unique short description>,<dsn>,<connection string>] {#db.odbc.discovery} <br> Transforms the SQL query result into a JSON array, used for [low-level discovery](/manual/discovery/low_level_discovery/examples/sql_queries). The column names from the query result are turned into low-level discovery macro names paired with the discovered field values. These macros can be used in creating item, trigger, etc. prototypes.<br> Return value: *JSON object*. Parameters: - **unique short description** - a unique short description to identify the item (for use in triggers, etc.); - **dsn** - the data source name (as specified in `odbc.ini`); - **connection string** - the connection string (may contain driver-specific arguments). Comments: - Although `dsn` and `connection string` are optional parameters, at least one of them is required; if both are defined, `dsn` will be ignored. ##### db.odbc.discovery[<unikāls īss apraksts>,<dsn>,<savienojuma virkne>] {#db.odbc.discovery} <br> Pārveido SQL vaicājuma rezultātu par JSON masīvu, ko izmanto [zema līmeņa atklāšanā](/manual/discovery/low_level_discovery/examples/sql_queries). Kolonnu nosaukumi no vaicājuma rezultāta tiek pārvērsti par zema līmeņa atklāšanas makrosu nosaukumiem, kas ir sasaistīti ar atklāto lauku vērtībām. Šos makrosus var izmantot, veidojot vienumu, trigeru u.c. prototipus.<br> Atgrieztā vērtība: *JSON objekts*. Parametri: - **unikāls īss apraksts** - unikāls īss apraksts vienuma identificēšanai (izmantošanai trigeros u.c.); - **dsn** - datu avota nosaukums (kā norādīts `odbc.ini`); - **savienojuma virkne** - savienojuma virkne (var saturēt draiverim specifiskus argumentus). Komentāri: - Lai gan `dsn` un `savienojuma virkne` ir neobligāti parametri, ir nepieciešams norādīt vismaz vienu no tiem; ja ir definēti abi, `dsn` tiks ignorēts. ##### db.odbc.get[<unique short description>,<dsn>,<connection string>] {#db.odbc.get} <br> Transforms the SQL query result into a JSON array.<br> Return value: *JSON object*. Parameters: - **unique short description** - a unique short description to identify the item (for use in triggers, etc.); - **dsn** - the data source name (as specified in `odbc.ini`); - **connection string** - the connection string (may contain driver-specific arguments). Comments: - Although `dsn` and `connection string` are optional parameters, at least one of them is required; if both are defined, `dsn` will be ignored. - Multiple rows/columns in JSON format may be returned. This item may be used as a master item that collects all data in one system call, while JSONPath preprocessing may be used in dependent items to extract individual values. For more information, see an [example](/manual/discovery/low_level_discovery/examples/sql_queries#using-db-odbc-get) of the returned format, used in low-level discovery. Example: # Connection for MySQL ODBC driver 5: db.odbc.get[MySQL example,,"Driver=/usr/local/lib/libmyodbc5a.so;Database=master;Server=127.0.0.1;Port=3306"] ##### db.odbc.get[<unique short description>,<dsn>,<connection string>] {#db.odbc.get} <br> Pārveido SQL vaicājuma rezultātu JSON masīvā.<br> Atgrieztā vērtība: *JSON objekts*. Parametri: - **unique short description** - unikāls īss apraksts, lai identificētu vienumu (izmantošanai trigeros u.c.); - **dsn** - datu avota nosaukums (kā norādīts `odbc.ini`); - **connection string** - savienojuma virkne (var saturēt draiverim specifiskus argumentus). Piezīmes: - Lai gan `dsn` un `connection string` ir neobligāti parametri, ir nepieciešams vismaz viens no tiem; ja abi ir definēti, `dsn` tiks ignorēts. - JSON formātā var tikt atgrieztas vairākas rindas/kolonnas. Šo vienumu var izmantot kā galveno vienumu, kas vienā sistēmas izsaukumā apkopo visus datus, savukārt atkarīgajos vienumos individuālu vērtību iegūšanai var izmantot JSONPath priekšapstrādi. Plašāku informāciju skatiet [piemērā](/manual/discovery/low_level_discovery/examples/sql_queries#using-db-odbc-get) par atgriezto formātu, kas izmantots zemā līmeņa atklāšanā. Piemērs: # Savienojums MySQL ODBC draiverim 5: db.odbc.get[MySQL example,,"Driver=/usr/local/lib/libmyodbc5a.so;Database=master;Server=127.0.0.1;Port=3306"] ##### db.odbc.select[<unique short description>,<dsn>,<connection string>] {#db.odbc.select} <br> Returns one value, that is, the first column of the first row of the SQL query result.<br> Return value: Depending on the SQL query. Parameters: - **unique short description** - a unique short description to identify the item (for use in triggers, etc.); - **dsn** - the data source name (as specified in `odbc.ini`); - **connection string** - the connection string (may contain driver-specific arguments). Comments: - Although `dsn` and `connection string` are optional parameters, at least one of them is required; if both are defined, `dsn` will be ignored. - If a query returns more than one column, only the first column is read. If a query returns more than one line, only the first line is read. ##### db.odbc.select[<unikāls īss apraksts>,<dsn>,<savienojuma virkne>] {#db.odbc.select} <br> Atgriež vienu vērtību, proti, SQL vaicājuma rezultāta pirmās rindas pirmo kolonnu.<br> Atgrieztā vērtība: atkarībā no SQL vaicājuma. Parametri: - **unikāls īss apraksts** - unikāls īss apraksts, lai identificētu vienumu (izmantošanai trigeros u.c.); - **dsn** - datu avota nosaukums (kā norādīts `odbc.ini`); - **savienojuma virkne** - savienojuma virkne (var saturēt draiverim specifiskus argumentus). Komentāri: - Lai gan `dsn` un `savienojuma virkne` ir neobligāti parametri, ir nepieciešams norādīt vismaz vienu no tiem; ja ir definēti abi, `dsn` tiks ignorēts. - Ja vaicājums atgriež vairāk nekā vienu kolonnu, tiek nolasīta tikai pirmā kolonna. Ja vaicājums atgriež vairāk nekā vienu rindu, tiek nolasīta tikai pirmā rinda. ##### DBPassword The database password. Comment this line if no password is used. ##### DBPassword Datubāzes parole. Ja parole netiek izmantota, komentējiet šo rindu. ##### DBPassword The database password. Comment this line if no password is used. Ignored for SQLite. ##### DBPassword Datubāzes parole. Ja parole netiek izmantota, komentējiet šo rindu. SQLite gadījumā tiek ignorēts. ##### DBPort The port of the Zabbix database host (see [`DBHost`](#dbhost)).**^[1](zabbix_proxy#footnotes)^** Ignored for SQLite.<br>With [Oracle](/manual/appendix/install/oracle#connection-set-up), if the Net Service Name connection method is used, this parameter will be ignored; the port number from the tnsnames.ora file will be used instead. Default for MySQL: `3306` Default for PostgreSQL: `5432` Range: 1024-65535 ##### DBPort Zabbix datubāzes hosta ports (skatiet [`DBHost`](#dbhost)).**^[1](zabbix_proxy#footnotes)^** Tiek ignorēts SQLite gadījumā.<br>Izmantojot [Oracle](/manual/appendix/install/oracle#connection-set-up), ja tiek lietota Net Service Name savienojuma metode, šis parametrs tiks ignorēts; tā vietā tiks izmantots ports no faila tnsnames.ora. Noklusējums MySQL: `3306` Noklusējums PostgreSQL: `5432` Diapazons: 1024-65535 ##### DBPort The port of the Zabbix database host (see [`DBHost`](#dbhost)).**^[3](zabbix_server#footnotes)^**<br>With [Oracle](/manual/appendix/install/oracle#connection-set-up), if the Net Service Name connection method is used, this parameter will be ignored; the port number from the `tnsnames.ora` file will be used instead. Default for MySQL: `3306` Default for PostgreSQL: `5432` Range: 1024-65535 ##### DBPort Zabbix datubāzes hosta ports (skatiet [`DBHost`](#dbhost)).**^[3](zabbix_server#footnotes)^**<br>Izmantojot [Oracle](/manual/appendix/install/oracle#connection-set-up), ja tiek lietota Net Service Name savienojuma metode, šis parametrs tiks ignorēts; tā vietā tiks izmantots ports no `tnsnames.ora` faila. Noklusējums MySQL: `3306` Noklusējums PostgreSQL: `5432` Diapazons: 1024-65535 ##### DBSchema The database schema name. Used for PostgreSQL. ##### DBSchema Datubāzes shēmas nosaukums. Izmanto PostgreSQL. ##### DBSchema The database schema name. Used for PostgreSQL. ##### DBSchema Datubāzes shēmas nosaukums. Izmanto PostgreSQL. ##### DBSocket The path to the MySQL socket file.**^[1](zabbix_proxy#footnotes)^** ##### DBSocket MySQL ligzdas faila ceļš.**^[1](zabbix_proxy#footnotes)^** ##### DBSocket The path to the MySQL socket file.**^[3](zabbix_server#footnotes)^** ##### DBSocket MySQL ligzdas faila ceļš.**^[3](zabbix_server#footnotes)^** ##### DBTLSCAFile The full pathname of a file containing the top-level CA(s) certificates for database certificate verification. Mandatory: no (yes, if DBTLSConnect set to *verify\_ca* or *verify\_full*) ##### DBTLSCAFile Pilns ceļa nosaukums uz failu, kurā ir datubāzes sertifikātu verifikācijai paredzētie augstākā līmeņa CA sertifikāti. Obligāts: nē (jā, ja DBTLSConnect ir iestatīts uz *verify\_ca* vai *verify\_full*) ##### DBTLSCAFile The full pathname of a file containing the top-level CA(s) certificates for database certificate verification. Mandatory: no (yes, if DBTLSConnect set to *verify\_ca* or *verify\_full*) ##### DBTLSCAFile Fails, kas satur datubāzes sertifikātu verifikācijai paredzētos augstākā līmeņa CA sertifikātus, pilns ceļš. Obligāts: nē (jā, ja DBTLSConnect ir iestatīts uz *verify\_ca* vai *verify\_full*) ##### DBTLSCertFile The full pathname of a file containing the Zabbix proxy certificate for authenticating to database. ##### DBTLSCertFile Pilns ceļa nosaukums uz failu, kurā ir Zabbix starpniekservera sertifikāts autentifikācijai datubāzē. ##### DBTLSCertFile The full pathname of a file containing the Zabbix server certificate for authenticating to database. ##### DBTLSCertFile Fails, kurā ir pilns ceļš uz Zabbix servera sertifikātu autentifikācijai datubāzei. ##### DBTLSCipher13 The list of encryption ciphersuites that Zabbix proxy permits for the TLS v1.3 protocol. Supported only for MySQL, starting from version 8.0.16. ##### DBTLSCipher13 To šifrēšanas algoritmu komplektu saraksts, ko Zabbix starpniekserveris atļauj TLS v1.3 protokolam. Atbalstīts tikai MySQL, начиная no versijas 8.0.16. ##### DBTLSCipher13 The list of encryption ciphersuites that Zabbix server permits for the TLS v1.3 protocol. Supported only for MySQL, starting from version 8.0.16. ##### DBTLSCipher13 Zabbix serveris atļauto šifrēšanas komplektu saraksts TLS v1.3 protokolam. Atbalstīts tikai MySQL, sākot no versijas 8.0.16. ##### DBTLSCipher The list of encryption ciphers that Zabbix proxy permits for TLS protocols up through TLS v1.2. Supported only for MySQL. ##### DBTLSCipher Šifrēšanas algoritmu saraksts, ko Zabbix starpniekserveris atļauj TLS protokoliem līdz pat TLS v1.2. Atbalstīts tikai MySQL. ##### DBTLSCipher The list of encryption ciphers that Zabbix server permits for TLS protocols up through TLS v1.2. Supported only for MySQL. ##### DBTLSCipher Zabbix serveris atļauto šifrēšanas algoritmu saraksts TLS protokoliem līdz TLS v1.2 ieskaitot. Atbalstīts tikai MySQL. ##### DBTLSConnect Setting this option enforces to use TLS connection to the database: - *required* - connect using TLS; - *verify\_ca* - connect using TLS and verify certificate; - *verify\_full* - connect using TLS, verify certificate and verify that database identity specified by DBHost matches its certificate.<br> On MySQL starting from 5.7.11 and PostgreSQL the following values are supported: "required", "verify", "verify\_full".<br> On MariaDB starting from version 10.2.6 "required" and "verify\_full" values are supported.<br>By default not set to any option and the behavior depends on database configuration. ##### DBTLSConnect Šīs opcijas iestatīšana piespiež izmantot TLS savienojumu ar datubāzi: - *required* - izveidot savienojumu, izmantojot TLS; - *verify\_ca* - izveidot savienojumu, izmantojot TLS un pārbaudīt sertifikātu; - *verify\_full* - izveidot savienojumu, izmantojot TLS, pārbaudīt sertifikātu un pārbaudīt, ka DBHost norādītā datubāzes identitāte atbilst tās sertifikātam.<br> MySQL, sākot no 5.7.11, un PostgreSQL tiek atbalstītas šādas vērtības: "required", "verify", "verify\_full".<br> MariaDB, sākot no versijas 10.2.6, tiek atbalstītas vērtības "required" un "verify\_full".<br>Pēc noklusējuma šī opcija nav iestatīta, un darbība ir atkarīga no datubāzes konfigurācijas. ##### DBTLSConnect Setting this option to the following values enforces to use a TLS connection to the database: - *required* - connect using TLS; - *verify\_ca* - connect using TLS and verify certificate; - *verify\_full* - connect using TLS, verify certificate and verify that database identity specified by DBHost matches its certificate.<br><br> With MySQL, starting from 5.7.11, and PostgreSQL the following values are supported: `required`, `verify_ca`, `verify_full`.<br> With MariaDB, starting from version 10.2.6, the `required` and `verify_full` values are supported.<br> By default not set to any option and the behavior depends on database configuration. ##### DBTLSConnect Šīs opcijas iestatīšana uz tālāk norādītajām vērtībām piespiež izmantot TLS savienojumu ar datubāzi: - *required* - izveidot savienojumu, izmantojot TLS; - *verify\_ca* - izveidot savienojumu, izmantojot TLS, un pārbaudīt sertifikātu; - *verify\_full* - izveidot savienojumu, izmantojot TLS, pārbaudīt sertifikātu un pārbaudīt, ka datubāzes identitāte, kas norādīta ar DBHost, atbilst tās sertifikātam.<br><br> Ar MySQL, sākot no 5.7.11, un PostgreSQL tiek atbalstītas šādas vērtības: `required`, `verify_ca`, `verify_full`.<br> Ar MariaDB, sākot no versijas 10.2.6, tiek atbalstītas vērtības `required` un `verify_full`.<br> Pēc noklusējuma neviena opcija nav iestatīta, un darbība ir atkarīga no datubāzes konfigurācijas. ##### DBTLSKeyFile The full pathname of a file containing the private key for authenticating to database. ##### DBTLSKeyFile Pilns faila ceļš uz failu, kas satur privāto atslēgu autentifikācijai datubāzē. ##### DBTLSKeyFile The full pathname of a file containing the private key for authenticating to the database. ##### DBTLSKeyFile Pilns ceļš uz failu, kurā atrodas privātā atslēga autentifikācijai datubāzē. ##### DBUser The database user. ##### DBUser Datubāzes lietotājs. ##### DBUser The database user. Ignored for SQLite. ##### DBUser Datubāzes lietotājs. Ignorēts SQLite. # dcheck.get # dcheck.get #### dcheck [ZBXNEXT-8079](https://support.zabbix.com/browse/ZBXNEXT-8079) Added new property `allow_redirect`. #### dcheck [ZBXNEXT-8079](https://support.zabbix.com/browse/ZBXNEXT-8079) Pievienota jauna īpašība `allow_redirect`. ### Debian/Ubuntu Open the `/etc/apt/sources.list.d/zabbix.list` and uncomment "Zabbix unstable repository". ```ini # Zabbix unstable repository deb https://repo.zabbix.com/zabbix/6.5/debian bullseye main deb-src https://repo.zabbix.com/zabbix/6.5/debian bullseye main ``` ### Debian/Ubuntu Atveriet `/etc/apt/sources.list.d/zabbix.list` un noņemiet komentāru no "Zabbix unstable repository". ```ini # Zabbix unstable repository deb https://repo.zabbix.com/zabbix/6.5/debian bullseye main deb-src https://repo.zabbix.com/zabbix/6.5/debian bullseye main ``` ### Debug Debug information of executed webhook script. The debug object has the following properties. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |logs|array|Array of [log entries](/manual/api/reference/script/object#log-entry).| |ms|string|Script execution duration in milliseconds.| ### Atkļūdošana Izpildītā webhook skripta atkļūdošanas informācija. Atkļūdošanas objektam ir šādas īpašības. |Īpašība|[Type](/manual/api/reference_commentary#data-types)|Apraksts| |--|--|------| |logs|array|[Žurnāla ierakstu](/manual/api/reference/script/object#log-entry) masīvs.| |ms|string|Skripta izpildes ilgums milisekundēs.| #### Debugging Java gateway In case there are any problems with Java gateway or an error message that you see about an item in the frontend is not descriptive enough, you might wish to take a look at Java gateway log file. By default, Java gateway logs its activities into `/tmp/zabbix_java.log` file with log level "info". Sometimes that information is not enough and there is a need for information at log level "debug". In order to increase logging level, modify file `lib/logback.xml` and change the level attribute of `<root>` tag to `debug`: <root level="debug"> <appender-ref ref="FILE" /> </root> Note that unlike Zabbix server or Zabbix proxy, there is no need to restart Zabbix Java gateway after changing `logback.xml` file - changes in `logback.xml` will be picked up automatically. When you are done with debugging, you can return the logging level to "info". If you wish to log to a different file or a completely different medium like database, adjust `logback.xml` file to meet your needs. See [Logback Manual](http://logback.qos.ch/manual/) for more details. Sometimes for debugging purposes it is useful to start Java gateway as a console application rather than a daemon. To do that, comment out `PID_FILE` variable in `settings.sh`. If `PID_FILE` is omitted, `startup.sh` script starts Java gateway as a console application and makes Logback use `lib/logback-console.xml` file instead, which not only logs to console, but has logging level "debug" enabled as well. 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 [SLF4J Manual](http://www.slf4j.org/manual.html) for more details. #### 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 informatīvs, iespējams, vēlēsieties apskatīt Java gateway žurnāla failu. Pēc noklusējuma Java gateway reģistrē savu darbību failā `/tmp/zabbix_java.log` ar žurnāla līmeni "info". Dažkārt šī informācija nav pietiekama, un ir nepieciešama informācija ar žurnāla līmeni "debug". Lai paaugstinātu žurnāla līmeni, modificējiet failu `lib/logback.xml` un mainiet `<root>` taga `level` atribūtu uz `debug`: <root level="debug"> <appender-ref ref="FILE" /> </root> Ņemiet vērā, ka atšķirībā no Zabbix serveris vai Zabbix starpniekserveris, pēc `logback.xml` faila izmaiņām Zabbix Java gateway nav jāpārstartē - izmaiņas `logback.xml` failā tiks automātiski ņemtas vērā. Kad atkļūdošana ir pabeigta, varat atgriezt žurnāla līmeni uz "info". Ja vēlaties reģistrēt datus citā failā vai pilnīgi citā datu nesējā, piemēram, datubāzē, pielāgojiet `logback.xml` failu atbilstoši savām vajadzībām. Plašāku informāciju skatiet [Logback Manual](http://logback.qos.ch/manual/). Dažkārt atkļūdošanas nolūkos ir noderīgi palaist Java gateway kā konsoles lietojumprogrammu, nevis kā dēmonu. Lai to izdarītu, komentējiet `PID_FILE` mainīgo failā `settings.sh`. Ja `PID_FILE` tiek izlaists, `startup.sh` skripts palaiž Java gateway kā konsoles lietojumprogrammu un liek Logback izmantot failu `lib/logback-console.xml`, kas ne tikai reģistrē datus konsolē, bet arī iespējo žurnāla līmeni "debug". Visbeidzot, ņemiet vērā, ka, tā kā Java gateway žurnālošanai izmanto SLF4J, jūs varat aizstāt Logback ar jebkuru sev vēlamo ietvaru, ievietojot atbilstošu JAR failu `lib` direktorijā. Plašāku informāciju skatiet [SLF4J Manual](http://www.slf4j.org/manual.html). #### Debugging Java gateway Zabbix Java gateway log file is: /var/log/zabbix/zabbix_java_gateway.log If you like to increase the logging, edit the file: /etc/zabbix/zabbix_java_gateway_logback.xml and change `info` in `level="info"` to `debug` or even `trace` (for deep troubleshooting): <configuration scan="true" scanPeriod="15 seconds"> [...] <root level="info"> <appender-ref ref="FILE" /> </root> </configuration> #### Java gateway atkļūdošana Zabbix Java gateway žurnāla fails ir: /var/log/zabbix/zabbix_java_gateway.log Ja vēlaties palielināt reģistrēšanas detalizācijas līmeni, rediģējiet failu: /etc/zabbix/zabbix_java_gateway_logback.xml un nomainiet `info` sadaļā `level="info"` uz `debug` vai pat `trace` (dziļākai problēmu novēršanai): <configuration scan="true" scanPeriod="15 seconds"> [...] <root level="info"> <appender-ref ref="FILE" /> </root> </configuration> #### Debugging Java gateway Zabbix Java gateway log file is: /var/log/zabbix/zabbix_java_gateway.log If you like to increase the logging, edit the file: /etc/zabbix/zabbix_java_gateway_logback.xml and change `info` in `level="info"` to `debug` or even `trace` (for deep troubleshooting): <configuration scan="true" scanPeriod="15 seconds"> [...] <root level="info"> <appender-ref ref="FILE" /> </root> </configuration> #### Java gateway atkļūdošana Zabbix Java gateway žurnāla fails ir: /var/log/zabbix/zabbix_java_gateway.log Ja vēlaties palielināt reģistrēšanas detalizācijas līmeni, rediģējiet failu: /etc/zabbix/zabbix_java_gateway_logback.xml un mainiet `info` sadaļā `level="info"` uz `debug` vai pat `trace` (dziļai problēmu novēršanai): <configuration scan="true" scanPeriod="15 seconds"> [...] <root level="info"> <appender-ref ref="FILE" /> </root> </configuration> #### Debuginfo packages `Debuginfo` packages contain debugging symbols for Zabbix binaries. They are not required for normal installation or operation but are useful for advanced troubleshooting. Please note that `Debuginfo` packages are available for the following versions: Red Hat Enterprise Linux 7 and earlier (including derivatives), and SUSE Linux Enterprise Server 15 and earlier (including derivatives). To enable the `zabbix-debuginfo` repository: - On RHEL 6 or 7, edit `/etc/yum.repos.d/zabbix.repo` and set `enabled=1` for the `zabbix-debuginfo` section: ```ini [zabbix-debuginfo] name=Zabbix Official Repository debuginfo - $basearch baseurl=https://repo.zabbix.com/zabbix/7.0/rhel/7/$basearch/debuginfo/ enabled=1 gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-ZABBIX-A14FE591 gpgcheck=1 ``` - On SUSE, edit `/etc/zypp/repos.d/zabbix.repo` and set `enabled=1` for the `zabbix-debuginfo` section: ```ini [zabbix-debuginfo] name=Zabbix Official Repository debuginfo type=rpm-md baseurl=https://repo.zabbix.com/zabbix/7.0/sles/15/$basearch/debuginfo/ gpgcheck=1 gpgkey=https://repo.zabbix.com/zabbix/7.0/sles/15/$basearch/debuginfo/repodata/repomd.xml.key enabled=0 update=1 ``` Once enabled, install the packages: - On RHEL, install a single package with debug information for all Zabbix components: ```bash dnf install zabbix-debuginfo ``` - On SUSE, install component-specific debuginfo packages: ```bash zypper install zabbix-<component>-debuginfo ``` #### Debuginfo pakotnes `Debuginfo` pakotnes satur Zabbix binārajiem failiem paredzētus atkļūdošanas simbolus. Tās nav nepieciešamas parastai instalēšanai vai darbībai, taču ir noderīgas padziļinātai problēmu novēršanai. Lūdzu, ņemiet vērā, ka `Debuginfo` pakotnes ir pieejamas šādām versijām: Red Hat Enterprise Linux 7 un vecākām versijām (tostarp atvasinājumiem), kā arī SUSE Linux Enterprise Server 15 un vecākām versijām (tostarp atvasinājumiem). Lai iespējotu `zabbix-debuginfo` repozitoriju: - RHEL 6 vai 7 gadījumā rediģējiet `/etc/yum.repos.d/zabbix.repo` un sadaļai `zabbix-debuginfo` iestatiet `enabled=1`: ```ini [zabbix-debuginfo] name=Zabbix Official Repository debuginfo - $basearch baseurl=https://repo.zabbix.com/zabbix/7.0/rhel/7/$basearch/debuginfo/ enabled=1 gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-ZABBIX-A14FE591 gpgcheck=1 ``` - SUSE gadījumā rediģējiet `/etc/zypp/repos.d/zabbix.repo` un sadaļai `zabbix-debuginfo` iestatiet `enabled=1`: ```ini [zabbix-debuginfo] name=Zabbix Official Repository debuginfo type=rpm-md baseurl=https://repo.zabbix.com/zabbix/7.0/sles/15/$basearch/debuginfo/ gpgcheck=1 gpgkey=https://repo.zabbix.com/zabbix/7.0/sles/15/$basearch/debuginfo/repodata/repomd.xml.key enabled=0 update=1 ``` Kad tas ir iespējots, instalējiet pakotnes: - RHEL gadījumā instalējiet vienu pakotni ar atkļūdošanas informāciju visiem Zabbix komponentiem: ```bash dnf install zabbix-debuginfo ``` - SUSE gadījumā instalējiet komponentam specifiskas debuginfo pakotnes: ```bash zypper install zabbix-<component>-debuginfo ``` ##### DebugLevel Specify the debug level: - *0* - basic information about starting and stopping of Zabbix processes; - *1* - critical information; - *2* - error information; - *3* - warnings; - *4* - for debugging (produces lots of information); - *5* - extended debugging (produces even more information). Default: `3`<br> Range: 0-5 ##### DebugLevel Norādiet atkļūdošanas līmeni: - *0* - pamatinformācija par Zabbix procesu palaišanu un apturēšanu; - *1* - kritiska informācija; - *2* - kļūdu informācija; - *3* - brīdinājumi; - *4* - atkļūdošanai (rada daudz informācijas); - *5* - paplašināta atkļūdošana (rada vēl vairāk informācijas). Noklusējums: `3`<br> Diapazons: 0-5 ##### DebugLevel Specify the debug level: - *0* - basic information about starting and stopping of Zabbix processes; - *1* - critical information; - *2* - error information; - *3* - warnings; - *4* - for debugging (produces lots of information); - *5* - extended debugging (produces even more information). Default: `3`<br> Range: 0-5 ##### DebugLevel Norādiet atkļūdošanas līmeni: - *0* - pamatinformācija par Zabbix procesu palaišanu un apturēšanu; - *1* - kritiska informācija; - *2* - kļūdu informācija; - *3* - brīdinājumi; - *4* - atkļūdošanai (rada daudz informācijas); - *5* - paplašināta atkļūdošana (rada vēl vairāk informācijas). Noklusējums: `3`<br> Diapazons: 0-5 ##### DebugLevel Specify the debug level: - *0* - basic information about starting and stopping of Zabbix processes; - *1* - critical information; - *2* - error information; - *3* - warnings; - *4* - for debugging (produces lots of information); - *5* - extended debugging (produces even more information). Default: `3`<br> Range: 0-5 ##### DebugLevel Norādiet atkļūdošanas līmeni: - *0* - pamatinformācija par Zabbix procesu palaišanu un apturēšanu; - *1* - kritiska informācija; - *2* - kļūdu informācija; - *3* - brīdinājumi; - *4* - atkļūdošanai (rada daudz informācijas); - *5* - paplašināta atkļūdošana (rada vēl vairāk informācijas). Noklusējums: `3`<br> Diapazons: 0-5 ##### DebugLevel Specify the debug level: - *0* - basic information about starting and stopping of Zabbix processes; - *1* - critical information; - *2* - error information; - *3* - warnings; - *4* - for debugging (produces lots of information); - *5* - extended debugging (produces even more information). Default: `3`<br> Range: 0-5 ##### DebugLevel Norādiet atkļūdošanas līmeni: - *0* - pamatinformācija par Zabbix procesu palaišanu un apturēšanu; - *1* - kritiska informācija; - *2* - kļūdu informācija; - *3* - brīdinājumi; - *4* - atkļūdošanai (ģenerē daudz informācijas); - *5* - paplašināta atkļūdošana (ģenerē vēl vairāk informācijas). Noklusējums: `3`<br> Diapazons: 0-5 ##### DebugLevel Specify the debug level: - *0* - basic information about starting and stopping of Zabbix processes; - *1* - critical information; - *2* - error information; - *3* - warnings; - *4* - for debugging (produces lots of information); - *5* - extended debugging (produces even more information). Default: `3`<br> Range: 0-5 ##### DebugLevel Norādiet atkļūdošanas līmeni: - *0* - pamatinformācija par Zabbix procesu palaišanu un apturēšanu; - *1* - kritiska informācija; - *2* - kļūdu informācija; - *3* - brīdinājumi; - *4* - atkļūdošanai (rada daudz informācijas); - *5* - paplašināta atkļūdošana (rada vēl vairāk informācijas). Noklusējums: `3`<br> Diapazons: 0-5 ##### DebugLevel Specify the debug level: - *0* - basic information about starting and stopping of Zabbix processes; - *1* - critical information; - *2* - error information; - *3* - warnings; - *4* - for debugging (produces lots of information); - *5* - extended debugging (produces even more information). Default: `3`<br> Range: 0-5 ##### DebugLevel Norādiet atkļūdošanas līmeni: - *0* - pamatinformācija par Zabbix procesu palaišanu un apturēšanu; - *1* - kritiska informācija; - *2* - kļūdu informācija; - *3* - brīdinājumi; - *4* - atkļūdošanai (rada daudz informācijas); - *5* - paplašināta atkļūdošana (rada vēl vairāk informācijas). Noklusējums: `3`<br> Diapazons: 0-5 ##### DebugLevel Specify the debug level: - *0* - basic information about starting and stopping of Zabbix processes; - *1* - critical information; - *2* - error information; - *3* - warnings; - *4* - for debugging (produces lots of information); - *5* - extended debugging (produces even more information). See also [runtime control](/manual/concepts/server#runtime-control) options. Default: `3`<br> Range: 0-5 ##### DebugLevel Norādiet atkļūdošanas līmeni: - *0* - pamatinformācija par Zabbix procesu palaišanu un apturēšanu; - *1* - kritiska informācija; - *2* - kļūdu informācija; - *3* - brīdinājumi; - *4* - atkļūdošanai (rada daudz informācijas); - *5* - paplašināta atkļūdošana (rada vēl vairāk informācijas). Skatiet arī [izpildlaika vadības](/manual/concepts/server#runtime-control) opcijas. Noklusējums: `3`<br> Diapazons: 0-5 # Debug logging To troubleshoot issues when working with Zabbix API, collecting data from Zabbix agent, or sending data to Zabbix server or proxy, you can enable debug logging. The zabbix\_utils library uses Python's standard `logging` module. To see detailed debug messages from the library: 1. Import Python's `logging` module in your script. 2. Configure the logging system to output messages in a readable format and set the logging level to DEBUG. ```python import logging from zabbix_utils import Getter logging.basicConfig( format=u'[%(asctime)s] %(levelname)s %(message)s', level=logging.DEBUG ) agent = Getter(host='127.0.0.1', port=10050) resp = agent.get('system.uname') print(resp.value) ``` With debug logging enabled, detailed information about requests and responses is printed, for example: ```bash [2023-10-01 12:00:01,587] DEBUG Content of the packet: b'ZBXD\x01\x0c\x00\x00\x00\x00\x00\x00\x00system.uname' [2023-10-01 12:00:01,722] DEBUG Zabbix response header: b'ZBXD\x01C\x00\x00\x00C\x00\x00\x00' [2023-10-01 12:00:01,723] DEBUG Zabbix response body: Linux test_server 5.15.0-3.60.5.1.el9uek.x86_64 [2023-10-01 12:00:01,724] DEBUG Response from [127.0.0.1:10050]: Linux test_server 5.15.0-3.60.5.1.el9uek.x86_64 Linux test_server 5.15.0-3.60.5.1.el9uek.x86_64 ``` # Atkļūdošanas žurnalēšana Lai novērstu problēmas, strādājot ar Zabbix API, vācot datus no Zabbix aģenta vai sūtot datus uz Zabbix serveri vai starpniekserveri, varat iespējot atkļūdošanas žurnalēšanu. Bibliotēka zabbix\_utils izmanto Python standarta moduli `logging`. Lai redzētu detalizētus atkļūdošanas ziņojumus no bibliotēkas: 1. Importējiet Python moduli `logging` savā skriptā. 2. Konfigurējiet žurnalēšanas sistēmu tā, lai ziņojumi tiktu izvadīti lasāmā formātā, un iestatiet žurnalēšanas līmeni uz DEBUG. ```python import logging from zabbix_utils import Getter logging.basicConfig( format=u'[%(asctime)s] %(levelname)s %(message)s', level=logging.DEBUG ) agent = Getter(host='127.0.0.1', port=10050) resp = agent.get('system.uname') print(resp.value) ``` Ja atkļūdošanas žurnalēšana ir iespējota, tiek izdrukāta detalizēta informācija par pieprasījumiem un atbildēm, piemēram: ```bash [2023-10-01 12:00:01,587] DEBUG Content of the packet: b'ZBXD\x01\x0c\x00\x00\x00\x00\x00\x00\x00system.uname' [2023-10-01 12:00:01,722] DEBUG Zabbix response header: b'ZBXD\x01C\x00\x00\x00C\x00\x00\x00' [2023-10-01 12:00:01,723] DEBUG Zabbix response body: Linux test_server 5.15.0-3.60.5.1.el9uek.x86_64 [2023-10-01 12:00:01,724] DEBUG Response from [127.0.0.1:10050]: Linux test_server 5.15.0-3.60.5.1.el9uek.x86_64 Linux test_server 5.15.0-3.60.5.1.el9uek.x86_64 ``` #### Default authentication By default, Zabbix uses **internal** Zabbix authentication for all users. It is possible to change the default authentication method to [LDAP](/manual/web_interface/frontend_sections/users/authentication/ldap) system-wide. To do so, navigate to the *LDAP* tab and configure LDAP parameters, then return to the *Authentication* tab and switch the *Default authentication* selector to LDAP. Note that the authentication method can be fine-tuned on the [user group](/manual/config/users_and_usergroups/usergroup) level. Even if LDAP authentication is set globally, some user groups can still be authenticated by Zabbix. These groups must have [frontend access](/manual/config/users_and_usergroups/usergroup#configuration) set to Internal. It is also possible to enable LDAP authentication only for specific user groups, if internal authentication is used globally. In this case LDAP authentication details can be specified and used for specific user groups whose [frontend access](/manual/config/users_and_usergroups/usergroup#configuration) must then be set to LDAP. If a user is included into at least one user group with LDAP authentication, this user will not be able to use the internal authentication method. HTTP, SAML 2.0, and MFA authentication methods can be used in addition to the default authentication method. Zabbix supports just-in-time (JIT) provisioning that allows to create user accounts in Zabbix the first time an external user authenticates and provision these user accounts. JIT provisioning is supported for LDAP and SAML. See also: - [HTTP authentication](/manual/web_interface/frontend_sections/users/authentication/http) - [LDAP authentication](/manual/web_interface/frontend_sections/users/authentication/ldap) - [SAML authentication](/manual/web_interface/frontend_sections/users/authentication/saml) - [MFA authentication](/manual/web_interface/frontend_sections/users/authentication/mfa) #### Noklusējuma autentifikācija Pēc noklusējuma Zabbix visiem lietotājiem izmanto **iekšējo** Zabbix autentifikāciju. Ir iespējams mainīt noklusējuma autentifikācijas metodi uz [LDAP](/manual/web_interface/frontend_sections/users/authentication/ldap) visā sistēmā. Lai to izdarītu, atveriet cilni *LDAP* un konfigurējiet LDAP parametrus, pēc tam atgriezieties cilnē *Authentication* un pārslēdziet atlasītāju *Default authentication* uz LDAP. Ņemiet vērā, ka autentifikācijas metodi var precīzi pielāgot [lietotāju grupas](/manual/config/users_and_usergroups/usergroup) līmenī. Pat ja LDAP autentifikācija ir iestatīta globāli, dažas lietotāju grupas joprojām var tikt autentificētas ar Zabbix. Šīm grupām [lietotāja saskarnes piekļuvei](/manual/config/users_and_usergroups/usergroup#configuration) jābūt iestatītai uz Internal. Ir iespējams arī iespējot LDAP autentifikāciju tikai noteiktām lietotāju grupām, ja globāli tiek izmantota iekšējā autentifikācija. Šajā gadījumā LDAP autentifikācijas datus var norādīt un izmantot konkrētām lietotāju grupām, kuru [lietotāja saskarnes piekļuvei](/manual/config/users_and_usergroups/usergroup#configuration) pēc tam jābūt iestatītai uz LDAP. Ja lietotājs ir iekļauts vismaz vienā lietotāju grupā ar LDAP autentifikāciju, šis lietotājs nevarēs izmantot iekšējo autentifikācijas metodi. HTTP, SAML 2.0 un MFA autentifikācijas metodes var izmantot papildus noklusējuma autentifikācijas metodei. Zabbix atbalsta tieši laikā (JIT) nodrošināšanu, kas ļauj izveidot lietotāju kontus Zabbix brīdī, kad ārējs lietotājs autentificējas pirmo reizi, un nodrošināt šos lietotāju kontus. JIT nodrošināšana tiek atbalstīta LDAP un SAML. Skatiet arī: - [HTTP autentifikācija](/manual/web_interface/frontend_sections/users/authentication/http) - [LDAP autentifikācija](/manual/web_interface/frontend_sections/users/authentication/ldap) - [SAML autentifikācija](/manual/web_interface/frontend_sections/users/authentication/saml) - [MFA autentifikācija](/manual/web_interface/frontend_sections/users/authentication/mfa) #### Default global regular expressions Zabbix comes with several global regular expression in its default dataset. |Name|Expression|Matches| |--|------|------| |*File systems for discovery*|`^(btrfs|ext2|ext3|ext4|jfs|reiser|xfs|ffs|ufs|jfs|jfs2|vxfs|hfs|refs|apfs|ntfs|fat32|zfs)$`|"btrfs" or "ext2" or "ext3" or "ext4" or "jfs" or "reiser" or "xfs" or "ffs" or "ufs" or "jfs" or "jfs2" or "vxfs" or "hfs" or "refs" or "apfs" or "ntfs" or "fat32" or "zfs"| |*Network interfaces for discovery*|`^Software Loopback Interface`|Strings starting with "Software Loopback Interface".| | |`^lo$`|"lo"| | |`^(In)?[Ll]oop[Bb]ack[0-9._]*$`|Strings that optionally start with "In", then have "L" or "l", then "oop", then "B" or "b", then "ack", which can be optionally followed by any number of digits, dots or underscores.| | |`^NULL[0-9.]*$`|Strings starting with "NULL" optionally followed by any number of digits or dots.| | |`^[Ll]o[0-9.]*$`|Strings starting with "Lo" or "lo" and optionally followed by any number of digits or dots.| | |`^[Ss]ystem$`|"System" or "system"| | |`^Nu[0-9.]*$`|Strings starting with "Nu" optionally followed by any number of digits or dots.| |*Storage devices for SNMP discovery*|`^(Physical memory|Virtual memory|Memory buffers|Cached memory|Swap space)$`|"Physical memory" or "Virtual memory" or "Memory buffers" or "Cached memory" or "Swap space"| |*Windows service names for discovery*|`^(MMCSS|gupdate|SysmonLog|clr_optimization_v2.0.50727_32|clr_optimization_v4.0.30319_32)$`|"MMCSS" or "gupdate" or "SysmonLog" or strings like "clr\_optimization\_v2.0.50727\_32" and "clr\_optimization\_v4.0.30319\_32" where instead of dots you can put any character except newline.| |*Windows service startup states for discovery*|`^(automatic|automatic delayed)$`|"automatic" or "automatic delayed"| #### Noklusējuma globālie regulārie izteicieni Zabbix komplektā ir iekļauti vairāki globālie regulārie izteicieni tā noklusējuma datu kopā. |Name|Expression|Matches| |--|------|------| |*Failu sistēmas atklāšanai*|`^(btrfs|ext2|ext3|ext4|jfs|reiser|xfs|ffs|ufs|jfs|jfs2|vxfs|hfs|refs|apfs|ntfs|fat32|zfs)$`|"btrfs" vai "ext2" vai "ext3" vai "ext4" vai "jfs" vai "reiser" vai "xfs" vai "ffs" vai "ufs" vai "jfs" vai "jfs2" vai "vxfs" vai "hfs" vai "refs" vai "apfs" vai "ntfs" vai "fat32" vai "zfs"| |*Tīkla saskarnes atklāšanai*|`^Software Loopback Interface`|Virknes, kas sākas ar "Software Loopback Interface".| | |`^lo$`|"lo"| | |`^(In)?[Ll]oop[Bb]ack[0-9._]*$`|Virknes, kas pēc izvēles sākas ar "In", pēc tam satur "L" vai "l", tad "oop", pēc tam "B" vai "b", tad "ack", kam pēc izvēles var sekot jebkurš ciparu, punktu vai pasvītrojumu skaits.| | |`^NULL[0-9.]*$`|Virknes, kas sākas ar "NULL", kam pēc izvēles var sekot jebkurš ciparu vai punktu skaits.| | |`^[Ll]o[0-9.]*$`|Virknes, kas sākas ar "Lo" vai "lo" un kam pēc izvēles var sekot jebkurš ciparu vai punktu skaits.| | |`^[Ss]ystem$`|"System" vai "system"| | |`^Nu[0-9.]*$`|Virknes, kas sākas ar "Nu", kam pēc izvēles var sekot jebkurš ciparu vai punktu skaits.| |*Krātuves ierīces SNMP atklāšanai*|`^(Physical memory|Virtual memory|Memory buffers|Cached memory|Swap space)$`|"Physical memory" vai "Virtual memory" vai "Memory buffers" vai "Cached memory" vai "Swap space"| |*Windows pakalpojumu nosaukumi atklāšanai*|`^(MMCSS|gupdate|SysmonLog|clr_optimization_v2.0.50727_32|clr_optimization_v4.0.30319_32)$`|"MMCSS" vai "gupdate" vai "SysmonLog" vai virknes, piemēram, "clr\_optimization\_v2.0.50727\_32" un "clr\_optimization\_v4.0.30319\_32", kur punktu vietā var ievietot jebkuru rakstzīmi, izņemot jaunu rindu.| |*Windows pakalpojumu startēšanas stāvokļi atklāšanai*|`^(automatic|automatic delayed)$`|"automatic" vai "automatic delayed"| #### Default location for Windows agent configuration file The default location where Zabbix agent on Windows looks for the configuration file has been changed. Now the agent searches for it in the directory where the agent binary zabbix_agentd.exe is located (instead of `C:\zabbix_agentd.conf`, as previously). Zabbix agent 2 on Windows already searched for the default configuration file in the directory where the binary zabbix_agent2.exe is located. However, in the new version the agent 2 expects the configuration file to be named `zabbix_agent2.conf` (instead of `zabbix_agent2.win.conf`) See also: [Installing Zabbix agent on Windows](/manual/appendix/install/windows_agent). #### Noklusējuma atrašanās vieta Windows aģenta konfigurācijas failam Noklusējuma atrašanās vieta, kur Zabbix aģents operētājsistēmā Windows meklē konfigurācijas failu, ir mainīta. Tagad aģents to meklē direktorijā, kur atrodas aģenta binārais fails `zabbix_agentd.exe` (nevis `C:\zabbix_agentd.conf`, kā iepriekš). Zabbix aģents 2 operētājsistēmā Windows jau iepriekš meklēja noklusējuma konfigurācijas failu direktorijā, kur atrodas binārais fails `zabbix_agent2.exe`. Tomēr jaunajā versijā aģents 2 sagaida, ka konfigurācijas faila nosaukums būs `zabbix_agent2.conf` (nevis `zabbix_agent2.win.conf`) Skatiet arī: [Zabbix aģenta instalēšana operētājsistēmā Windows](/manual/appendix/install/windows_agent). #### Default permissions **Access to UI elements** The default access to menu sections depends on the user type. See the Permissions page for [details](/manual/config/users_and_usergroups/permissions#user-types). **Access to other options** | | | | | | | | |-|----------|-----------------------------|----|----|----|----| |**Parameter**|<|**Description**|**Default user roles**|<|<|<| | |<|<|*Super admin role*|*Admin role*|*User role*|*Guest role*| |*Default access to new UI elements*|<|This option specifies how new menu sections will be accessible after a Zabbix upgrade. Existing menu sections of modules remain unaffected.|Yes|Yes|Yes|Yes| |**Access to services**|<|<|<|<|<|<| | |Read-write access to services|Select read-write access to services:<br>**None** - no access at all<br>**All** - access to all services is read-write<br>**Service list** - select services for read-write access<br><br>The read-write access, if granted, takes precedence over the read-only access settings and is dynamically inherited by the child services.|All|All|None|None| |^|Read-write access to services with tag|Specify tag name and, optionally, value to additionally grant read-write access to services matching the tag.<br>This option is available if 'Service list' is selected in the *Read-write access to services* parameter.<br>The read-write access, if granted, takes precedence over the read-only access settings and is dynamically inherited by the child services.|^|^|^|^| |^|Read-only access to services|Select read-only access to services:<br>**None** - no access at all<br>**All** - access to all services is read-only<br>**Service list** - select services for read-only access<br><br>The read-only access does not take precedence over the read-write access and is dynamically inherited by the child services.|^|^|All|All| |^|Read-only access to services with tag|Specify tag name and, optionally, value to additionally grant read-only access to services matching the tag.<br>This option is available if 'Service list' is selected in the *Read-only access to services* parameter.<br>The read-only access does not take precedence over the read-write access and is dynamically inherited by the child services.|^|^|^|^| |**Access to modules**|<|<|<|<|<|<| | |<Module name>|Allow/deny access to a specific module. Only enabled modules are shown in this section. It is not possible to grant or restrict access to a module that is currently disabled.|Yes|Yes|Yes|Yes| |^|*Default access to new modules*|This option specifies how new modules and widgets will be accessible after a Zabbix upgrade. It also applies to modules and widgets added in the *Administration > General > Modules section*.|^|^|^|^| |**Access to API**|<|<|<|<|<|<| | |*Enabled*|Enable/disable access to API.|Yes|Yes|Yes|No| |^|*API methods*|Select either *Allow list* to allow, or *Deny list* to deny the API methods specified in the search field. Note that it is not possible to allow some API methods and deny others.<br><br>In the search field, start typing the method name, then select the method from the auto-complete list.<br>You can also press the Select button and select methods from the full list available for this user type. Note that if certain action from the Access to actions block is unchecked, users will not be able to use API methods related to this action.<br><br>Wildcards are supported. Examples: `dashboard.*` (all methods of 'dashboard.' API service) `*` (any method), `*.export` (methods with '.export' name from all API services).<br><br>If no methods have been specified the *Allow/Deny list* rule will be ignored.|^|^|^|^| |**Access to actions**|<|<|<|<|<|<| | |Create and edit dashboards|Clearing this checkbox will also revoke the rights to use `.create`, `.update` and `.delete` API methods for the corresponding elements.|Yes|Yes|Yes|No| |^|Create and edit maps| |^|^|^|^| |^|Create and edit maintenance|^|^|^|No|^| |^|Add problem comments|Clearing this checkbox will also revoke the rights to perform corresponding action via `event.acknowledge` API method.|^|^|Yes|^| |^|Change severity| |^|^|^|^| |^|Acknowledge problems|^|^|^|^|^| |^|Suppress problems|^|^|^|^|^| |^|Close problems|^|^|^|^|^| |^|Execute scripts|Clearing this checkbox will also revoke the rights to use the `script.execute` API method.|^|^|^|^| |^|Manage API tokens|Clearing this checkbox will also revoke the rights to use all `token.` API methods.|^|^|^|^| |^|Manage scheduled reports|Clearing this checkbox will also revoke the rights to use all `report.` API methods.|^|^|No|^| |^|Manage SLA|Enable/disable the rights to manage [SLA](/manual/web_interface/frontend_sections/services/sla).|^|^|^|^| |^|Invoke "Execute now" on read-only hosts|Allow to use the "Execute now" option in latest data for items of read-only hosts.|^|^|Yes|^| |^|Change problem ranking|Allow to change the problem ranking from cause to symptom, and vice versa.|^|^|^|^| |^|Default access to new actions|This option specifies how new actions will be accessible after a Zabbix upgrade.|^|^|^|^| See also: - [Configuring a user](/manual/config/users_and_usergroups/user) #### Noklusējuma atļaujas **Piekļuve lietotāja saskarnes elementiem** Noklusējuma piekļuve izvēlnes sadaļām ir atkarīga no lietotāja tipa. Skatiet lapu Permissions, lai iegūtu [detalizētu informāciju](/manual/config/users_and_usergroups/permissions#user-types). **Piekļuve citām opcijām** | | | | | | | | |-|----------|-----------------------------|----|----|----|----| |**Parametrs**|<|**Apraksts**|**Noklusējuma lietotāja lomas**|<|<|<| | |<|<|*Super admin loma*|*Admin loma*|*User loma*|*Guest loma*| |*Noklusējuma piekļuve jauniem lietotāja saskarnes elementiem*|<|Šī opcija nosaka, kā būs pieejamas jaunās izvēlnes sadaļas pēc Zabbix jaunināšanas. Esošās moduļu izvēlnes sadaļas netiek ietekmētas.|Yes|Yes|Yes|Yes| |**Piekļuve pakalpojumiem**|<|<|<|<|<|<| | |Lasīšanas-rakstīšanas piekļuve pakalpojumiem|Atlasiet lasīšanas-rakstīšanas piekļuvi pakalpojumiem:<br>**None** - nav piekļuves vispār<br>**All** - piekļuve visiem pakalpojumiem ir lasīšanas-rakstīšanas režīmā<br>**Service list** - atlasiet pakalpojumus lasīšanas-rakstīšanas piekļuvei<br><br>Ja lasīšanas-rakstīšanas piekļuve ir piešķirta, tai ir prioritāte pār tikai lasīšanas piekļuves iestatījumiem, un tā tiek dinamiski mantota pakalpojumu bērnelementiem.|All|All|None|None| |^|Lasīšanas-rakstīšanas piekļuve pakalpojumiem ar tagu|Norādiet taga nosaukumu un, pēc izvēles, vērtību, lai papildus piešķirtu lasīšanas-rakstīšanas piekļuvi pakalpojumiem, kas atbilst tagam.<br>Šī opcija ir pieejama, ja parametrā *Lasīšanas-rakstīšanas piekļuve pakalpojumiem* ir atlasīts 'Service list'.<br>Ja lasīšanas-rakstīšanas piekļuve ir piešķirta, tai ir prioritāte pār tikai lasīšanas piekļuves iestatījumiem, un tā tiek dinamiski mantota pakalpojumu bērnelementiem.|^|^|^|^| |^|Tikai lasīšanas piekļuve pakalpojumiem|Atlasiet tikai lasīšanas piekļuvi pakalpojumiem:<br>**None** - nav piekļuves vispār<br>**All** - piekļuve visiem pakalpojumiem ir tikai lasīšanas režīmā<br>**Service list** - atlasiet pakalpojumus tikai lasīšanas piekļuvei<br><br>Tikai lasīšanas piekļuvei nav prioritātes pār lasīšanas-rakstīšanas piekļuvi, un tā tiek dinamiski mantota pakalpojumu bērnelementiem.|^|^|All|All| |^|Tikai lasīšanas piekļuve pakalpojumiem ar tagu|Norādiet taga nosaukumu un, pēc izvēles, vērtību, lai papildus piešķirtu tikai lasīšanas piekļuvi pakalpojumiem, kas atbilst tagam.<br>Šī opcija ir pieejama, ja parametrā *Tikai lasīšanas piekļuve pakalpojumiem* ir atlasīts 'Service list'.<br>Tikai lasīšanas piekļuvei nav prioritātes pār lasīšanas-rakstīšanas piekļuvi, un tā tiek dinamiski mantota pakalpojumu bērnelementiem.|^|^|^|^| |**Piekļuve moduļiem**|<|<|<|<|<|<| | |<Moduļa nosaukums>|Atļaut/aizliegt piekļuvi konkrētam modulim. Šajā sadaļā tiek rādīti tikai iespējotie moduļi. Nav iespējams piešķirt vai ierobežot piekļuvi modulim, kas pašlaik ir atspējots.|Yes|Yes|Yes|Yes| |^|*Noklusējuma piekļuve jauniem moduļiem*|Šī opcija nosaka, kā jaunie moduļi un logrīki būs pieejami pēc Zabbix jaunināšanas. Tā attiecas arī uz moduļiem un logrīkiem, kas pievienoti sadaļā *Administration > General > Modules*.|^|^|^|^| |**Piekļuve API**|<|<|<|<|<|<| | |*Enabled*|Iespējot/atspējot piekļuvi API.|Yes|Yes|Yes|No| |^|*API methods*|Atlasiet vai nu *Allow list*, lai atļautu, vai *Deny list*, lai liegtu meklēšanas laukā norādītās API metodes. Ņemiet vērā, ka nav iespējams atļaut dažas API metodes un liegt citas.<br><br>Meklēšanas laukā sāciet rakstīt metodes nosaukumu, pēc tam atlasiet metodi no automātiskās pabeigšanas saraksta.<br>Varat arī nospiest pogu Select un atlasīt metodes no pilnā saraksta, kas pieejams šim lietotāja tipam. Ņemiet vērā: ja kāda darbība blokā Access to actions nav atzīmēta, lietotāji nevarēs izmantot ar šo darbību saistītās API metodes.<br><br>Tiek atbalstīti aizstājējzīmes. Piemēri: `dashboard.*` (visas 'dashboard.' API pakalpojuma metodes) `*` (jebkura metode), `*.export` (metodes ar nosaukumu '.export' no visiem API pakalpojumiem).<br><br>Ja nav norādītas metodes, *Allow/Deny list* noteikums tiks ignorēts.|^|^|^|^| |**Piekļuve darbībām**|<|<|<|<|<|<| | |Izveidot un rediģēt paneļus|Šīs izvēles rūtiņas notīrīšana arī atsauks tiesības izmantot `.create`, `.update` un `.delete` API metodes attiecīgajiem elementiem.|Yes|Yes|Yes|No| |^|Izveidot un rediģēt kartes| |^|^|^|^| |^|Izveidot un rediģēt apkopi|^|^|^|No|^| |^|Pievienot problēmu komentārus|Šīs izvēles rūtiņas notīrīšana arī atsauks tiesības veikt attiecīgo darbību, izmantojot `event.acknowledge` API metodi.|^|^|Yes|^| |^|Mainīt smagumu| |^|^|^|^| |^|Apstiprināt problēmas|^|^|^|^|^| |^|Slāpēt problēmas|^|^|^|^|^| |^|Aizvērt problēmas|^|^|^|^|^| |^|Izpildīt skriptus|Šīs izvēles rūtiņas notīrīšana arī atsauks tiesības izmantot `script.execute` API metodi.|^|^|^|^| |^|Pārvaldīt API žetonus|Šīs izvēles rūtiņas notīrīšana arī atsauks tiesības izmantot visas `token.` API metodes.|^|^|^|^| |^|Pārvaldīt plānotos pārskatus|Šīs izvēles rūtiņas notīrīšana arī atsauks tiesības izmantot visas `report.` API metodes.|^|^|No|^| |^|Pārvaldīt SLA|Iespējot/atspējot tiesības pārvaldīt [SLA](/manual/web_interface/frontend_sections/services/sla).|^|^|^|^| |^|Izsaukt "Execute now" tikai lasīšanas hosts|Atļaut izmantot opciju "Execute now" jaunākajos datos vienumiem tikai lasīšanas hosts.|^|^|Yes|^| |^|Mainīt problēmas prioritāti|Atļaut mainīt problēmas prioritāti no cēloņa uz simptomu un otrādi.|^|^|^|^| |^|Noklusējuma piekļuve jaunām darbībām|Šī opcija nosaka, kā jaunās darbības būs pieejamas pēc Zabbix jaunināšanas.|^|^|^|^| Skatīt arī: - [Lietotāja konfigurēšana](/manual/config/users_and_usergroups/user) #### Default port numbers The following list of open ports per component is applicable for default configuration: |Zabbix component|Port number|Protocol|Type of connection| |-------|-------|-------|-------| |Zabbix agent|10050|TCP|on demand| |Zabbix agent 2|10050|TCP|on demand| |Zabbix server|10051|TCP|on demand| |Zabbix proxy|10051|TCP|on demand| |Zabbix Java gateway|10052|TCP|on demand| |Zabbix web service|10053|TCP|on demand| |Zabbix frontend|80|HTTP|on demand| |^|443|HTTPS|on demand| |Zabbix trapper|10051 |TCP| on demand| ::: noteclassic The port numbers should be open in firewall to enable Zabbix communications. Outgoing TCP connections usually do not require explicit firewall settings. ::: #### Noklusējuma portu numuri Tālāk redzamais atvērto portu saraksts katram komponentam ir piemērojams noklusējuma konfigurācijai: |Zabbix komponents|Porta numurs|Protokols|Savienojuma veids| |-------|-------|-------|-------| |Zabbix aģents|10050|TCP|pēc pieprasījuma| |Zabbix aģents 2|10050|TCP|pēc pieprasījuma| |Zabbix serveris|10051|TCP|pēc pieprasījuma| |Zabbix starpniekserveris|10051|TCP|pēc pieprasījuma| |Zabbix Java gateway|10052|TCP|pēc pieprasījuma| |Zabbix tīmekļa pakalpojums|10053|TCP|pēc pieprasījuma| |Zabbix lietotāja saskarne|80|HTTP|pēc pieprasījuma| |^|443|HTTPS|pēc pieprasījuma| |Zabbix trapper|10051 |TCP| pēc pieprasījuma| ::: noteclassic Lai nodrošinātu Zabbix saziņu, šiem portu numuriem jābūt atvērtiem ugunsmūrī. Izejošajiem TCP savienojumiem parasti nav nepieciešami īpaši ugunsmūra iestatījumi. ::: ##### Default script The following script: 1. Initializes a browser session. 2. Navigates to a specified URL. 3. Collects performance entries and session statistics, and returns them as a JSON string. In the *Script* field, enter: ```javascript var browser = new Browser(Browser.chromeOptions()); try { browser.navigate("http://example.com"); browser.collectPerfEntries(); } finally { return JSON.stringify(browser.getResult()); } ``` ##### Noklusējuma skripts Šis skripts: 1. Inicializē pārlūka sesiju. 2. Pāriet uz norādīto URL. 3. Apkopo veiktspējas ierakstus un sesijas statistiku un atgriež tos kā JSON virkni. Laukā *Skripts* ievadiet: ```javascript var browser = new Browser(Browser.chromeOptions()); try { browser.navigate("http://example.com"); browser.collectPerfEntries(); } finally { return JSON.stringify(browser.getResult()); } ``` #### Default user roles By default, Zabbix is configured with four user roles, which have a pre-defined set of permissions: - Guest role - User role - Admin role - Super admin role {width="600"} These are based on the main user types in Zabbix. The list of all users assigned the respective role is displayed. The users included in disabled groups are stated in red. The *Guest role* is a user-type role with the only permissions to view some frontend sections. ::: noteclassic The default *Super admin role* cannot be modified or deleted, because at least one Super admin user with unlimited privileges must exist in Zabbix. Users of type *Super admin* can modify settings of their own role, but not the user type. ::: #### Noklusējuma lietotāju lomas Pēc noklusējuma Zabbix ir konfigurēts ar četrām lietotāju lomām, kurām ir iepriekš definēts atļauju kopums: - Viesa loma - Lietotāja loma - Administratora loma - Super administratora loma {width="600"} Tās ir balstītas uz galvenajiem lietotāju tipiem Zabbix. Tiek parādīts visu lietotāju saraksts, kuriem ir piešķirta attiecīgā loma. Lietotāji, kas iekļauti atspējotās grupās, ir norādīti sarkanā krāsā. *Viesa loma* ir lietotāja tipa loma, kurai vienīgās atļaujas ir skatīt dažas lietotāja saskarnes sadaļas. ::: noteclassic Noklusējuma *Super administratora lomu* nevar mainīt vai dzēst, jo Zabbix ir jāpastāv vismaz vienam Super administratora lietotājam ar neierobežotām privilēģijām. *Super administratora* tipa lietotāji var mainīt savas lomas iestatījumus, bet ne lietotāja tipu. ::: ##### Default values Defaults, limits and description of values for ICMP check parameters: |Parameter|Unit|Description|Fping's flag|Defaults set by|<|Allowed limits<br>by Zabbix|<| |--|--|--------|-|--|--|--|--| | | | | |**fping**|**Zabbix**|**min**|**max**| |packets|number|number of request packets sent to a target|-C| |3|1|10000| |interval|milliseconds|time to wait between successive packets to an individual target|-p|1000| |20|unlimited| |size|bytes|packet size in bytes<br>56 bytes on x86, 68 bytes on x86_64|-b|56 or 68| |24|65507| |timeout|milliseconds|**fping v3.x** - timeout to wait after last packet sent, affected by *-C* flag<br> **fping v4.x** - individual timeout for each packet|-t|**fping v3.x** - 500<br>**fping v4.x** and newer - inherited from *-p* flag, but not more than 2000| |50|unlimited| The defaults may differ slightly depending on the platform and version. In addition, Zabbix uses fping options *-i interval ms* (do not mix up with the item parameter *interval* mentioned in the table above, which corresponds to fping option *-p*) and *-S source IP address* (or *-I* in older fping versions). These options are auto-detected by running checks with different option combinations. Zabbix tries to detect the minimal value in milliseconds that fping allows to use with *-i* by trying 3 values: 0, 1 and 10. The value that first succeeds is then used for subsequent ICMP checks. This process is done by each [ICMP pinger](/manual/concepts/server#server-process-types-and-threads) process individually. Auto-detected fping options are invalidated every hour and detected again on the next attempt to perform ICMP check. Set [DebugLevel](/manual/appendix/config/zabbix_server#debuglevel)>=4 in order to view details of this process in the server or proxy log file. Zabbix writes IP addresses to be checked by any of the three *icmpping\** keys to a temporary file, which is then passed to fping. If items have different key parameters, only the ones with identical key parameters are written to a single file. All IP addresses written to the single file will be checked by fping in parallel, so Zabbix ICMP pinger process will spend fixed amount of time disregarding the number of IP addresses in the file. ##### Noklusējuma vērtības Noklusējuma vērtības, ierobežojumi un vērtību apraksts ICMP pārbaudes parametriem: |Parameter|Unit|Description|Fping's flag|Defaults set by|<|Allowed limits<br>by Zabbix|<| |--|--|--------|-|--|--|--|--| | | | | |**fping**|**Zabbix**|**min**|**max**| |packets|number|uz mērķi nosūtīto pieprasījuma pakešu skaits|-C| |3|1|10000| |interval|milliseconds|laiks, kas jāgaida starp secīgām paketēm uz atsevišķu mērķi|-p|1000| |20|neierobežots| |size|bytes|paketes lielums baitos<br>56 baiti uz x86, 68 baiti uz x86_64|-b|56 or 68| |24|65507| |timeout|milliseconds|**fping v3.x** - noildze, kas jāgaida pēc pēdējās nosūtītās paketes; ietekmē *-C* karodziņš<br> **fping v4.x** - individuāla noildze katrai paketei|-t|**fping v3.x** - 500<br>**fping v4.x** un jaunākām versijām - mantots no *-p* karodziņa, bet ne vairāk kā 2000| |50|neierobežots| Noklusējuma vērtības var nedaudz atšķirties atkarībā no platformas un versijas. Turklāt Zabbix izmanto fping opcijas *-i interval ms* (nejauciet ar vienuma parametru *interval*, kas minēts tabulā iepriekš, un kas atbilst fping opcijai *-p*) un *-S source IP address* (vai *-I* vecākās fping versijās). Šīs opcijas tiek automātiski noteiktas, veicot pārbaudes ar dažādām opciju kombinācijām. Zabbix mēģina noteikt minimālo vērtību milisekundēs, ko fping atļauj izmantot ar *-i*, izmēģinot 3 vērtības: 0, 1 un 10. Vērtība, kas pirmā izdodas, pēc tam tiek izmantota turpmākajām ICMP pārbaudēm. Šis process tiek veikts katram [ICMP pinger](/manual/concepts/server#server-process-types-and-threads) procesam atsevišķi. Automātiski noteiktās fping opcijas tiek anulētas katru stundu un nākamajā mēģinājumā veikt ICMP pārbaudi tiek noteiktas atkārtoti. Iestatiet [DebugLevel](/manual/appendix/config/zabbix_server#debuglevel)>=4, lai servera vai starpniekservera žurnālfailā skatītu šī procesa detaļas. Zabbix ieraksta IP adreses, kas jāpārbauda ar jebkuru no trim *icmpping\** atslēgām, pagaidu failā, kas pēc tam tiek nodots fping. Ja vienumiem ir atšķirīgi atslēgas parametri, vienā failā tiek ierakstīti tikai tie, kuriem atslēgas parametri ir identiski. Visas IP adreses, kas ierakstītas vienā failā, fping pārbaudīs paralēli, tāpēc Zabbix ICMP pinger process patērēs fiksētu laiku neatkarīgi no IP adrešu skaita failā. ##### Default values You can set default values for the connection-related parameters (URI, username, password, etc.) in the configuration file in the format: ```default Plugins.<PluginName>.Default.<Parameter>=<Value> ``` For example, `Plugins.Mysql.Default.Username=zabbix`, `Plugins.MongoDB.Default.Uri=tcp://127.0.0.1:27017`, etc. If a value for such parameter is not provided in an item key or in the [named session](#named-sessions) parameters, the plugin will use the default value. If a default parameter is also undefined, hardcoded defaults will be used. ::: noteclassic If an item key does not have any parameters, Zabbix agent 2 will attempt to collect the metric using values defined in the default parameters section. ::: ##### Noklusējuma vērtības Savienojuma parametriem (URI, lietotājvārds, parole utt.) varat iestatīt noklusējuma vērtības konfigurācijas failā šādā formātā: ```default Plugins.<PluginName>.Default.<Parameter>=<Value> ``` Piemēram, `Plugins.Mysql.Default.Username=zabbix`, `Plugins.MongoDB.Default.Uri=tcp://127.0.0.1:27017` utt. Ja šāda parametra vērtība nav norādīta vienuma atslēgā vai [nosauktās sesijas](#named-sessions) parametros, spraudnis izmantos noklusējuma vērtību. Ja arī noklusējuma parametrs nav definēts, tiks izmantotas iebūvētās noklusējuma vērtības. ::: noteclassic Ja vienuma atslēgai nav neviena parametra, Zabbix aģents 2 mēģinās savākt metriku, izmantojot vērtības, kas definētas noklusējuma parametru sadaļā. ::: #### Defining a host A host in Zabbix is not a physical machine or device, but a logical entity. For monitoring purposes, you can create separate hosts for a database or, for example, a virtual machine. Alternatively, you can create a generic host *John's laptop* and monitor all metrics under that host. The best practice is to create a separate host for each independent instance such as a virtual machine, a database, a container, or a network switch. By utilizing this approach, you will: 1. Avoid clutter in the monitoring data by having separate items, triggers, and alert notifications for each host. 2. Fine-tune user-access levels. You can configure [user-roles](/manual/web_interface/frontend_sections/users/user_roles) to grant access to viewing and/or configuring only specific hosts. See also [the principle of least privilege](/manual/best_practices/security/access_control#principle-of-least-privilege). #### Hosts definēšana Hosts Zabbix nav fiziska mašīna vai ierīce, bet gan loģiska vienība. Uzraudzības nolūkos varat izveidot atsevišķus hosts datubāzei vai, piemēram, virtuālajai mašīnai. Alternatīvi varat izveidot vispārīgu hosts *John's laptop* un uzraudzīt visus metriskos datus šī hosts ietvaros. Labākā prakse ir izveidot atsevišķu hosts katram neatkarīgam eksemplāram, piemēram, virtuālajai mašīnai, datubāzei, konteineram vai tīkla komutatoram. Izmantojot šo pieeju, jūs: 1. Izvairīsieties no jucekļa uzraudzības datos, jo katram hosts būs atsevišķi vienumi, trigeri un brīdinājumu paziņojumi. 2. Precīzāk pielāgosiet lietotāju piekļuves līmeņus. Varat konfigurēt [user-roles](/manual/web_interface/frontend_sections/users/user_roles), lai piešķirtu piekļuvi tikai konkrētu hosts skatīšanai un/vai konfigurēšanai. Skatiet arī [mazāko privilēģiju principu](/manual/best_practices/security/access_control#principle-of-least-privilege). ##### Defining items Each item is defined in a ZBX\_METRIC structure: ```c typedef struct { char *key; unsigned flags; int (*function)(); char *test_param; } ZBX_METRIC; ``` Here, **key** is the item key (e.g., "dummy.random"), **flags** is either CF\_HAVEPARAMS or 0 (depending on whether the item accepts parameters or not), **function** is a C function that implements the item (e.g., "zbx\_module\_dummy\_random"), and **test\_param** is the parameter list to be used when Zabbix agent is started with the "-p" flag (e.g., "1,1000", can be NULL). An example definition may look like this: ```c static ZBX_METRIC keys[] = { { "dummy.random", CF_HAVEPARAMS, zbx_module_dummy_random, "1,1000" }, { NULL } } ``` Each function that implements an item should accept two pointer parameters, the first one of type AGENT\_REQUEST and the second one of type AGENT\_RESULT: ```c int zbx_module_dummy_random(AGENT_REQUEST *request, AGENT_RESULT *result) { ... SET_UI64_RESULT(result, from + rand() % (to - from + 1)); return SYSINFO_RET_OK; } ``` These functions should return SYSINFO\_RET\_OK, if the item value was successfully obtained. Otherwise, they should return SYSINFO\_RET\_FAIL. See example "dummy" module below for details on how to obtain information from AGENT\_REQUEST and how to set information in AGENT\_RESULT. ##### Vienumu definēšana Katrs vienums tiek definēts ZBX\_METRIC struktūrā: ```c typedef struct { char *key; unsigned flags; int (*function)(); char *test_param; } ZBX_METRIC; ``` Šeit **key** ir vienuma atslēga (piemēram, "dummy.random"), **flags** ir vai nu CF\_HAVEPARAMS, vai 0 (atkarībā no tā, vai vienums pieņem parametrus), **function** ir C funkcija, kas realizē vienumu (piemēram, "zbx\_module\_dummy\_random"), un **test\_param** ir parametru saraksts, kas jāizmanto, kad Zabbix aģents tiek palaists ar karodziņu "-p" (piemēram, "1,1000", var būt NULL). Definīcijas piemērs var izskatīties šādi: ```c static ZBX_METRIC keys[] = { { "dummy.random", CF_HAVEPARAMS, zbx_module_dummy_random, "1,1000" }, { NULL } } ``` Katrai funkcijai, kas realizē vienumu, jāpieņem divi rādītāja parametri: pirmais ar tipu AGENT\_REQUEST un otrais ar tipu AGENT\_RESULT: ```c int zbx_module_dummy_random(AGENT_REQUEST *request, AGENT_RESULT *result) { ... SET_UI64_RESULT(result, from + rand() % (to - from + 1)); return SYSINFO_RET_OK; } ``` Šīm funkcijām jāatgriež SYSINFO\_RET\_OK, ja vienuma vērtība tika veiksmīgi iegūta. Pretējā gadījumā tām jāatgriež SYSINFO\_RET\_FAIL. Sīkāku informāciju par to, kā iegūt informāciju no AGENT\_REQUEST un kā iestatīt informāciju AGENT\_RESULT, skatiet tālāk esošajā moduļa "dummy" piemērā. #### Definitions ***[host](/manual/config/hosts)*** \- *any physical or virtual device, application, service, or any other logically-related collection of monitored parameters.* ***[host group](/manual/config/hosts)*** \- *a logical grouping of hosts. Host groups are used when assigning access rights to hosts for different user groups.* ***[item](/manual/config/items)*** \- *a particular piece of data that you want to receive from a host, a metric of data.* ***[value preprocessing](/manual/config/items/item#item-value-preprocessing)*** \- *a transformation of received metric value* before saving it to the database. ***[trigger](/manual/config/triggers)*** \- *a logical expression that defines a problem threshold and is used to "evaluate" data received in items.* When received data are above the threshold, triggers go from 'Ok' into a 'Problem' state. When received data are below the threshold, triggers stay in/return to an 'Ok' state. ***[template](/manual/config/templates)*** \- *a set of entities (items, triggers, graphs, low-level discovery rules, web scenarios) ready to be applied to one or several hosts.* The job of templates is to speed up the deployment of monitoring tasks on a host; also to make it easier to apply mass changes to monitoring tasks. Templates are linked directly to individual hosts. ***[template group](/manual/config/templates)*** \- *a logical grouping of templates. Template groups are used when assigning access rights to templates for different user groups.* ***[event](/manual/config/events)*** \- *a single occurrence of something that deserves attention such as a trigger changing state or a discovery/agent autoregistration taking place.* ***[event tag](/manual/config/tagging)*** \- *a pre-defined marker for the event.* It may be used in event correlation, permission granulation, etc. ***[event correlation](/manual/config/event_correlation)*** \- *a method of correlating problems to their resolution flexibly and precisely.* For example, you may define that a problem reported by one trigger may be resolved by another trigger, which may even use a different data collection method. ***[problem](/manual/web_interface/frontend_sections/monitoring/problems)*** \- *a trigger that is in "Problem" state.* ***[problem update](/manual/acknowledgment#updating-problems)*** \- *problem management options provided by Zabbix, such as adding comment, acknowledging, changing severity or closing manually.* ***[action](/manual/config/notifications/action)*** \- *a predefined means of reacting to an event.* An action consists of operations (e.g. sending a notification) and conditions (*when* the operation is carried out) ***[escalation](/manual/config/notifications/action/escalations)*** \- *a custom scenario for executing operations within an action; a sequence of sending notifications/executing remote commands.* ***[macro](/manual/config/macros)*** \- *a variable placeholder that resolves to a specific value depending on the context.* ***[media](/manual/config/notifications/media)*** \- *a means of delivering notifications; delivery channel.* ***[notification](/manual/config/notifications/action/operation/message)*** \- *a message about some event sent to a user via the chosen media channel.* ***[remote command](/manual/config/notifications/action/operation/remote_command)*** \- *a pre-defined command that is automatically executed on a monitored host upon some condition.* ***[web scenario](/manual/web_monitoring)*** \- *one or several HTTP requests to check the availability of a web site.* ***[frontend](/manual/introduction/overview#architecture)*** \- *the web interface provided with Zabbix.* ***[dashboard](/manual/web_interface/frontend_sections/dashboards)*** \- *customizable section of the web interface displaying summaries and visualizations* of important information in visual units called widgets. ***[widget](/manual/web_interface/frontend_sections/dashboards/widgets)*** \- *visual unit displaying information of a certain kind and source* (a summary, a map, a graph, the clock, etc.), used in the dashboard. ***[Zabbix API](/manual/api)*** \- *Zabbix API allows you to use the JSON RPC protocol to create, update and fetch Zabbix objects (like hosts, items, graphs and others) or perform any other custom tasks.* ***[Zabbix server](/manual/concepts/server)*** \- *a central process of Zabbix software that performs monitoring, interacts with Zabbix proxies and agents, calculates triggers, sends notifications; a central repository of data.* ***[Zabbix proxy](/manual/concepts/proxy)*** \- *a process that may collect data on behalf of Zabbix server, taking some processing load from the server.* ***[Zabbix agent](/manual/concepts/agent)*** \- *a process deployed on monitoring targets to actively monitor local resources and applications.* ***[Zabbix agent 2](/manual/concepts/agent2)*** \- *a new generation of Zabbix agent to actively monitor local resources and applications, allowing to use custom plugins for monitoring.* ::: noteimportant Because Zabbix agent 2 shares much functionality with Zabbix agent, the term "Zabbix agent" in documentation stands for both - Zabbix agent and Zabbix agent 2, if the functional behavior is the same. Zabbix agent 2 is only specifically named where its functionality differs. ::: ***[encryption](/manual/encryption)*** \- *support of encrypted communications between Zabbix components (server, proxy, agent, zabbix\_sender and zabbix\_get utilities)* using Transport Layer Security (TLS) protocol. ***[agent autoregistration](/manual/discovery/auto_registration)*** \- *automated process whereby a Zabbix agent itself is registered* as a host and started to monitor. ***[network discovery](/manual/discovery/network_discovery)*** \- *automated discovery of network devices*. ***[low-level discovery](/manual/discovery/low_level_discovery)*** \- *automated discovery of low-level entities on a particular device* (e.g. file systems, network interfaces, etc). ***[low-level discovery rule](/manual/discovery/low_level_discovery#discovery-rule)*** \- *set of definitions for automated discovery of low-level entities* on a device. ***[item prototype](/manual/discovery/low_level_discovery#item-prototypes)*** \- *a metric with certain parameters as variables, ready for low-level discovery*. After low-level discovery the variables are automatically substituted with the real discovered parameters and the metric automatically starts gathering data. ***[trigger prototype](/manual/discovery/low_level_discovery#trigger-prototypes)*** \- *a trigger with certain parameters as variables, ready for low-level discovery*. After low-level discovery the variables are automatically substituted with the real discovered parameters and the trigger automatically starts evaluating data. *Prototypes* of some other Zabbix entities are also in use in low-level discovery - graph prototypes, host prototypes, host group prototypes. #### Definīcijas ***[hosts](/manual/config/hosts)*** \- *jebkura fiziska vai virtuāla ierīce, lietojumprogramma, pakalpojums vai jebkura cita loģiski saistīta uzraudzīto parametru kopa.* ***[host group](/manual/config/hosts)*** \- *loģiska hosts grupa. Host grupas tiek izmantotas, piešķirot piekļuves tiesības hosts dažādām lietotāju grupām.* ***[vienums](/manual/config/items)*** \- *konkrēta datu vienība, ko vēlaties saņemt no hosta, datu metrika.* ***[value preprocessing](/manual/config/items/item#item-value-preprocessing)*** \- *saņemtās metrikas vērtības pārveidošana* pirms tās saglabāšanas datubāzē. ***[trigeris](/manual/config/triggers)*** \- *loģiska izteiksme, kas nosaka problēmas slieksni un tiek izmantota, lai "izvērtētu" datos saņemtos vienumus.* Ja saņemtie dati pārsniedz slieksni, trigeri pāriet no stāvokļa 'Ok' uz stāvokli 'Problem'. Ja saņemtie dati ir zem sliekšņa, trigeri paliek/atgriežas stāvoklī 'Ok'. ***[veidne](/manual/config/templates)*** \- *entītiju kopums (vienumi, trigeri, grafiki, zema līmeņa atklāšanas noteikumi, tīmekļa scenāriji), kas ir gatavs piemērošanai vienam vai vairākiem hostiem.* Veidņu uzdevums ir paātrināt uzraudzības uzdevumu izvietošanu hostā; tāpat arī atvieglot masveida izmaiņu piemērošanu uzraudzības uzdevumiem. Veidnes tiek saistītas tieši ar atsevišķiem hostiem. ***[template group](/manual/config/templates)*** \- *veidņu loģiska grupa. Template grupas tiek izmantotas, piešķirot piekļuves tiesības veidnēm dažādām lietotāju grupām.* ***[event](/manual/config/events)*** \- *viens notikums, kam jāpievērš uzmanība, piemēram, trigerim mainot stāvokli vai notiekot atklāšanai/aģenta automātiskajai reģistrācijai.* ***[event tag](/manual/config/tagging)*** \- *iepriekš definēts notikuma marķieris.* To var izmantot notikumu korelācijā, tiesību detalizētākā sadalē utt. ***[event correlation](/manual/config/event_correlation)*** \- *metode, kas ļauj elastīgi un precīzi sasaistīt problēmas ar to novēršanu.* Piemēram, varat definēt, ka vienu trigeri ziņotu problēmu var novērst cits trigeris, kas var izmantot pat citu datu vākšanas metodi. ***[problem](/manual/web_interface/frontend_sections/monitoring/problems)*** \- *trigeris, kas ir stāvoklī "Problem".* ***[problem update](/manual/acknowledgment#updating-problems)*** \- *Zabbix nodrošinātās problēmu pārvaldības opcijas, piemēram, komentāra pievienošana, apstiprināšana, nopietnības maiņa vai manuāla aizvēršana.* ***[action](/manual/config/notifications/action)*** \- *iepriekš definēts veids, kā reaģēt uz notikumu.* Darbība sastāv no operācijām (piem., paziņojuma nosūtīšanas) un nosacījumiem (*kad* operācija tiek veikta) ***[escalation](/manual/config/notifications/action/escalations)*** \- *pielāgots scenārijs operāciju izpildei darbības ietvaros; paziņojumu sūtīšanas/attālo komandu izpildes secība.* ***[macro](/manual/config/macros)*** \- *mainīgais vietturis, kas atkarībā no konteksta tiek aizstāts ar konkrētu vērtību.* ***[media](/manual/config/notifications/media)*** \- *paziņojumu piegādes līdzeklis; piegādes kanāls.* ***[notification](/manual/config/notifications/action/operation/message)*** \- *ziņojums par kādu notikumu, kas lietotājam nosūtīts, izmantojot izvēlēto mediju kanālu.* ***[remote command](/manual/config/notifications/action/operation/remote_command)*** \- *iepriekš definēta komanda, kas automātiski tiek izpildīta uzraudzītā hostā, iestājoties noteiktam nosacījumam.* ***[web scenario](/manual/web_monitoring)*** \- *viens vai vairāki HTTP pieprasījumi tīmekļa vietnes pieejamības pārbaudei.* ***[lietotāja saskarne](/manual/introduction/overview#architecture)*** \- *Zabbix nodrošinātā tīmekļa saskarne.* ***[dashboard](/manual/web_interface/frontend_sections/dashboards)*** \- *pielāgojama lietotāja saskarnes sadaļa, kas vizuālos elementos, sauktos par logrīkiem, attēlo svarīgas informācijas kopsavilkumus un vizualizācijas.* ***[widget](/manual/web_interface/frontend_sections/dashboards/widgets)*** \- *vizuāls elements, kas attēlo noteikta veida un avota informāciju* (kopsavilkumu, karti, grafiku, pulksteni utt.), ko izmanto dashboard. ***[Zabbix API](/manual/api)*** \- *Zabbix API ļauj izmantot JSON RPC protokolu, lai izveidotu, atjauninātu un izgūtu Zabbix objektus (piemēram, hostus, vienumus, grafikus un citus) vai veiktu jebkurus citus pielāgotus uzdevumus.* ***[Zabbix serveris](/manual/concepts/server)*** \- *Zabbix programmatūras centrālais process, kas veic uzraudzību, mijiedarbojas ar Zabbix starpniekserveriem un aģentiem, aprēķina trigerus, nosūta paziņojumus; centrālā datu krātuve.* ***[Zabbix starpniekserveris](/manual/concepts/proxy)*** \- *process, kas var vākt datus Zabbix servera vārdā, daļu apstrādes slodzes pārņemot no servera.* ***[Zabbix aģents](/manual/concepts/agent)*** \- *process, kas izvietots uzraudzības mērķos, lai aktīvi uzraudzītu lokālos resursus un lietojumprogrammas.* ***[Zabbix agent 2](/manual/concepts/agent2)*** \- *jaunās paaudzes Zabbix aģents, kas aktīvi uzrauga lokālos resursus un lietojumprogrammas, ļaujot izmantot pielāgotus spraudņus uzraudzībai.* ::: noteimportant Tā kā Zabbix agent 2 koplieto lielu daļu funkcionalitātes ar Zabbix aģents, dokumentācijā termins "Zabbix aģents" apzīmē abus - Zabbix aģents un Zabbix agent 2, ja funkcionālā darbība ir vienāda. Zabbix agent 2 tiek īpaši nosaukts tikai tad, ja tā funkcionalitāte atšķiras. ::: ***[šifrēšana](/manual/encryption)*** \- *šifrētas saziņas atbalsts starp Zabbix komponentēm (serveris, starpniekserveris, aģents, zabbix\_sender un zabbix\_get utilītām)*, izmantojot Transport Layer Security (TLS) protokolu. ***[agent autoregistration](/manual/discovery/auto_registration)*** \- *automatizēts process, kurā pats Zabbix aģents tiek reģistrēts* kā hosts un sāk uzraudzību. ***[network discovery](/manual/discovery/network_discovery)*** \- *tīkla ierīču automatizēta atklāšana*. ***[low-level discovery](/manual/discovery/low_level_discovery)*** \- *zemā līmeņa entītiju automatizēta atklāšana konkrētā ierīcē* (piem., failu sistēmas, tīkla saskarnes utt.). ***[low-level discovery rule](/manual/discovery/low_level_discovery#discovery-rule)*** \- *definīciju kopums zemā līmeņa entītiju automatizētai atklāšanai* uz ierīces. ***[item prototype](/manual/discovery/low_level_discovery#item-prototypes)*** \- *metrika ar noteiktiem parametriem kā mainīgajiem, gatava zema līmeņa atklāšanai*. Pēc zema līmeņa atklāšanas mainīgie automātiski tiek aizstāti ar reāli atklātajiem parametriem, un metrika automātiski sāk vākt datus. ***[trigger prototype](/manual/discovery/low_level_discovery#trigger-prototypes)*** \- *trigeris ar noteiktiem parametriem kā mainīgajiem, gatavs zema līmeņa atklāšanai*. Pēc zema līmeņa atklāšanas mainīgie automātiski tiek aizstāti ar reāli atklātajiem parametriem, un trigeris automātiski sāk izvērtēt datus. *Dažu citu Zabbix entītiju* prototipi *arī tiek izmantoti zema līmeņa atklāšanā - grafiku prototipi, hostu prototipi, host grupu prototipi.* ##### degrees(value) {#degrees} Converts a value from radians to degrees. Parameter: - **value** - the value to check For example, a value '1' converted to degrees will be '57.2957795'. Example: degrees(last(/host/key)) ##### degrees(value) {#degrees} Pārveido vērtību no radiāniem uz grādiem. Parametrs: - **value** - pārbaudāmā vērtība Piemēram, vērtība '1', pārveidota grādos, būs '57.2957795'. Piemērs: degrees(last(/host/key)) #### Delete a host interface Delete the host interface with ID 30062. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "hostinterface.delete", "params": [ "30062" ], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "interfaceids": [ "30062" ] }, "id": 1 } ``` #### Dzēst hosta saskarni Dzēsiet hosta saskarni ar ID 30062. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "hostinterface.delete", "params": [ "30062" ], "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "interfaceids": [ "30062" ] }, "id": 1 } ``` #### Delete multiple actions Delete two actions. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "action.delete", "params": [ "17", "18" ], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "17", "18" ] }, "id": 1 } ``` #### Dzēst vairākas darbības Dzēst divas darbības. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "action.delete", "params": [ "17", "18" ], "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "17", "18" ] }, "id": 1 } ``` #### Delete multiple correlations Delete two correlations. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "correlation.delete", "params": [ "1", "2" ], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "correlationids": [ "1", "2" ] }, "id": 1 } ``` #### Dzēst vairākas korelācijas Dzēsiet divas korelācijas. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "correlation.delete", "params": [ "1", "2" ], "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "correlationids": [ "1", "2" ] }, "id": 1 } ``` #### Delete multiple discovery rules Delete two discovery rules. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "drule.delete", "params": [ "4", "6" ], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "druleids": [ "4", "6" ] }, "id": 1 } ``` #### Dzēst vairākus atklāšanas noteikumus Dzēsiet divus atklāšanas noteikumus. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "drule.delete", "params": [ "4", "6" ], "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "druleids": [ "4", "6" ] }, "id": 1 } ``` #### Delete multiple icon maps Delete two icon maps. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "iconmap.delete", "params": [ "2", "5" ], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "iconmapids": [ "2", "5" ] }, "id": 1 } ``` #### Dzēst vairākas ikonu kartes Dzēsiet divas ikonu kartes. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "iconmap.delete", "params": [ "2", "5" ], "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "iconmapids": [ "2", "5" ] }, "id": 1 } ``` #### Delete multiple images Delete two images. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "image.delete", "params": [ "188", "192" ], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "imageids": [ "188", "192" ] }, "id": 1 } ``` #### Dzēst vairākus attēlus Dzēsiet divus attēlus. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "image.delete", "params": [ "188", "192" ], "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "imageids": [ "188", "192" ] }, "id": 1 } ``` #### Delete multiple maps Delete two maps. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "map.delete", "params": [ "12", "34" ], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "sysmapids": [ "12", "34" ] }, "id": 1 } ``` #### Dzēst vairākas kartes Dzēsiet divas kartes. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "map.delete", "params": [ "12", "34" ], "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "sysmapids": [ "12", "34" ] }, "id": 1 } ``` #### Delete multiple proxies Delete two proxies. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "proxy.delete", "params": [ "10286", "10285" ], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "proxyids": [ "10286", "10285" ] }, "id": 1 } ``` #### Dzēst vairākus starpniekserverus Dzēsiet divus starpniekserverus. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "proxy.delete", "params": [ "10286", "10285" ], "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "proxyids": [ "10286", "10285" ] }, "id": 1 } ``` #### Delete multiple proxy groups Delete two proxy groups. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "proxygroup.delete", "params": [ "5", "10" ], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "proxy_groupids": [ "5", "10" ] }, "id": 1 } ``` #### Dzēst vairākas starpniekserveru grupas Dzēst divas starpniekserveru grupas. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "proxygroup.delete", "params": [ "5", "10" ], "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "proxy_groupids": [ "5", "10" ] }, "id": 1 } ``` #### Delete multiple scripts Delete two scripts. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "script.delete", "params": [ "3", "4" ], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "scriptids": [ "3", "4" ] }, "id": 1 } ``` #### Vairāku skriptu dzēšana Dzēsiet divus skriptus. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "script.delete", "params": [ "3", "4" ], "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "scriptids": [ "3", "4" ] }, "id": 1 } ``` #### Delete multiple tokens Delete two tokens. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "token.delete", "params": [ "188", "192" ], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "tokenids": [ "188", "192" ] }, "id": 1 } ``` #### Dzēst vairākus tokenus Dzēst divus tokenus. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "token.delete", "params": [ "188", "192" ], "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "tokenids": [ "188", "192" ] }, "id": 1 } ``` #### Delete multiple triggers Delete two triggers. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "trigger.delete", "params": [ "12002", "12003" ], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "12002", "12003" ] }, "id": 1 } ``` #### Dzēst vairākus trigerus Dzēst divus trigerus. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "trigger.delete", "params": [ "12002", "12003" ], "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "12002", "12003" ] }, "id": 1 } ``` #### Deleting MFA methods Delete an MFA method. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "mfa.delete", "params": [ "2" ], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "mfaids": [ "2" ] }, "id": 1 } ``` #### MFA metožu dzēšana Dzēsiet MFA metodi. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "mfa.delete", "params": [ "2" ], "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "mfaids": [ "2" ] }, "id": 1 } ``` #### Deleting multiple connectors Delete two connector entries. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "connector.delete", "params": [ 3, 5 ], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "connectorids": [ "3", "5" ] }, "id": 1 } ``` #### Vairāku savienotāju dzēšana Dzēsiet divus savienotāju ierakstus. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "connector.delete", "params": [ 3, 5 ], "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "connectorids": [ "3", "5" ] }, "id": 1 } ``` #### Deleting multiple dashboards Delete two dashboards. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.delete", "params": [ "2", "3" ], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "2", "3" ] }, "id": 1 } ``` #### Vairāku paneļu dzēšana Dzēsiet divus paneļus. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.delete", "params": [ "2", "3" ], "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "2", "3" ] }, "id": 1 } ``` #### Deleting multiple global macros Delete two global macros. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "usermacro.deleteglobal", "params": [ "32", "11" ], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "globalmacroids": [ "32", "11" ] }, "id": 1 } ``` #### Vairāku globālo makrosu dzēšana Dzēsiet divus globālos makrosus. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "usermacro.deleteglobal", "params": [ "32", "11" ], "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "globalmacroids": [ "32", "11" ] }, "id": 1 } ``` #### Deleting multiple global regular expressions. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "regexp.delete", "params": [ "16", "17" ], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "regexpids": [ "16", "17" ] }, "id": 1 } ``` #### Vairāku globālo regulāro izteiksmju dzēšana. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "regexp.delete", "params": [ "16", "17" ], "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "regexpids": [ "16", "17" ] }, "id": 1 } ``` #### Deleting multiple graph prototypes Delete two graph prototypes. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "graphprototype.delete", "params": [ "652", "653" ], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "graphids": [ "652", "653" ] }, "id": 1 } ``` #### Vairāku grafiku prototipu dzēšana Dzēsiet divus grafiku prototipus. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "graphprototype.delete", "params": [ "652", "653" ], "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "graphids": [ "652", "653" ] }, "id": 1 } ``` #### Deleting multiple graphs Delete two graphs. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "graph.delete", "params": [ "652", "653" ], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "graphids": [ "652", "653" ] }, "id": 1 } ``` #### Vairāku grafiku dzēšana Dzēsiet divus grafikus. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "graph.delete", "params": [ "652", "653" ], "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "graphids": [ "652", "653" ] }, "id": 1 } ``` #### Deleting multiple host groups Delete two host groups. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "hostgroup.delete", "params": [ "107824", "107825" ], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "groupids": [ "107824", "107825" ] }, "id": 1 } ``` #### Vairāku hostu grupu dzēšana Dzēsiet divas hostu grupas. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "hostgroup.delete", "params": [ "107824", "107825" ], "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "groupids": [ "107824", "107825" ] }, "id": 1 } ``` #### Deleting multiple host macros Delete two host macros. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "usermacro.delete", "params": [ "32", "11" ], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostmacroids": [ "32", "11" ] }, "id": 1 } ``` #### Vairāku hosta makrosu dzēšana Dzēsiet divus hosta makrosus. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "usermacro.delete", "params": [ "32", "11" ], "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "hostmacroids": [ "32", "11" ] }, "id": 1 } ``` #### Deleting multiple host prototypes Delete two host prototypes. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "hostprototype.delete", "params": [ "10103", "10105" ], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10103", "10105" ] }, "id": 1 } ``` #### Vairāku hostu prototipu dzēšana Dzēsiet divus hostu prototipus. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "hostprototype.delete", "params": [ "10103", "10105" ], "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10103", "10105" ] }, "id": 1 } ``` #### Deleting multiple hosts Delete two hosts. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "host.delete", "params": [ "13", "32" ], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "13", "32" ] }, "id": 1 } ``` #### Vairāku hostu dzēšana Dzēsiet divus hostus. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "host.delete", "params": [ "13", "32" ], "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "13", "32" ] }, "id": 1 } ``` #### Deleting multiple item prototypes Delete two item prototypes.<br> Dependent item prototypes are removed automatically if master item or item prototype is deleted. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "itemprototype.delete", "params": [ "27352", "27356" ], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "prototypeids": [ "27352", "27356" ] }, "id": 1 } ``` #### Vairāku vienumu prototipu dzēšana Dzēsiet divus vienumu prototipus.<br> Atkarīgie vienumu prototipi tiek noņemti automātiski, ja tiek dzēsts galvenais vienums vai vienuma prototips. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "itemprototype.delete", "params": [ "27352", "27356" ], "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "prototypeids": [ "27352", "27356" ] }, "id": 1 } ``` #### Deleting multiple items Delete two items.<br> Dependent items and item prototypes are removed automatically if master item is deleted. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "item.delete", "params": [ "22982", "22986" ], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "22982", "22986" ] }, "id": 1 } ``` #### Vairāku vienumu dzēšana Dzēsiet divus vienumus.<br> Atkarīgie vienumi un vienumu prototipi tiek noņemti automātiski, ja tiek dzēsts galvenais vienums. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "item.delete", "params": [ "22982", "22986" ], "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "22982", "22986" ] }, "id": 1 } ``` #### Deleting multiple LLD rules Delete two LLD rules. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "discoveryrule.delete", "params": [ "27665", "27668" ], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "ruleids": [ "27665", "27668" ] }, "id": 1 } ``` #### Vairāku LLD noteikumu dzēšana Dzēsiet divus LLD noteikumus. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "discoveryrule.delete", "params": [ "27665", "27668" ], "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "ruleids": [ "27665", "27668" ] }, "id": 1 } ``` #### Deleting multiple maintenance periods Delete two maintenance periods. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "maintenance.delete", "params": [ "3", "1" ], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "maintenanceids": [ "3", "1" ] }, "id": 1 } ``` #### Vairāku uzturēšanas periodu dzēšana Dzēsiet divus uzturēšanas periodus. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "maintenance.delete", "params": [ "3", "1" ], "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "maintenanceids": [ "3", "1" ] }, "id": 1 } ``` #### Deleting multiple media types Delete two media types. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "mediatype.delete", "params": [ "3", "5" ], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "mediatypeids": [ "3", "5" ] }, "id": 1 } ``` #### Vairāku paziņojumu veidu dzēšana Dzēsiet divus paziņojumu veidus. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "mediatype.delete", "params": [ "3", "5" ], "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "mediatypeids": [ "3", "5" ] }, "id": 1 } ``` #### Deleting multiple scheduled reports Delete two scheduled reports. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "report.delete", "params": [ "1", "2" ], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "reportids": [ "1", "2" ] }, "id": 1 } ``` #### Vairāku ieplānoto atskaišu dzēšana Dzēsiet divas ieplānotās atskaites. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "report.delete", "params": [ "1", "2" ], "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "reportids": [ "1", "2" ] }, "id": 1 } ``` #### Deleting multiple services Delete two services. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "service.delete", "params": [ "4", "5" ], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "serviceids": [ "4", "5" ] }, "id": 1 } ``` #### Vairāku pakalpojumu dzēšana Dzēsiet divus pakalpojumus. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "service.delete", "params": [ "4", "5" ], "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "serviceids": [ "4", "5" ] }, "id": 1 } ``` #### Deleting multiple SLAs Delete two SLA entries. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "sla.delete", "params": [ "4", "5" ], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "slaids": [ "4", "5" ] }, "id": 1 } ``` #### Vairāku SLA dzēšana Dzēsiet divus SLA ierakstus. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "sla.delete", "params": [ "4", "5" ], "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "slaids": [ "4", "5" ] }, "id": 1 } ``` #### Deleting multiple template dashboards Delete two template dashboards. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "templatedashboard.delete", "params": [ "45", "46" ], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "45", "46" ] }, "id": 1 } ``` #### Vairāku veidņu paneļu dzēšana Dzēsiet divus veidņu paneļus. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "templatedashboard.delete", "params": [ "45", "46" ], "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "45", "46" ] }, "id": 1 } ``` #### Deleting multiple template groups Delete two template groups. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "templategroup.delete", "params": [ "107814", "107815" ], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "groupids": [ "107814", "107815" ] }, "id": 1 } ``` #### Vairāku veidņu grupu dzēšana Dzēsiet divas veidņu grupas. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "templategroup.delete", "params": [ "107814", "107815" ], "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "groupids": [ "107814", "107815" ] }, "id": 1 } ``` #### Deleting multiple templates Delete two templates. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "template.delete", "params": [ "13", "32" ], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "templateids": [ "13", "32" ] }, "id": 1 } ``` #### Vairāku veidņu dzēšana Dzēsiet divas veidnes. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "template.delete", "params": [ "13", "32" ], "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "templateids": [ "13", "32" ] }, "id": 1 } ``` #### Deleting multiple trigger prototypes Delete two trigger prototypes. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "triggerprototype.delete", "params": [ "12002", "12003" ], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "12002", "12003" ] }, "id": 1 } ``` #### Vairāku trigeru prototipu dzēšana Dzēsiet divus trigeru prototipus. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "triggerprototype.delete", "params": [ "12002", "12003" ], "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "12002", "12003" ] }, "id": 1 } ``` #### Deleting multiple user directories Delete two user directories. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "userdirectory.delete", "params": [ "2", "12" ], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "userdirectoryids": [ "2", "12" ] }, "id": 1 } ``` #### Vairāku lietotāju direktoriju dzēšana Dzēsiet divas lietotāju direktorijas. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "userdirectory.delete", "params": [ "2", "12" ], "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "userdirectoryids": [ "2", "12" ] }, "id": 1 } ``` #### Deleting multiple user groups Delete two user groups. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "usergroup.delete", "params": [ "20", "21" ], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "usrgrpids": [ "20", "21" ] }, "id": 1 } ``` #### Vairāku lietotāju grupu dzēšana Dzēsiet divas lietotāju grupas. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "usergroup.delete", "params": [ "20", "21" ], "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "usrgrpids": [ "20", "21" ] }, "id": 1 } ``` #### Deleting multiple user roles Delete two user roles. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "role.delete", "params": [ "4", "5" ], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "roleids": [ "4", "5" ] }, "id": 1 } ``` #### Vairāku lietotāju lomu dzēšana Dzēsiet divas lietotāju lomas. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "role.delete", "params": [ "4", "5" ], "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "roleids": [ "4", "5" ] }, "id": 1 } ``` #### Deleting multiple users Delete two users. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "user.delete", "params": [ "1", "5" ], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "userids": [ "1", "5" ] }, "id": 1 } ``` #### Vairāku lietotāju dzēšana Dzēsiet divus lietotājus. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "user.delete", "params": [ "1", "5" ], "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "userids": [ "1", "5" ] }, "id": 1 } ``` #### Deleting multiple value maps Delete two value maps. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "valuemap.delete", "params": [ "1", "2" ], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "valuemapids": [ "1", "2" ] }, "id": 1 } ``` #### Vairāku vērtību karšu dzēšana Dzēsiet divas vērtību kartes. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "valuemap.delete", "params": [ "1", "2" ], "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "valuemapids": [ "1", "2" ] }, "id": 1 } ``` #### Deleting multiple web scenarios Delete two web scenarios. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "httptest.delete", "params": [ "2", "3" ], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "httptestids": [ "2", "3" ] }, "id": 1 } ``` #### Vairāku tīmekļa scenāriju dzēšana Dzēsiet divus tīmekļa scenārijus. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "httptest.delete", "params": [ "2", "3" ], "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "httptestids": [ "2", "3" ] }, "id": 1 } ``` #### Deleting objects used in actions When attempting to delete objects that are used in an action condition/operation, the user will receive a corresponding error message. Actions are not disabled if action conditions or operations: - have deleted objects; - have objects that are no longer discovered by low-level discovery and have been removed (after the *Delete lost resources* period). Action conditions/operations are not removed if they have missing objects. Instead, deleted objects are displayed as *Deleted host group*, *Deleted host*, *Deleted trigger*, etc. A warning icon with message "This action has conditions or operations referencing deleted object(s)." is displayed in the "Info" column of the action list. Note that **before Zabbix 7.0.10**, if a certain object (host, template, trigger, etc.) used in an action condition/operation is deleted, the condition/operation is removed and the action is disabled. #### Objektu dzēšana, kas tiek izmantoti darbībās Mēģinot dzēst objektus, kas tiek izmantoti darbības nosacījumā/operācijā, lietotājs saņems atbilstošu kļūdas ziņojumu. Darbības netiek atspējotas, ja darbības nosacījumiem vai operācijām: - ir dzēsti objekti; - ir objekti, kas vairs netiek atklāti ar zemā līmeņa atklāšanu un ir noņemti (pēc perioda *Delete lost resources*). Darbības nosacījumi/operācijas netiek noņemtas, ja tām trūkst objektu. Tā vietā dzēstie objekti tiek attēloti kā *Deleted host group*, *Deleted host*, *Deleted trigger* utt. Brīdinājuma ikona ar ziņojumu "This action has conditions or operations referencing deleted object(s)." tiek parādīta darbību saraksta kolonnā "Info". Ņemiet vērā, ka **pirms Zabbix 7.0.10**, ja noteikts objekts (hosts, veidne, trigeris utt.), kas tiek izmantots darbības nosacījumā/operācijā, tiek dzēsts, nosacījums/operācija tiek noņemta un darbība tiek atspējota. ##### DenyKey Deny the execution of those item keys that match a pattern.<br> The key pattern is a wildcard expression that supports the `*` character to match any number of any characters.<br>Multiple key matching rules may be defined in combination with `AllowKey`. The parameters are processed one by one according to their appearance order. See also: [Restricting agent checks](/manual/config/items/restrict_checks). ##### DenyKey Noraidīt to vienumu atslēgu izpildi, kas atbilst paraugam.<br> Atslēgas paraugs ir aizstājējzīmju izteiksme, kas atbalsta `*` rakstzīmi, lai atbilstu jebkuram rakstzīmju skaitam.<br>Vairākus atslēgu atbilstības noteikumus var definēt kopā ar `AllowKey`. Parametri tiek apstrādāti pa vienam atbilstoši to parādīšanās secībai. Skatiet arī: [Restricting agent checks](/manual/config/items/restrict_checks). ##### DenyKey Deny the execution of those item keys that match a pattern. The key pattern is a wildcard expression that supports the `*` character to match any number of any characters.<br>Multiple key matching rules may be defined in combination with `AllowKey`. The parameters are processed one by one according to their appearance order. See also: [Restricting agent checks](/manual/config/items/restrict_checks). ##### DenyKey Aizliegt to vienumu atslēgu izpildi, kas atbilst paraugam. Atslēgas paraugs ir aizstājējzīmju izteiksme, kas atbalsta `*` rakstzīmi, lai atbilstu jebkuram rakstzīmju skaitam.<br>Vairākus atslēgu atbilstības noteikumus var definēt kopā ar `AllowKey`. Parametri tiek apstrādāti pa vienam atbilstoši to parādīšanās secībai. Skatiet arī: [Aģenta pārbaužu ierobežošana](/manual/config/items/restrict_checks). ##### DenyKey Deny the execution of those item keys that match a pattern. The key pattern is a wildcard expression that supports the `*` character to match any number of any characters.<br>Multiple key matching rules may be defined in combination with `AllowKey`. The parameters are processed one by one according to their appearance order. See also: [Restricting agent checks](/manual/config/items/restrict_checks). ##### DenyKey Aizliegt to vienumu atslēgu izpildi, kas atbilst paraugam. Atslēgas paraugs ir aizstājējzīmju izteiksme, kas atbalsta `*` rakstzīmi, lai atbilstu jebkuram rakstzīmju skaitam.<br>Vairāki atslēgu atbilstības noteikumi var tikt definēti kopā ar `AllowKey`. Parametri tiek apstrādāti pa vienam atbilstoši to parādīšanās secībai. Skatiet arī: [Aģenta pārbaužu ierobežošana](/manual/config/items/restrict_checks). ##### DenyKey Deny the execution of those item keys that match a pattern. The key pattern is a wildcard expression that supports the `*` character to match any number of any characters.<br>Multiple key matching rules may be defined in combination with `AllowKey`. The parameters are processed one by one according to their appearance order. See also: [Restricting agent checks](/manual/config/items/restrict_checks). ##### DenyKey Aizliegt to vienumu atslēgu izpildi, kas atbilst paraugam. Atslēgas paraugs ir aizstājējzīmju izteiksme, kas atbalsta `*` rakstzīmi, lai atbilstu jebkuram rakstzīmju skaitam.<br>Vairākus atslēgu atbilstības noteikumus var definēt kopā ar `AllowKey`. Parametri tiek apstrādāti pa vienam atbilstoši to parādīšanās secībai. Skatiet arī: [Aģenta pārbaužu ierobežošana](/manual/config/items/restrict_checks). ##### Dependent item prototype Create an item prototype with "Dependent item" type in this LLD rule. As master item for this prototype select the `ipmi.get` item we created.  Note the use of the {\#SENSOR\_ID} macro in the item prototype name and key: - *Name*: IPMI value for sensor {\#SENSOR\_ID} - *Key*: ipmi\_sensor\[{\#SENSOR\_ID}\] As type of information, *Numeric (unsigned)*. In the item prototype "Preprocessing" tab select JSONPath and use the following JSONPath expression as parameter: $.[?(@.id=='{#SENSOR_ID}')].value.first()  When discovery starts, one item per each IPMI sensor will be created. This item will return the integer value of the given sensor. ##### Atkarīgā vienuma prototips Izveidojiet šajā LLD kārtulā vienuma prototipu ar tipu "Dependent item". Kā galveno vienumu šim prototipam atlasiet iepriekš izveidoto `ipmi.get` vienumu.  Ņemiet vērā makrosa {\#SENSOR\_ID} izmantošanu vienuma prototipa nosaukumā un atslēgā: - *Name*: IPMI vērtība sensoram {\#SENSOR\_ID} - *Key*: ipmi\_sensor\[{\#SENSOR\_ID}\] Kā informācijas tipu norādiet *Numeric (unsigned)*. Vienuma prototipa cilnē "Preprocessing" atlasiet JSONPath un izmantojiet šādu JSONPath izteiksmi kā parametru: $.[?(@.id=='{#SENSOR_ID}')].value.first()  Kad atklāšana sāksies, tiks izveidots viens vienums katram IPMI sensoram. Šis vienums atgriezīs dotā sensora veselo skaitlisko vērtību. ##### Dependent item prototype Create an item prototype with "Dependent item" type in this LLD rule. As master item for this prototype select the `vfs.fs.get` item we created.  Note the use of custom macros in the item prototype name and key: - *Name*: Free disk space on {\#FSNAME}, type: {\#FSTYPE} - *Key*: Free\[{\#FSNAME}\] As type of information, use: - *Numeric (unsigned)* for metrics like 'free', 'total', 'used' - *Numeric (float)* for metrics like 'pfree', 'pused' (percentage) In the item prototype *Preprocessing* tab select *JSONPath* and use the following JSONPath expression as parameter: ```default $.[?(@.fsname=='{#FSNAME}')].bytes.free.first() ```  When discovery starts, one item per each mountpoint will be created. This item will return the number of free bytes for the given mountpoint. ##### Atkarīgā vienuma prototips Šajā LLD noteikumā izveidojiet vienuma prototipu ar tipu "Atkarīgais vienums". Kā šī prototipa galveno vienumu atlasiet `vfs.fs.get` vienumu, ko izveidojām.  Ņemiet vērā pielāgoto makro izmantošanu vienuma prototipa nosaukumā un atslēgā: - *Nosaukums*: Brīvā diska vieta uz {\#FSNAME}, tips: {\#FSTYPE} - *Atslēga*: Free\[{\#FSNAME}\] Kā informācijas tipu izmantojiet: - *Numeric (unsigned)* tādiem rādītājiem kā 'free', 'total', 'used' - *Numeric (float)* tādiem rādītājiem kā 'pfree', 'pused' (procenti) Vienuma prototipa cilnē *Preprocessing* atlasiet *JSONPath* un kā parametru izmantojiet šādu JSONPath izteiksmi: ```default $.[?(@.fsname=='{#FSNAME}')].bytes.free.first() ```  Kad atklāšana sākas, tiks izveidots viens vienums katram montēšanas punktam. Šis vienums atgriezīs brīvo baitu skaitu attiecīgajam montēšanas punktam. #### Dependent items To minimize the number of requests to the target entity, Zabbix allows the creation of master and dependent items. In this case, the master item collects a large set of information in a single request. Then dependent items can be configured to extract specific pieces of data from that collection via preprocessing and store them as individual metrics. For example, the master item might collect a JSON or XML response containing multiple metrics or execute a database query that returns multiple columns of data (e.g., number of open connections, aborted connections, maximum allowed simultaneous connections, and total cumulative connections since startup), and dependent items will parse and store each required value separately. The best practice for this configuration is to discard master item's history right after collection and only keep the dependent items data. #### Atkarīgie vienumi Lai samazinātu pieprasījumu skaitu uz mērķa entītiju, Zabbix ļauj izveidot galvenos un atkarīgos vienumus. Šādā gadījumā galvenais vienums vienā pieprasījumā apkopo lielu informācijas kopu. Pēc tam atkarīgos vienumus var konfigurēt tā, lai tie, izmantojot priekšapstrādi, no šīs kopas izvilktu konkrētas datu daļas un saglabātu tās kā atsevišķus metriskos datus. Piemēram, galvenais vienums varētu apkopot JSON vai XML atbildi, kas satur vairākus metriskos datus, vai izpildīt datubāzes vaicājumu, kas atgriež vairākas datu kolonnas (piem., atvērto savienojumu skaitu, pārtraukto savienojumu skaitu, maksimāli atļauto vienlaicīgo savienojumu skaitu un kopējo uzkrāto savienojumu skaitu kopš palaišanas), bet atkarīgie vienumi katru nepieciešamo vērtību parsēs un saglabās atsevišķi. Šīs konfigurācijas labākā prakse ir uzreiz pēc apkopošanas atmest galvenā vienuma vēsturi un saglabāt tikai atkarīgo vienumu datus. ##### Dependent LLD rule Create a low-level discovery rule as *Dependent item* type:  As master item select the `vfs.fs.get` item we created. In the *LLD macros* tab define custom macros with the corresponding JSONPath:  In the *Filters* tab you may add a regular expression that filters only **read-write** filesystems:  ##### Atkarīgais LLD noteikums Izveidojiet zema līmeņa atklāšanas noteikumu kā *Atkarīgā vienuma* tipu:  Kā galveno vienumu atlasiet izveidoto `vfs.fs.get` vienumu. Cilnē *LLD macros* definējiet pielāgotus makro ar atbilstošo JSONPath:  Cilnē *Filters* varat pievienot regulāro izteiksmi, kas filtrē tikai **read-write** failu sistēmas:  ##### Dependent LLD rule Create a low-level discovery rule as "Dependent item" type:  As master item select the `ipmi.get` item we created. In the "LLD macros" tab define a custom macro with the corresponding JSONPath:  ##### Atkarīgais LLD noteikums Izveidojiet zema līmeņa atklāšanas noteikumu ar tipu "Atkarīgais vienums":  Kā galveno vienumu atlasiet mūsu izveidoto `ipmi.get` vienumu. Cilnē "LLD makrosi" definējiet pielāgotu makrosu ar atbilstošo JSONPath:  # Deploy Zabbix in the cloud # Zabbix izvietošana mākonī #### Deploy Zabbix server (MySQL) with Java gateway This example shows how to deploy a Zabbix server with a MySQL backend, a Java gateway for [JMX monitoring](/manual/config/items/itemtypes/jmx_monitoring), and an Nginx-based web interface. 1\. Create a dedicated Docker network, so that all Zabbix component containers can reach each other by container name: ```bash docker network create --subnet 172.20.0.0/16 --ip-range 172.20.240.0/20 zabbix-net ``` 2\. Run an empty MySQL server container (replace `zabbix_pwd` and `root_pwd` with strong passwords, and use those values in the following steps): ```bash docker run --name mysql-server -t \ -e MYSQL_DATABASE="zabbix" \ -e MYSQL_USER="zabbix" \ -e MYSQL_PASSWORD="zabbix_pwd" \ -e MYSQL_ROOT_PASSWORD="root_pwd" \ --network=zabbix-net \ --restart unless-stopped \ -d mysql:8.0-oracle \ --character-set-server=utf8mb4 --collation-server=utf8mb4_bin ``` 3\. Follow the MySQL logs and wait until MySQL is ready for connections (use `Ctrl+C` to exit the logs): ```bash docker logs -f mysql-server # ... [Server] /usr/sbin/mysqld: ready for connections. ... ``` 4\. Run a Zabbix Java gateway container: ```bash docker run --name zabbix-java-gateway -t \ --network=zabbix-net \ --restart unless-stopped \ -d zabbix/zabbix-java-gateway:alpine-7.0-latest ``` 5\. Enable `log_bin_trust_function_creators` in the MySQL server container. This temporarily relaxes security restrictions on stored functions; the setting will be disabled in later steps. It allows the Zabbix database user to create stored functions without the `SUPER` privilege, which MySQL requires when [binary logging](https://dev.mysql.com/doc/refman/8.0/en/stored-programs-logging.html) is enabled (default since MySQL 8.0). Run the following command: ```bash docker exec -it mysql-server mysql -u root -p'root_pwd' \ -e "SET GLOBAL log_bin_trust_function_creators = 1;" ``` 6\. Run a Zabbix server container and link it to the Java Gateway and MySQL server containers: ```bash docker run --name zabbix-server-mysql -t \ -e DB_SERVER_HOST="mysql-server" \ -e MYSQL_DATABASE="zabbix" \ -e MYSQL_USER="zabbix" \ -e MYSQL_PASSWORD="zabbix_pwd" \ -e ZBX_JAVAGATEWAY="zabbix-java-gateway" \ --network=zabbix-net \ -p 10051:10051 \ --restart unless-stopped \ --init \ -d zabbix/zabbix-server-mysql:alpine-7.0-latest ``` 7\. Follow the Zabbix server logs and wait until Zabbix server has finished initializing the database schema (use `Ctrl+C` to exit the logs): ```bash docker logs -f zabbix-server-mysql # ... [info]: ** Creating 'zabbix' schema in MySQL # ... [info]: ** Database schema successfully created! ``` 8\. Disable `log_bin_trust_function_creators` in the MySQL server container. This re-enforces the security restriction that prevents non-SUPER users from creating stored functions. Run the following command: ```bash docker exec -it mysql-server mysql -u root -p'root_pwd' \ -e "SET GLOBAL log_bin_trust_function_creators = 0;" ``` 9\. Run a Zabbix web interface container and link it to the Zabbix server and MySQL server containers: ```bash docker run --name zabbix-web-nginx-mysql -t \ -e ZBX_SERVER_HOST="zabbix-server-mysql" \ -e DB_SERVER_HOST="mysql-server" \ -e MYSQL_DATABASE="zabbix" \ -e MYSQL_USER="zabbix" \ -e MYSQL_PASSWORD="zabbix_pwd" \ -e PHP_TZ="Europe/Riga" \ --network=zabbix-net \ -p 80:8080 \ --restart unless-stopped \ -d zabbix/zabbix-web-nginx-mysql:alpine-7.0-latest ``` After the containers are up and running, the Zabbix server starts and the web interface becomes available for [login](/manual/quickstart/basic_config/login#login). ::: noteclassic Use `docker ps` to check container status. All containers should have the `Up` status. If any show `Exited`, check their logs for errors with `docker logs -f <container-name>`. ::: #### Deploy Zabbix server (PostgreSQL) with SNMP traps This example shows how to deploy a Zabbix server with a PostgreSQL backend, [SNMP traps](/manual/config/items/itemtypes/snmptrap), and an Nginx-based web interface. 1\. Create a dedicated Docker network, so that all Zabbix component containers can reach each other by container name: ```bash docker network create --subnet 172.20.0.0/16 --ip-range 172.20.240.0/20 zabbix-net ``` 2\. Run an empty PostgreSQL server container (replace `zabbix_pwd` with a strong password, and use that value in the following steps): ```bash docker run --name postgres-server -t \ -e POSTGRES_USER="zabbix" \ -e POSTGRES_PASSWORD="zabbix_pwd" \ -e POSTGRES_DB="zabbix" \ --network=zabbix-net \ --restart unless-stopped \ -d postgres:latest ``` 3\. Run a Zabbix SNMP traps container: ```bash docker run --name zabbix-snmptraps -t \ -v /zbx_instance/snmptraps:/var/lib/zabbix/snmptraps:rw \ -v /var/lib/zabbix/mibs:/usr/share/snmp/mibs:ro \ --network=zabbix-net \ -p 162:1162/udp \ --restart unless-stopped \ -d zabbix/zabbix-snmptraps:alpine-7.0-latest ``` 4\. Run a Zabbix server container and link it to the PostgreSQL server and SNMP traps containers: ```bash docker run --name zabbix-server-pgsql -t \ -e DB_SERVER_HOST="postgres-server" \ -e POSTGRES_USER="zabbix" \ -e POSTGRES_PASSWORD="zabbix_pwd" \ -e POSTGRES_DB="zabbix" \ -e ZBX_ENABLE_SNMP_TRAPS="true" \ --network=zabbix-net \ -p 10051:10051 \ --volumes-from zabbix-snmptraps \ --restart unless-stopped \ --init \ -d zabbix/zabbix-server-pgsql:alpine-7.0-latest ``` 5\. Follow the Zabbix server logs and wait until Zabbix server has finished initializing the database schema (use `Ctrl+C` to exit the logs): ```bash docker logs -f zabbix-server-pgsql # ... [info]: ** Creating 'zabbix' schema in PostgreSQL # ... [info]: ** Database schema successfully created! ``` 6\. Run a Zabbix web interface container and link it to the Zabbix server and PostgreSQL server containers: ```bash docker run --name zabbix-web-nginx-pgsql -t \ -e ZBX_SERVER_HOST="zabbix-server-pgsql" \ -e DB_SERVER_HOST="postgres-server" \ -e POSTGRES_DB="zabbix" \ -e POSTGRES_USER="zabbix" \ -e POSTGRES_PASSWORD="zabbix_pwd" \ -e PHP_TZ="Europe/Riga" \ --network=zabbix-net \ -p 443:8443 \ -p 80:8080 \ -v /etc/ssl/nginx:/etc/ssl/nginx:ro \ --restart unless-stopped \ -d zabbix/zabbix-web-nginx-pgsql:alpine-7.0-latest ``` After the containers are up and running, the Zabbix server starts and the web interface becomes available for [login](/manual/quickstart/basic_config/login#login). ::: noteclassic Use `docker ps` to check container status. All containers should have the `Up` status. If any show `Exited`, check their logs for errors with `docker logs -f <container-name>`. ::: #### Deploy Zabbix server (MySQL) with Java gateway on RHEL 8–10 This example shows how to deploy a Zabbix server with a MySQL backend, a Java gateway for [JMX monitoring](/manual/config/items/itemtypes/jmx_monitoring), and an Nginx-based web interface, all running on Red Hat Enterprise Linux 8, 9, or 10. On Red Hat Enterprise Linux, the recommended container runtime is Podman instead of Docker. Podman works similarly to Docker but does not require a background service running as root, which makes it a better fit for Red Hat environments. 1\. Create a new pod with the name `zabbix` and exposed ports for Zabbix web interface and Zabbix server trapper: ```bash podman pod create --name zabbix -p 80:8080 -p 10051:10051 ``` 2\. (Optional) Run a Zabbix agent container in the `zabbix` pod location: ```bash podman run --name zabbix-agent \ -e ZBX_SERVER_HOST="127.0.0.1,localhost" \ --restart=always \ --pod=zabbix \ -d registry.connect.redhat.com/zabbix/zabbix-agent-70:latest ``` 3\. Create a `./mysql/` directory on the RHEL host: ```bash mkdir -p ./mysql ``` 4\. Run an empty MySQL server container (replace `zabbix_pwd` and `root_pwd` with strong passwords, and use those values in the following steps): ```bash podman run --name mysql-server -t \ -e MYSQL_DATABASE="zabbix" \ -e MYSQL_USER="zabbix" \ -e MYSQL_PASSWORD="zabbix_pwd" \ -e MYSQL_ROOT_PASSWORD="root_pwd" \ -v ./mysql/:/var/lib/mysql/:Z \ --restart=always \ --pod=zabbix \ -d mysql:8.0 \ --character-set-server=utf8mb4 --collation-server=utf8mb4_bin ``` 5\. Follow the MySQL logs and wait until MySQL is ready for connections (use `Ctrl+C` to exit the logs): ```bash podman logs -f mysql-server # ... [Server] /usr/sbin/mysqld: ready for connections. ... ``` 6\. Run a Zabbix Java gateway container: ```bash podman run --name zabbix-java-gateway -t \ --restart=always \ --pod=zabbix \ -d registry.connect.redhat.com/zabbix/zabbix-java-gateway-70 ``` 7\. Enable `log_bin_trust_function_creators` in the MySQL server container. This temporarily relaxes security restrictions on stored functions; the setting will be disabled in later steps. It allows the Zabbix database user to create stored functions without the `SUPER` privilege, which MySQL requires when [binary logging](https://dev.mysql.com/doc/refman/8.0/en/stored-programs-logging.html) is enabled (default since MySQL 8.0). Run the following command: ```bash podman exec -it mysql-server mysql -u root -p'root_pwd' \ -e "SET GLOBAL log_bin_trust_function_creators = 1;" ``` 8\. Run a Zabbix server container and link it to the Java Gateway and MySQL server containers: ```bash podman run --name zabbix-server-mysql -t \ -e DB_SERVER_HOST="127.0.0.1" \ -e MYSQL_DATABASE="zabbix" \ -e MYSQL_USER="zabbix" \ -e MYSQL_PASSWORD="zabbix_pwd" \ -e ZBX_JAVAGATEWAY="127.0.0.1" \ --restart=always \ --init \ --pod=zabbix \ -d registry.connect.redhat.com/zabbix/zabbix-server-mysql-70 ``` 9\. Follow the Zabbix server logs and wait until Zabbix server has finished initializing the database schema (use `Ctrl+C` to exit the logs): ```bash podman logs -f zabbix-server-mysql # ... [info]: ** Creating 'zabbix' schema in MySQL # ... [info]: ** Database schema successfully created! ``` 10\. Disable `log_bin_trust_function_creators` in the MySQL server container. This re-enforces the security restriction that prevents non-SUPER users from creating stored functions. Run the following command: ```bash podman exec -it mysql-server mysql -u root -p'root_pwd' \ -e "SET GLOBAL log_bin_trust_function_creators = 0;" ``` 11\. Run a Zabbix web interface container and link it to the Zabbix server and MySQL server containers: ```bash podman run --name zabbix-web-mysql -t \ -e ZBX_SERVER_HOST="127.0.0.1" \ -e DB_SERVER_HOST="127.0.0.1" \ -e MYSQL_DATABASE="zabbix" \ -e MYSQL_USER="zabbix" \ -e MYSQL_PASSWORD="zabbix_pwd" \ -e PHP_TZ="Europe/Riga" \ --restart=always \ --pod=zabbix \ -d registry.connect.redhat.com/zabbix/zabbix-web-mysql-70 ``` ::: noteclassic Pod `zabbix` exposes `80/TCP` port (HTTP) to the host machine from `8080/TCP` of `zabbix-web-mysql` container. ::: After the containers are up and running, the Zabbix server starts and the web interface becomes available for [login](/manual/quickstart/basic_config/login#login). ::: noteclassic Use `docker ps` to check container status. All containers should have the `Up` status. If any show `Exited`, check their logs for errors with `docker logs -f <container-name>`. ::: #### Zabbix servera izvietošana (MySQL) ar Java gateway Šis piemērs parāda, kā izvietot Zabbix serveri ar MySQL aizmugursistēmu, Java gateway [JMX monitoringam](/manual/config/items/itemtypes/jmx_monitoring) un uz Nginx balstītu lietotāja saskarni. 1\. Izveidojiet atsevišķu Docker tīklu, lai visi Zabbix komponentu konteineri varētu sasniegt cits citu pēc konteinera nosaukuma: ```bash docker network create --subnet 172.20.0.0/16 --ip-range 172.20.240.0/20 zabbix-net ``` 2\. Palaidiet tukšu MySQL servera konteineru (aizstājiet `zabbix_pwd` un `root_pwd` ar drošām parolēm un izmantojiet šīs vērtības turpmākajās darbībās): ```bash docker run --name mysql-server -t \ -e MYSQL_DATABASE="zabbix" \ -e MYSQL_USER="zabbix" \ -e MYSQL_PASSWORD="zabbix_pwd" \ -e MYSQL_ROOT_PASSWORD="root_pwd" \ --network=zabbix-net \ --restart unless-stopped \ -d mysql:8.0-oracle \ --character-set-server=utf8mb4 --collation-server=utf8mb4_bin ``` 3\. Sekojiet MySQL žurnāliem un gaidiet, līdz MySQL ir gatavs savienojumiem (izmantojiet `Ctrl+C`, lai izietu no žurnālu skatīšanas): ```bash docker logs -f mysql-server # ... [Server] /usr/sbin/mysqld: ready for connections. ... ``` 4\. Palaidiet Zabbix Java gateway konteineru: ```bash docker run --name zabbix-java-gateway -t \ --network=zabbix-net \ --restart unless-stopped \ -d zabbix/zabbix-java-gateway:alpine-7.0-latest ``` 5\. Iespējojiet `log_bin_trust_function_creators` MySQL servera konteinerā. Tas uz laiku atslābina drošības ierobežojumus saglabātajām funkcijām; vēlāk šis iestatījums tiks atspējots. Tas ļauj Zabbix datubāzes lietotājam izveidot saglabātās funkcijas bez `SUPER` privilēģijas, kas MySQL ir nepieciešama, ja ir iespējota [binārā žurnalēšana](https://dev.mysql.com/doc/refman/8.0/en/stored-programs-logging.html) (pēc noklusējuma kopš MySQL 8.0). Palaidiet šādu komandu: ```bash docker exec -it mysql-server mysql -u root -p'root_pwd' \ -e "SET GLOBAL log_bin_trust_function_creators = 1;" ``` 6\. Palaidiet Zabbix servera konteineru un savienojiet to ar Java Gateway un MySQL servera konteineriem: ```bash docker run --name zabbix-server-mysql -t \ -e DB_SERVER_HOST="mysql-server" \ -e MYSQL_DATABASE="zabbix" \ -e MYSQL_USER="zabbix" \ -e MYSQL_PASSWORD="zabbix_pwd" \ -e ZBX_JAVAGATEWAY="zabbix-java-gateway" \ --network=zabbix-net \ -p 10051:10051 \ --restart unless-stopped \ --init \ -d zabbix/zabbix-server-mysql:alpine-7.0-latest ``` 7\. Sekojiet Zabbix servera žurnāliem un gaidiet, līdz Zabbix serveris ir pabeidzis datubāzes shēmas inicializēšanu (izmantojiet `Ctrl+C`, lai izietu no žurnālu skatīšanas): ```bash docker logs -f zabbix-server-mysql # ... [info]: ** Creating 'zabbix' schema in MySQL # ... [info]: ** Database schema successfully created! ``` 8\. Atspējojiet `log_bin_trust_function_creators` MySQL servera konteinerā. Tas atjauno drošības ierobežojumu, kas neļauj lietotājiem bez `SUPER` privilēģijas veidot saglabātās funkcijas. Palaidiet šādu komandu: ```bash docker exec -it mysql-server mysql -u root -p'root_pwd' \ -e "SET GLOBAL log_bin_trust_function_creators = 0;" ``` 9\. Palaidiet Zabbix lietotāja saskarnes konteineru un savienojiet to ar Zabbix servera un MySQL servera konteineriem: ```bash docker run --name zabbix-web-nginx-mysql -t \ -e ZBX_SERVER_HOST="zabbix-server-mysql" \ -e DB_SERVER_HOST="mysql-server" \ -e MYSQL_DATABASE="zabbix" \ -e MYSQL_USER="zabbix" \ -e MYSQL_PASSWORD="zabbix_pwd" \ -e PHP_TZ="Europe/Riga" \ --network=zabbix-net \ -p 80:8080 \ --restart unless-stopped \ -d zabbix/zabbix-web-nginx-mysql:alpine-7.0-latest ``` Kad konteineri ir palaisti un darbojas, Zabbix serveris startējas un lietotāja saskarne kļūst pieejama [pieteikšanās](/manual/quickstart/basic_config/login#login) veikšanai. ::: noteclassic Izmantojiet `docker ps`, lai pārbaudītu konteineru statusu. Visiem konteineriem jābūt statusā `Up`. Ja kāds rāda `Exited`, pārbaudiet tā žurnālus, lai atrastu kļūdas, izmantojot `docker logs -f <container-name>`. ::: #### Zabbix servera izvietošana (PostgreSQL) ar SNMP trapām Šis piemērs parāda, kā izvietot Zabbix serveri ar PostgreSQL aizmugursistēmu, [SNMP trapām](/manual/config/items/itemtypes/snmptrap) un uz Nginx balstītu lietotāja saskarni. 1\. Izveidojiet atsevišķu Docker tīklu, lai visi Zabbix komponentu konteineri varētu sasniegt cits citu pēc konteinera nosaukuma: ```bash docker network create --subnet 172.20.0.0/16 --ip-range 172.20.240.0/20 zabbix-net ``` 2\. Palaidiet tukšu PostgreSQL servera konteineru (aizstājiet `zabbix_pwd` ar drošu paroli un izmantojiet šo vērtību turpmākajās darbībās): ```bash docker run --name postgres-server -t \ -e POSTGRES_USER="zabbix" \ -e POSTGRES_PASSWORD="zabbix_pwd" \ -e POSTGRES_DB="zabbix" \ --network=zabbix-net \ --restart unless-stopped \ -d postgres:latest ``` 3\. Palaidiet Zabbix SNMP trapu konteineru: ```bash docker run --name zabbix-snmptraps -t \ -v /zbx_instance/snmptraps:/var/lib/zabbix/snmptraps:rw \ -v /var/lib/zabbix/mibs:/usr/share/snmp/mibs:ro \ --network=zabbix-net \ -p 162:1162/udp \ --restart unless-stopped \ -d zabbix/zabbix-snmptraps:alpine-7.0-latest ``` 4\. Palaidiet Zabbix servera konteineru un savienojiet to ar PostgreSQL servera un SNMP trapu konteineriem: ```bash docker run --name zabbix-server-pgsql -t \ -e DB_SERVER_HOST="postgres-server" \ -e POSTGRES_USER="zabbix" \ -e POSTGRES_PASSWORD="zabbix_pwd" \ -e POSTGRES_DB="zabbix" \ -e ZBX_ENABLE_SNMP_TRAPS="true" \ --network=zabbix-net \ -p 10051:10051 \ --volumes-from zabbix-snmptraps \ --restart unless-stopped \ --init \ -d zabbix/zabbix-server-pgsql:alpine-7.0-latest ``` 5\. Sekojiet Zabbix servera žurnāliem un gaidiet, līdz Zabbix serveris ir pabeidzis datubāzes shēmas inicializēšanu (izmantojiet `Ctrl+C`, lai izietu no žurnālu skatīšanas): ```bash docker logs -f zabbix-server-pgsql # ... [info]: ** Creating 'zabbix' schema in PostgreSQL # ... [info]: ** Database schema successfully created! ``` 6\. Palaidiet Zabbix lietotāja saskarnes konteineru un savienojiet to ar Zabbix servera un PostgreSQL servera konteineriem: ```bash docker run --name zabbix-web-nginx-pgsql -t \ -e ZBX_SERVER_HOST="zabbix-server-pgsql" \ -e DB_SERVER_HOST="postgres-server" \ -e POSTGRES_DB="zabbix" \ -e POSTGRES_USER="zabbix" \ -e POSTGRES_PASSWORD="zabbix_pwd" \ -e PHP_TZ="Europe/Riga" \ --network=zabbix-net \ -p 443:8443 \ -p 80:8080 \ -v /etc/ssl/nginx:/etc/ssl/nginx:ro \ --restart unless-stopped \ -d zabbix/zabbix-web-nginx-pgsql:alpine-7.0-latest ``` Kad konteineri ir palaisti un darbojas, Zabbix serveris startējas un lietotāja saskarne kļūst pieejama [pieteikšanās](/manual/quickstart/basic_config/login#login) veikšanai. ::: noteclassic Izmantojiet `docker ps`, lai pārbaudītu konteineru statusu. Visiem konteineriem jābūt statusā `Up`. Ja kāds rāda `Exited`, pārbaudiet tā žurnālus, lai atrastu kļūdas, izmantojot `docker logs -f <container-name>`. ::: #### Zabbix servera izvietošana (MySQL) ar Java gateway uz RHEL 8–10 Šis piemērs parāda, kā izvietot Zabbix serveri ar MySQL aizmugursistēmu, Java gateway [JMX monitoringam](/manual/config/items/itemtypes/jmx_monitoring) un uz Nginx balstītu lietotāja saskarni, kas darbojas uz Red Hat Enterprise Linux 8, 9 vai 10. Uz Red Hat Enterprise Linux ieteicamais konteineru izpildlaiks ir Podman, nevis Docker. Podman darbojas līdzīgi Docker, taču tam nav nepieciešams fonā darbojošs pakalpojums ar root tiesībām, tāpēc tas labāk atbilst Red Hat videi. 1\. Izveidojiet jaunu podu ar nosaukumu `zabbix` un atvērtām pieslēgvietām Zabbix lietotāja saskarnei un Zabbix servera trapperim: ```bash podman pod create --name zabbix -p 80:8080 -p 10051:10051 ``` 2\. (Neobligāti) Palaidiet Zabbix aģenta konteineru `zabbix` poda ietvaros: ```bash podman run --name zabbix-agent \ -e ZBX_SERVER_HOST="127.0.0.1,localhost" \ --restart=always \ --pod=zabbix \ -d registry.connect.redhat.com/zabbix/zabbix-agent-70:latest ``` 3\. Izveidojiet `./mysql/` direktoriju RHEL resursdatorā: ```bash mkdir -p ./mysql ``` 4\. Palaidiet tukšu MySQL servera konteineru (aizstājiet `zabbix_pwd` un `root_pwd` ar drošām parolēm un izmantojiet šīs vērtības turpmākajās darbībās): ```bash podman run --name mysql-server -t \ -e MYSQL_DATABASE="zabbix" \ -e MYSQL_USER="zabbix" \ -e MYSQL_PASSWORD="zabbix_pwd" \ -e MYSQL_ROOT_PASSWORD="root_pwd" \ -v ./mysql/:/var/lib/mysql/:Z \ --restart=always \ --pod=zabbix \ -d mysql:8.0 \ --character-set-server=utf8mb4 --collation-server=utf8mb4_bin ``` 5\. Sekojiet MySQL žurnāliem un gaidiet, līdz MySQL ir gatavs savienojumiem (izmantojiet `Ctrl+C`, lai izietu no žurnālu skatīšanas): ```bash podman logs -f mysql-server # ... [Server] /usr/sbin/mysqld: ready for connections. ... ``` 6\. Palaidiet Zabbix Java gateway konteineru: ```bash podman run --name zabbix-java-gateway -t \ --restart=always \ --pod=zabbix \ -d registry.connect.redhat.com/zabbix/zabbix-java-gateway-70 ``` 7\. Iespējojiet `log_bin_trust_function_creators` MySQL servera konteinerā. Tas uz laiku atslābina drošības ierobežojumus saglabātajām funkcijām; vēlāk šis iestatījums tiks atspējots. Tas ļauj Zabbix datubāzes lietotājam izveidot saglabātās funkcijas bez `SUPER` privilēģijas, kas MySQL ir nepieciešama, ja ir iespējota [binārā žurnalēšana](https://dev.mysql.com/doc/refman/8.0/en/stored-programs-logging.html) (pēc noklusējuma kopš MySQL 8.0). Palaidiet šādu komandu: ```bash podman exec -it mysql-server mysql -u root -p'root_pwd' \ -e "SET GLOBAL log_bin_trust_function_creators = 1;" ``` 8\. Palaidiet Zabbix servera konteineru un savienojiet to ar Java Gateway un MySQL servera konteineriem: ```bash podman run --name zabbix-server-mysql -t \ -e DB_SERVER_HOST="127.0.0.1" \ -e MYSQL_DATABASE="zabbix" \ -e MYSQL_USER="zabbix" \ -e MYSQL_PASSWORD="zabbix_pwd" \ -e ZBX_JAVAGATEWAY="127.0.0.1" \ --restart=always \ --init \ --pod=zabbix \ -d registry.connect.redhat.com/zabbix/zabbix-server-mysql-70 ``` 9\. Sekojiet Zabbix servera žurnāliem un gaidiet, līdz Zabbix serveris ir pabeidzis datubāzes shēmas inicializēšanu (izmantojiet `Ctrl+C`, lai izietu no žurnālu skatīšanas): ```bash podman logs -f zabbix-server-mysql # ... [info]: ** Creating 'zabbix' schema in MySQL # ... [info]: ** Database schema successfully created! ``` 10\. Atspējojiet `log_bin_trust_function_creators` MySQL servera konteinerā. Tas atjauno drošības ierobežojumu, kas neļauj lietotājiem bez `SUPER` privilēģijas veidot saglabātās funkcijas. Palaidiet šādu komandu: ```bash podman exec -it mysql-server mysql -u root -p'root_pwd' \ -e "SET GLOBAL log_bin_trust_function_creators = 0;" ``` 11\. Palaidiet Zabbix lietotāja saskarnes konteineru un savienojiet to ar Zabbix servera un MySQL servera konteineriem: ```bash podman run --name zabbix-web-mysql -t \ -e ZBX_SERVER_HOST="127.0.0.1" \ -e DB_SERVER_HOST="127.0.0.1" \ -e MYSQL_DATABASE="zabbix" \ -e MYSQL_USER="zabbix" \ -e MYSQL_PASSWORD="zabbix_pwd" \ -e PHP_TZ="Europe/Riga" \ --restart=always \ --pod=zabbix \ -d registry.connect.redhat.com/zabbix/zabbix-web-mysql-70 ``` ::: noteclassic Pods `zabbix` atklāj `80/TCP` portu (HTTP) resursdatorā no `zabbix-web-mysql` konteinera `8080/TCP`. ::: Kad konteineri ir palaisti un darbojas, Zabbix serveris startējas un lietotāja saskarne kļūst pieejama [pieteikšanās](/manual/quickstart/basic_config/login#login) veikšanai. ::: noteclassic Izmantojiet `docker ps`, lai pārbaudītu konteineru statusu. Visiem konteineriem jābūt statusā `Up`. Ja kāds rāda `Exited`, pārbaudiet tā žurnālus, lai atrastu kļūdas, izmantojot `docker logs -f <container-name>`. ::: ### Description `array configuration.importcompare(object parameters)` This method allows to compare import file with current system elements and shows what will be changed if this import file will be imported. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `array configuration.importcompare(object parameters)` Šī metode ļauj salīdzināt importēšanas failu ar pašreizējiem sistēmas elementiem un parāda, kas tiks mainīts, ja šis importēšanas fails tiks importēts. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `boolean configuration.import(object parameters)` This method allows to import configuration data from a serialized string. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `boolean configuration.import(object parameters)` Šī metode ļauj importēt konfigurācijas datus no serializētas virknes. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `integer/array action.get(object parameters)` The method allows to retrieve actions according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `integer/array action.get(object parameters)` Metode ļauj izgūt darbības atbilstoši norādītajiem parametriem. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `integer/array alert.get(object parameters)` The method allows to retrieve alerts according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `integer/array alert.get(object parameters)` Šī metode ļauj izgūt brīdinājumus atbilstoši norādītajiem parametriem. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `integer/array auditlog.get(object parameters)` The method allows to retrieve audit log records according to the given parameters. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `integer/array auditlog.get(object parameters)` Šī metode ļauj izgūt audita žurnāla ierakstus atbilstoši norādītajiem parametriem. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `integer/array connector.get(object parameters)` The method allows to retrieve connector objects according to the given parameters. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `integer/array connector.get(object parameters)` Metode ļauj izgūt savienotāja objektus atbilstoši norādītajiem parametriem. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `integer/array correlation.get(object parameters)` The method allows to retrieve correlations according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `integer/array correlation.get(object parameters)` Metode ļauj izgūt korelācijas atbilstoši norādītajiem parametriem. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāju lomu iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `integer/array dashboard.get(object parameters)` The method allows to retrieve dashboards according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `integer/array dashboard.get(object parameters)` Metode ļauj izgūt paneļus atbilstoši norādītajiem parametriem. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `integer/array dcheck.get(object parameters)` The method allows to retrieve discovery checks according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `integer/array dcheck.get(object parameters)` Metode ļauj izgūt atklāšanas pārbaudes atbilstoši norādītajiem parametriem. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `integer/array dhost.get(object parameters)` The method allows to retrieve discovered hosts according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `integer/array dhost.get(object parameters)` Metode ļauj izgūt atklātos hostus atbilstoši norādītajiem parametriem. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles), lai iegūtu vairāk informācijas. ::: ### Description `integer/array discoveryrule.get(object parameters)` The method allows to retrieve LLD rules according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `integer/array discoveryrule.get(object parameters)` Šī metode ļauj izgūt LLD noteikumus atbilstoši norādītajiem parametriem. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Tiesības izsaukt šo metodi var atsaukt lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `integer/array drule.get(object parameters)` The method allows to retrieve discovery rules according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `integer/array drule.get(object parameters)` Metode ļauj izgūt atklāšanas kārtulas atbilstoši norādītajiem parametriem. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `integer/array dservice.get(object parameters)` The method allows to retrieve discovered services according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `integer/array dservice.get(object parameters)` Metode ļauj izgūt atklātos servisus atbilstoši norādītajiem parametriem. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `integer/array event.get(object parameters)` The method allows to retrieve events according to the given parameters. ::: noteimportant This method may return events of a deleted entity if these events have not been removed by the housekeeper yet. ::: ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `integer/array event.get(object parameters)` Metode ļauj izgūt notikumus atbilstoši norādītajiem parametriem. ::: noteimportant Šī metode var atgriezt dzēstas entītijas notikumus, ja šie notikumi vēl nav noņemti ar housekeeper. ::: ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `integer/array graph.get(object parameters)` The method allows to retrieve graphs according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `integer/array graph.get(object parameters)` Šī metode ļauj izgūt grafikus atbilstoši norādītajiem parametriem. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `integer/array graphitem.get(object parameters)` The method allows to retrieve graph items according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `integer/array graphitem.get(object parameters)` Metode ļauj izgūt grafiku vienumus atbilstoši norādītajiem parametriem. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `integer/array graphprototype.get(object parameters)` The method allows to retrieve graph prototypes according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `integer/array graphprototype.get(object parameters)` Metode ļauj izgūt grafiku prototipus atbilstoši norādītajiem parametriem. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `integer/array hanode.get(object parameters)` The method allows to retrieve a list of High availability cluster nodes according to the given parameters. ::: noteclassic This method is only available to *Super admin* user types. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `integer/array hanode.get(object parameters)` Metode ļauj izgūt Augstas pieejamības klastera mezglu sarakstu atbilstoši norādītajiem parametriem. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāju tipiem. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `integer/array history.get(object parameters)` The method allows to retrieve history data according to the given parameters. ::: noteimportant This method may return historical data of a deleted entity if this data has not been removed by the housekeeper yet. ::: ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `integer/array history.get(object parameters)` Metode ļauj izgūt vēstures datus atbilstoši norādītajiem parametriem. ::: noteimportant Šī metode var atgriezt dzēstas entītijas vēsturiskos datus, ja housekeeper šos datus vēl nav noņēmis. ::: ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `integer/array host.get(object parameters)` The method allows to retrieve hosts according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `integer/array host.get(object parameters)` Šī metode ļauj iegūt hostus atbilstoši norādītajiem parametriem. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `integer/array hostgroup.get(object parameters)` The method allows to retrieve host groups according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `integer/array hostgroup.get(object parameters)` Metode ļauj izgūt hostu grupas atbilstoši norādītajiem parametriem. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `integer/array hostinterface.get(object parameters)` The method allows to retrieve host interfaces according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `integer/array hostinterface.get(object parameters)` Metode ļauj izgūt hostu saskarnes atbilstoši norādītajiem parametriem. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `integer/array hostprototype.get(object parameters)` The method allows to retrieve host prototypes according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `integer/array hostprototype.get(object parameters)` Metode ļauj izgūt hostu prototipus atbilstoši norādītajiem parametriem. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Tiesības izsaukt šo metodi var atsaukt lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `integer/array httptest.get(object parameters)` The method allows to retrieve web scenarios according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `integer/array httptest.get(object parameters)` Metode ļauj izgūt tīmekļa scenārijus atbilstoši norādītajiem parametriem. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `integer/array iconmap.get(object parameters)` The method allows to retrieve icon maps according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `integer/array iconmap.get(object parameters)` Metode ļauj izgūt ikonu kartes atbilstoši norādītajiem parametriem. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāju lomu iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `integer/array image.get(object parameters)` The method allows to retrieve images according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `integer/array image.get(object parameters)` Šī metode ļauj izgūt attēlus atbilstoši norādītajiem parametriem. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāju lomu iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `integer/array item.get(object parameters)` The method allows to retrieve items according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `integer/array item.get(object parameters)` Šī metode ļauj izgūt vienumus atbilstoši norādītajiem parametriem. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Tiesības izsaukt šo metodi var atsaukt lietotāja lomas iestatījumos. Skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles), lai iegūtu papildu informāciju. ::: ### Description `integer/array itemprototype.get(object parameters)` The method allows to retrieve item prototypes according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `integer/array itemprototype.get(object parameters)` Metode ļauj izgūt vienumu prototipus atbilstoši norādītajiem parametriem. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `integer/array maintenance.get(object parameters)` The method allows to retrieve maintenances according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `integer/array maintenance.get(object parameters)` Metode ļauj izgūt uzturēšanas atbilstoši norādītajiem parametriem. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `integer/array map.get(object parameters)` The method allows to retrieve maps according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `integer/array map.get(object parameters)` Šī metode ļauj izgūt kartes atbilstoši norādītajiem parametriem. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `integer/array mediatype.get(object parameters)` The method allows to retrieve media types according to the given parameters. ::: noteclassic This method is available to users of any type (to *User* type users since Zabbix 7.0.6). Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `integer/array mediatype.get(object parameters)` Metode ļauj izgūt mediju tipus atbilstoši norādītajiem parametriem. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem (lietotājiem ar *User* tipu kopš Zabbix 7.0.6). Atļaujas izsaukt šo metodi var atsaukt lietotāju lomu iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `integer/array mfa.get(object parameters)` The method allows to retrieve MFA methods according to the given parameters. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `integer/array mfa.get(object parameters)` Metode ļauj izgūt MFA metodes atbilstoši norādītajiem parametriem. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `integer/array module.get(object parameters)` The method allows to retrieve modules according to the given parameters. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `integer/array module.get(object parameters)` Metode ļauj izgūt moduļus atbilstoši norādītajiem parametriem. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `integer/array problem.get(object parameters)` The method allows to retrieve problems according to the given parameters. This method is for retrieving unresolved problems. It is also possible, if specified, to additionally retrieve recently resolved problems. The period that determines how old is "recently" is defined in *Administration* → *[General](/manual/web_interface/frontend_sections/administration/general#trigger-displaying-options)*. Problems that were resolved prior to that period are not kept in the problem table. To retrieve problems that were resolved further back in the past, use the [`event.get`](/manual/api/reference/event/get) method. ::: noteimportant This method may return problems of a deleted entity if these problems have not been removed by the housekeeper yet. ::: ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `integer/array problem.get(object parameters)` Metode ļauj izgūt problēmas atbilstoši norādītajiem parametriem. Šī metode ir paredzēta neatrisinātu problēmu izgūšanai. Ir arī iespējams, ja tas ir norādīts, papildus izgūt nesen atrisinātas problēmas. Periods, kas nosaka, cik sens ir “nesen”, ir definēts sadaļā *Administrēšana* → *[Vispārīgi](/manual/web_interface/frontend_sections/administration/general#trigger-displaying-options)*. Problēmas, kas tika atrisinātas pirms šī perioda, netiek glabātas problēmu tabulā. Lai izgūtu problēmas, kas tika atrisinātas vēl senākā pagātnē, izmantojiet metodi [`event.get`](/manual/api/reference/event/get). ::: noteimportant Šī metode var atgriezt dzēstas entītijas problēmas, ja housekeeper tās vēl nav noņēmis. ::: ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var atsaukt lietotāju lomu iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `integer/array proxy.get(object parameters)` The method allows to retrieve proxies according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `integer/array proxy.get(object parameters)` Metode ļauj izgūt starpniekserverus atbilstoši norādītajiem parametriem. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [User roles](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `integer/array proxygroup.get(object parameters)` The method allows to retrieve proxy groups according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `integer/array proxygroup.get(object parameters)` Šī metode ļauj izgūt starpniekserveru grupas atbilstoši norādītajiem parametriem. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [User roles](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `integer/array regexp.get(object parameters)` The method allows to retrieve global regular expressions according to the given parameters. ::: noteclassic This method is available only to *Super Admin*. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `integer/array regexp.get(object parameters)` Metode ļauj izgūt globālās regulārās izteiksmes atbilstoši norādītajiem parametriem. ::: noteclassic Šī metode ir pieejama tikai *Super Admin*. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `integer/array report.get(object parameters)` The method allows to retrieve scheduled reports according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `integer/array report.get(object parameters)` Metode ļauj izgūt ieplānotos pārskatus atbilstoši norādītajiem parametriem. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `integer/array role.get(object parameters)` The method allows to retrieve roles according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `integer/array role.get(object parameters)` Metode ļauj izgūt lomas atbilstoši norādītajiem parametriem. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `integer/array script.get(object parameters)` The method allows to retrieve scripts according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `integer/array script.get(object parameters)` Šī metode ļauj izgūt skriptus atbilstoši norādītajiem parametriem. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `integer/array service.get(object parameters)` The method allows to retrieve services according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `integer/array service.get(object parameters)` Metode ļauj izgūt pakalpojumus atbilstoši norādītajiem parametriem. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `integer/array sla.get(object parameters)` The method allows to retrieve SLA objects according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `integer/array sla.get(object parameters)` Metode ļauj izgūt SLA objektus atbilstoši norādītajiem parametriem. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `integer/array task.get(object parameters)` The method allows to retrieve tasks according to the given parameters. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `integer/array task.get(object parameters)` Metode ļauj izgūt uzdevumus atbilstoši norādītajiem parametriem. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `integer/array templatedashboard.get(object parameters)` The method allows to retrieve template dashboards according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `integer/array templatedashboard.get(object parameters)` Metode ļauj izgūt veidņu paneļus atbilstoši norādītajiem parametriem. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāju lomu iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `integer/array template.get(object parameters)` The method allows to retrieve templates according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `integer/array template.get(object parameters)` Šī metode ļauj izgūt veidnes atbilstoši norādītajiem parametriem. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Tiesības izsaukt šo metodi var atsaukt lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāja lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `integer/array templategroup.get(object parameters)` The method allows to retrieve template groups according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `integer/array templategroup.get(object parameters)` Metode ļauj izgūt veidņu grupas atbilstoši norādītajiem parametriem. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `integer/array token.get(object parameters)` The method allows to retrieve tokens according to the given parameters. ::: noteclassic Only *Super admin* user type is allowed to view tokens for other users. ::: ### Apraksts `integer/array token.get(object parameters)` Metode ļauj izgūt tokenus atbilstoši norādītajiem parametriem. ::: noteclassic Tikai *Super admin* lietotāja tipam ir atļauts skatīt citu lietotāju tokenus. ::: ### Description `integer/array trend.get(object parameters)` The method allows to retrieve trend data according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `integer/array trend.get(object parameters)` Šī metode ļauj izgūt tendenču datus atbilstoši norādītajiem parametriem. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `integer/array trigger.get(object parameters)` The method allows to retrieve triggers according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `integer/array trigger.get(object parameters)` Šī metode ļauj izgūt trigerus atbilstoši norādītajiem parametriem. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Tiesības izsaukt šo metodi var atsaukt lietotāja lomas iestatījumos. Plašāka informācija ir pieejama sadaļā [User roles](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `integer/array triggerprototype.get(object parameters)` The method allows to retrieve trigger prototypes according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `integer/array triggerprototype.get(object parameters)` Šī metode ļauj izgūt trigeru prototipus atbilstoši norādītajiem parametriem. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Tiesības izsaukt šo metodi var atsaukt lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāja lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `integer/array userdirectory.get(object parameters)` The method allows to retrieve user directories according to the given parameters. ::: noteclassic This method is only available to *Super admin* user types. ::: ### Apraksts `integer/array userdirectory.get(object parameters)` Metode ļauj izgūt lietotāju direktorijus atbilstoši norādītajiem parametriem. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāju tipiem. ::: ### Description `integer/array user.get(object parameters)` The method allows to retrieve users according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `integer/array user.get(object parameters)` Metode ļauj izgūt lietotājus atbilstoši norādītajiem parametriem. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `integer/array usergroup.get(object parameters)` The method allows to retrieve user groups according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `integer/array usergroup.get(object parameters)` Metode ļauj iegūt lietotāju grupas atbilstoši norādītajiem parametriem. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `integer/array usermacro.get(object parameters)` The method allows to retrieve host and global macros according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `integer/array usermacro.get(object parameters)` Metode ļauj izgūt hosta un globālos makrosus atbilstoši norādītajiem parametriem. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `integer/array valuemap.get(object parameters)` The method allows to retrieve value maps according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `integer/array valuemap.get(object parameters)` Šī metode ļauj izgūt vērtību kartes atbilstoši norādītajiem parametriem. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### description Module description. *Type*: String *Example*: ```json "description": "This is a clock widget." ``` ### apraksts Moduļa apraksts. *Type*: String *Piemērs*: ```json "description": "This is a clock widget." ``` ### Description `object action.create(object/array actions)` This method allows to create new actions. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object action.create(object/array actions)` Šī metode ļauj izveidot jaunas darbības. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object action.delete(array actionIds)` This method allows to delete actions. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object action.delete(array actionIds)` Šī metode ļauj dzēst darbības. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object action.update(object/array actions)` This method allows to update existing actions. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object action.update(object/array actions)` Šī metode ļauj atjaunināt esošās darbības. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object authentication.get(object parameters)` The method allows to retrieve authentication object according to the given parameters. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object authentication.get(object parameters)` Metode ļauj izgūt autentifikācijas objektu atbilstoši norādītajiem parametriem. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object authentication.update(object authentication)` This method allows to update existing authentication settings. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object authentication.update(object authentication)` Šī metode ļauj atjaunināt esošos autentifikācijas iestatījumus. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object autoregistration.get(object parameters)` The method allows to retrieve autoregistration object according to the given parameters. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object autoregistration.get(object parameters)` Šī metode ļauj izgūt automātiskās reģistrācijas objektu atbilstoši norādītajiem parametriem. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles) papildinformācijai. ::: ### Description `object autoregistration.update(object autoregistration)` This method allows to update existing autoregistration. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object autoregistration.update(object autoregistration)` Šī metode ļauj atjaunināt esošu automātisko reģistrāciju. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles) papildinformācijai. ::: ### Description `object connector.create(object/array connectors)` This method allows to create new connector objects. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object connector.create(object/array connectors)` Šī metode ļauj izveidot jaunus savienotāja objektus. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object connector.delete(array connectorids)` This method allows to delete connector entries. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object connector.delete(array connectorids)` Šī metode ļauj dzēst savienotāju ierakstus. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object connector.update(object/array connectors)` This method allows to update existing connectors. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object connector.update(object/array connectors)` Šī metode ļauj atjaunināt esošos savienotājus. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object correlation.create(object/array correlations)` This method allows to create new correlations. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object correlation.create(object/array correlations)` Šī metode ļauj izveidot jaunas korelācijas. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object correlation.delete(array correlationids)` This method allows to delete correlations. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object correlation.delete(array correlationids)` Šī metode ļauj dzēst korelācijas. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles) papildinformācijai. ::: ### Description `object correlation.update(object/array correlations)` This method allows to update existing correlations. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object correlation.update(object/array correlations)` Šī metode ļauj atjaunināt esošās korelācijas. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles) papildinformācijai. ::: ### Description `object dashboard.create(object/array dashboards)` This method allows to create new dashboards. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object dashboard.create(object/array dashboards)` Šī metode ļauj izveidot jaunus paneļus. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object dashboard.delete(array dashboardids)` This method allows to delete dashboards. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object dashboard.delete(array dashboardids)` Šī metode ļauj dzēst paneļus. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object dashboard.update(object/array dashboards)` This method allows to update existing dashboards. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object dashboard.update(object/array dashboards)` Šī metode ļauj atjaunināt esošos paneļus. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object discoveryrule.copy(object parameters)` This method allows to copy LLD rules with all of the prototypes to the given hosts. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object discoveryrule.copy(object parameters)` Šī metode ļauj kopēt LLD noteikumus ar visiem prototipiem uz norādītajiem hosts. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Tiesības izsaukt šo metodi var atsaukt lietotāju lomu iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object discoveryrule.create(object/array lldRules)` This method allows to create new LLD rules. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object discoveryrule.create(object/array lldRules)` Šī metode ļauj izveidot jaunus LLD noteikumus. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object discoveryrule.delete(array lldRuleIds)` This method allows to delete LLD rules. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object discoveryrule.delete(array lldRuleIds)` Šī metode ļauj dzēst LLD kārtulas. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object discoveryrule.update(object/array lldRules)` This method allows to update existing LLD rules. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object discoveryrule.update(object/array lldRules)` Šī metode ļauj atjaunināt esošos LLD noteikumus. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object drule.create(object/array discoveryRules)` This method allows to create new discovery rules. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object drule.create(object/array discoveryRules)` Šī metode ļauj izveidot jaunus atklāšanas noteikumus. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object drule.delete(array discoveryRuleIds)` This method allows to delete discovery rules. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object drule.delete(array discoveryRuleIds)` Šī metode ļauj dzēst atklāšanas noteikumus. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object drule.update(object/array discoveryRules)` This method allows to update existing discovery rules. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object drule.update(object/array discoveryRules)` Šī metode ļauj atjaunināt esošos atklāšanas noteikumus. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object event.acknowledge(object/array parameters)` This method allows you to update events. The following update actions can be performed: - Close event. If the event is already resolved, this action will be skipped. - Acknowledge event. If the event is already acknowledged, this action will be skipped. - Unacknowledge event. If the event is not acknowledged, this action will be skipped. - Add message. - Change event severity. If the event already has the same severity, this action will be skipped. - Suppress event. If the event is already suppressed, this action will be skipped. - Unsuppress event. If the event is not suppressed, this action will be skipped. - Change event rank to cause. If the event is already ranked as cause, this action will be skipped. - Change event rank to symptom. If the event is already ranked as symptom, this action will be skipped. ::: noteimportant Only trigger events can be updated.<br> Only problem events can be updated.<br> Read/Write rights for trigger are required to close the event or to change event's severity.<br> To close an event, manual close should be allowed in the trigger. ::: ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object event.acknowledge(object/array parameters)` Šī metode ļauj atjaunināt notikumus. Var veikt šādas atjaunināšanas darbības: - Aizvērt notikumu. Ja notikums jau ir atrisināts, šī darbība tiks izlaista. - Apstiprināt notikumu. Ja notikums jau ir apstiprināts, šī darbība tiks izlaista. - Noņemt notikuma apstiprinājumu. Ja notikums nav apstiprināts, šī darbība tiks izlaista. - Pievienot ziņojumu. - Mainīt notikuma nopietnību. Ja notikumam jau ir tāda pati nopietnība, šī darbība tiks izlaista. - Slāpēt notikumu. Ja notikums jau ir slāpēts, šī darbība tiks izlaista. - Noņemt notikuma slāpēšanu. Ja notikums nav slāpēts, šī darbība tiks izlaista. - Mainīt notikuma rangu uz cēloni. Ja notikums jau ir ierindots kā cēlonis, šī darbība tiks izlaista. - Mainīt notikuma rangu uz simptomu. Ja notikums jau ir ierindots kā simptoms, šī darbība tiks izlaista. ::: noteimportant Var atjaunināt tikai trigera notikumus.<br> Var atjaunināt tikai problēmu notikumus.<br> Lai aizvērtu notikumu vai mainītu notikuma nopietnību, ir nepieciešamas lasīšanas/rakstīšanas tiesības trigerim.<br> Lai aizvērtu notikumu, trigerī ir jābūt atļautai manuālai aizvēršanai. ::: ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Tiesības izsaukt metodi var atsaukt lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object graph.create(object/array graphs)` This method allows to create new graphs. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object graph.create(object/array graphs)` Šī metode ļauj izveidot jaunus grafikus. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object graph.delete(array graphIds)` This method allows to delete graphs. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object graph.delete(array graphIds)` Šī metode ļauj dzēst grafikus. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object graphprototype.create(object/array graphPrototypes)` This method allows to create new graph prototypes. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object graphprototype.create(object/array graphPrototypes)` Šī metode ļauj izveidot jaunus grafiku prototipus. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object graphprototype.delete(array graphPrototypeIds)` This method allows to delete graph prototypes. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object graphprototype.delete(array graphPrototypeIds)` Šī metode ļauj dzēst grafiku prototipus. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object graphprototype.update(object/array graphPrototypes)` This method allows to update existing graph prototypes. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object graphprototype.update(object/array graphPrototypes)` Šī metode ļauj atjaunināt esošos grafiku prototipus. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object graph.update(object/array graphs)` This method allows to update existing graphs. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object graph.update(object/array graphs)` Šī metode ļauj atjaunināt esošos grafikus. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object history.clear(array itemids)` This method allows to clear item history. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object history.clear(array itemids)` Šī metode ļauj notīrīt vienuma vēsturi. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: #### Description `object history.push(object/array itemHistoryData)` This method allows sending item history data to Zabbix server. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: The IP address of the Zabbix web interface must be specified in the *Allowed hosts* field of the [Zabbix trapper](/manual/config/items/itemtypes/trapper) in order for the method to work. #### Apraksts `object history.push(object/array itemHistoryData)` Šī metode ļauj nosūtīt vienuma vēstures datus uz Zabbix serveri. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Tiesības izsaukt šo metodi var atsaukt lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāja lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: Lai šī metode darbotos, Zabbix lietotāja saskarnes IP adresei jābūt norādītai [Zabbix trapper](/manual/config/items/itemtypes/trapper) *Allowed hosts* laukā. ### Description `object host.create(object/array hosts)` This method allows to create new hosts. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object host.create(object/array hosts)` Šī metode ļauj izveidot jaunus hostus. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāju lomu iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object host.delete(array hosts)` This method allows to delete hosts. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object host.delete(array hosts)` Šī metode ļauj dzēst hostus. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object hostgroup.create(object/array hostGroups)` This method allows to create new host groups. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object hostgroup.create(object/array hostGroups)` Šī metode ļauj izveidot jaunas hostu grupas. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object hostgroup.delete(array hostGroupIds)` This method allows to delete host groups. A host group cannot be deleted if: - it contains hosts that belong to this group only; - it is marked as internal; - it is used by a host prototype; - it is used in a global script; - it is used in a correlation condition. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object hostgroup.delete(array hostGroupIds)` Šī metode ļauj dzēst hostu grupas. Hostu grupu nevar dzēst, ja: - tā satur hostus, kas pieder tikai šai grupai; - tā ir atzīmēta kā iekšēja; - tā tiek izmantota hosta prototipā; - tā tiek izmantota globālajā skriptā; - tā tiek izmantota korelācijas nosacījumā. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāju lomu iestatījumos. Papildinformāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object hostgroup.massadd(object parameters)` This method allows to simultaneously add multiple related objects to all the given host groups. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object hostgroup.massadd(object parameters)` Šī metode ļauj vienlaikus pievienot vairākus saistītos objektus visām norādītajām hostu grupām. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object hostgroup.massremove(object parameters)` This method allows to remove related objects from multiple host groups. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object hostgroup.massremove(object parameters)` Šī metode ļauj noņemt saistītos objektus no vairākām hostu grupām. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object hostgroup.massupdate(object parameters)` This method allows to replace hosts and templates with the specified ones in multiple host groups. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object hostgroup.massupdate(object parameters)` Šī metode ļauj vairākās hostu grupās aizstāt hosts un veidnes ar norādītajiem. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Tiesības izsaukt šo metodi var atsaukt lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [User roles](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object hostgroup.propagate(object parameters)` This method allows to apply permissions and tag filters to all subgroups of a host group. ::: noteclassic This method is only available to *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object hostgroup.propagate(object parameters)` Šī metode ļauj piemērot atļaujas un birku filtrus visām hostu grupas apakšgrupām. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object hostgroup.update(object/array hostGroups)` This method allows to update existing hosts groups. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object hostgroup.update(object/array hostGroups)` Šī metode ļauj atjaunināt esošās hostu grupas. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object hostinterface.create(object/array hostInterfaces)` This method allows to create new host interfaces. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object hostinterface.create(object/array hostInterfaces)` Šī metode ļauj izveidot jaunas hostu saskarnes. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object hostinterface.delete(array hostInterfaceIds)` This method allows to delete host interfaces. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object hostinterface.delete(array hostInterfaceIds)` Šī metode ļauj dzēst hostu saskarnes. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object hostinterface.massadd(object parameters)` This method allows to simultaneously add host interfaces to multiple hosts. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object hostinterface.massadd(object parameters)` Šī metode ļauj vienlaikus pievienot hostu saskarnes vairākiem hostiem. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object hostinterface.massremove(object parameters)` This method allows to remove host interfaces from the given hosts. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object hostinterface.massremove(object parameters)` Šī metode ļauj noņemt hostu saskarnes no norādītajiem hostiem. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object hostinterface.replacehostinterfaces(object parameters)` This method allows to replace all host interfaces on a given host. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object hostinterface.replacehostinterfaces(object parameters)` Šī metode ļauj aizstāt visas host saskarnes norādītajā hostā. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Tiesības izsaukt šo metodi var atsaukt lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object hostinterface.update(object/array hostInterfaces)` This method allows to update existing host interfaces. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object hostinterface.update(object/array hostInterfaces)` Šī metode ļauj atjaunināt esošās hostu saskarnes. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object host.massadd(object parameters)` This method allows to simultaneously add multiple related objects to all the given hosts. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object host.massadd(object parameters)` Šī metode ļauj vienlaikus pievienot vairākus saistītus objektus visiem norādītajiem hostiem. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object host.massremove(object parameters)` This method allows to remove related objects from multiple hosts. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object host.massremove(object parameters)` Šī metode ļauj noņemt saistītos objektus no vairākiem hostiem. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāju lomu iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object host.massupdate(object parameters)` This method allows to simultaneously replace or remove related objects and update properties on multiple hosts. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object host.massupdate(object parameters)` Šī metode ļauj vienlaikus aizstāt vai noņemt saistītos objektus un atjaunināt vairāku hosts īpašības. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Tiesības izsaukt šo metodi var atsaukt lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object hostprototype.create(object/array hostPrototypes)` This method allows to create new host prototypes. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object hostprototype.create(object/array hostPrototypes)` Šī metode ļauj izveidot jaunus hostu prototipus. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object hostprototype.delete(array hostPrototypeIds)` This method allows to delete host prototypes. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object hostprototype.delete(array hostPrototypeIds)` Šī metode ļauj dzēst hostu prototipus. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object hostprototype.update(object/array hostPrototypes)` This method allows to update existing host prototypes. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object hostprototype.update(object/array hostPrototypes)` Šī metode ļauj atjaunināt esošos hostu prototipus. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object host.update(object/array hosts)` This method allows to update existing hosts. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object host.update(object/array hosts)` Šī metode ļauj atjaunināt esošos hostus. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object housekeeping.get(object parameters)` The method allows to retrieve housekeeping object according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object housekeeping.get(object parameters)` Metode ļauj izgūt uzturēšanas objektu atbilstoši norādītajiem parametriem. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object housekeeping.update(object housekeeping)` This method allows to update existing housekeeping settings. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object housekeeping.update(object housekeeping)` Šī metode ļauj atjaunināt esošos housekeeper iestatījumus. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles) papildinformācijai. ::: ### Description `object httptest.create(object/array webScenarios)` This method allows to create new web scenarios. ::: noteclassic Creating a web scenario will automatically create a set of [web monitoring items](/manual/web_monitoring/items). ::: ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object httptest.create(object/array webScenarios)` Šī metode ļauj izveidot jaunus tīmekļa scenārijus. ::: noteclassic Izveidojot tīmekļa scenāriju, tiks automātiski izveidota kopa ar [tīmekļa uzraudzības vienumiem](/manual/web_monitoring/items). ::: ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāju lomu iestatījumos. Papildinformāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object httptest.delete(array webScenarioIds)` This method allows to delete web scenarios. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object httptest.delete(array webScenarioIds)` Šī metode ļauj dzēst tīmekļa scenārijus. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object httptest.update(object/array webScenarios)` This method allows to update existing web scenarios. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object httptest.update(object/array webScenarios)` Šī metode ļauj atjaunināt esošos tīmekļa scenārijus. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object iconmap.create(object/array iconMaps)` This method allows to create new icon maps. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object iconmap.create(object/array iconMaps)` Šī metode ļauj izveidot jaunas ikonu kartes. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles) papildinformācijai. ::: ### Description `object iconmap.delete(array iconMapIds)` This method allows to delete icon maps. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object iconmap.delete(array iconMapIds)` Šī metode ļauj dzēst ikonu kartes. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles) papildinformācijai. ::: ### Description `object iconmap.update(object/array iconMaps)` This method allows to update existing icon maps. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object iconmap.update(object/array iconMaps)` Šī metode ļauj atjaunināt esošās ikonu kartes. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object image.create(object/array images)` This method allows to create new images. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object image.create(object/array images)` Šī metode ļauj izveidot jaunus attēlus. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles) papildinformācijai. ::: ### Description `object image.delete(array imageIds)` This method allows to delete images. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object image.delete(array imageIds)` Šī metode ļauj dzēst attēlus. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [User roles](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object image.update(object/array images)` This method allows to update existing images. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object image.update(object/array images)` Šī metode ļauj atjaunināt esošos attēlus. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles) papildinformācijai. ::: ### Description `object item.create(object/array items)` This method allows to create new items. ::: noteclassic Web items cannot be created via the Zabbix API. ::: ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object item.create(object/array items)` Šī metode ļauj izveidot jaunus vienumus. ::: noteclassic Tīmekļa vienumus nevar izveidot, izmantojot Zabbix API. ::: ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var atsaukt lietotāju lomu iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object item.delete(array itemIds)` This method allows to delete items. ::: noteclassic Web items cannot be deleted via the Zabbix API. ::: ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object item.delete(array itemIds)` Šī metode ļauj dzēst vienumus. ::: noteclassic Tīmekļa vienumus nevar dzēst, izmantojot Zabbix API. ::: ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object itemprototype.create(object/array itemPrototypes)` This method allows to create new item prototypes. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object itemprototype.create(object/array itemPrototypes)` Šī metode ļauj izveidot jaunus vienumu prototipus. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object itemprototype.delete(array itemPrototypeIds)` This method allows to delete item prototypes. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object itemprototype.delete(array itemPrototypeIds)` Šī metode ļauj dzēst vienumu prototipus. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object itemprototype.update(object/array itemPrototypes)` This method allows to update existing item prototypes. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object itemprototype.update(object/array itemPrototypes)` Šī metode ļauj atjaunināt esošos vienumu prototipus. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object item.update(object/array items)` This method allows to update existing items. ::: noteclassic Web items cannot be updated via the Zabbix API. ::: ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object item.update(object/array items)` Šī metode ļauj atjaunināt esošos vienumus. ::: noteclassic Tīmekļa vienumus nevar atjaunināt, izmantojot Zabbix API. ::: ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāju lomu iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object maintenance.create(object/array maintenances)` This method allows to create new maintenances. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object maintenance.create(object/array maintenances)` Šī metode ļauj izveidot jaunas apkopes. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object maintenance.delete(array maintenanceIds)` This method allows to delete maintenance periods. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object maintenance.delete(array maintenanceIds)` Šī metode ļauj dzēst uzturēšanas periodus. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object maintenance.update(object/array maintenances)` This method allows to update existing maintenances. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object maintenance.update(object/array maintenances)` Šī metode ļauj atjaunināt esošās uzturēšanas. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāju lomu iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object map.create(object/array maps)` This method allows to create new maps. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object map.create(object/array maps)` Šī metode ļauj izveidot jaunas kartes. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object map.delete(array mapIds)` This method allows to delete maps. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object map.delete(array mapIds)` Šī metode ļauj dzēst kartes. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object map.update(object/array maps)` This method allows to update existing maps. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object map.update(object/array maps)` Šī metode ļauj atjaunināt esošās kartes. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object mediatype.create(object/array mediaTypes)` This method allows to create new media types. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object mediatype.create(object/array mediaTypes)` Šī metode ļauj izveidot jaunus mediju tipus. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Skatiet [User roles](/manual/web_interface/frontend_sections/users/user_roles) papildinformācijai. ::: ### Description `object mediatype.delete(array mediaTypeIds)` This method allows to delete media types. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object mediatype.delete(array mediaTypeIds)` Šī metode ļauj dzēst mediju tipus. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object mediatype.update(object/array mediaTypes)` This method allows to update existing media types. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object mediatype.update(object/array mediaTypes)` Šī metode ļauj atjaunināt esošos mediju tipus. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Skatiet [User roles](/manual/web_interface/frontend_sections/users/user_roles) papildinformācijai. ::: ### Description `object mfa.create(object/array MFA methods)` This method allows to create new MFA methods. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object mfa.create(object/array MFA methods)` Šī metode ļauj izveidot jaunas MFA metodes. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object mfa.delete(array mfaids)` This method allows to delete MFA methods. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object mfa.delete(array mfaids)` Šī metode ļauj dzēst MFA metodes. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object mfa.update(object/array MFA methods)` This method allows to update existing MFA methods. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object mfa.update(object/array MFA methods)` Šī metode ļauj atjaunināt esošās MFA metodes. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object module.create(object/array modules)` This method allows to install new frontend modules. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ::: noteimportant Module files must be unpacked manually in the correct subdirectories, matching the `relative_path` property of the modules. ::: ### Apraksts `object module.create(object/array modules)` Šī metode ļauj instalēt jaunus lietotāja saskarnes moduļus. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ::: noteimportant Moduļu faili ir manuāli jāizpako pareizajās apakšdirektorijās, lai tās atbilstu moduļu `relative_path` īpašībai. ::: ### Description `object module.delete(array moduleids)` This method allows to uninstall modules. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ::: noteimportant Module files must be removed manually. ::: ### Apraksts `object module.delete(array moduleids)` Šī metode ļauj atinstalēt moduļus. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ::: noteimportant Moduļu faili ir jānoņem manuāli. ::: ### Description `object module.update(object/array modules)` This method allows to update existing modules. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object module.update(object/array modules)` Šī metode ļauj atjaunināt esošos moduļus. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object proxy.create(object/array proxies)` This method allows to create new proxies. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object proxy.create(object/array proxies)` Šī metode ļauj izveidot jaunus starpniekserverus. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object proxy.delete(array proxies)` This method allows to delete proxies. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object proxy.delete(array proxies)` Šī metode ļauj dzēst starpniekserverus. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object proxygroup.create(object/array proxyGroups)` This method allows to create new proxy groups. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object proxygroup.create(object/array proxyGroups)` Šī metode ļauj izveidot jaunas starpniekserveru grupas. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object proxygroup.delete(array proxyGroupIds)` This method allows to delete proxy groups. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object proxygroup.delete(array proxyGroupIds)` Šī metode ļauj dzēst starpniekserveru grupas. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object proxygroup.update(object/array proxyGroups)` This method allows to update existing proxy groups. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object proxygroup.update(object/array proxyGroups)` Šī metode ļauj atjaunināt esošās starpniekserveru grupas. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object proxy.update(object/array proxies)` This method allows to update existing proxies. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object proxy.update(object/array proxies)` Šī metode ļauj atjaunināt esošos starpniekserverus. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object regexp.create(object/array regularExpressions)` This method allows to create new global regular expressions. ::: noteclassic This method is only available to *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object regexp.create(object/array regularExpressions)` Šī metode ļauj izveidot jaunas globālās regulārās izteiksmes. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles) papildinformācijai. ::: ### Description `object regexp.delete(array regexpids)` This method allows to delete global regular expressions. ::: noteclassic This method is only available to *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object regexp.delete(array regexpids)` Šī metode ļauj dzēst globālās regulārās izteiksmes. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles) papildinformācijai. ::: ### Description `object regexp.update(object/array regularExpressions)` This method allows to update existing global regular expressions. ::: noteclassic This method is only available to *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object regexp.update(object/array regularExpressions)` Šī metode ļauj atjaunināt esošās globālās regulārās izteiksmes. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles) papildinformācijai. ::: ### Description `object report.create(object/array reports)` This method allows to create new scheduled reports. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object report.create(object/array reports)` Šī metode ļauj izveidot jaunus ieplānotus pārskatus. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object report.delete(array reportids)` This method allows to delete scheduled reports. ::: noteclassic This method is only available to *Admin* and *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object report.delete(array reportids)` Šī metode ļauj dzēst ieplānotos pārskatus. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object report.update(object/array reports)` This method allows to update existing scheduled reports. ::: noteclassic This method is only available to *Admin* and *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object report.update(object/array reports)` Šī metode ļauj atjaunināt esošos ieplānotos pārskatus. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object role.create(object/array roles)` This method allows to create new roles. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object role.create(object/array roles)` Šī metode ļauj izveidot jaunas lomas. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object role.delete(array roleids)` This method allows to delete roles. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object role.delete(array roleids)` Šī metode ļauj dzēst lomas. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object role.update(object/array roles)` This method allows to update existing roles. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object role.update(object/array roles)` Šī metode ļauj atjaunināt esošās lomas. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles) papildinformācijai. ::: ### Description `object script.create(object/array scripts)` This method allows to create new scripts. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object script.create(object/array scripts)` Šī metode ļauj izveidot jaunus skriptus. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles) papildinformācijai. ::: ### Description `object script.delete(array scriptIds)` This method allows to delete scripts. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object script.delete(array scriptIds)` Šī metode ļauj dzēst skriptus. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles) papildinformācijai. ::: ### Description `object script.execute(object parameters)` This method allows to run a script on a host or event. Except for URL type scripts. Those are not executable. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object script.execute(object parameters)` Šī metode ļauj izpildīt skriptu hostā vai notikumā. Izņemot URL tipa skriptus. Tie nav izpildāmi. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object script.getscriptsbyevents(object parameters)` This method allows to retrieve all available scripts on the given event or specific script if script ID is provided. When manualinput is provided, it substitutes the {MANUALINPUT} macro with the specified value. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object script.getscriptsbyevents(object parameters)` Šī metode ļauj izgūt visus pieejamos skriptus norādītajam notikumam vai konkrētu skriptu, ja ir norādīts skripta ID. Ja ir norādīts manualinput, tas aizstāj {MANUALINPUT} makrosu ar norādīto vērtību. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles) papildinformācijai. ::: ### Description `object script.getscriptsbyhosts(object parameters)` This method allows to retrieve all available scripts on the given host or specific script if script ID is provided. When manualinput is provided, it substitutes the {MANUALINPUT} macro with the specified value. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object script.getscriptsbyhosts(object parameters)` Šī metode ļauj iegūt visus pieejamos skriptus norādītajā hostā vai konkrētu skriptu, ja ir norādīts skripta ID. Ja ir norādīts manualinput, tas aizstāj makrosu {MANUALINPUT} ar norādīto vērtību. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles) papildinformācijai. ::: ### Description `object script.update(object/array scripts)` This method allows to update existing scripts. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object script.update(object/array scripts)` Šī metode ļauj atjaunināt esošos skriptus. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles) papildinformācijai. ::: ### Description `object service.create(object/array services)` This method allows to create new services. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object service.create(object/array services)` Šī metode ļauj izveidot jaunus pakalpojumus. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object service.delete(array serviceIds)` This method allows to delete services. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object service.delete(array serviceIds)` Šī metode ļauj dzēst pakalpojumus. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object service.update(object/array services)` This method allows to update existing services. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object service.update(object/array services)` Šī metode ļauj atjaunināt esošos pakalpojumus. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object settings.get(object parameters)` The method allows to retrieve settings object according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object settings.get(object parameters)` Metode ļauj izgūt iestatījumu objektu atbilstoši norādītajiem parametriem. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object settings.update(object settings)` This method allows to update existing common settings. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object settings.update(object settings)` Šī metode ļauj atjaunināt esošos kopīgos iestatījumus. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles) papildu informācijai. ::: ### Description `object sla.create(object/array SLAs)` This method allows to create new SLA objects. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object sla.create(object/array SLAs)` Šī metode ļauj izveidot jaunus SLA objektus. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Tiesības izsaukt šo metodi var atsaukt lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāja lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object sla.delete(array slaids)` This method allows to delete SLA entries. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object sla.delete(array slaids)` Šī metode ļauj dzēst SLA ierakstus. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object sla.getsli(object parameters)` This method allows to calculate the Service Level Indicator (SLI) data for a Service Level Agreement (SLA). ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object sla.getsli(object parameters)` Šī metode ļauj aprēķināt Service Level Indicator (SLI) datus Service Level Agreement (SLA). ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object sla.update(object/array slaids)` This method allows to update existing SLA entries. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object sla.update(object/array slaids)` Šī metode ļauj atjaunināt esošos SLA ierakstus. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object task.create(object/array tasks)` This method allows to create tasks. ::: noteclassic This method is available to users of any type (to *Admin* and *User* type users since Zabbix 7.0.19). Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object task.create(object/array tasks)` Šī metode ļauj izveidot uzdevumus. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem (kopš Zabbix 7.0.19 - *Admin* un *User* tipa lietotājiem). Tiesības izsaukt šo metodi var atsaukt lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāja lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object template.create(object/array templates)` This method allows to create new templates. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object template.create(object/array templates)` Šī metode ļauj izveidot jaunas veidnes. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object templatedashboard.create(object/array templateDashboards)` This method allows to create new template dashboards. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object templatedashboard.create(object/array templateDashboards)` Šī metode ļauj izveidot jaunus veidņu paneļus. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object templatedashboard.delete(array templateDashboardIds)` This method allows to delete template dashboards. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object templatedashboard.delete(array templateDashboardIds)` Šī metode ļauj dzēst veidņu paneļus. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object templatedashboard.update(object/array templateDashboards)` This method allows to update existing template dashboards. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object templatedashboard.update(object/array templateDashboards)` Šī metode ļauj atjaunināt esošos veidņu paneļus. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object template.delete(array templateIds)` This method allows to delete templates. Deleting a template will cause deletion of all template entities (items, triggers, graphs, etc.). To leave template entities with the hosts, but delete the template itself, first unlink the template from required hosts using one of these methods: [template.update](/manual/api/reference/template/update), [template.massupdate](/manual/api/reference/template/massupdate), [host.update](/manual/api/reference/host/update), [host.massupdate](/manual/api/reference/host/massupdate). ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object template.delete(array templateIds)` Šī metode ļauj dzēst veidnes. Dzēšot veidni, tiks dzēsti arī visi veidnes objekti (vienumi, trigeri, grafiki utt.). Lai veidnes objekti paliktu pie hosts, bet tiktu dzēsta pati veidne, vispirms atsaistiet veidni no nepieciešamajiem hosts, izmantojot vienu no šīm metodēm: [template.update](/manual/api/reference/template/update), [template.massupdate](/manual/api/reference/template/massupdate), [host.update](/manual/api/reference/host/update), [host.massupdate](/manual/api/reference/host/massupdate). ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Tiesības izsaukt šo metodi var atsaukt lietotāju lomu iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object templategroup.create(object/array templateGroups)` This method allows to create new template groups. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object templategroup.create(object/array templateGroups)` Šī metode ļauj izveidot jaunas veidņu grupas. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Skatiet [User roles](/manual/web_interface/frontend_sections/users/user_roles) papildinformācijai. ::: ### Description `object templategroup.delete(array templateGroupIds)` This method allows to delete template groups. A template group cannot be deleted if it contains templates that belong to this group only. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object templategroup.delete(array templateGroupIds)` Šī metode ļauj dzēst veidņu grupas. Veidņu grupu nevar dzēst, ja tajā ir veidnes, kas pieder tikai šai grupai. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object templategroup.massadd(object parameters)` This method allows to simultaneously add multiple related objects to all the given template groups. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object templategroup.massadd(object parameters)` Šī metode ļauj vienlaikus pievienot vairākus saistītos objektus visām norādītajām veidņu grupām. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object templategroup.massremove(object parameters)` This method allows to remove related objects from multiple template groups. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object templategroup.massremove(object parameters)` Šī metode ļauj noņemt saistītos objektus no vairākām veidņu grupām. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object templategroup.massupdate(object parameters)` This method allows to replace templates with the specified ones in multiple template groups. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object templategroup.massupdate(object parameters)` Šī metode ļauj aizstāt veidnes vairākās veidņu grupās ar norādītajām veidnēm. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Tiesības izsaukt šo metodi var atsaukt lietotāju lomu iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object templategroup.propagate(object parameters)` This method allows to apply permissions to all template groups' subgroups. ::: noteclassic This method is only available to *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object templategroup.propagate(object parameters)` Šī metode ļauj piemērot atļaujas visām veidņu grupu apakšgrupām. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāju lomu iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object templategroup.update(object/array templateGroups)` This method allows to update existing template groups. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object templategroup.update(object/array templateGroups)` Šī metode ļauj atjaunināt esošās veidņu grupas. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object template.massadd(object parameters)` This method allows to simultaneously add multiple related objects to the given templates. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object template.massadd(object parameters)` Šī metode ļauj vienlaikus pievienot vairākus saistītus objektus norādītajām veidnēm. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object template.massremove(object parameters)` This method allows to remove related objects from multiple templates. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object template.massremove(object parameters)` Šī metode ļauj noņemt saistītos objektus no vairākām veidnēm. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object template.massupdate(object parameters)` This method allows to simultaneously replace or remove related objects and update properties on multiple templates. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object template.massupdate(object parameters)` Šī metode ļauj vienlaikus aizstāt vai noņemt saistītos objektus un atjaunināt īpašības vairākām veidnēm. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Tiesības izsaukt šo metodi var atsaukt lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object template.update(object/array templates)` This method allows to update existing templates. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object template.update(object/array templates)` Šī metode ļauj atjaunināt esošās veidnes. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object token.create(object/array tokens)` This method allows to create new tokens. ::: noteclassic The *Manage API tokens* [permission](/manual/web_interface/frontend_sections/users/user_roles#configuration) is required for the user role to manage tokens for other users. ::: ::: noteimportant A token created by this method also has to be [generated](generate) before it is usable. ::: ### Apraksts `object token.create(object/array tokens)` Šī metode ļauj izveidot jaunus tokenus. ::: noteclassic Lai lietotāja loma varētu pārvaldīt tokenus citiem lietotājiem, ir nepieciešama *Manage API tokens* [atļauja](/manual/web_interface/frontend_sections/users/user_roles#configuration). ::: ::: noteimportant Ar šo metodi izveidots tokens pirms lietošanas ir arī [jāģenerē](generate). ::: ### Description `object token.delete(array tokenids)` This method allows to delete tokens. ::: noteclassic The *Manage API tokens* [permission](/manual/web_interface/frontend_sections/users/user_roles#configuration) is required for the user role to manage tokens for other users. ::: ### Apraksts `object token.delete(array tokenids)` Šī metode ļauj dzēst tokenus. ::: noteclassic Lai lietotāja loma varētu pārvaldīt citu lietotāju tokenus, ir nepieciešama *Manage API tokens* [atļauja](/manual/web_interface/frontend_sections/users/user_roles#configuration). ::: ### Description `object token.generate(array tokenids)` This method allows to generate tokens. ::: noteclassic The *Manage API tokens* [permission](/manual/web_interface/frontend_sections/users/user_roles#configuration) is required for the user role to manage tokens for other users. ::: ::: noteimportant A token can be generated by this method only if it has been [created](create). ::: ### Apraksts `object token.generate(array tokenids)` Šī metode ļauj ģenerēt tokenus. ::: noteclassic Lietotāja lomai ir nepieciešama *Manage API tokens* [atļauja](/manual/web_interface/frontend_sections/users/user_roles#configuration), lai pārvaldītu tokenus citiem lietotājiem. ::: ::: noteimportant Tokenu ar šo metodi var ģenerēt tikai tad, ja tas ir [izveidots](create). ::: ### Description `object token.update(object/array tokens)` This method allows to update existing tokens. ::: noteclassic The *Manage API tokens* [permission](/manual/web_interface/frontend_sections/users/user_roles#configuration) is required for the user role to manage tokens for other users. ::: ### Apraksts `object token.update(object/array tokens)` Šī metode ļauj atjaunināt esošos tokenus. ::: noteclassic Lai lietotāja loma varētu pārvaldīt tokenus citiem lietotājiem, ir nepieciešama *Manage API tokens* [atļauja](/manual/web_interface/frontend_sections/users/user_roles#configuration). ::: ### Description `object trigger.create(object/array triggers)` This method allows to create new triggers. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object trigger.create(object/array triggers)` Šī metode ļauj izveidot jaunus trigerus. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object trigger.delete(array triggerIds)` This method allows to delete triggers. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object trigger.delete(array triggerIds)` Šī metode ļauj dzēst trigerus. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object triggerprototype.create(object/array triggerPrototypes)` This method allows to create new trigger prototypes. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object triggerprototype.create(object/array triggerPrototypes)` Šī metode ļauj izveidot jaunus trigeru prototipus. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object triggerprototype.delete(array triggerPrototypeIds)` This method allows to delete trigger prototypes. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object triggerprototype.delete(array triggerPrototypeIds)` Šī metode ļauj dzēst trigeru prototipus. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object triggerprototype.update(object/array triggerPrototypes)` This method allows to update existing trigger prototypes. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object triggerprototype.update(object/array triggerPrototypes)` Šī metode ļauj atjaunināt esošos trigeru prototipus. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Papildinformāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object trigger.update(object/array triggers)` This method allows to update existing triggers. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object trigger.update(object/array triggers)` Šī metode ļauj atjaunināt esošos trigerus. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object user.checkAuthentication` This method checks and prolongs the user session. ::: noteimportant Calling the `user.checkAuthentication` method using the parameter `sessionid` prolongs the user session by default. ::: ### Apraksts `object user.checkAuthentication` Šī metode pārbauda un pagarina lietotāja sesiju. ::: noteimportant Izsaucot metodi `user.checkAuthentication`, izmantojot parametru `sessionid`, lietotāja sesija pēc noklusējuma tiek pagarināta. ::: ### Description `object user.create(object/array users)` This method allows to create new users. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ::: noteclassic The strength of user password is validated according the password policy rules defined by Authentication API. See [Authentication API](/manual/api/reference/authentication) for more information. ::: ### Apraksts `object user.create(object/array users)` Šī metode ļauj izveidot jaunus lietotājus. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles) papildinformācijai. ::: ::: noteclassic Lietotāja paroles stiprums tiek validēts saskaņā ar paroļu politikas noteikumiem, ko definē Authentication API. Skatiet [Authentication API](/manual/api/reference/authentication), lai iegūtu vairāk informācijas. ::: ### Description `object user.delete(array users)` This method allows to delete users. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object user.delete(array users)` Šī metode ļauj dzēst lietotājus. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object userdirectory.create(object/array userDirectory)` This method allows to create new user directories. ::: noteclassic This method is only available to *Super admin* user type. ::: ### Apraksts `object userdirectory.create(object/array userDirectory)` Šī metode ļauj izveidot jaunus lietotāju direktorijus. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. ::: ### Description `object userdirectory.delete(array userDirectoryIds)` This method allows to delete user directories. User directory cannot be deleted when it is directly used for at least one user group.<br> Default LDAP user directory cannot be deleted when `authentication.ldap_configured` is set to 1 or when there are more user directories left. ::: noteclassic This method is only available to *Super admin* user type. ::: ### Apraksts `object userdirectory.delete(array userDirectoryIds)` Šī metode ļauj dzēst lietotāju direktorijus. Lietotāju direktoriju nevar dzēst, ja tas tiek tieši izmantots vismaz vienai lietotāju grupai.<br> Noklusējuma LDAP lietotāju direktoriju nevar dzēst, ja `authentication.ldap_configured` ir iestatīts uz 1 vai ja ir palikuši citi lietotāju direktoriji. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. ::: ### Description `object userdirectory.test(array userDirectory)` This method allows to test user directory connection settings. ::: noteclassic This method also allows to test what configured data matches the user directory settings for user provisioning (e.g., what user role, user groups, user medias will be assigned to the user). For this type of test the API request should be made for a [user directory](/manual/api/reference/userdirectory/object#userdirectory) that has `provision_status` set to enabled. ::: ::: noteclassic This method is only available to *Super admin* user type. ::: ### Apraksts `object userdirectory.test(array userDirectory)` Šī metode ļauj pārbaudīt lietotāju direktorija savienojuma iestatījumus. ::: noteclassic Šī metode arī ļauj pārbaudīt, kā konfigurētie dati atbilst lietotāju direktorija iestatījumiem lietotāju nodrošināšanai (piemēram, kāda lietotāja loma, lietotāju grupas, lietotāja mediji tiks piešķirti lietotājam). Šāda veida pārbaudei API pieprasījums jāveic [lietotāju direktorijam](/manual/api/reference/userdirectory/object#userdirectory), kuram `provision_status` ir iestatīts kā enabled. ::: ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. ::: ### Description `object userdirectory.update(object/array userDirectory)` This method allows to update existing user directories. ::: noteclassic This method is only available to *Super admin* user type. ::: ### Apraksts `object userdirectory.update(object/array userDirectory)` Šī metode ļauj atjaunināt esošos lietotāju direktorijus. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. ::: ### Description `object usergroup.create(object/array userGroups)` This method allows to create new user groups. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object usergroup.create(object/array userGroups)` Šī metode ļauj izveidot jaunas lietotāju grupas. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object usergroup.delete(array userGroupIds)` This method allows to delete user groups. ::: noteimportant [Deprovisioned](/manual/web_interface/frontend_sections/users/authentication#configuration) users group (the user group specified for `disabled_usrgrpid` in [Authentication](/manual/api/reference/authentication/object)) cannot be deleted. ::: ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object usergroup.delete(array userGroupIds)` Šī metode ļauj dzēst lietotāju grupas. ::: noteimportant [Atatdalīto lietotāju](/manual/web_interface/frontend_sections/users/authentication#configuration) grupa (lietotāju grupa, kas norādīta `disabled_usrgrpid` laukam sadaļā [Autentifikācija](/manual/api/reference/authentication/object)) nevar tikt dzēsta. ::: ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object usergroup.update(object/array userGroups)` This method allows to update existing user groups. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object usergroup.update(object/array userGroups)` Šī metode ļauj atjaunināt esošās lietotāju grupas. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles) papildinformācijai. ::: ### Description `object usermacro.createglobal(object/array globalMacros)` This method allows to create new global macros. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object usermacro.createglobal(object/array globalMacros)` Šī metode ļauj izveidot jaunus globālos makrosus. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles) papildinformācijai. ::: ### Description `object usermacro.create(object/array hostMacros)` This method allows to create new host macros. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object usermacro.create(object/array hostMacros)` Šī metode ļauj izveidot jaunus hosta makrosus. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object usermacro.delete(array hostMacroIds)` This method allows to delete host macros. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object usermacro.delete(array hostMacroIds)` Šī metode ļauj dzēst hostu makrosus. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object usermacro.deleteglobal(array globalMacroIds)` This method allows to delete global macros. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object usermacro.deleteglobal(array globalMacroIds)` Šī metode ļauj dzēst globālos makrosus. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Skatiet [User roles](/manual/web_interface/frontend_sections/users/user_roles) papildinformācijai. ::: ### Description `object usermacro.updateglobal(object/array globalMacros)` This method allows to update existing global macros. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object usermacro.updateglobal(object/array globalMacros)` Šī metode ļauj atjaunināt esošos globālos makrosus. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles) papildinformācijai. ::: ### Description `object usermacro.update(object/array hostMacros)` This method allows to update existing host macros. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object usermacro.update(object/array hostMacros)` Šī metode ļauj atjaunināt esošos hostu makrosus. ::: noteclassic Šī metode ir pieejama tikai *Admin* un *Super admin* lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object user.provision(object/array users)` This method allows to provision LDAP users. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object user.provision(object/array users)` Šī metode ļauj nodrošināt LDAP lietotājus. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object user.resettotp(object/array users)` This method allows to reset user TOTP secrets. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object user.resettotp(object/array users)` Šī metode ļauj atiestatīt lietotāja TOTP noslēpumus. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `object user.unblock(array userids)` This method allows to unblock users. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object user.unblock(array userids)` Šī metode ļauj atbloķēt lietotājus. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles) papildinformācijai. ::: ### Description `object user.update(object/array users)` This method allows to update existing users. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ::: noteclassic The strength of user password is validated according the password policy rules defined by Authentication API. See [Authentication API](/manual/api/reference/authentication) for more information. ::: ### Apraksts `object user.update(object/array users)` Šī metode ļauj atjaunināt esošos lietotājus. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ::: noteclassic Lietotāja paroles stiprums tiek validēts saskaņā ar paroles politikas noteikumiem, ko definē Authentication API. Plašāku informāciju skatiet [Authentication API](/manual/api/reference/authentication). ::: ### Description `object valuemap.create(object/array valuemaps)` This method allows to create new value maps. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object valuemap.create(object/array valuemaps)` Šī metode ļauj izveidot jaunas vērtību kartes. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles) papildinformācijai. ::: ### Description `object valuemap.delete(array valuemapids)` This method allows to delete value maps. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object valuemap.delete(array valuemapids)` Šī metode ļauj dzēst vērtību kartes. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles) papildinformācijai. ::: ### Description `object valuemap.update(object/array valuemaps)` This method allows to update existing value maps. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `object valuemap.update(object/array valuemaps)` Šī metode ļauj atjaunināt esošās vērtību kartes. ::: noteclassic Šī metode ir pieejama tikai *Super admin* lietotāja tipam. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles) papildinformācijai. ::: ### Description `string apiinfo.version(array)` This method allows to retrieve the version of the Zabbix API. ::: noteimportant This method is only available to unauthenticated users and must be called without the `auth` parameter in the JSON-RPC request. ::: ### Apraksts `string apiinfo.version(array)` Šī metode ļauj izgūt Zabbix API versiju. ::: noteimportant Šī metode ir pieejama tikai neautentificētiem lietotājiem, un tā ir jāizsauc bez `auth` parametra JSON-RPC pieprasījumā. ::: ### Description `string configuration.export(object parameters)` This method allows to export configuration data as a serialized string. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `string configuration.export(object parameters)` Šī metode ļauj eksportēt konfigurācijas datus kā serializētu virkni. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ### Description `string/object user.login(object parameters)` This method allows to log in to the API and generate an authentication token. ::: notewarning When using this method, you also need to do [user.logout](/manual/api/reference/user/logout) to prevent the generation of a large number of open session records. ::: ::: noteimportant This method is only available to unauthenticated users who do not belong to any [user group](/manual/api/reference/usergroup/object#user-group) with enabled multi-factor authentication. This method must be called without the `auth` parameter in the JSON-RPC request. ::: ### Apraksts `string/object user.login(object parameters)` Šī metode ļauj pieteikties API un ģenerēt autentifikācijas tokenu. ::: notewarning Izmantojot šo metodi, jums arī jāizpilda [user.logout](/manual/api/reference/user/logout), lai novērstu liela skaita atvērtu sesiju ierakstu ģenerēšanu. ::: ::: noteimportant Šī metode ir pieejama tikai neautentificētiem lietotājiem, kuri nepieder nevienai [lietotāju grupai](/manual/api/reference/usergroup/object#user-group) ar iespējotu daudzfaktoru autentifikāciju. Šī metode ir jāizsauc bez `auth` parametra JSON-RPC pieprasījumā. ::: ### Description `string/object user.logout(array)` This method allows to log out of the API and invalidates the current authentication token. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### Apraksts `string/object user.logout(array)` Šī metode ļauj izrakstīties no API un padara pašreizējo autentifikācijas marķieri nederīgu. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāju lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: ##### Description The following advanced configuration parameters are supported if *Show* is set to "Description". |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Description*|1|description|Any string value, including macros.<br>Supported macros: {HOST.\*}, {ITEM.\*}, {INVENTORY.\*}, User macros.<br><br>Default: {ITEM.NAME}.| |*Horizontal position*|0|desc_h_pos|0 - Left;<br>1 - *(default)* Center;<br>2 - Right.<br><br>Two or more elements (Description, Value, Time) cannot share the same *Horizontal position* and *Vertical position*.| |*Vertical position*|0|desc_v_pos|0 - Top;<br>1 - Middle;<br>2 - *(default)* Bottom.<br><br>Two or more elements (Description, Value, Time) cannot share the same *Horizontal position* and *Vertical position*.| |*Size*|0|desc_size|Possible values range from 1-100.<br><br>Default: 15.| |*Bold*|0|desc_bold|0 - *(default)* Disabled;<br>1 - Enabled.| |*Color*|1|desc_color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `""` (empty).| ##### Apraksts Tālāk norādītie paplašinātās konfigurācijas parametri tiek atbalstīti, ja *Rādīt* ir iestatīts uz "Apraksts". |Parametrs|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Apraksts*|1|description|Jebkura virknes vērtība, ieskaitot makrosus.<br>Atbalstītie makrosi: {HOST.\*}, {ITEM.\*}, {INVENTORY.\*}, lietotāja makrosi.<br><br>Noklusējums: {ITEM.NAME}.| |*Horizontālā pozīcija*|0|desc_h_pos|0 - Pa kreisi;<br>1 - *(noklusējums)* Centrā;<br>2 - Pa labi.<br><br>Diviem vai vairākiem elementiem (Apraksts, Vērtība, Laiks) nevar būt vienāda *Horizontālā pozīcija* un *Vertikālā pozīcija*.| |*Vertikālā pozīcija*|0|desc_v_pos|0 - Augšā;<br>1 - Vidū;<br>2 - *(noklusējums)* Apakšā.<br><br>Diviem vai vairākiem elementiem (Apraksts, Vērtība, Laiks) nevar būt vienāda *Horizontālā pozīcija* un *Vertikālā pozīcija*.| |*Izmērs*|0|desc_size|Iespējamās vērtības ir diapazonā no 1 līdz 100.<br><br>Noklusējums: 15.| |*Treknraksts*|0|desc_bold|0 - *(noklusējums)* Atspējots;<br>1 - Iespējots.| |*Krāsa*|1|desc_color|Heksadecimāls krāsas kods (piemēram, `FF0000`).<br><br>Noklusējums: `""` (tukšs).| ### Description These parameters and the possible property values for the respective dashboard widget field objects allow to configure the [*Action log*](/manual/web_interface/frontend_sections/dashboards/widgets/action_log) widget in `dashboard.create` and `dashboard.update` methods. ::: noteimportant Widget `fields` properties are not validated during the creation or update of a dashboard. This allows users to modify [built-in widgets](/manual/web_interface/frontend_sections/dashboards/widgets) and create [custom widgets](/devel/modules/tutorials/widget), but also introduces the risk of creating or updating widgets incorrectly. To ensure the successful creation or update of the *Action log* widget, please refer to the parameter behavior outlined in the tables below. ::: ### Apraksts Šie parametri un iespējamās īpašību vērtības attiecīgajiem paneļa logrīka lauku objektiem ļauj konfigurēt [*Darbību žurnāla*](/manual/web_interface/frontend_sections/dashboards/widgets/action_log) logrīku `dashboard.create` un `dashboard.update` metodēs. ::: noteimportant Logrīka `fields` īpašības netiek validētas paneļa izveides vai atjaunināšanas laikā. Tas ļauj lietotājiem modificēt [iebūvētos logrīkus](/manual/web_interface/frontend_sections/dashboards/widgets) un izveidot [pielāgotus logrīkus](/devel/modules/tutorials/widget), taču vienlaikus rada arī risku izveidot vai atjaunināt logrīkus nepareizi. Lai nodrošinātu veiksmīgu *Darbību žurnāla* logrīka izveidi vai atjaunināšanu, lūdzu, skatiet tālāk esošajās tabulās aprakstīto parametru darbību. ::: ### Description These parameters and the possible property values for the respective dashboard widget field objects allow to configure the [*Clock*](/manual/web_interface/frontend_sections/dashboards/widgets/clock) widget in `dashboard.create` and `dashboard.update` methods. ::: noteimportant Widget `fields` properties are not validated during the creation or update of a dashboard. This allows users to modify [built-in widgets](/manual/web_interface/frontend_sections/dashboards/widgets) and create [custom widgets](/devel/modules/tutorials/widget), but also introduces the risk of creating or updating widgets incorrectly. To ensure the successful creation or update of the *Clock* widget, please refer to the parameter behavior outlined in the tables below. ::: ### Apraksts Šie parametri un iespējamās attiecīgo paneļa logrīka lauku objektu īpašību vērtības ļauj konfigurēt [*Pulksteņa*](/manual/web_interface/frontend_sections/dashboards/widgets/clock) logrīku `dashboard.create` un `dashboard.update` metodēs. ::: noteimportant Logrīka `fields` īpašības netiek validētas paneļa izveides vai atjaunināšanas laikā. Tas ļauj lietotājiem modificēt [iebūvētos logrīkus](/manual/web_interface/frontend_sections/dashboards/widgets) un izveidot [pielāgotus logrīkus](/devel/modules/tutorials/widget), taču vienlaikus rada arī risku logrīkus izveidot vai atjaunināt nepareizi. Lai nodrošinātu veiksmīgu *Pulksteņa* logrīka izveidi vai atjaunināšanu, lūdzu, skatiet tālāk esošajās tabulās aprakstīto parametru darbību. ::: ### Description These parameters and the possible property values for the respective dashboard widget field objects allow to configure the [*Data overview*](/manual/web_interface/frontend_sections/dashboards/widgets/data_overview) widget in `dashboard.create` and `dashboard.update` methods. ::: noteimportant Widget `fields` properties are not validated during the creation or update of a dashboard. This allows users to modify [built-in widgets](/manual/web_interface/frontend_sections/dashboards/widgets) and create [custom widgets](/devel/modules/tutorials/widget), but also introduces the risk of creating or updating widgets incorrectly. To ensure the successful creation or update of the *Data overview* widget, please refer to the parameter behavior outlined in the tables below. ::: ### Apraksts Šie parametri un iespējamās īpašību vērtības attiecīgajiem informācijas paneļa logrīka lauku objektiem ļauj konfigurēt [*Datu pārskata*](/manual/web_interface/frontend_sections/dashboards/widgets/data_overview) logrīku `dashboard.create` un `dashboard.update` metodēs. ::: noteimportant Logrīka `fields` īpašības netiek validētas informācijas paneļa izveides vai atjaunināšanas laikā. Tas ļauj lietotājiem modificēt [iebūvētos logrīkus](/manual/web_interface/frontend_sections/dashboards/widgets) un izveidot [pielāgotus logrīkus](/devel/modules/tutorials/widget), taču tas arī rada risku nepareizi izveidot vai atjaunināt logrīkus. Lai nodrošinātu veiksmīgu *Datu pārskata* logrīka izveidi vai atjaunināšanu, lūdzu, skatiet parametru darbību tabulās zemāk. ::: ### Description These parameters and the possible property values for the respective dashboard widget field objects allow to configure the [*Discovery status*](/manual/web_interface/frontend_sections/dashboards/widgets/discovery_status) widget in `dashboard.create` and `dashboard.update` methods. ### Apraksts Šie parametri un iespējamās īpašību vērtības attiecīgajiem paneļa logrīka lauku objektiem ļauj konfigurēt logrīku [*Atklāšanas statuss*](/manual/web_interface/frontend_sections/dashboards/widgets/discovery_status) metodēs `dashboard.create` un `dashboard.update`. ### Description These parameters and the possible property values for the respective dashboard widget field objects allow to configure the [*Favorite graphs*](/manual/web_interface/frontend_sections/dashboards/widgets/favorite_graphs) widget in `dashboard.create` and `dashboard.update` methods. ### Apraksts Šie parametri un iespējamās īpašību vērtības attiecīgajiem paneļa logrīka lauku objektiem ļauj konfigurēt logrīku [*Favorite graphs*](/manual/web_interface/frontend_sections/dashboards/widgets/favorite_graphs) metodēs `dashboard.create` un `dashboard.update`. ### Description These parameters and the possible property values for the respective dashboard widget field objects allow to configure the [*Favorite maps*](/manual/web_interface/frontend_sections/dashboards/widgets/favorite_maps) widget in `dashboard.create` and `dashboard.update` methods. ### Apraksts Šie parametri un iespējamās īpašību vērtības attiecīgajiem paneļa logrīka lauku objektiem ļauj konfigurēt logrīku [*Iecienītās kartes*](/manual/web_interface/frontend_sections/dashboards/widgets/favorite_maps) `dashboard.create` un `dashboard.update` metodēs. ### Description These parameters and the possible property values for the respective dashboard widget field objects allow to configure the [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge) widget in `dashboard.create` and `dashboard.update` methods. ::: noteimportant Widget `fields` properties are not validated during the creation or update of a dashboard. This allows users to modify [built-in widgets](/manual/web_interface/frontend_sections/dashboards/widgets) and create [custom widgets](/devel/modules/tutorials/widget), but also introduces the risk of creating or updating widgets incorrectly. To ensure the successful creation or update of the *Gauge* widget, please refer to the parameter behavior outlined in the tables below. ::: ### Apraksts Šie parametri un iespējamās īpašību vērtības attiecīgajiem paneļa logrīka lauku objektiem ļauj konfigurēt [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge) logrīku `dashboard.create` un `dashboard.update` metodēs. ::: noteimportant Logrīka `fields` īpašības netiek validētas paneļa izveides vai atjaunināšanas laikā. Tas ļauj lietotājiem modificēt [iebūvētos logrīkus](/manual/web_interface/frontend_sections/dashboards/widgets) un izveidot [pielāgotus logrīkus](/devel/modules/tutorials/widget), taču vienlaikus rada arī risku izveidot vai atjaunināt logrīkus nepareizi. Lai nodrošinātu veiksmīgu *Gauge* logrīka izveidi vai atjaunināšanu, lūdzu, skatiet tālāk esošajās tabulās aprakstīto parametru darbību. ::: ### Description These parameters and the possible property values for the respective dashboard widget field objects allow to configure the [*Geomap*](/manual/web_interface/frontend_sections/dashboards/widgets/geomap) widget in `dashboard.create` and `dashboard.update` methods. ::: noteimportant Widget `fields` properties are not validated during the creation or update of a dashboard. This allows users to modify [built-in widgets](/manual/web_interface/frontend_sections/dashboards/widgets) and create [custom widgets](/devel/modules/tutorials/widget), but also introduces the risk of creating or updating widgets incorrectly. To ensure the successful creation or update of the *Geomap* widget, please refer to the parameter behavior outlined in the tables below. ::: ### Apraksts Šie parametri un iespējamās īpašību vērtības attiecīgajiem paneļa logrīka lauku objektiem ļauj konfigurēt [*Geomap*](/manual/web_interface/frontend_sections/dashboards/widgets/geomap) logrīku `dashboard.create` un `dashboard.update` metodēs. ::: noteimportant Logrīka `fields` īpašības netiek validētas paneļa izveides vai atjaunināšanas laikā. Tas ļauj lietotājiem modificēt [iebūvētos logrīkus](/manual/web_interface/frontend_sections/dashboards/widgets) un izveidot [pielāgotus logrīkus](/devel/modules/tutorials/widget), taču vienlaikus rada arī risku izveidot vai atjaunināt logrīkus nepareizi. Lai nodrošinātu veiksmīgu *Geomap* logrīka izveidi vai atjaunināšanu, lūdzu, skatiet tālāk esošajās tabulās aprakstīto parametru darbību. ::: ### Description These parameters and the possible property values for the respective dashboard widget field objects allow to configure the [*Graph (classic)*](/manual/web_interface/frontend_sections/dashboards/widgets/graph_classic) widget in `dashboard.create` and `dashboard.update` methods. ::: noteimportant Widget `fields` properties are not validated during the creation or update of a dashboard. This allows users to modify [built-in widgets](/manual/web_interface/frontend_sections/dashboards/widgets) and create [custom widgets](/devel/modules/tutorials/widget), but also introduces the risk of creating or updating widgets incorrectly. To ensure the successful creation or update of the *Graph (classic)* widget, please refer to the parameter behavior outlined in the tables below. ::: ### Apraksts Šie parametri un iespējamās attiecīgo paneļa logrīka lauku objektu īpašību vērtības ļauj konfigurēt [*Graph (classic)*](/manual/web_interface/frontend_sections/dashboards/widgets/graph_classic) logrīku `dashboard.create` un `dashboard.update` metodēs. ::: noteimportant Logrīka `fields` īpašības netiek validētas paneļa izveides vai atjaunināšanas laikā. Tas ļauj lietotājiem modificēt [iebūvētos logrīkus](/manual/web_interface/frontend_sections/dashboards/widgets) un izveidot [pielāgotus logrīkus](/devel/modules/tutorials/widget), taču vienlaikus rada arī risku izveidot vai atjaunināt logrīkus nepareizi. Lai nodrošinātu veiksmīgu *Graph (classic)* logrīka izveidi vai atjaunināšanu, lūdzu, skatiet tālāk esošajās tabulās aprakstīto parametru darbību. ::: ### Description These parameters and the possible property values for the respective dashboard widget field objects allow to configure the [*Graph*](/manual/web_interface/frontend_sections/dashboards/widgets/graph) widget in `dashboard.create` and `dashboard.update` methods. ::: noteimportant Widget `fields` properties are not validated during the creation or update of a dashboard. This allows users to modify [built-in widgets](/manual/web_interface/frontend_sections/dashboards/widgets) and create [custom widgets](/devel/modules/tutorials/widget), but also introduces the risk of creating or updating widgets incorrectly. To ensure the successful creation or update of the *Graph* widget, please refer to the parameter behavior outlined in the tables below. ::: ### Apraksts Šie parametri un iespējamās attiecīgo paneļa logrīka lauku objektu rekvizītu vērtības ļauj konfigurēt [*Graph*](/manual/web_interface/frontend_sections/dashboards/widgets/graph) logrīku `dashboard.create` un `dashboard.update` metodēs. ::: noteimportant Logrīka `fields` rekvizīti netiek validēti paneļa izveides vai atjaunināšanas laikā. Tas ļauj lietotājiem modificēt [iebūvētos logrīkus](/manual/web_interface/frontend_sections/dashboards/widgets) un izveidot [pielāgotus logrīkus](/devel/modules/tutorials/widget), taču vienlaikus rada arī risku logrīkus izveidot vai atjaunināt nepareizi. Lai nodrošinātu veiksmīgu *Graph* logrīka izveidi vai atjaunināšanu, lūdzu, skatiet tālāk esošajās tabulās aprakstīto parametru darbību. ::: ### Description These parameters and the possible property values for the respective dashboard widget field objects allow to configure the [*Graph prototype*](/manual/web_interface/frontend_sections/dashboards/widgets/graph_prototype) widget in `dashboard.create` and `dashboard.update` methods. ::: noteimportant Widget `fields` properties are not validated during the creation or update of a dashboard. This allows users to modify [built-in widgets](/manual/web_interface/frontend_sections/dashboards/widgets) and create [custom widgets](/devel/modules/tutorials/widget), but also introduces the risk of creating or updating widgets incorrectly. To ensure the successful creation or update of the *Graph prototype* widget, please refer to the parameter behavior outlined in the tables below. ::: ### Apraksts Šie parametri un iespējamās attiecīgo paneļa logrīka lauku objektu īpašību vērtības ļauj konfigurēt [*Graph prototype*](/manual/web_interface/frontend_sections/dashboards/widgets/graph_prototype) logrīku `dashboard.create` un `dashboard.update` metodēs. ::: noteimportant Logrīka `fields` īpašības netiek validētas paneļa izveides vai atjaunināšanas laikā. Tas ļauj lietotājiem modificēt [iebūvētos logrīkus](/manual/web_interface/frontend_sections/dashboards/widgets) un izveidot [pielāgotus logrīkus](/devel/modules/tutorials/widget), taču vienlaikus rada arī risku izveidot vai atjaunināt logrīkus nepareizi. Lai nodrošinātu veiksmīgu *Graph prototype* logrīka izveidi vai atjaunināšanu, lūdzu, skatiet tālāk esošajās tabulās aprakstīto parametru darbību. ::: ### Description These parameters and the possible property values for the respective dashboard widget field objects allow to configure the [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb) widget in `dashboard.create` and `dashboard.update` methods. ::: noteimportant Widget `fields` properties are not validated during the creation or update of a dashboard. This allows users to modify [built-in widgets](/manual/web_interface/frontend_sections/dashboards/widgets) and create [custom widgets](/devel/modules/tutorials/widget), but also introduces the risk of creating or updating widgets incorrectly. To ensure the successful creation or update of the *Honeycomb* widget, please refer to the parameter behavior outlined in the tables below. ::: ### Apraksts Šie parametri un iespējamās īpašību vērtības attiecīgajiem paneļa logrīka lauku objektiem ļauj konfigurēt [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb) logrīku `dashboard.create` un `dashboard.update` metodēs. ::: noteimportant Logrīka `fields` īpašības netiek validētas paneļa izveides vai atjaunināšanas laikā. Tas ļauj lietotājiem modificēt [iebūvētos logrīkus](/manual/web_interface/frontend_sections/dashboards/widgets) un izveidot [pielāgotus logrīkus](/devel/modules/tutorials/widget), taču vienlaikus rada arī risku logrīkus izveidot vai atjaunināt nepareizi. Lai nodrošinātu veiksmīgu *Honeycomb* logrīka izveidi vai atjaunināšanu, lūdzu, skatiet parametru darbību, kas aprakstīta tālāk esošajās tabulās. ::: ### Description These parameters and the possible property values for the respective dashboard widget field objects allow to configure the [*Host availability*](/manual/web_interface/frontend_sections/dashboards/widgets/host_availability) widget in `dashboard.create` and `dashboard.update` methods. ### Apraksts Šie parametri un iespējamās īpašību vērtības attiecīgajiem paneļa logrīka lauku objektiem ļauj konfigurēt [*Host availability*](/manual/web_interface/frontend_sections/dashboards/widgets/host_availability) logrīku `dashboard.create` un `dashboard.update` metodēs. ### Description These parameters and the possible property values for the respective dashboard widget field objects allow to configure the [*Host navigator*](/manual/web_interface/frontend_sections/dashboards/widgets/host_navigator) widget in `dashboard.create` and `dashboard.update` methods. ::: noteimportant Widget `fields` properties are not validated during the creation or update of a dashboard. This allows users to modify [built-in widgets](/manual/web_interface/frontend_sections/dashboards/widgets) and create [custom widgets](/devel/modules/tutorials/widget), but also introduces the risk of creating or updating widgets incorrectly. To ensure the successful creation or update of the *Host navigator* widget, please refer to the parameter behavior outlined in the tables below. ::: ### Apraksts Šie parametri un iespējamās attiecīgo paneļa logrīka lauku objektu rekvizītu vērtības ļauj konfigurēt [*Host navigator*](/manual/web_interface/frontend_sections/dashboards/widgets/host_navigator) logrīku `dashboard.create` un `dashboard.update` metodēs. ::: noteimportant Logrīka `fields` rekvizīti netiek validēti paneļa izveides vai atjaunināšanas laikā. Tas ļauj lietotājiem modificēt [iebūvētos logrīkus](/manual/web_interface/frontend_sections/dashboards/widgets) un izveidot [pielāgotus logrīkus](/devel/modules/tutorials/widget), taču vienlaikus rada arī risku izveidot vai atjaunināt logrīkus nepareizi. Lai nodrošinātu veiksmīgu *Host navigator* logrīka izveidi vai atjaunināšanu, lūdzu, skatiet tālāk esošajās tabulās aprakstīto parametru darbību. ::: ### Description These parameters and the possible property values for the respective dashboard widget field objects allow to configure the [*Item history*](/manual/web_interface/frontend_sections/dashboards/widgets/item_history) widget in `dashboard.create` and `dashboard.update` methods. ::: noteimportant Widget `fields` properties are not validated during the creation or update of a dashboard. This allows users to modify [built-in widgets](/manual/web_interface/frontend_sections/dashboards/widgets) and create [custom widgets](/devel/modules/tutorials/widget), but also introduces the risk of creating or updating widgets incorrectly. To ensure the successful creation or update of the *Item history* widget, please refer to the parameter behavior outlined in the tables below. ::: ### Apraksts Šie parametri un iespējamās īpašību vērtības attiecīgajiem paneļa logrīka lauku objektiem ļauj konfigurēt logrīku [*Vienuma vēsture*](/manual/web_interface/frontend_sections/dashboards/widgets/item_history) metodēs `dashboard.create` un `dashboard.update`. ::: noteimportant Logrīka `fields` īpašības netiek validētas paneļa izveides vai atjaunināšanas laikā. Tas ļauj lietotājiem modificēt [iebūvētos logrīkus](/manual/web_interface/frontend_sections/dashboards/widgets) un izveidot [pielāgotus logrīkus](/devel/modules/tutorials/widget), taču vienlaikus rada arī risku izveidot vai atjaunināt logrīkus nepareizi. Lai nodrošinātu veiksmīgu logrīka *Vienuma vēsture* izveidi vai atjaunināšanu, lūdzu, skatiet parametru darbību, kas aprakstīta tālāk esošajās tabulās. ::: ### Description These parameters and the possible property values for the respective dashboard widget field objects allow to configure the [*Item navigator*](/manual/web_interface/frontend_sections/dashboards/widgets/item_navigator) widget in `dashboard.create` and `dashboard.update` methods. ::: noteimportant Widget `fields` properties are not validated during the creation or update of a dashboard. This allows users to modify [built-in widgets](/manual/web_interface/frontend_sections/dashboards/widgets) and create [custom widgets](/devel/modules/tutorials/widget), but also introduces the risk of creating or updating widgets incorrectly. To ensure the successful creation or update of the *Item navigator* widget, please refer to the parameter behavior outlined in the tables below. ::: ### Apraksts Šie parametri un iespējamās īpašību vērtības attiecīgajiem paneļa logrīka lauku objektiem ļauj konfigurēt [*Vienumu navigatora*](/manual/web_interface/frontend_sections/dashboards/widgets/item_navigator) logrīku `dashboard.create` un `dashboard.update` metodēs. ::: noteimportant Logrīka `fields` īpašības netiek validētas paneļa izveides vai atjaunināšanas laikā. Tas ļauj lietotājiem modificēt [iebūvētos logrīkus](/manual/web_interface/frontend_sections/dashboards/widgets) un izveidot [pielāgotus logrīkus](/devel/modules/tutorials/widget), taču vienlaikus rada arī risku izveidot vai atjaunināt logrīkus nepareizi. Lai nodrošinātu veiksmīgu *Vienumu navigatora* logrīka izveidi vai atjaunināšanu, lūdzu, skatiet parametru darbību, kas aprakstīta tālāk esošajās tabulās. ::: ### Description These parameters and the possible property values for the respective dashboard widget field objects allow to configure the [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value) widget in `dashboard.create` and `dashboard.update` methods. ::: noteimportant Widget `fields` properties are not validated during the creation or update of a dashboard. This allows users to modify [built-in widgets](/manual/web_interface/frontend_sections/dashboards/widgets) and create [custom widgets](/devel/modules/tutorials/widget), but also introduces the risk of creating or updating widgets incorrectly. To ensure the successful creation or update of the *Item value* widget, please refer to the parameter behavior outlined in the tables below. ::: ### Apraksts Šie parametri un iespējamās īpašību vērtības attiecīgajiem paneļa logrīka lauka objektiem ļauj konfigurēt [*Vienuma vērtība*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value) logrīku `dashboard.create` un `dashboard.update` metodēs. ::: noteimportant Logrīka `fields` īpašības netiek validētas paneļa izveides vai atjaunināšanas laikā. Tas ļauj lietotājiem modificēt [iebūvētos logrīkus](/manual/web_interface/frontend_sections/dashboards/widgets) un izveidot [pielāgotus logrīkus](/devel/modules/tutorials/widget), taču vienlaikus rada arī risku izveidot vai atjaunināt logrīkus nepareizi. Lai nodrošinātu veiksmīgu *Vienuma vērtība* logrīka izveidi vai atjaunināšanu, lūdzu, skatiet parametru darbību, kas aprakstīta tālāk esošajās tabulās. ::: ### Description These parameters and the possible property values for the respective dashboard widget field objects allow to configure the [*Map*](/manual/web_interface/frontend_sections/dashboards/widgets/map) widget in `dashboard.create` and `dashboard.update` methods. ::: noteimportant Widget `fields` properties are not validated during the creation or update of a dashboard. This allows users to modify [built-in widgets](/manual/web_interface/frontend_sections/dashboards/widgets) and create [custom widgets](/devel/modules/tutorials/widget), but also introduces the risk of creating or updating widgets incorrectly. To ensure the successful creation or update of the *Map* widget, please refer to the parameter behavior outlined in the tables below. ::: ### Apraksts Šie parametri un iespējamās īpašību vērtības attiecīgajiem paneļa logrīka lauku objektiem ļauj konfigurēt [*Map*](/manual/web_interface/frontend_sections/dashboards/widgets/map) logrīku `dashboard.create` un `dashboard.update` metodēs. ::: noteimportant Logrīka `fields` īpašības netiek validētas paneļa izveides vai atjaunināšanas laikā. Tas ļauj lietotājiem modificēt [iebūvētos logrīkus](/manual/web_interface/frontend_sections/dashboards/widgets) un izveidot [pielāgotus logrīkus](/devel/modules/tutorials/widget), taču vienlaikus rada arī risku izveidot vai atjaunināt logrīkus nepareizi. Lai nodrošinātu veiksmīgu *Map* logrīka izveidi vai atjaunināšanu, lūdzu, skatiet tālāk esošajās tabulās aprakstīto parametru darbību. ::: ### Description These parameters and the possible property values for the respective dashboard widget field objects allow to configure the [*Map navigation tree*](/manual/web_interface/frontend_sections/dashboards/widgets/map_tree) widget in `dashboard.create` and `dashboard.update` methods. ::: noteimportant Widget `fields` properties are not validated during the creation or update of a dashboard. This allows users to modify [built-in widgets](/manual/web_interface/frontend_sections/dashboards/widgets) and create [custom widgets](/devel/modules/tutorials/widget), but also introduces the risk of creating or updating widgets incorrectly. To ensure the successful creation or update of the *Map navigation tree* widget, please refer to the parameter behavior outlined in the tables below. ::: ### Apraksts Šie parametri un iespējamās īpašību vērtības attiecīgajiem paneļa logrīka lauku objektiem ļauj konfigurēt [*Kartes navigācijas koks*](/manual/web_interface/frontend_sections/dashboards/widgets/map_tree) logrīku `dashboard.create` un `dashboard.update` metodēs. ::: noteimportant Logrīka `fields` īpašības netiek validētas paneļa izveides vai atjaunināšanas laikā. Tas ļauj lietotājiem modificēt [iebūvētos logrīkus](/manual/web_interface/frontend_sections/dashboards/widgets) un izveidot [pielāgotus logrīkus](/devel/modules/tutorials/widget), taču vienlaikus rada arī risku izveidot vai atjaunināt logrīkus nepareizi. Lai nodrošinātu veiksmīgu *Kartes navigācijas koks* logrīka izveidi vai atjaunināšanu, lūdzu, skatiet parametru darbību, kas aprakstīta tālāk esošajās tabulās. ::: ### Description These parameters and the possible property values for the respective dashboard widget field objects allow to configure the [*Pie chart*](/manual/web_interface/frontend_sections/dashboards/widgets/pie_chart) widget in `dashboard.create` and `dashboard.update` methods. ::: noteimportant Widget `fields` properties are not validated during the creation or update of a dashboard. This allows users to modify [built-in widgets](/manual/web_interface/frontend_sections/dashboards/widgets) and create [custom widgets](/devel/modules/tutorials/widget), but also introduces the risk of creating or updating widgets incorrectly. To ensure the successful creation or update of the *Pie chart* widget, please refer to the parameter behavior outlined in the tables below. ::: ### Apraksts Šie parametri un iespējamās attiecīgo paneļa logrīka lauku objektu īpašību vērtības ļauj konfigurēt [*Sektoru diagrammas*](/manual/web_interface/frontend_sections/dashboards/widgets/pie_chart) logrīku `dashboard.create` un `dashboard.update` metodēs. ::: noteimportant Logrīka `fields` īpašības netiek validētas paneļa izveides vai atjaunināšanas laikā. Tas ļauj lietotājiem modificēt [iebūvētos logrīkus](/manual/web_interface/frontend_sections/dashboards/widgets) un izveidot [pielāgotus logrīkus](/devel/modules/tutorials/widget), taču vienlaikus rada arī risku izveidot vai atjaunināt logrīkus nepareizi. Lai nodrošinātu veiksmīgu *Sektoru diagrammas* logrīka izveidi vai atjaunināšanu, lūdzu, skatiet tālāk esošajās tabulās aprakstīto parametru darbību. ::: ### Description These parameters and the possible property values for the respective dashboard widget field objects allow to configure the [*Problem hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/problem_hosts) widget in `dashboard.create` and `dashboard.update` methods. ::: noteimportant Widget `fields` properties are not validated during the creation or update of a dashboard. This allows users to modify [built-in widgets](/manual/web_interface/frontend_sections/dashboards/widgets) and create [custom widgets](/devel/modules/tutorials/widget), but also introduces the risk of creating or updating widgets incorrectly. To ensure the successful creation or update of the *Problem hosts* widget, please refer to the parameter behavior outlined in the tables below. ::: ### Apraksts Šie parametri un iespējamās attiecīgo paneļa logrīka lauku objektu īpašību vērtības ļauj konfigurēt [*Problem hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/problem_hosts) logrīku `dashboard.create` un `dashboard.update` metodēs. ::: noteimportant Logrīka `fields` īpašības netiek validētas paneļa izveides vai atjaunināšanas laikā. Tas ļauj lietotājiem modificēt [iebūvētos logrīkus](/manual/web_interface/frontend_sections/dashboards/widgets) un izveidot [pielāgotus logrīkus](/devel/modules/tutorials/widget), taču vienlaikus rada arī risku logrīkus izveidot vai atjaunināt nepareizi. Lai nodrošinātu veiksmīgu *Problem hosts* logrīka izveidi vai atjaunināšanu, lūdzu, skatiet tālāk esošajās tabulās aprakstīto parametru darbību. ::: ### Description These parameters and the possible property values for the respective dashboard widget field objects allow to configure the [*Problems by severity*](/manual/web_interface/frontend_sections/dashboards/widgets/problems_severity) widget in `dashboard.create` and `dashboard.update` methods. ::: noteimportant Widget `fields` properties are not validated during the creation or update of a dashboard. This allows users to modify [built-in widgets](/manual/web_interface/frontend_sections/dashboards/widgets) and create [custom widgets](/devel/modules/tutorials/widget), but also introduces the risk of creating or updating widgets incorrectly. To ensure the successful creation or update of the *Problems by severity* widget, please refer to the parameter behavior outlined in the tables below. ::: ### Apraksts Šie parametri un iespējamās attiecīgo paneļa logrīka lauku objektu īpašību vērtības ļauj konfigurēt logrīku [*Problēmas pēc nopietnības*](/manual/web_interface/frontend_sections/dashboards/widgets/problems_severity) `dashboard.create` un `dashboard.update` metodēs. ::: noteimportant Logrīka `fields` īpašības netiek validētas paneļa izveides vai atjaunināšanas laikā. Tas ļauj lietotājiem modificēt [iebūvētos logrīkus](/manual/web_interface/frontend_sections/dashboards/widgets) un izveidot [pielāgotus logrīkus](/devel/modules/tutorials/widget), taču vienlaikus rada arī risku logrīkus izveidot vai atjaunināt nepareizi. Lai nodrošinātu veiksmīgu logrīka *Problēmas pēc nopietnības* izveidi vai atjaunināšanu, lūdzu, skatiet tālāk esošajās tabulās aprakstīto parametru darbību. ::: ### Description These parameters and the possible property values for the respective dashboard widget field objects allow to configure the [*Problems*](/manual/web_interface/frontend_sections/dashboards/widgets/problems) widget in `dashboard.create` and `dashboard.update` methods. ::: noteimportant Widget `fields` properties are not validated during the creation or update of a dashboard. This allows users to modify [built-in widgets](/manual/web_interface/frontend_sections/dashboards/widgets) and create [custom widgets](/devel/modules/tutorials/widget), but also introduces the risk of creating or updating widgets incorrectly. To ensure the successful creation or update of the *Problems* widget, please refer to the parameter behavior outlined in the tables below. ::: ### Apraksts Šie parametri un iespējamās attiecīgo paneļa logrīka lauku objektu īpašību vērtības ļauj konfigurēt logrīku [*Problems*](/manual/web_interface/frontend_sections/dashboards/widgets/problems) metodēs `dashboard.create` un `dashboard.update`. ::: noteimportant Logrīka `fields` īpašības netiek validētas paneļa izveides vai atjaunināšanas laikā. Tas ļauj lietotājiem modificēt [iebūvētos logrīkus](/manual/web_interface/frontend_sections/dashboards/widgets) un izveidot [pielāgotus logrīkus](/devel/modules/tutorials/widget), taču vienlaikus rada arī risku izveidot vai atjaunināt logrīkus nepareizi. Lai nodrošinātu veiksmīgu logrīka *Problems* izveidi vai atjaunināšanu, lūdzu, skatiet tālāk esošajās tabulās aprakstīto parametru darbību. ::: ### Description These parameters and the possible property values for the respective dashboard widget field objects allow to configure the [*SLA report*](/manual/web_interface/frontend_sections/dashboards/widgets/sla_report) widget in `dashboard.create` and `dashboard.update` methods. ::: noteimportant Widget `fields` properties are not validated during the creation or update of a dashboard. This allows users to modify [built-in widgets](/manual/web_interface/frontend_sections/dashboards/widgets) and create [custom widgets](/devel/modules/tutorials/widget), but also introduces the risk of creating or updating widgets incorrectly. To ensure the successful creation or update of the *SLA report* widget, please refer to the parameter behavior outlined in the tables below. ::: ### Apraksts Šie parametri un iespējamās attiecīgo paneļa logrīka lauku objektu īpašību vērtības ļauj konfigurēt [*SLA report*](/manual/web_interface/frontend_sections/dashboards/widgets/sla_report) logrīku `dashboard.create` un `dashboard.update` metodēs. ::: noteimportant Logrīka `fields` īpašības netiek validētas paneļa izveides vai atjaunināšanas laikā. Tas ļauj lietotājiem modificēt [iebūvētos logrīkus](/manual/web_interface/frontend_sections/dashboards/widgets) un izveidot [pielāgotus logrīkus](/devel/modules/tutorials/widget), taču vienlaikus rada arī risku logrīkus izveidot vai atjaunināt nepareizi. Lai nodrošinātu veiksmīgu *SLA report* logrīka izveidi vai atjaunināšanu, lūdzu, skatiet tālāk esošajās tabulās aprakstīto parametru darbību. ::: ### Description These parameters and the possible property values for the respective dashboard widget field objects allow to configure the [*System Information*](/manual/web_interface/frontend_sections/dashboards/widgets/system) widget in `dashboard.create` and `dashboard.update` methods. ::: noteimportant Widget `fields` properties are not validated during the creation or update of a dashboard. This allows users to modify [built-in widgets](/manual/web_interface/frontend_sections/dashboards/widgets) and create [custom widgets](/devel/modules/tutorials/widget), but also introduces the risk of creating or updating widgets incorrectly. To ensure the successful creation or update of the *System information* widget, please refer to the parameter behavior outlined in the tables below. ::: ### Apraksts Šie parametri un iespējamās īpašību vērtības attiecīgajiem paneļa logrīka lauku objektiem ļauj konfigurēt [*Sistēmas informācija*](/manual/web_interface/frontend_sections/dashboards/widgets/system) logrīku `dashboard.create` un `dashboard.update` metodēs. ::: noteimportant Logrīka `fields` īpašības netiek validētas paneļa izveides vai atjaunināšanas laikā. Tas ļauj lietotājiem modificēt [iebūvētos logrīkus](/manual/web_interface/frontend_sections/dashboards/widgets) un izveidot [pielāgotus logrīkus](/devel/modules/tutorials/widget), bet vienlaikus rada arī risku izveidot vai atjaunināt logrīkus nepareizi. Lai nodrošinātu veiksmīgu *Sistēmas informācija* logrīka izveidi vai atjaunināšanu, lūdzu, skatiet parametru darbību, kas aprakstīta tālāk esošajās tabulās. ::: ### Description These parameters and the possible property values for the respective dashboard widget field objects allow to configure the [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts) widget in `dashboard.create` and `dashboard.update` methods. ::: noteimportant Widget `fields` properties are not validated during the creation or update of a dashboard. This allows users to modify [built-in widgets](/manual/web_interface/frontend_sections/dashboards/widgets) and create [custom widgets](/devel/modules/tutorials/widget), but also introduces the risk of creating or updating widgets incorrectly. To ensure the successful creation or update of the *Top hosts* widget, please refer to the parameter behavior outlined in the tables below. ::: ### Apraksts Šie parametri un iespējamās īpašību vērtības attiecīgajiem paneļa logrīka lauku objektiem ļauj konfigurēt [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts) logrīku `dashboard.create` un `dashboard.update` metodēs. ::: noteimportant Logrīka `fields` īpašības netiek validētas paneļa izveides vai atjaunināšanas laikā. Tas ļauj lietotājiem modificēt [iebūvētos logrīkus](/manual/web_interface/frontend_sections/dashboards/widgets) un izveidot [pielāgotus logrīkus](/devel/modules/tutorials/widget), taču vienlaikus rada arī risku izveidot vai atjaunināt logrīkus nepareizi. Lai nodrošinātu veiksmīgu *Top hosts* logrīka izveidi vai atjaunināšanu, lūdzu, skatiet tālāk esošajās tabulās aprakstīto parametru darbību. ::: ### Description These parameters and the possible property values for the respective dashboard widget field objects allow to configure the [*Top triggers*](/manual/web_interface/frontend_sections/dashboards/widgets/top_triggers) widget in `dashboard.create` and `dashboard.update` methods. ::: noteimportant Widget `fields` properties are not validated during the creation or update of a dashboard. This allows users to modify [built-in widgets](/manual/web_interface/frontend_sections/dashboards/widgets) and create [custom widgets](/devel/modules/tutorials/widget), but also introduces the risk of creating or updating widgets incorrectly. To ensure the successful creation or update of the *Top triggers* widget, please refer to the parameter behavior outlined in the tables below. ::: ### Apraksts Šie parametri un iespējamās īpašību vērtības attiecīgajiem paneļa logrīka lauku objektiem ļauj konfigurēt [*Top trigeri*](/manual/web_interface/frontend_sections/dashboards/widgets/top_triggers) logrīku `dashboard.create` un `dashboard.update` metodēs. ::: noteimportant Logrīka `fields` īpašības netiek validētas paneļa izveides vai atjaunināšanas laikā. Tas ļauj lietotājiem modificēt [iebūvētos logrīkus](/manual/web_interface/frontend_sections/dashboards/widgets) un izveidot [pielāgotus logrīkus](/devel/modules/tutorials/widget), taču vienlaikus rada arī risku izveidot vai atjaunināt logrīkus nepareizi. Lai nodrošinātu veiksmīgu *Top trigeri* logrīka izveidi vai atjaunināšanu, lūdzu, skatiet tālāk esošajās tabulās aprakstīto parametru darbību. ::: ### Description These parameters and the possible property values for the respective dashboard widget field objects allow to configure the [*Trigger overview*](/manual/web_interface/frontend_sections/dashboards/widgets/trigger_overview) widget in `dashboard.create` and `dashboard.update` methods. ::: noteimportant Widget `fields` properties are not validated during the creation or update of a dashboard. This allows users to modify [built-in widgets](/manual/web_interface/frontend_sections/dashboards/widgets) and create [custom widgets](/devel/modules/tutorials/widget), but also introduces the risk of creating or updating widgets incorrectly. To ensure the successful creation or update of the *Trigger overview* widget, please refer to the parameter behavior outlined in the tables below. ::: ### Apraksts Šie parametri un iespējamās attiecīgo paneļa logrīka lauku objektu īpašību vērtības ļauj konfigurēt [*Trigeru pārskata*](/manual/web_interface/frontend_sections/dashboards/widgets/trigger_overview) logrīku `dashboard.create` un `dashboard.update` metodēs. ::: noteimportant Logrīka `fields` īpašības netiek validētas paneļa izveides vai atjaunināšanas laikā. Tas ļauj lietotājiem modificēt [iebūvētos logrīkus](/manual/web_interface/frontend_sections/dashboards/widgets) un izveidot [pielāgotus logrīkus](/devel/modules/tutorials/widget), taču vienlaikus rada arī risku izveidot vai atjaunināt logrīkus nepareizi. Lai nodrošinātu veiksmīgu *Trigeru pārskata* logrīka izveidi vai atjaunināšanu, lūdzu, skatiet tālāk esošajās tabulās aprakstīto parametru darbību. ::: ### Description These parameters and the possible property values for the respective dashboard widget field objects allow to configure the [*URL*](/manual/web_interface/frontend_sections/dashboards/widgets/url) widget in `dashboard.create` and `dashboard.update` methods. ::: noteimportant Widget `fields` properties are not validated during the creation or update of a dashboard. This allows users to modify [built-in widgets](/manual/web_interface/frontend_sections/dashboards/widgets) and create [custom widgets](/devel/modules/tutorials/widget), but also introduces the risk of creating or updating widgets incorrectly. To ensure the successful creation or update of the *URL* widget, please refer to the parameter behavior outlined in the tables below. ::: ### Apraksts Šie parametri un iespējamās attiecīgo paneļa logrīka lauku objektu īpašību vērtības ļauj konfigurēt [*URL*](/manual/web_interface/frontend_sections/dashboards/widgets/url) logrīku `dashboard.create` un `dashboard.update` metodēs. ::: noteimportant Logrīka `fields` īpašības netiek validētas paneļa izveides vai atjaunināšanas laikā. Tas ļauj lietotājiem modificēt [iebūvētos logrīkus](/manual/web_interface/frontend_sections/dashboards/widgets) un izveidot [pielāgotus logrīkus](/devel/modules/tutorials/widget), bet vienlaikus rada arī risku izveidot vai atjaunināt logrīkus nepareizi. Lai nodrošinātu veiksmīgu *URL* logrīka izveidi vai atjaunināšanu, lūdzu, skatiet tālāk esošajās tabulās aprakstīto parametru darbību. ::: ### Description These parameters and the possible property values for the respective dashboard widget field objects allow to configure the [*Web monitoring*](/manual/web_interface/frontend_sections/dashboards/widgets/web_monitoring) widget in `dashboard.create` and `dashboard.update` methods. ::: noteimportant Widget `fields` properties are not validated during the creation or update of a dashboard. This allows users to modify [built-in widgets](/manual/web_interface/frontend_sections/dashboards/widgets) and create [custom widgets](/devel/modules/tutorials/widget), but also introduces the risk of creating or updating widgets incorrectly. To ensure the successful creation or update of the *Web monitoring* widget, please refer to the parameter behavior outlined in the tables below. ::: ### Apraksts Šie parametri un iespējamās attiecīgo paneļa logrīka lauku objektu īpašību vērtības ļauj konfigurēt [*Tīmekļa uzraudzības*](/manual/web_interface/frontend_sections/dashboards/widgets/web_monitoring) logrīku `dashboard.create` un `dashboard.update` metodēs. ::: noteimportant Logrīka `fields` īpašības netiek validētas paneļa izveides vai atjaunināšanas laikā. Tas ļauj lietotājiem modificēt [iebūvētos logrīkus](/manual/web_interface/frontend_sections/dashboards/widgets) un izveidot [pielāgotus logrīkus](/devel/modules/tutorials/widget), bet vienlaikus rada arī risku izveidot vai atjaunināt logrīkus nepareizi. Lai nodrošinātu veiksmīgu *Tīmekļa uzraudzības* logrīka izveidi vai atjaunināšanu, lūdzu, skatiet parametru darbību, kas aprakstīta tālāk esošajās tabulās. ::: ## DESCRIPTION **zabbix\_agent2** is an application for monitoring parameters of various services.\ \ [ ]{#lbAE} ## APRAKSTS **zabbix\_aģents2** ir lietojumprogramma dažādu pakalpojumu parametru monitorēšanai.\ \ [ ]{#lbAE} ## DESCRIPTION **zabbix\_agentd** is a daemon for monitoring various server parameters. [ ]{#lbAE} ## APRAKSTS **zabbix\_agentd** ir dēmons dažādu servera parametru uzraudzībai. [ ]{#lbAE} #### Details about export - All supported elements are exported in one file. - Host and template entities (items, triggers, graphs, discovery rules) that are inherited from linked templates are not exported. Any changes made to those entities on a host level (such as changed item interval, modified regular expression or added prototypes to the low-level discovery rule) will be lost when exporting; when importing, all entities from linked templates are re-created as on the original linked template. - Entities created by low-level discovery and any entities depending on them are not exported. For example, a trigger created for an LLD-rule generated item will not be exported. - When the exported host/template contains entities supporting timeouts, the timeout values will be exported if these entities have their own timeouts configured. #### Informācija par eksportēšanu - Visi atbalstītie elementi tiek eksportēti vienā failā. - No saistītajām veidnēm mantotās hostu un veidņu entītijas (vienumi, trigeri, grafiki, atklāšanas kārtulas) netiek eksportētas. Visas izmaiņas, kas veiktas šajās entītijās hosta līmenī (piemēram, mainīts vienuma intervāls, modificēta regulārā izteiksme vai zema līmeņa atklāšanas kārtulai pievienoti prototipi), eksportēšanas laikā tiks zaudētas; importēšanas laikā visas entītijas no saistītajām veidnēm tiek izveidotas no jauna tāpat kā sākotnējā saistītajā veidnē. - Zema līmeņa atklāšanas izveidotās entītijas un visas no tām atkarīgās entītijas netiek eksportētas. Piemēram, trigeris, kas izveidots vienumam, kuru ģenerējusi ZLA kārtula, netiks eksportēts. - Ja eksportētais hosts/veidne satur entītijas, kas atbalsta noildzes, noildzes vērtības tiks eksportētas, ja šīm entītijām ir konfigurētas savas noildzes. #### Details about import - Import stops at the first error. - When updating existing images during image import, "imagetype" field is ignored, i.e., it is impossible to change image type via import. - When importing hosts/templates using the "Delete missing" option, host/template macros not present in the import file will be deleted from the host/template after the import. - Empty tags for items, triggers, graphs, discoveryRules, itemPrototypes, triggerPrototypes, graphPrototypes are meaningless, i.e., it's the same as if it was missing. - If entities of the imported host/template have their own timeouts configured, they will be applied; otherwise, proxy/global timeouts will be applied. - Import supports YAML, XML and JSON, the import file must have a correct file extension: .yaml and .yml for YAML, .xml for XML and .json for JSON. See [compatibility information](/manual/appendix/compatibility) about supported XML versions. - Import supports configuration files only in UTF-8 encoding (with or without [BOM](https://en.wikipedia.org/wiki/Byte_order_mark)); other encodings (UTF16LE, UTF16BE, UTF32LE, UTF32BE, etc.) will result in an import conversion error. #### Informācija par importēšanu - Importēšana tiek pārtraukta pie pirmās kļūdas. - Atjauninot esošos attēlus attēlu importēšanas laikā, lauks "imagetype" tiek ignorēts, t.i., attēla tipu nav iespējams mainīt, izmantojot importēšanu. - Importējot hosts/veidnes, izmantojot opciju "Delete missing", hosts/veidnes makrosi, kas nav iekļauti importēšanas failā, pēc importēšanas tiks dzēsti no hosts/veidnes. - Tukšas birkas vienumiem, trigeriem, grafikiem, discoveryRules, itemPrototypes, triggerPrototypes, graphPrototypes ir bezjēdzīgas, t.i., tas ir tas pats, it kā tās nebūtu norādītas. - Ja importētā hosts/veidnes entītijām ir konfigurēti savi noildzes laiki, tie tiks piemēroti; pretējā gadījumā tiks piemēroti starpniekservera/globālie noildzes laiki. - Importēšana atbalsta YAML, XML un JSON; importēšanas failam jābūt ar pareizu faila paplašinājumu: .yaml un .yml YAML failiem, .xml XML failiem un .json JSON failiem. Skatiet [saderības informāciju](/manual/appendix/compatibility) par atbalstītajām XML versijām. - Importēšana atbalsta tikai konfigurācijas failus UTF-8 kodējumā (ar vai bez [BOM](https://en.wikipedia.org/wiki/Byte_order_mark)); citi kodējumi (UTF16LE, UTF16BE, UTF32LE, UTF32BE u.c.) izraisīs importēšanas konvertēšanas kļūdu. #### Details The details object has the following properties. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |version|integer|SNMP interface version.<br><br>Possible values:<br>1 - SNMPv1;<br>2 - SNMPv2c;<br>3 - SNMPv3.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |bulk|integer|Whether to use bulk SNMP requests.<br><br>Possible values:<br>0 - don't use bulk requests;<br>1 - (default) - use bulk requests.| |community|string|SNMP community. Used only by SNMPv1 and SNMPv2 interfaces.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `version` is set to "SNMPv1" or "SNMPv2c"| |max_repetitions|integer|Max repetition value for [native SNMP bulk requests](#native-snmp-bulk-requests) (GetBulkRequest-PDUs).<br>Used only for `discovery[]` and `walk[]` items in SNMPv2 and v3.<br><br>Default: 10.| |securityname|string|SNMPv3 security name. Used only by SNMPv3 interfaces.| |securitylevel|integer|SNMPv3 security level. Used only by SNMPv3 interfaces.<br><br>Possible values:<br>0 - (default) - noAuthNoPriv;<br>1 - authNoPriv;<br>2 - authPriv.| |authpassphrase|string|SNMPv3 authentication passphrase. Used only by SNMPv3 interfaces.| |privpassphrase|string|SNMPv3 privacy passphrase. Used only by SNMPv3 interfaces.| |authprotocol|integer|SNMPv3 authentication protocol. Used only by SNMPv3 interfaces.<br><br>Possible values:<br>0 - (default) - MD5;<br>1 - SHA1;<br>2 - SHA224;<br>3 - SHA256;<br>4 - SHA384;<br>5 - SHA512.| |privprotocol|integer|SNMPv3 privacy protocol. Used only by SNMPv3 interfaces.<br><br>Possible values:<br>0 - (default) - DES;<br>1 - AES128;<br>2 - AES192;<br>3 - AES256;<br>4 - AES192C;<br>5 - AES256C.| |contextname|string|SNMPv3 context name. Used only by SNMPv3 interfaces.| #### Detalizēta informācija Objektam details ir šādas īpašības. |Īpašība|[Tips](/manual/api/reference_commentary#data-types)|Apraksts| |--|--|------| |version|integer|SNMP saskarnes versija.<br><br>Iespējamās vērtības:<br>1 - SNMPv1;<br>2 - SNMPv2c;<br>3 - SNMPv3.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāta*| |bulk|integer|Vai izmantot SNMP lielapjoma pieprasījumus.<br><br>Iespējamās vērtības:<br>0 - neizmantot lielapjoma pieprasījumus;<br>1 - (noklusējums) - izmantot lielapjoma pieprasījumus.| |community|string|SNMP kopiena. Tiek izmantota tikai SNMPv1 un SNMPv2 saskarnēs.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāta*, ja `version` ir iestatīts uz "SNMPv1" vai "SNMPv2c"| |max_repetitions|integer|Maksimālā atkārtojumu vērtība [vietējiem SNMP lielapjoma pieprasījumiem](#native-snmp-bulk-requests) (GetBulkRequest-PDUs).<br>Tiek izmantota tikai `discovery[]` un `walk[]` vienumiem SNMPv2 un v3.<br><br>Noklusējums: 10.| |securityname|string|SNMPv3 drošības nosaukums. Tiek izmantots tikai SNMPv3 saskarnēs.| |securitylevel|integer|SNMPv3 drošības līmenis. Tiek izmantots tikai SNMPv3 saskarnēs.<br><br>Iespējamās vērtības:<br>0 - (noklusējums) - noAuthNoPriv;<br>1 - authNoPriv;<br>2 - authPriv.| |authpassphrase|string|SNMPv3 autentifikācijas parole. Tiek izmantota tikai SNMPv3 saskarnēs.| |privpassphrase|string|SNMPv3 privātuma parole. Tiek izmantota tikai SNMPv3 saskarnēs.| |authprotocol|integer|SNMPv3 autentifikācijas protokols. Tiek izmantots tikai SNMPv3 saskarnēs.<br><br>Iespējamās vērtības:<br>0 - (noklusējums) - MD5;<br>1 - SHA1;<br>2 - SHA224;<br>3 - SHA256;<br>4 - SHA384;<br>5 - SHA512.| |privprotocol|integer|SNMPv3 privātuma protokols. Tiek izmantots tikai SNMPv3 saskarnēs.<br><br>Iespējamās vērtības:<br>0 - (noklusējums) - DES;<br>1 - AES128;<br>2 - AES192;<br>3 - AES256;<br>4 - AES192C;<br>5 - AES256C.| |contextname|string|SNMPv3 konteksta nosaukums. Tiek izmantots tikai SNMPv3 saskarnēs.| #### Details The output of this item is an array of objects each containing the following keys: - **name** - package name - **manager** - package manager that reported this data (`rpm`, `dpkg`, `pacman`, `pkgtool`, or `portage`) - **version** - package version - **size** - uncompressed package size in bytes (if not available, set to 0) - **arch** - package architecture - **buildtime** - an object with 2 entries: - **timestamp** - UNIX timestamp when the package was built (if not available, set to 0) - **value** - human readable date and time when the package was built (if not available, set to empty string) - **installtime** - an object with 2 entries: - **timestamp** - UNIX timestamp when the package was installed (if not available, set to 0) - **value** - human readable date and time when the package was installed (if not available, set to empty string) Example: ```json [ { "name": "util-linux-core", "manager": "rpm", "version": "2.37.4-3.el9", "size": 1296335, "arch": "x86_64", "buildtime": { "timestamp" : 1653552239, "value" : "Sep 20 01:39:40 2021 UTC" }, "installtime": { "timestamp" : 1660780885, "value" : "Aug 18 00:01:25 2022 UTC" } }, { "name": "xfonts-base", "manager": "dpkg", "version": "1:1.0.5", "size": 7337984, "arch": "all", "buildtime": { "timestamp": 0, "value": "" }, "installtime": { "timestamp": 0, "value": "" } } ] ``` #### Detaļas Šī vienuma izvade ir objektu masīvs, kurā katrs objekts satur šādas atslēgas: - **name** - pakotnes nosaukums - **manager** - pakotņu pārvaldnieks, kas ziņoja par šiem datiem (`rpm`, `dpkg`, `pacman`, `pkgtool` vai `portage`) - **version** - pakotnes versija - **size** - nesaspiestas pakotnes lielums baitos (ja nav pieejams, iestatiet uz 0) - **arch** - pakotnes arhitektūra - **buildtime** - objekts ar 2 ierakstiem: - **timestamp** - UNIX laikspiedols, kad pakotne tika izveidota (ja nav pieejams, iestatiet uz 0) - **value** - cilvēkam lasāms datums un laiks, kad pakotne tika izveidota (ja nav pieejams, iestatiet uz tukšu virkni) - **installtime** - objekts ar 2 ierakstiem: - **timestamp** - UNIX laikspiedols, kad pakotne tika instalēta (ja nav pieejams, iestatiet uz 0) - **value** - cilvēkam lasāms datums un laiks, kad pakotne tika instalēta (ja nav pieejams, iestatiet uz tukšu virkni) Piemērs: ```json [ { "name": "util-linux-core", "manager": "rpm", "version": "2.37.4-3.el9", "size": 1296335, "arch": "x86_64", "buildtime": { "timestamp" : 1653552239, "value" : "Sep 20 01:39:40 2021 UTC" }, "installtime": { "timestamp" : 1660780885, "value" : "Aug 18 00:01:25 2022 UTC" } }, { "name": "xfonts-base", "manager": "dpkg", "version": "1:1.0.5", "size": 7337984, "arch": "all", "buildtime": { "timestamp": 0, "value": "" }, "installtime": { "timestamp": 0, "value": "" } } ] ``` #### Details The output of this item is an object containing DNS record information based on the parameters provided in the item key. For example, the `net.dns.get[,example.com]` item may return the following JSON of a refused query: ```json { "flags": [ "RA" ], "query_time": "0.019030", "question_section": [ { "qclass": "IN", "qname": "example.com.", "qtype": "SOA" } ], "response_code": "REFUSED", "zbx_error_code": 0 } ``` By specifying the IP address of the DNS server, the `net.dns.get[192.0.2.1,example.com]` item may return the following JSON: ```json { "answer_section": [ { "class": "IN", "name": "example.com.", "rdata": { "expire": 1209600, "mbox": "noc.dns.example.org.", "minttl": 3600, "ns": "ns.example.org.", "refresh": 7200, "retry": 3600, "serial": 2022091378 }, "rdlength": 44, "ttl": 1205, "type": "SOA" } ], "flags": [ "RA" ], "query_time": "0.029556", "question_section": [ { "qclass": "IN", "qname": "example.com.", "qtype": "SOA" } ], "response_code": "NOERROR", "zbx_error_code": 0 } ``` If there is a connection problem, the `net.dns.get[192.0.2.1,example.com]` item may an error: ```json { "zbx_error_code": -1, "zbx_error_msg": "Communication error: read udp 192.0.2.1:12345->192.0.2.1:53: i/o timeout" } ``` The following types of error codes are possible: |Scenario|"zbx_error_code"|"zbx_error_msg"| |----|--|----| |No errors and the DNS response was received and parsed.|0| | |DNS is down.|-1|"Communication error"| |Error occurs during JSON parsing|-2|"Received unexpected response"| With additional parameters, the `net.dns.get[192.0.2.1,example.com,ANY,5,5,tcp,"cdflag,rdflag,dnssec,nsid,edns0,aaflag,adflag"]` item may return the following JSON: ```json { "additional_section": [ { "extended_rcode": 32768, "name": ".", "rdata": { "options": [ { "code": 0, "nsid": "67 70 64 6e 73 2d 6c 70 70" } ] }, "rdlength": 13, "type": "OPT", "udp_payload": 512 } ], "answer_section": [ { "class": "IN", "name": "example.com.", "rdata": { "a": "192.0.2.1" }, "rdlength": 4, "ttl": 19308, "type": "A" }, { "class": "IN", "name": "example.com.", "rdata": { "algorithm": 13, "expiration": 1704715951, "inception": 1702910624, "key_tag": 21021, "labels": 2, "orig_ttl": 86400, "signature": "HVBOBcJJQy0S08J3f8kviPj8UkEUj7wmyiMyQqPSWgQIY9SCEJ5plq6KuxJmtAek1txZWXDo+6tpIC6DIVBnuw==", "signer_name": "example.com.", "type_covered": "A" }, "rdlength": 95, "ttl": 19308, "type": "RRSIG" } ], "flags": [ "RD", "RA", "AD", "CD" ], "query_time": "0.058221", "question_section": [ { "qclass": "IN", "qname": "example.com.", "qtype": "ANY" } ], "response_code": "NOERROR", "zbx_error_code": 0 } ``` #### Detaļas Šī vienuma izvade ir objekts, kas satur DNS ieraksta informāciju, pamatojoties uz vienuma atslēgā norādītajiem parametriem. Piemēram, vienums `net.dns.get[,example.com]` var atgriezt šādu atteiktas vaicājuma JSON: ```json { "flags": [ "RA" ], "query_time": "0.019030", "question_section": [ { "qclass": "IN", "qname": "example.com.", "qtype": "SOA" } ], "response_code": "REFUSED", "zbx_error_code": 0 } ``` Norādot DNS servera IP adresi, vienums `net.dns.get[192.0.2.1,example.com]` var atgriezt šādu JSON: ```json { "answer_section": [ { "class": "IN", "name": "example.com.", "rdata": { "expire": 1209600, "mbox": "noc.dns.example.org.", "minttl": 3600, "ns": "ns.example.org.", "refresh": 7200, "retry": 3600, "serial": 2022091378 }, "rdlength": 44, "ttl": 1205, "type": "SOA" } ], "flags": [ "RA" ], "query_time": "0.029556", "question_section": [ { "qclass": "IN", "qname": "example.com.", "qtype": "SOA" } ], "response_code": "NOERROR", "zbx_error_code": 0 } ``` Ja rodas savienojuma problēma, vienums `net.dns.get[192.0.2.1,example.com]` var atgriezt kļūdu: ```json { "zbx_error_code": -1, "zbx_error_msg": "Communication error: read udp 192.0.2.1:12345->192.0.2.1:53: i/o timeout" } ``` Iespējami šādi kļūdu kodu veidi: |Scenārijs|"zbx_error_code"|"zbx_error_msg"| |----|--|----| |Nav kļūdu, un DNS atbilde tika saņemta un parsēta.|0| | |DNS nedarbojas.|-1|"Communication error"| |Kļūda rodas JSON parsēšanas laikā|-2|"Received unexpected response"| Ar papildu parametriem vienums `net.dns.get[192.0.2.1,example.com,ANY,5,5,tcp,"cdflag,rdflag,dnssec,nsid,edns0,aaflag,adflag"]` var atgriezt šādu JSON: ```json { "additional_section": [ { "extended_rcode": 32768, "name": ".", "rdata": { "options": [ { "code": 0, "nsid": "67 70 64 6e 73 2d 6c 70 70" } ] }, "rdlength": 13, "type": "OPT", "udp_payload": 512 } ], "answer_section": [ { "class": "IN", "name": "example.com.", "rdata": { "a": "192.0.2.1" }, "rdlength": 4, "ttl": 19308, "type": "A" }, { "class": "IN", "name": "example.com.", "rdata": { "algorithm": 13, "expiration": 1704715951, "inception": 1702910624, "key_tag": 21021, "labels": 2, "orig_ttl": 86400, "signature": "HVBOBcJJQy0S08J3f8kviPj8UkEUj7wmyiMyQqPSWgQIY9SCEJ5plq6KuxJmtAek1txZWXDo+6tpIC6DIVBnuw==", "signer_name": "example.com.", "type_covered": "A" }, "rdlength": 95, "ttl": 19308, "type": "RRSIG" } ], "flags": [ "RD", "RA", "AD", "CD" ], "query_time": "0.058221", "question_section": [ { "qclass": "IN", "qname": "example.com.", "qtype": "ANY" } ], "response_code": "NOERROR", "zbx_error_code": 0 } ``` #### Details To avoid calculations with huge numbers, we consider the timestamp of the first value in specified period plus 1 ns as a new zero-time (current epoch time is of order 10^9^, epoch squared is 10^18^, double precision is about 10^-16^). 1 ns is added to provide all positive time values for *logarithmic* and *power* fits which involve calculating log(t). Time shift does not affect *linear*, *polynomial*, *exponential* (apart from easier and more precise calculations) but changes the shape of *logarithmic* and *power* functions. #### Detaļas Lai izvairītos no aprēķiniem ar ļoti lieliem skaitļiem, mēs uzskatām norādītā perioda pirmās vērtības laika zīmogu plus 1 ns par jaunu nulles laiku (pašreizējais epoch laiks ir aptuveni 10^9^, epoch kvadrāts ir 10^18^, dubultprecizitāte ir aptuveni 10^-16^). 1 ns tiek pievienots, lai nodrošinātu visus pozitīvos laika vērtību *logaritmiskajām* un *pakāpes* pielāgošanām, kas ietver log(t) aprēķināšanu. Laika nobīde neietekmē *lineāro*, *polinomiālo*, *eksponenciālo* (izņemot vienkāršākus un precīzākus aprēķinus) pielāgojumus, taču maina *logaritmisko* un *pakāpes* funkciju formu. #### Detecting cURL library features at runtime Previously cURL library features were detected at build time of Zabbix server, proxy or agent. If cURL features were upgraded, to make use of them the respective Zabbix component had to be recompiled. Now only a restart is required for upgraded cURL library features to become available in Zabbix. Recompilation is no longer required. This is true for Zabbix server, proxy or agent. In addition: - Minimum required build-time cURL version was raised to 7.19.1; - When being built Zabbix just checks if the cURL library is available (if requested) and satisfies the version requirement; - When issuing a runtime cURL library error the version being in use will be added (e.g. "cURL library does not support SSL/TLS (using version 7.88.1)"); - When Zabbix server is started and SMTP authentication is logged it will write the availability of SMTP authentication of cURL library being used. #### cURL bibliotēkas funkciju noteikšana izpildes laikā Iepriekš cURL bibliotēkas funkcijas tika noteiktas Zabbix servera, starpniekservera vai aģenta būvēšanas laikā. Ja cURL funkcijas tika jauninātas, lai tās izmantotu, attiecīgais Zabbix komponents bija jāpārkompilē. Tagad, lai jauninātās cURL bibliotēkas funkcijas kļūtu pieejamas Zabbix, pietiek ar restartēšanu. Pārkompilēšana vairs nav nepieciešama. Tas attiecas uz Zabbix serveri, starpniekserveri vai aģentu. Turklāt: - Minimālā nepieciešamā cURL versija būvēšanas laikā tika paaugstināta līdz 7.19.1; - Būvēšanas laikā Zabbix tikai pārbauda, vai cURL bibliotēka ir pieejama (ja tas ir pieprasīts) un atbilst versijas prasībām; - Izsniedzot cURL bibliotēkas kļūdu izpildes laikā, tiks pievienota izmantotā versija (piem., "cURL library does not support SSL/TLS (using version 7.88.1)"); - Kad Zabbix serveris tiek startēts un tiek reģistrēta SMTP autentifikācija, tas pierakstīs izmantotās cURL bibliotēkas SMTP autentifikācijas pieejamību. #### Detecting cURL library features at runtime Previously cURL library features were detected at build time of Zabbix server, proxy or agent. If cURL features were upgraded, to make use of them the respective Zabbix component had to be recompiled. Now only a restart is required for upgraded cURL library features to become available in Zabbix. Recompilation is no longer required. This is true for Zabbix server, proxy or agent. See also the [upgrade notes](/manual/installation/upgrade_notes_700). #### cURL bibliotēkas funkciju noteikšana izpildes laikā Iepriekš cURL bibliotēkas funkcijas tika noteiktas Zabbix servera, starpniekservera vai aģenta būvēšanas laikā. Ja cURL funkcijas tika jauninātas, lai tās izmantotu, attiecīgais Zabbix komponents bija jāpārkompilē. Tagad, lai jauninātās cURL bibliotēkas funkcijas kļūtu pieejamas Zabbix, pietiek ar restartēšanu. Pārkompilēšana vairs nav nepieciešama. Tas attiecas uz Zabbix serveri, starpniekserveri vai aģentu. Skatiet arī [jaunināšanas piezīmes](/manual/installation/upgrade_notes_700). # Developer center # Izstrādātāju centrs ## Developer center ## Izstrādātāju centrs #### Developing modules For information about developing custom modules, see [Developer center](/devel/modules). #### Moduļu izstrāde Informāciju par pielāgotu moduļu izstrādi skatiet [Izstrādātāju centrā](/devel/modules). #### Devices List of device families for which templates are available: |Template name|Vendor|Device family|Known models|OS|MIBs used|**[Tags](/manual/config/templates_out_of_the_box/network_devices#tags)**| |----|--|--|----|--|----|-----| |*Alcatel Timetra TiMOS SNMP*|Alcatel|Alcatel Timetra|ALCATEL SR 7750|TiMOS|TIMETRA-SYSTEM-MIB,TIMETRA-CHASSIS-MIB|Certified| |*Aruba CX 8300s by SNMP*|HPE Aruba Networking|Aruba CX Switch Series|Aruba JL636A 8325, Aruba JL717A 8360|Aruba AOS-CX|ARUBAWIRED-FAN-MIB, ARUBAWIRED-POWERSUPPLY-MIB, ARUBAWIRED-SYSTEMINFO-MIB, ARUBAWIRED-TEMPSENSOR-MIB, OSPF-MIB|Certified| |*Brocade FC SNMP*|Brocade|Brocade FC switches|Brocade 300 SAN Switch-|\-|SW-MIB,ENTITY-MIB|Performance<br>Fault| |*Brocade\_Foundry Stackable SNMP*|Brocade|Brocade ICX|Brocade ICX6610, Brocade ICX7250-48, Brocade ICX7450-48F| |FOUNDRY-SN-AGENT-MIB, FOUNDRY-SN-STACKING-MIB|Certified| |*Brocade\_Foundry Nonstackable SNMP*|Brocade, Foundry|Brocade MLX, Foundry|Brocade MLXe, Foundry FLS648, Foundry FWSX424| |FOUNDRY-SN-AGENT-MIB|Performance<br>Fault| |*Check Point Next Generation Firewall by SNMP*|Check Point|Next Generation Firewall|-|Gaia|HOST-RESOURCES-MIB, CHECKPOINT-MIB, UCD-SNMP-MIB, SNMPv2-MIB, IF-MIB|Certified| |*Ciena 3906 by SNMP*|Ciena|Ciena CPE|Ciena 3906|SAOS|WWP-LEOS-BLADE-MIB, WWP-LEOS-CHASSIS-MIB, WWP-LEOS-SYSTEM-CONFIG-MIB|Certified| |*Cisco Catalyst 3750<device model> SNMP*|Cisco|Cisco Catalyst 3750|Cisco Catalyst 3750V2-24FS, Cisco Catalyst 3750V2-24PS, Cisco Catalyst 3750V2-24TS, Cisco Catalyst SNMP, Cisco Catalyst SNMP| |CISCO-MEMORY-POOL-MIB, IF-MIB, EtherLike-MIB, SNMPv2-MIB, CISCO-PROCESS-MIB, CISCO-ENVMON-MIB, ENTITY-MIB|Certified| |*Cisco IOS SNMP*|Cisco|Cisco IOS ver > 12.2 3.5|Cisco C2950|IOS|CISCO-PROCESS-MIB,CISCO-MEMORY-POOL-MIB,CISCO-ENVMON-MIB|Certified| |*Cisco IOS versions 12.0\_3\_T-12.2\_3.5 SNMP*|Cisco|Cisco IOS > 12.0 3 T and < 12.2 3.5|\-|IOS|CISCO-PROCESS-MIB,CISCO-MEMORY-POOL-MIB,CISCO-ENVMON-MIB|Certified| |*Cisco IOS prior to 12.0\_3\_T SNMP*|Cisco|Cisco IOS < 12.0 3 T|\-|IOS|OLD-CISCO-CPU-MIB,CISCO-MEMORY-POOL-MIB|Certified| |*D-Link DES\_DGS Switch SNMP*|D-Link|DES/DGX switches|D-Link DES-xxxx/DGS-xxxx,DLINK DGS-3420-26SC|\-|DLINK-AGENT-MIB,EQUIPMENT-MIB,ENTITY-MIB|Certified| |*D-Link DES 7200 SNMP*|D-Link|DES-7xxx|D-Link DES 7206|\-|ENTITY-MIB,MY-SYSTEM-MIB,MY-PROCESS-MIB,MY-MEMORY-MIB|Performance<br>Fault<br>Interfaces| |*Dell Force S-Series SNMP*|Dell|Dell Force S-Series|S4810| |F10-S-SERIES-CHASSIS-MIB|Certified| |*Extreme Exos SNMP*|Extreme|Extreme EXOS|X670V-48x|EXOS|EXTREME-SYSTEM-MIB,EXTREME-SOFTWARE-MONITOR-MIB|Certified| |*FortiGate by SNMP*|Fortinet|FortiGate (NGFW)|-|FortiOS|HOST-RESOURCES-MIB<br>FORTINET-FORTIGATE-MIB<br>FORTINET-CORE-MIB<br>SNMPv2-MIB<br>IF-MIB<br>ENTITY-MIB|Performance<br>Inventory| |*HP Comware HH3C SNMP*|HP|HP (H3C) Comware|HP A5500-24G-4SFP HI Switch| |HH3C-ENTITY-EXT-MIB,ENTITY-MIB|Certified| |*HP Enterprise Switch SNMP*|HP|HP Enterprise Switch|HP ProCurve J4900B Switch 2626, HP J9728A 2920-48G Switch| |STATISTICS-MIB,NETSWITCH-MIB,HP-ICF-CHASSIS,ENTITY-MIB,SEMI-MIB|Certified| |*Huawei OceanStor 5300 V5 by SNMP*|Huawei|Huawei OceanStor Dorado|Huawei OceanStor Dorado with V5 software| |HUAWEI-STORAGE-HARDWARE-MIB, HUAWEI-STORAGE-SPACE-MIB, ISM-PERFORMANCE-MIB, HOST-RESOURCES-MIB, SNMPv2-MIB|Certified| |*Huawei OceanStor Dorado by SNMP*|Huawei|Huawei OceanStor, Huawei OceanStor Dorado|Huawei OceanStor Dorado 3000/5000/6000/8000/18000/5300/5500/5600/6800/18500/18800 with V6/V700 software| |HUAWEI-STORAGE-HARDWARE-MIB, HUAWEI-STORAGE-SPACE-MIB, ISM-PERFORMANCE-MIB, HOST-RESOURCES-MIB, SNMPv2-MIB|Certified| |*Huawei VRP by SNMP*|Huawei|Huawei VRP|S2352P-EI| |ENTITY-MIB,HUAWEI-ENTITY-EXTENT-MIB|Certified| |*Intel\_Qlogic Infiniband SNMP*|Intel/QLogic|Intel/QLogic Infiniband devices|Infiniband 12300| |ICS-CHASSIS-MIB|Fault<br>Inventory| |*Juniper SNMP*|Juniper|MX,SRX,EX models|Juniper MX240, Juniper EX4200-24F|JunOS|JUNIPER-MIB|Certified| |*Juniper MX SNMP*|Juniper|MX models|Juniper MX204 Edge Router|JunOS 24.2R1-S1.10|OSPF-MIB, JUNIPER-DOM-MIB, JUNIPER-MIB, BGP4-V2-MIB-JUNIPER, OSPFV3-MIB-JUNIPER|Certified| |*Mellanox SNMP*|Mellanox|Mellanox Infiniband devices|SX1036|MLNX-OS|HOST-RESOURCES-MIB,ENTITY-MIB,ENTITY-SENSOR-MIB,MELLANOX-MIB|Certified| |*MikroTik CCR<device model> SNMP*|MikroTik|MikroTik Cloud Core Routers (CCR series)|Separate dedicated templates are available for MikroTik CCR1009-7G-1C-1S+, MikroTik CCR1009-7G-1C-1S+PC, MikroTik CCR1009-7G-1C-PC, MikroTik CCR1016-12G, MikroTik CCR1016-12S-1S+, MikroTik CCR1036-12G-4S-EM, MikroTik CCR1036-12G-4S, MikroTik CCR1036-8G-2S+, MikroTik CCR1036-8G-2S+EM, MikroTik CCR1072-1G-8S+, MikroTik CCR2004-16G-2S+, MikroTik CCR2004-1G-12S+2XS|RouterOS|MIKROTIK-MIB,HOST-RESOURCES-MIB|Certified| |*MikroTik CRS<device model> SNMP*|MikroTik|MikroTik Cloud Router Switches (CRS series)|Separate dedicated templates are available for MikroTik CRS106-1C-5S, MikroTik CRS109-8G-1S-2HnD-IN, MikroTik CRS112-8G-4S-IN, MikroTik CRS112-8P-4S-IN, MikroTik CRS125-24G-1S-2HnD-IN, MikroTik CRS212-1G-10S-1S+IN, MikroTik CRS305-1G-4S+IN, MikroTik CRS309-1G-8S+IN, MikroTik CRS312-4C+8XG-RM, MikroTik CRS317-1G-16S+RM, MikroTik CRS326-24G-2S+IN, MikroTik CRS326-24G-2S+RM, MikroTik CRS326-24S+2Q+RM, MikroTik CRS328-24P-4S+RM, MikroTik CRS328-4C-20S-4S+RM, MikroTik CRS354-48G-4S+2Q+RM, MikroTik CRS354-48P-4S+2Q+RM|RouterOS/SwitchOS|MIKROTIK-MIB,HOST-RESOURCES-MIB|Certified| |*MikroTik CSS<device model> SNMP*|MikroTik|MikroTik Cloud Smart Switches (CSS series)|Separate dedicated templates are available for MikroTik CSS326-24G-2S+RM, MikroTik CSS610-8G-2S+IN|RouterOS|MIKROTIK-MIB,HOST-RESOURCES-MIB|Certified| |*MikroTik FiberBox SNMP*|MikroTik|MikroTik FiberBox|MikroTik FiberBox|RouterOS|MIKROTIK-MIB,HOST-RESOURCES-MIB|Certified| |*MikroTik hEX <device model> SNMP*|MikroTik|MikroTik hEX|Separate dedicated templates are available for MikroTik hEX, MikroTik hEX lite, MikroTik hEX PoE, MikroTik hEX PoE lite, MikroTik hEX S|RouterOS|MIKROTIK-MIB,HOST-RESOURCES-MIB|Certified| |*MikroTik netPower <device model> SNMP*|MikroTik|MikroTik netPower|Separate dedicated templates are available for MikroTik netPower 15FR, MikroTik netPower 16P SNMP, MikroTik netPower Lite 7R|RouterOS/SwitchOS, SwitchOS Lite|MIKROTIK-MIB,HOST-RESOURCES-MIB|Certified| |*MikroTik PowerBox <device model> SNMP*|MikroTik|MikroTik PowerBox|Separate dedicated templates are available for MikroTik PowerBox, MikroTik PowerBox Pro|RouterOS|MIKROTIK-MIB,HOST-RESOURCES-MIB|Certified| |*MikroTik RB<device model> SNMP*|MikroTik|MikroTik RB series routers|Separate dedicated templates are available for MikroTik RB1100AHx4, MikroTik RB1100AHx4 Dude Edition, MikroTik RB2011iL-IN, MikroTik RB2011iL-RM, MikroTik RB2011iLS-IN, MikroTik RB2011UiAS-IN, MikroTik RB2011UiAS-RM, MikroTik RB260GS, MikroTik RB3011UiAS-RM, MikroTik RB4011iGS+RM, MikroTik RB5009UG+S+IN|RouterOS|MIKROTIK-MIB,HOST-RESOURCES-MIB|Certified| |*MikroTik SNMP*|MikroTik|MikroTik RouterOS devices|MikroTik CCR1016-12G, MikroTik RB2011UAS-2HnD, MikroTik 912UAG-5HPnD, MikroTik 941-2nD, MikroTik 951G-2HnD, MikroTik 1100AHx2|RouterOS|MIKROTIK-MIB,HOST-RESOURCES-MIB|Certified| |*Netgear Fastpath SNMP*|Netgear|Netgear Fastpath|M5300-28G| |FASTPATH-SWITCHING-MIB,FASTPATH-BOXSERVICES-PRIVATE-MIB|Fault<br>Inventory| |*QTech QSW SNMP*|QTech|Qtech devices|Qtech QSW-2800-28T|\-|QTECH-MIB,ENTITY-MIB|Performance<br>Inventory| |*Stormshield SNS by SNMP*|Stormshield|Stormshield Network Security (SNS) firewalls|SN3100|Stormshield SNS|HOST-RESOURCES-MIB, UCD-SNMP-MIB, STORMSHIELD-ASQ-STATS-MIB, STORMSHIELD-AUTOUPDATE-MIB, STORMSHIELD-HA-MIB, STORMSHIELD-PROPERTY-MIB, STORMSHIELD-HEALTH-MONITOR-MIB, STORMSHIELD-IF-MIB, STORMSHIELD-SYSTEM-MONITOR-MIB, STORMSHIELD-IPSEC-STATS-MIB|Certified| |*TP-LINK SNMP*|TP-LINK|TP-LINK|T2600G-28TS v2.0| |TPLINK-SYSMONITOR-MIB,TPLINK-SYSINFO-MIB|Performance<br>Inventory| |*Ubiquiti AirOS SNMP*|Ubiquiti|Ubiquiti AirOS wireless devices|NanoBridge,NanoStation,Unifi|AirOS|FROGFOOT-RESOURCES-MIB,IEEE802dot11-MIB|Performance| |*Vyatta Virtual Router by SNMP*|Ciena|Vyatta|Vyatta Virtual Router 1908e|Vyatta 1908e|SNMPv2-MIB, HOST-RESOURCES-MIB, UCD-SNMP-MIB, IF-MIB, DISMAN-EVENT-MIB|Performance<br>Inventory| #### Ierīces Pieejamo veidņu saraksts ierīču saimēm: |Veidnes nosaukums|Ražotājs|Ierīču saime|Zināmie modeļi|OS|Izmantotie MIB|**[Tagi](/manual/config/templates_out_of_the_box/network_devices#tags)**| |----|--|--|----|--|----|-----| |*Alcatel Timetra TiMOS SNMP*|Alcatel|Alcatel Timetra|ALCATEL SR 7750|TiMOS|TIMETRA-SYSTEM-MIB,TIMETRA-CHASSIS-MIB|Sertificēts| |*Aruba CX 8300s by SNMP*|HPE Aruba Networking|Aruba CX Switch Series|Aruba JL636A 8325, Aruba JL717A 8360|Aruba AOS-CX|ARUBAWIRED-FAN-MIB, ARUBAWIRED-POWERSUPPLY-MIB, ARUBAWIRED-SYSTEMINFO-MIB, ARUBAWIRED-TEMPSENSOR-MIB, OSPF-MIB|Sertificēts| |*Brocade FC SNMP*|Brocade|Brocade FC switches|Brocade 300 SAN Switch-|\-|SW-MIB,ENTITY-MIB|Veiktspēja<br>Kļūme| |*Brocade\_Foundry Stackable SNMP*|Brocade|Brocade ICX|Brocade ICX6610, Brocade ICX7250-48, Brocade ICX7450-48F| |FOUNDRY-SN-AGENT-MIB, FOUNDRY-SN-STACKING-MIB|Sertificēts| |*Brocade\_Foundry Nonstackable SNMP*|Brocade, Foundry|Brocade MLX, Foundry|Brocade MLXe, Foundry FLS648, Foundry FWSX424| |FOUNDRY-SN-AGENT-MIB|Veiktspēja<br>Kļūme| |*Check Point Next Generation Firewall by SNMP*|Check Point|Next Generation Firewall|-|Gaia|HOST-RESOURCES-MIB, CHECKPOINT-MIB, UCD-SNMP-MIB, SNMPv2-MIB, IF-MIB|Sertificēts| |*Ciena 3906 by SNMP*|Ciena|Ciena CPE|Ciena 3906|SAOS|WWP-LEOS-BLADE-MIB, WWP-LEOS-CHASSIS-MIB, WWP-LEOS-SYSTEM-CONFIG-MIB|Sertificēts| |*Cisco Catalyst 3750<device model> SNMP*|Cisco|Cisco Catalyst 3750|Cisco Catalyst 3750V2-24FS, Cisco Catalyst 3750V2-24PS, Cisco Catalyst 3750V2-24TS, Cisco Catalyst SNMP, Cisco Catalyst SNMP| |CISCO-MEMORY-POOL-MIB, IF-MIB, EtherLike-MIB, SNMPv2-MIB, CISCO-PROCESS-MIB, CISCO-ENVMON-MIB, ENTITY-MIB|Sertificēts| |*Cisco IOS SNMP*|Cisco|Cisco IOS ver > 12.2 3.5|Cisco C2950|IOS|CISCO-PROCESS-MIB,CISCO-MEMORY-POOL-MIB,CISCO-ENVMON-MIB|Sertificēts| |*Cisco IOS versions 12.0\_3\_T-12.2\_3.5 SNMP*|Cisco|Cisco IOS > 12.0 3 T and < 12.2 3.5|\-|IOS|CISCO-PROCESS-MIB,CISCO-MEMORY-POOL-MIB,CISCO-ENVMON-MIB|Sertificēts| |*Cisco IOS prior to 12.0\_3\_T SNMP*|Cisco|Cisco IOS < 12.0 3 T|\-|IOS|OLD-CISCO-CPU-MIB,CISCO-MEMORY-POOL-MIB|Sertificēts| |*D-Link DES\_DGS Switch SNMP*|D-Link|DES/DGX switches|D-Link DES-xxxx/DGS-xxxx,DLINK DGS-3420-26SC|\-|DLINK-AGENT-MIB,EQUIPMENT-MIB,ENTITY-MIB|Sertificēts| |*D-Link DES 7200 SNMP*|D-Link|DES-7xxx|D-Link DES 7206|\-|ENTITY-MIB,MY-SYSTEM-MIB,MY-PROCESS-MIB,MY-MEMORY-MIB|Veiktspēja<br>Kļūme<br>Interfeisi| |*Dell Force S-Series SNMP*|Dell|Dell Force S-Series|S4810| |F10-S-SERIES-CHASSIS-MIB|Sertificēts| |*Extreme Exos SNMP*|Extreme|Extreme EXOS|X670V-48x|EXOS|EXTREME-SYSTEM-MIB,EXTREME-SOFTWARE-MONITOR-MIB|Sertificēts| |*FortiGate by SNMP*|Fortinet|FortiGate (NGFW)|-|FortiOS|HOST-RESOURCES-MIB<br>FORTINET-FORTIGATE-MIB<br>FORTINET-CORE-MIB<br>SNMPv2-MIB<br>IF-MIB<br>ENTITY-MIB|Veiktspēja<br>Inventārs| |*HP Comware HH3C SNMP*|HP|HP (H3C) Comware|HP A5500-24G-4SFP HI Switch| |HH3C-ENTITY-EXT-MIB,ENTITY-MIB|Sertificēts| |*HP Enterprise Switch SNMP*|HP|HP Enterprise Switch|HP ProCurve J4900B Switch 2626, HP J9728A 2920-48G Switch| |STATISTICS-MIB,NETSWITCH-MIB,HP-ICF-CHASSIS,ENTITY-MIB,SEMI-MIB|Sertificēts| |*Huawei OceanStor 5300 V5 by SNMP*|Huawei|Huawei OceanStor Dorado|Huawei OceanStor Dorado with V5 software| |HUAWEI-STORAGE-HARDWARE-MIB, HUAWEI-STORAGE-SPACE-MIB, ISM-PERFORMANCE-MIB, HOST-RESOURCES-MIB, SNMPv2-MIB|Sertificēts| |*Huawei OceanStor Dorado by SNMP*|Huawei|Huawei OceanStor, Huawei OceanStor Dorado|Huawei OceanStor Dorado 3000/5000/6000/8000/18000/5300/5500/5600/6800/18500/18800 with V6/V700 software| |HUAWEI-STORAGE-HARDWARE-MIB, HUAWEI-STORAGE-SPACE-MIB, ISM-PERFORMANCE-MIB, HOST-RESOURCES-MIB, SNMPv2-MIB|Sertificēts| |*Huawei VRP by SNMP*|Huawei|Huawei VRP|S2352P-EI| |ENTITY-MIB,HUAWEI-ENTITY-EXTENT-MIB|Sertificēts| |*Intel\_Qlogic Infiniband SNMP*|Intel/QLogic|Intel/QLogic Infiniband devices|Infiniband 12300| |ICS-CHASSIS-MIB|Kļūme<br>Inventārs| |*Juniper SNMP*|Juniper|MX,SRX,EX models|Juniper MX240, Juniper EX4200-24F|JunOS|JUNIPER-MIB|Sertificēts| |*Juniper MX SNMP*|Juniper|MX models|Juniper MX204 Edge Router|JunOS 24.2R1-S1.10|OSPF-MIB, JUNIPER-DOM-MIB, JUNIPER-MIB, BGP4-V2-MIB-JUNIPER, OSPFV3-MIB-JUNIPER|Sertificēts| |*Mellanox SNMP*|Mellanox|Mellanox Infiniband devices|SX1036|MLNX-OS|HOST-RESOURCES-MIB,ENTITY-MIB,ENTITY-SENSOR-MIB,MELLANOX-MIB|Sertificēts| |*MikroTik CCR<device model> SNMP*|MikroTik|MikroTik Cloud Core Routers (CCR series)|Separate dedicated templates are available for MikroTik CCR1009-7G-1C-1S+, MikroTik CCR1009-7G-1C-1S+PC, MikroTik CCR1009-7G-1C-PC, MikroTik CCR1016-12G, MikroTik CCR1016-12S-1S+, MikroTik CCR1036-12G-4S-EM, MikroTik CCR1036-12G-4S, MikroTik CCR1036-8G-2S+, MikroTik CCR1036-8G-2S+EM, MikroTik CCR1072-1G-8S+, MikroTik CCR2004-16G-2S+, MikroTik CCR2004-1G-12S+2XS|RouterOS|MIKROTIK-MIB,HOST-RESOURCES-MIB|Sertificēts| |*MikroTik CRS<device model> SNMP*|MikroTik|MikroTik Cloud Router Switches (CRS series)|Separate dedicated templates are available for MikroTik CRS106-1C-5S, MikroTik CRS109-8G-1S-2HnD-IN, MikroTik CRS112-8G-4S-IN, MikroTik CRS112-8P-4S-IN, MikroTik CRS125-24G-1S-2HnD-IN, MikroTik CRS212-1G-10S-1S+IN, MikroTik CRS305-1G-4S+IN, MikroTik CRS309-1G-8S+IN, MikroTik CRS312-4C+8XG-RM, MikroTik CRS317-1G-16S+RM, MikroTik CRS326-24G-2S+IN, MikroTik CRS326-24G-2S+RM, MikroTik CRS326-24S+2Q+RM, MikroTik CRS328-24P-4S+RM, MikroTik CRS328-4C-20S-4S+RM, MikroTik CRS354-48G-4S+2Q+RM, MikroTik CRS354-48P-4S+2Q+RM|RouterOS/SwitchOS|MIKROTIK-MIB,HOST-RESOURCES-MIB|Sertificēts| |*MikroTik CSS<device model> SNMP*|MikroTik|MikroTik Cloud Smart Switches (CSS series)|Separate dedicated templates are available for MikroTik CSS326-24G-2S+RM, MikroTik CSS610-8G-2S+IN|RouterOS|MIKROTIK-MIB,HOST-RESOURCES-MIB|Sertificēts| |*MikroTik FiberBox SNMP*|MikroTik|MikroTik FiberBox|MikroTik FiberBox|RouterOS|MIKROTIK-MIB,HOST-RESOURCES-MIB|Sertificēts| |*MikroTik hEX <device model> SNMP*|MikroTik|MikroTik hEX|Separate dedicated templates are available for MikroTik hEX, MikroTik hEX lite, MikroTik hEX PoE, MikroTik hEX PoE lite, MikroTik hEX S|RouterOS|MIKROTIK-MIB,HOST-RESOURCES-MIB|Sertificēts| |*MikroTik netPower <device model> SNMP*|MikroTik|MikroTik netPower|Separate dedicated templates are available for MikroTik netPower 15FR, MikroTik netPower 16P SNMP, MikroTik netPower Lite 7R|RouterOS/SwitchOS, SwitchOS Lite|MIKROTIK-MIB,HOST-RESOURCES-MIB|Sertificēts| |*MikroTik PowerBox <device model> SNMP*|MikroTik|MikroTik PowerBox|Separate dedicated templates are available for MikroTik PowerBox, MikroTik PowerBox Pro|RouterOS|MIKROTIK-MIB,HOST-RESOURCES-MIB|Sertificēts| |*MikroTik RB<device model> SNMP*|MikroTik|MikroTik RB series routers|Separate dedicated templates are available for MikroTik RB1100AHx4, MikroTik RB1100AHx4 Dude Edition, MikroTik RB2011iL-IN, MikroTik RB2011iL-RM, MikroTik RB2011iLS-IN, MikroTik RB2011UiAS-IN, MikroTik RB2011UiAS-RM, MikroTik RB260GS, MikroTik RB3011UiAS-RM, MikroTik RB4011iGS+RM, MikroTik RB5009UG+S+IN|RouterOS|MIKROTIK-MIB,HOST-RESOURCES-MIB|Sertificēts| |*MikroTik SNMP*|MikroTik|MikroTik RouterOS devices|MikroTik CCR1016-12G, MikroTik RB2011UAS-2HnD, MikroTik 912UAG-5HPnD, MikroTik 941-2nD, MikroTik 951G-2HnD, MikroTik 1100AHx2|RouterOS|MIKROTIK-MIB,HOST-RESOURCES-MIB|Sertificēts| |*Netgear Fastpath SNMP*|Netgear|Netgear Fastpath|M5300-28G| |FASTPATH-SWITCHING-MIB,FASTPATH-BOXSERVICES-PRIVATE-MIB|Kļūme<br>Inventārs| |*QTech QSW SNMP*|QTech|Qtech devices|Qtech QSW-2800-28T|\-|QTECH-MIB,ENTITY-MIB|Veiktspēja<br>Inventārs| |*Stormshield SNS by SNMP*|Stormshield|Stormshield Network Security (SNS) firewalls|SN3100|Stormshield SNS|HOST-RESOURCES-MIB, UCD-SNMP-MIB, STORMSHIELD-ASQ-STATS-MIB, STORMSHIELD-AUTOUPDATE-MIB, STORMSHIELD-HA-MIB, STORMSHIELD-PROPERTY-MIB, STORMSHIELD-HEALTH-MONITOR-MIB, STORMSHIELD-IF-MIB, STORMSHIELD-SYSTEM-MONITOR-MIB, STORMSHIELD-IPSEC-STATS-MIB|Sertificēts| |*TP-LINK SNMP*|TP-LINK|TP-LINK|T2600G-28TS v2.0| |TPLINK-SYSMONITOR-MIB,TPLINK-SYSINFO-MIB|Veiktspēja<br>Inventārs| |*Ubiquiti AirOS SNMP*|Ubiquiti|Ubiquiti AirOS wireless devices|NanoBridge,NanoStation,Unifi|AirOS|FROGFOOT-RESOURCES-MIB,IEEE802dot11-MIB|Veiktspēja| |*Vyatta Virtual Router by SNMP*|Ciena|Vyatta|Vyatta Virtual Router 1908e|Vyatta 1908e|SNMPv2-MIB, HOST-RESOURCES-MIB, UCD-SNMP-MIB, IF-MIB, DISMAN-EVENT-MIB|Veiktspēja<br>Inventārs| # dhost.get # dhost.get #### 'Diagnostic information' request object The diagnostic information task request object has the following properties. Statistic request object for all types of properties is [described in detail below](/manual/api/reference/task/object#statistic-request-object). |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |historycache|object|History cache statistic request. Available on server and proxy.| |valuecache|object|Items cache statistic request. Available on server.| |preprocessing|object|Preprocessing manager statistic request. Available on server and proxy.| |alerting|object|Alert manager statistic request. Available on server.| |lld|object|LLD manager statistic request. Available on server.| #### 'Diagnostikas informācijas' pieprasījuma objekts Diagnostikas informācijas uzdevuma pieprasījuma objektam ir šādas īpašības. Statistikas pieprasījuma objekts visiem īpašību tipiem ir [detalizēti aprakstīts zemāk](/manual/api/reference/task/object#statistic-request-object). |Īpašība|[Tips](/manual/api/reference_commentary#data-types)|Apraksts| |--|--|------| |historycache|object|Vēstures kešatmiņas statistikas pieprasījums. Pieejams serverī un starpniekserverī.| |valuecache|object|Vienumu kešatmiņas statistikas pieprasījums. Pieejams serverī.| |preprocessing|object|Pirmsapstrādes pārvaldnieka statistikas pieprasījums. Pieejams serverī un starpniekserverī.| |alerting|object|Brīdinājumu pārvaldnieka statistikas pieprasījums. Pieejams serverī.| |lld|object|LLD pārvaldnieka statistikas pieprasījums. Pieejams serverī.| Direct upgrade to Zabbix 7.0.x is possible from Zabbix **6.4**.x, **6.2**.x, **6.0**.x, **5.4**.x, **5.2**.x, **5.0**.x, **4.4**.x, **4.2**.x, **4.0**.x, **3.4**.x, **3.2**.x, **3.0**.x, **2.4**.x, **2.2**.x and **2.0**.x. For upgrading from earlier versions consult Zabbix documentation for 2.0 and earlier. ::: noteclassic Please be aware that after upgrading some third-party software integrations in Zabbix might be affected, if the external software is not compatible with the upgraded Zabbix version. ::: Tieša jaunināšana uz Zabbix 7.0.x ir iespējama no Zabbix **6.4**.x, **6.2**.x, **6.0**.x, **5.4**.x, **5.2**.x, **5.0**.x, **4.4**.x, **4.2**.x, **4.0**.x, **3.4**.x, **3.2**.x, **3.0**.x, **2.4**.x, **2.2**.x un **2.0**.x. Jaunināšanai no vecākām versijām skatiet Zabbix dokumentāciju par 2.0 un agrākām versijām. ::: noteclassic Lūdzu, ņemiet vērā, ka pēc jaunināšanas dažas trešo pušu programmatūras integrācijas Zabbix var tikt ietekmētas, ja ārējā programmatūra nav saderīga ar jaunināto Zabbix versiju. ::: #### Disable action Disable an action, that is, set its status to "1". [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "action.update", "params": { "actionid": "2", "status": "1" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "2" ] }, "id": 1 } ``` #### Atspējot darbību Atspējojiet darbību, tas ir, iestatiet tās statusu uz "1". [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "action.update", "params": { "actionid": "2", "status": "1" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "2" ] }, "id": 1 } ``` #### Disable correlation [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "correlation.update", "params": { "correlationid": "1", "status": "1" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "correlationids": [ "1" ] }, "id": 1 } ``` #### Atspējot korelāciju [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "correlation.update", "params": { "correlationid": "1", "status": "1" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "correlationids": [ "1" ] }, "id": 1 } ``` #### Disable trapping Disable LLD trapping for discovery rule. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "discoveryrule.update", "params": { "itemid": "28336", "allow_traps": 0 }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "28336" ] }, "id": 1 } ``` #### Atspējot slazdošanu Atspējot LLD slazdošanu atklāšanas kārtulai. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "discoveryrule.update", "params": { "itemid": "28336", "allow_traps": 0 }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "28336" ] }, "id": 1 } ``` #### Disabling ability to execute scripts Update role with ID "5", disable ability to execute scripts. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "role.update", "params": [ { "roleid": "5", "rules": { "actions": [ { "name": "execute_scripts", "status": "0" } ] } } ], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "roleids": [ "5" ] }, "id": 1 } ``` #### Skriptu izpildes iespējas atspējošana Atjauniniet lomu ar ID "5", atspējojiet skriptu izpildes iespēju. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "role.update", "params": [ { "roleid": "5", "rules": { "actions": [ { "name": "execute_scripts", "status": "0" } ] } } ], "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "roleids": [ "5" ] }, "id": 1 } ``` #### Disabling a host prototype Disable a host prototype, that is, set its status to "1". [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "hostprototype.update", "params": { "hostid": "10092", "status": 1 }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10092" ] }, "id": 1 } ``` #### Hosta prototipa atspējošana Atspējojiet hosta prototipu, tas ir, iestatiet tā statusu uz "1". [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "hostprototype.update", "params": { "hostid": "10092", "status": 1 }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10092" ] }, "id": 1 } ``` #### Disabling a module Disable module "25". [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "module.update", "params": { "moduleid": "25", "status": 0 }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "moduleids": [ "25" ] }, "id": 1 } ``` #### Moduļa atspējošana Atspējojiet moduli "25". [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "module.update", "params": { "moduleid": "25", "status": 0 }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "moduleids": [ "25" ] }, "id": 1 } ``` ### Disabling HA cluster To disable a high availability cluster: 1. Make backup copies of configuration files. 2. Stop standby nodes. 3. Remove the HANodeName parameter from the active primary server. 4. Restart the primary server (it will start in standalone mode). ### HA klastera atspējošana Lai atspējotu augstas pieejamības klasteri: 1. Izveidojiet konfigurācijas failu rezerves kopijas. 2. Apturiet gaidstāves mezglus. 3. No aktīvā primārā servera noņemiet parametru HANodeName. 4. Pārstartējiet primāro serveri (tas tiks palaists patstāvīgā režīmā). #### Disabling scheduled report [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "report.update", "params": { "reportid": "1", "status": "0" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "reportids": [ "1" ] }, "id": 1 } ``` #### Ieplānotā pārskata atspējošana [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "report.update", "params": { "reportid": "1", "status": "0" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "reportids": [ "1" ] }, "id": 1 } ``` #### Disabling web server default error pages To avoid information exposure, disabling the default error pages is recommended. By default, a web server uses built-in error pages:  These default error pages should be replaced/removed. For example, the "ErrorDocument" directive can be used to define a custom error page/text for the Apache web server. Please refer to the documentation of your web server to find help on how to replace/remove default error pages. #### Tīmekļa servera noklusējuma kļūdu lapu atspējošana Lai novērstu informācijas noplūdi, ieteicams atspējot noklusējuma kļūdu lapas. Pēc noklusējuma tīmekļa serveris izmanto iebūvētās kļūdu lapas:  Šīs noklusējuma kļūdu lapas ir jāaizstāj/jānoņem. Piemēram, Apache tīmekļa serverim var izmantot direktīvu "ErrorDocument", lai definētu pielāgotu kļūdu lapu/tekstu. Lūdzu, skatiet sava tīmekļa servera dokumentāciju, lai uzzinātu, kā aizstāt/noņemt noklusējuma kļūdu lapas. #### Disabling web server information exposure To improve security, disabling all web server signatures is recommended. By default, the web server is exposing the software signature:  The signature can be disabled by adding the following parameters to the Apache configuration file: ```ini ServerSignature Off ServerTokens Prod ``` PHP signature (X-Powered-By HTTP header) can be disabled by changing the `php.ini` configuration file (by default, the signature is disabled): ```ini expose_php = Off ``` Web server restart is required for configuration file changes to be applied. For additional security, you can use the *mod_security* tool with Apache (package *libapache2-mod-security2*). This tool allows removing the server signature instead of removing only the version from the server signature. The server signature can be changed to any value by setting "SecServerSignature" to any desired value after installing *mod_security*. Please refer to the documentation of your web server to find help on how to remove/change software signatures. #### Tīmekļa servera informācijas atklāšanas atspējošana Lai uzlabotu drošību, ieteicams atspējot visas tīmekļa servera parakstu norādes. Pēc noklusējuma tīmekļa serveris atklāj programmatūras parakstu:  Parakstu var atspējot, Apache konfigurācijas failam pievienojot šādus parametrus: ```ini ServerSignature Off ServerTokens Prod ``` PHP parakstu (X-Powered-By HTTP galveni) var atspējot, mainot `php.ini` konfigurācijas failu (pēc noklusējuma paraksts ir atspējots): ```ini expose_php = Off ``` Lai konfigurācijas faila izmaiņas stātos spēkā, ir nepieciešams restartēt tīmekļa serveri. Papildu drošībai varat izmantot rīku *mod_security* kopā ar Apache (pakotne *libapache2-mod-security2*). Šis rīks ļauj noņemt servera parakstu, nevis tikai noņemt versiju no servera paraksta. Servera parakstu var mainīt uz jebkuru vērtību, pēc *mod_security* instalēšanas iestatot "SecServerSignature" uz vēlamo vērtību. Lūdzu, skatiet sava tīmekļa servera dokumentāciju, lai uzzinātu, kā noņemt vai mainīt programmatūras parakstus. ##### Discard unchanged {#discardunchanged} Discard a value if it has not changed. Comments: - If a value is discarded, it is not saved in the database and Zabbix server has no knowledge that this value was received. No trigger expressions will be evaluated, as a result, no problems for related triggers will be created/resolved. Functions will work only based on data that is actually saved in the database. As trends are built based on data in the database, if there is no value saved for an hour then there will also be no trends data for that hour.<br> - Only one throttling option can be specified per item. ##### Atmest nemainīto {#discardunchanged} Atmest vērtību, ja tā nav mainījusies. Komentāri: - Ja vērtība tiek atmesta, tā netiek saglabāta datubāzē, un Zabbix serveris nezina, ka šī vērtība tika saņemta. Trigeru izteiksmes netiks novērtētas, un rezultātā saistītajiem trigeriem netiks izveidotas/atrisinātas nekādas problēmas. Funkcijas darbosies, tikai pamatojoties uz datiem, kas faktiski ir saglabāti datubāzē. Tā kā tendences tiek veidotas, pamatojoties uz datiem datubāzē, ja stundas laikā netiek saglabāta neviena vērtība, tad arī par šo stundu nebūs tendenču datu.<br> - Katram vienumam var norādīt tikai vienu ierobežošanas opciju. ##### Discard unchanged with heartbeat {#discardwithheartbeat} Discard a value if it has not changed within the defined time period (in seconds). Comments: - Positive integer values are supported to specify the seconds (minimum - 1 second);<br> - Time suffixes can be used (e.g., 30s, 1m, 2h, 1d);<br> - User macros and low-level discovery macros can be used;<br> - If a value is discarded, it is not saved in the database and Zabbix server has no knowledge that this value was received. No trigger expressions will be evaluated, as a result, no problems for related triggers will be created/resolved. Functions will work only based on data that is actually saved in the database. As trends are built based on data in the database, if there is no value saved for an hour then there will also be no trends data for that hour.<br> - Only one throttling option can be specified per item. ##### Atmest nemainīgu ar sirdspukstu {#discardwithheartbeat} Atmest vērtību, ja tā nav mainījusies noteiktajā laika periodā (sekundēs). Komentāri: - Tiek atbalstītas pozitīvas veselu skaitļu vērtības, lai norādītu sekundes (minimums — 1 sekunde);<br> - Var izmantot laika sufiksus (piemēram, 30s, 1m, 2h, 1d);<br> - Var izmantot lietotāja makrosus un zema līmeņa atklāšanas makrosus;<br> - Ja vērtība tiek atmesta, tā netiek saglabāta datubāzē, un Zabbix serveris nezina, ka šī vērtība tika saņemta. Netiks novērtētas nekādas trigeru izteiksmes, un rezultātā saistītajiem trigeriem netiks izveidotas/atrisinātas nekādas problēmas. Funkcijas darbosies tikai, pamatojoties uz datiem, kas faktiski ir saglabāti datubāzē. Tā kā tendences tiek veidotas, pamatojoties uz datiem datubāzē, ja stundas laikā netiek saglabāta neviena vērtība, tad arī par šo stundu nebūs tendenču datu.<br> - Katram vienumam var norādīt tikai vienu droselēšanas opciju. ### Discovered entities The screenshots below illustrate how discovered items, triggers, and graphs look like in the host's configuration. Discovered entities are prefixed with an orange link to a discovery rule they come from. {width="600"} Note that discovered entities will not be created in case there are already existing entities with the same uniqueness criteria, for example, an item with the same key or graph with the same name. An error message is displayed in this case in the frontend that the low-level discovery rule could not create certain entities. The discovery rule itself, however, will not turn unsupported because some entity could not be created and had to be skipped. The discovery rule will go on creating/updating other entities. If a discovered entity (host, file system, interface, etc) stops being discovered (or does not pass the filter anymore) the entities that were created based on it may be automatically disabled and eventually deleted. Lost resources may be automatically disabled based on the value of the *Disable lost resources* parameter. This affects lost hosts, items and triggers. Lost resources may be automatically deleted based on the value of the *Delete lost resources* parameter. This affects lost hosts, host groups, items, triggers, and graphs. When discovered entities become 'Not discovered anymore', a lifetime indicator is displayed in the entity list. Move your mouse pointer over it and a message will be displayed indicating its status details.  If entities were marked for deletion, but were not deleted at the expected time (disabled discovery rule or item host), they will be deleted the next time the discovery rule is processed. Entities containing other entities, which are marked for deletion, will not update if changed on the discovery rule level. For example, LLD-based triggers will not update if they contain items that are marked for deletion.  {width="600"} ### Atklātās entītijas Tālāk redzamie ekrānuzņēmumi ilustrē, kā hosta konfigurācijā izskatās atklātie vienumi, trigeri un grafiki. Atklātajām entītijām priekšā ir oranža saite uz atklāšanas kārtulu, no kuras tās ir iegūtas. {width="600"} Ņemiet vērā, ka atklātās entītijas netiks izveidotas, ja jau pastāv entītijas ar tiem pašiem unikalitātes kritērijiem, piemēram, vienums ar to pašu atslēgu vai grafiks ar to pašu nosaukumu. Šādā gadījumā lietotāja saskarnē tiek parādīts kļūdas ziņojums, ka zema līmeņa atklāšanas kārtula nevarēja izveidot noteiktas entītijas. Tomēr pati atklāšanas kārtula nekļūs par neatbalstītu tikai tāpēc, ka kādu entītiju nevarēja izveidot un tā bija jāizlaiž. Atklāšanas kārtula turpinās izveidot/atjaunināt citas entītijas. Ja atklātā entītija (hosts, failu sistēma, saskarne utt.) vairs netiek atklāta (vai vairs neatbilst filtram), entītijas, kas tika izveidotas, pamatojoties uz to, var tikt automātiski atspējotas un vēlāk dzēstas. Zaudētie resursi var tikt automātiski atspējoti atkarībā no parametra *Disable lost resources* vērtības. Tas attiecas uz zaudētajiem hostiem, vienumiem un trigeriem. Zaudētie resursi var tikt automātiski dzēsti atkarībā no parametra *Delete lost resources* vērtības. Tas attiecas uz zaudētajiem hostiem, hostu grupām, vienumiem, trigeriem un grafikiem. Kad atklātās entītijas kļūst par "Vairs netiek atklātas", entītiju sarakstā tiek parādīts dzīves ilguma indikators. Pārvietojiet peles kursoru virs tā, un tiks parādīts ziņojums ar detalizētu informāciju par statusu.  Ja entītijas tika atzīmētas dzēšanai, bet netika dzēstas paredzētajā laikā (atspējota atklāšanas kārtula vai vienuma hosts), tās tiks dzēstas nākamajā reizē, kad tiks apstrādāta atklāšanas kārtula. Entītijas, kas satur citas entītijas un ir atzīmētas dzēšanai, netiks atjauninātas, ja izmaiņas tiks veiktas atklāšanas kārtulas līmenī. Piemēram, uz LLD balstīti trigeri netiks atjaunināti, ja tie satur vienumus, kas ir atzīmēti dzēšanai.  {width="600"} #### Discovered entities When server runs, it will create real items, triggers and graphs based on the values the SNMP discovery rule returns. In the host configuration they are prefixed with an orange link to a discovery rule they come from. {width="600"} {width="600"} {width="600"} #### Atklātās entītijas Kad serveris darbojas, tas izveidos reālus vienumus, trigerus un grafikus, pamatojoties uz vērtībām, ko atgriež SNMP atklāšanas kārtula. Hosta konfigurācijā tiem ir prefikss ar oranžu saiti uz atklāšanas kārtulu, no kuras tie ir izveidoti. {width="600"} {width="600"} {width="600"} #### Discovered entities When the server runs, it will create real dependent items, triggers and graphs based on the values the SNMP discovery rule returns. #### Atklātās entītijas Kad serveris darbojas, tas izveidos reālus atkarīgos vienumus, trigerus un grafikus, pamatojoties uz vērtībām, ko atgriež SNMP atklāšanas kārtula. ### Discovered host ::: noteclassic Discovered host are created by the Zabbix server and cannot be modified via the API. ::: The discovered host object contains information about a host discovered by a network discovery rule. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |dhostid|ID|ID of the discovered host.| |druleid|ID|ID of the discovery rule that detected the host.| |lastdown|timestamp|Time when the discovered host last went down.| |lastup|timestamp|Time when the discovered host last went up.| |status|integer|Whether the discovered host is up or down. A host is up if it has at least one active discovered service.<br><br>Possible values:<br>0 - host up;<br>1 - host down.| ### Atklātais hosts ::: noteclassic Atklātos hostus izveido Zabbix serveris, un tos nevar mainīt, izmantojot API. ::: Atklātā hosta objekts satur informāciju par hostu, kas atklāts ar tīkla atklāšanas kārtulu. Tam ir šādas īpašības. |Īpašība|[Tips](/manual/api/reference_commentary#data-types)|Apraksts| |--|--|------| |dhostid|ID|Atklātā hosta ID.| |druleid|ID|Atklāšanas kārtulas ID, kas noteica hostu.| |lastdown|timestamp|Laiks, kad atklātais hosts pēdējo reizi kļuva nepieejams.| |lastup|timestamp|Laiks, kad atklātais hosts pēdējo reizi kļuva pieejams.| |status|integer|Vai atklātais hosts ir pieejams vai nepieejams. Hosts ir pieejams, ja tam ir vismaz viens aktīvs atklātais serviss.<br><br>Iespējamās vērtības:<br>0 - hosts pieejams;<br>1 - hosts nepieejams.| # Discovered host object The following objects are directly related to the `dhost` API. # Atklātā hosta objekts Tālāk norādītie objekti ir tieši saistīti ar `dhost` API. ##### Discovered hosts In the host list, discovered hosts are prefixed with the name of the discovery rule that created them. Discovered hosts inherit most parameters from host prototypes as *read-only*. Only the following discovered host parameters can be configured: - *Templates* - link new templates or unlink manually added ones. Templates inherited from a host prototype cannot be unlinked. - *Description* - add or edit the host description. - *Status* - enable or disable the host. - *Tags* - add new tags or remove manually added ones. Tags inherited from a host prototype cannot be removed. Note that tags cannot have duplicates (tags with the same name and value). If a new tag is added to the host prototype and it matches a manually added tag on a discovered host, the manually added tag will be replaced with the inherited tag during discovery. - *Macros* - add new host macros or remove manually added ones, as well as those inherited from a host prototype; change macro values and [types](/manual/config/macros/user_macros#configuration). ::: noteclassic Discovered hosts also inherit [user macros](/manual/config/macros/user_macros) from the host where the discovery rule is configured. These inherited macros can be removed, and their values and types can be changed. ::: Discovered hosts can be deleted manually. Note, however, that they will be discovered again if discovery is enabled for them. Hosts that are no longer discovered may be: - automatically disabled (based on the *Disable lost resources* value of the discovery rule) - automatically deleted (based on the *Delete lost resources* value of the discovery rule). ::: noteclassic Zabbix does not support nested host prototypes, that is, host prototypes on hosts discovered by low-level discovery rules. ::: ##### Atklātie hosts Hosts sarakstā atklātajiem hosts tiek pievienots prefikss ar atklāšanas noteikuma nosaukumu, kas tos izveidoja. Atklātie hosts pārmanto lielāko daļu parametru no host prototipiem kā *tikai lasāmus*. Tālāk norādītos atklāto hostu parametrus var konfigurēt: - *Veidnes* - pievienot jaunas veidnes vai atsaistīt manuāli pievienotās. Veidnes, kas pārmantotas no host prototipa, nevar atsaistīt. - *Apraksts* - pievienot vai rediģēt host aprakstu. - *Statuss* - iespējot vai atspējot host. - *Tagi* - pievienot jaunus tagus vai noņemt manuāli pievienotos. Tagus, kas pārmantoti no host prototipa, nevar noņemt. Ņemiet vērā, ka tagiem nevar būt dublikāti (tagi ar vienādu nosaukumu un vērtību). Ja host prototipam tiek pievienots jauns tags un tas sakrīt ar manuāli pievienotu tagu atklātā hostā, manuāli pievienotais tags atklāšanas laikā tiks aizstāts ar pārmantoto tagu. - *Makrosi* - pievienot jaunus host makrosus vai noņemt manuāli pievienotos, kā arī tos, kas pārmantoti no host prototipa; mainīt makrosu vērtības un [tipus](/manual/config/macros/user_macros#configuration). ::: noteclassic Atklātie hosts arī pārmanto [lietotāja makrosus](/manual/config/macros/user_macros) no host, kurā ir konfigurēts atklāšanas noteikums. Šos pārmantotos makrosus var noņemt, un to vērtības un tipus var mainīt. ::: Atklātos hosts var dzēst manuāli. Tomēr ņemiet vērā, ka tie tiks atklāti atkārtoti, ja tiem ir iespējota atklāšana. Hosts, kas vairs netiek atklāti, var tikt: - automātiski atspējoti (pamatojoties uz atklāšanas noteikuma vērtību *Disable lost resources*) - automātiski dzēsti (pamatojoties uz atklāšanas noteikuma vērtību *Delete lost resources*). ::: noteclassic Zabbix neatbalsta ligzdotus host prototipus, tas ir, host prototipus uz hosts, kas atklāti ar zemā līmeņa atklāšanas noteikumiem. ::: # Discovered host This class is designed to work with discovered hosts. Object references: - [Discovered host](/manual/api/reference/dhost/object#discovered-host) Available methods: - [dhost.get](/manual/api/reference/dhost/get) - retrieve discovered hosts # Atklātais hosts Šī klase ir paredzēta darbam ar atklātajiem hostiem. Objektu atsauces: - [Atklātais hosts](/manual/api/reference/dhost/object#discovered-host) Pieejamās metodes: - [dhost.get](/manual/api/reference/dhost/get) - izgūt atklātos hostus ### Discovered service ::: noteclassic Discovered services are created by the Zabbix server and cannot be modified via the API. ::: The discovered service object contains information about a service discovered by a network discovery rule on a host. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |dserviceid|ID|ID of the discovered service.| |dcheckid|ID|ID of the discovery check used to detect the service.| |dhostid|ID|ID of the discovered host running the service.| |dns|string|DNS of the host running the service.| |ip|string|IP address of the host running the service.| |lastdown|timestamp|Time when the discovered service last went down.| |lastup|timestamp|Time when the discovered service last went up.| |port|integer|Service port number.| |status|integer|Status of the service.<br><br>Possible values:<br>0 - service up;<br>1 - service down.| |value|string|Value returned by the service when performing a Zabbix agent, SNMPv1, SNMPv2 or SNMPv3 discovery check.| ### Atklātais serviss ::: noteclassic Atklātos servisus izveido Zabbix serveris, un tos nevar modificēt, izmantojot API. ::: Atklātā servisa objekts satur informāciju par servisu, ko hosts atklāšanas noteikums ir atklājis tīkla atklāšanas kārtulas ietvaros. Tam ir šādas īpašības. |Īpašība|[Tips](/manual/api/reference_commentary#data-types)|Apraksts| |--|--|------| |dserviceid|ID|Atklātā servisa ID.| |dcheckid|ID|Servisa noteikšanai izmantotās atklāšanas pārbaudes ID.| |dhostid|ID|Atklātā hosta, kurā darbojas serviss, ID.| |dns|string|Hosta, kurā darbojas serviss, DNS.| |ip|string|Hosta, kurā darbojas serviss, IP adrese.| |lastdown|timestamp|Laiks, kad atklātais serviss pēdējo reizi kļuva nepieejams.| |lastup|timestamp|Laiks, kad atklātais serviss pēdējo reizi kļuva pieejams.| |port|integer|Servisa porta numurs.| |status|integer|Servisa statuss.<br><br>Iespējamās vērtības:<br>0 - serviss pieejams;<br>1 - serviss nav pieejams.| |value|string|Vērtība, ko serviss atgriež, veicot Zabbix aģents, SNMPv1, SNMPv2 vai SNMPv3 atklāšanas pārbaudi.| # Discovered service object The following objects are directly related to the `dservice` API. # Atklātais pakalpojuma objekts Tālāk norādītie objekti ir tieši saistīti ar `dservice` API. # Discovered service This class is designed to work with discovered services. Object references: - [Discovered service](/manual/api/reference/dservice/object#discovered-service) Available methods: - [dservice.get](/manual/api/reference/dservice/get) - retrieve discovered services # Atklātais pakalpojums Šī klase ir paredzēta darbam ar atklātajiem pakalpojumiem. Objekta atsauces: - [Atklātais pakalpojums](/manual/api/reference/dservice/object#discovered-service) Pieejamās metodes: - [dservice.get](/manual/api/reference/dservice/get) - izgūt atklātos pakalpojumus ##### Discovering MBean attributes Discovery item: `jmx.get[attributes,"com.example:type=*,*"]` Response: ``` {.json} [ { "object": "com.example:type=*", "domain": "com.example", "properties": { "type": "Simple" } }, { "object": "com.zabbix:type=yes,domain=zabbix.com,data-source=/dev/rand,ключ=значение,obj=true", "domain": "com.zabbix", "properties": { "type": "Hello", "domain": "com.example", "data-source": "/dev/rand", "ключ": "значение", "obj": true } } ] ``` ##### MBean atribūtu atklāšana Atklāšanas vienums: `jmx.get[attributes,"com.example:type=*,*"]` Atbilde: ``` {.json} [ { "object": "com.example:type=*", "domain": "com.example", "properties": { "type": "Simple" } }, { "object": "com.zabbix:type=yes,domain=zabbix.com,data-source=/dev/rand,ключ=значение,obj=true", "domain": "com.zabbix", "properties": { "type": "Hello", "domain": "com.example", "data-source": "/dev/rand", "ключ": "значение", "obj": true } } ] ``` ##### Discovering MBeans Discovery item: `jmx.get[beans,"com.example:type=*,*"]` Response: ``` {.json} [ { "object": "com.example:type=Hello,data-src=data-base,ключ=значение", "domain": "com.example", "properties": { "data-src": "data-base", "ключ": "значение", "type": "Hello" } }, { "object": "com.example:type=Atomic", "domain": "com.example", "properties": { "type": "Atomic" } } ] ``` ##### MBeans atklāšana Atklāšanas vienums: `jmx.get[beans,"com.example:type=*,*"]` Atbilde: ``` {.json} [ { "object": "com.example:type=Hello,data-src=data-base,ключ=значение", "domain": "com.example", "properties": { "data-src": "data-base", "ключ": "значение", "type": "Hello" } }, { "object": "com.example:type=Atomic", "domain": "com.example", "properties": { "type": "Atomic" } } ] ``` ## Discovery ## Atklāšana #### Discovery actions The following conditions can be used in discovery-based events: |Condition type|Supported operators|Description| |--|--|------| |*Host IP*|equals<br>does not equal|Specify an IP address range or a range to exclude for a discovered host.<br>**equals** - host IP is in the range.<br>**does not equal** - host IP is not in the range.<br>It may have the following formats:<br>Single IP: 192.168.1.33<br>Range of IP addresses: 192.168.1-10.1-254<br>IP mask: 192.168.4.0/24<br>List: 192.168.1.1-254, 192.168.2.1-100, 192.168.2.200, 192.168.4.0/24<br>Spaces in the list format are supported.| |*Service type*|equals<br>does not equal|Specify a service type of a discovered service or a service type to exclude.<br>**equals** - matches the discovered service.<br>**does not equal** - does not match the discovered service.<br>Available service types: SSH, LDAP, SMTP, FTP, HTTP, HTTPS, POP, NNTP, IMAP, TCP, Zabbix agent, SNMPv1 agent, SNMPv2 agent, SNMPv3 agent, ICMP ping, telnet.| |*Service port*|equals<br>does not equal|Specify a TCP port range of a discovered service or a range to exclude.<br>**equals** - service port is in the range.<br>**does not equal** - service port is not in the range.| |*Discovery rule*|equals<br>does not equal|Specify a discovery rule or a discovery rule to exclude.<br>**equals** - using this discovery rule.<br>**does not equal** - using any other discovery rule, except this one.| |*Discovery check*|equals<br>does not equal|Specify a discovery check or a discovery check to exclude.<br>**equals** - using this discovery check.<br>**does not equal** - using any other discovery check, except this one.| |*Discovery object*|equals|Specify the discovered object.<br>**equals** - equal to discovered object (a device or a service).| |*Discovery status*|equals|**Up** - matches 'Host Up' and 'Service Up' events.<br>**Down** - matches 'Host Down' and 'Service Down' events.<br>**Discovered** - matches 'Host Discovered' and 'Service Discovered' events.<br>**Lost** - matches 'Host Lost' and 'Service Lost' events.| |*Uptime/Downtime*|is greater than or equals<br>is less than or equals|Uptime for 'Host Up' and 'Service Up' events. Downtime for 'Host Down' and 'Service Down' events.<br>**is greater than or equals** - is more or equal to. Parameter is given in seconds.<br>**is less than or equals** - is less or equal to. Parameter is given in seconds.| |*Received value*|equals<br>does not equal<br>is greater than or equals<br>is less than or equals<br>contains<br>does not contain|Specify the value received from an agent (Zabbix, SNMP) check in a discovery rule. String comparison. If several Zabbix agent or SNMP checks are configured for a rule, received values for each of them are checked (each check generates a new event which is matched against all conditions).<br>**equals** - equal to the value.<br>**does not equal** - not equal to the value.<br>**is greater than or equals** - more or equal to the value.<br>**is less than or equals** - less or equal to the value.<br>**contains** - contains the substring. Parameter is given as a string.<br>**does not contain** - does not contain the substring. Parameter is given as a string.| |*Proxy*|equals<br>does not equal|Specify a proxy or a proxy to exclude.<br>**equals** - using this proxy.<br>**does not equal** - using any other proxy except this one.| ::: noteclassic Service checks in a discovery rule, which result in discovery events, do not take place simultaneously. Therefore, if **multiple** values are configured for `Service type`, `Service port` or `Received value` conditions in the action, they will be compared to one discovery event at a time, but **not** to several events simultaneously. As a result, actions with multiple values for the same check types may not be executed correctly. ::: #### Atklāšanas darbības Tālāk norādītos nosacījumus var izmantot uz atklāšanu balstītos notikumos: |Nosacījuma tips|Atbalstītie operatori|Apraksts| |--|--|------| |*Host IP*|vienāds ar<br>nav vienāds ar|Norādiet atklāta hosta IP adrešu diapazonu vai izslēdzamo diapazonu.<br>**vienāds ar** - hosta IP ir diapazonā.<br>**nav vienāds ar** - hosta IP nav diapazonā.<br>Tam var būt šādi formāti:<br>Viena IP adrese: 192.168.1.33<br>IP adrešu diapazons: 192.168.1-10.1-254<br>IP maska: 192.168.4.0/24<br>Saraksts: 192.168.1.1-254, 192.168.2.1-100, 192.168.2.200, 192.168.4.0/24<br>Atstarpes saraksta formātā tiek atbalstītas.| |*Service type*|vienāds ar<br>nav vienāds ar|Norādiet atklāta pakalpojuma tipu vai izslēdzamo pakalpojuma tipu.<br>**vienāds ar** - atbilst atklātajam pakalpojumam.<br>**nav vienāds ar** - neatbilst atklātajam pakalpojumam.<br>Pieejamie pakalpojumu tipi: SSH, LDAP, SMTP, FTP, HTTP, HTTPS, POP, NNTP, IMAP, TCP, Zabbix aģents, SNMPv1 aģents, SNMPv2 aģents, SNMPv3 aģents, ICMP ping, telnet.| |*Service port*|vienāds ar<br>nav vienāds ar|Norādiet atklāta pakalpojuma TCP portu diapazonu vai izslēdzamo diapazonu.<br>**vienāds ar** - pakalpojuma ports ir diapazonā.<br>**nav vienāds ar** - pakalpojuma ports nav diapazonā.| |*Discovery rule*|vienāds ar<br>nav vienāds ar|Norādiet atklāšanas kārtulu vai izslēdzamu atklāšanas kārtulu.<br>**vienāds ar** - izmanto šo atklāšanas kārtulu.<br>**nav vienāds ar** - izmanto jebkuru citu atklāšanas kārtulu, izņemot šo.| |*Discovery check*|vienāds ar<br>nav vienāds ar|Norādiet atklāšanas pārbaudi vai izslēdzamu atklāšanas pārbaudi.<br>**vienāds ar** - izmanto šo atklāšanas pārbaudi.<br>**nav vienāds ar** - izmanto jebkuru citu atklāšanas pārbaudi, izņemot šo.| |*Discovery object*|vienāds ar|Norādiet atklāto objektu.<br>**vienāds ar** - vienāds ar atklāto objektu (ierīci vai pakalpojumu).| |*Discovery status*|vienāds ar|**Up** - atbilst notikumiem 'Host Up' un 'Service Up'.<br>**Down** - atbilst notikumiem 'Host Down' un 'Service Down'.<br>**Discovered** - atbilst notikumiem 'Host Discovered' un 'Service Discovered'.<br>**Lost** - atbilst notikumiem 'Host Lost' un 'Service Lost'.| |*Uptime/Downtime*|ir lielāks vai vienāds ar<br>ir mazāks vai vienāds ar|Darbspējas laiks notikumiem 'Host Up' un 'Service Up'. Dīkstāves laiks notikumiem 'Host Down' un 'Service Down'.<br>**ir lielāks vai vienāds ar** - ir lielāks vai vienāds ar. Parametrs tiek norādīts sekundēs.<br>**ir mazāks vai vienāds ar** - ir mazāks vai vienāds ar. Parametrs tiek norādīts sekundēs.| |*Received value*|vienāds ar<br>nav vienāds ar<br>ir lielāks vai vienāds ar<br>ir mazāks vai vienāds ar<br>satur<br>nesatur|Norādiet vērtību, kas saņemta no aģenta (Zabbix, SNMP) pārbaudes atklāšanas kārtulā. Virkņu salīdzināšana. Ja kārtulai ir konfigurētas vairākas Zabbix aģenta vai SNMP pārbaudes, tiek pārbaudītas no katras no tām saņemtās vērtības (katra pārbaude ģenerē jaunu notikumu, kas tiek salīdzināts ar visiem nosacījumiem).<br>**vienāds ar** - vienāds ar vērtību.<br>**nav vienāds ar** - nav vienāds ar vērtību.<br>**ir lielāks vai vienāds ar** - lielāks vai vienāds ar vērtību.<br>**ir mazāks vai vienāds ar** - mazāks vai vienāds ar vērtību.<br>**satur** - satur apakšvirkni. Parametrs tiek norādīts kā virkne.<br>**nesatur** - nesatur apakšvirkni. Parametrs tiek norādīts kā virkne.| |*Proxy*|vienāds ar<br>nav vienāds ar|Norādiet starpniekserveri vai izslēdzamu starpniekserveri.<br>**vienāds ar** - izmanto šo starpniekserveri.<br>**nav vienāds ar** - izmanto jebkuru citu starpniekserveri, izņemot šo.| ::: noteclassic Pakalpojumu pārbaudes atklāšanas kārtulā, kuru rezultātā rodas atklāšanas notikumi, nenotiek vienlaikus. Tāpēc, ja darbībā ir konfigurētas **vairākas** vērtības nosacījumiem `Service type`, `Service port` vai `Received value`, tās tiks salīdzinātas ar vienu atklāšanas notikumu vienlaikus, bet **nevis** ar vairākiem notikumiem vienlaikus. Tādēļ darbības ar vairākām vērtībām vieniem un tiem pašiem pārbaužu tipiem var netikt izpildītas pareizi. ::: # Discovery check object The following objects are directly related to the `dcheck` API. # Atklāšanas pārbaudes objekts Tālāk norādītie objekti ir tieši saistīti ar `dcheck` API. ### Discovery check The discovery check object defines a specific check performed by a network discovery rule. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |dcheckid|ID|ID of the discovery check.| |druleid|ID|ID of the discovery rule that the check belongs to.| |key\_|string|Item key (if `type` is set to "Zabbix agent") or SNMP OID (if `type` is set to "SNMPv1 agent", "SNMPv2 agent", or "SNMPv3 agent").<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "Zabbix agent", "SNMPv1 agent", "SNMPv2 agent", or "SNMPv3 agent"| |ports|string|One or several port ranges to check, separated by commas.<br><br>Default: 0.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "SSH" (0), "LDAP" (1), "SMTP" (2), "FTP" (3), "HTTP" (4), "POP" (5), "NNTP" (6), "IMAP" (7), "TCP" (8), "Zabbix agent" (9), "SNMPv1 agent" (10), "SNMPv2 agent" (11), "SNMPv3 agent" (13), "HTTPS" (14), or "Telnet" (15)| |snmp\_community|string|SNMP community.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "SNMPv1 agent" or "SNMPv2 agent"| |snmpv3\_authpassphrase|string|Authentication passphrase.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "SNMPv3 agent" and `snmpv3_securitylevel` is set to "authNoPriv" or "authPriv"| |snmpv3\_authprotocol|integer|Authentication protocol.<br><br>Possible values:<br>0 - *(default)* MD5;<br>1 - SHA1;<br>2 - SHA224;<br>3 - SHA256;<br>4 - SHA384;<br>5 - SHA512.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "SNMPv3 agent" and `snmpv3_securitylevel` is set to "authNoPriv" or "authPriv"| |snmpv3\_contextname|string|SNMPv3 context name.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "SNMPv3 agent"| |snmpv3\_privpassphrase|string|Privacy passphrase.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "SNMPv3 agent" and `snmpv3_securitylevel` is set to "authPriv"| |snmpv3\_privprotocol|integer|Privacy protocol.<br><br>Possible values:<br>0 - *(default)* DES;<br>1 - AES128;<br>2 - AES192;<br>3 - AES256;<br>4 - AES192C;<br>5 - AES256C.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "SNMPv3 agent" and `snmpv3_securitylevel` is set to "authPriv"| |snmpv3\_securitylevel|string|Security level.<br><br>Possible values:<br>0 - noAuthNoPriv;<br>1 - authNoPriv;<br>2 - authPriv.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "SNMPv3 agent"| |snmpv3\_securityname|string|Security name.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "SNMPv3 agent"| |type|integer|Type of check.<br><br>Possible values:<br>0 - SSH;<br>1 - LDAP;<br>2 - SMTP;<br>3 - FTP;<br>4 - HTTP;<br>5 - POP;<br>6 - NNTP;<br>7 - IMAP;<br>8 - TCP;<br>9 - Zabbix agent;<br>10 - SNMPv1 agent;<br>11 - SNMPv2 agent;<br>12 - ICMP ping;<br>13 - SNMPv3 agent;<br>14 - HTTPS;<br>15 - Telnet.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |uniq|integer|Whether to use this check as a device uniqueness criteria. Only a single unique check can be configured for a discovery rule.<br><br>Possible values:<br>0 - *(default)* do not use this check as a uniqueness criteria;<br>1 - use this check as a uniqueness criteria.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "Zabbix agent", "SNMPv1 agent", "SNMPv2 agent", or "SNMPv3 agent"| |host\_source|integer|Source for host name.<br><br>Possible values:<br>1 - *(default)* DNS;<br>2 - IP;<br>3 - discovery value of this check.| |name\_source|integer|Source for visible name.<br><br>Possible values:<br>0 - *(default)* not specified;<br>1 - DNS;<br>2 - IP;<br>3 - discovery value of this check.| |allow\_redirect|integer|Allow situation where the target being ICMP pinged responds from a different IP address.<br><br>Possible values:<br>0 - *(default)* treat redirected responses as if the target host is down (fail);<br>1 - treat redirected responses as if the target host is up (success).<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "ICMP ping"| ### Atklāšanas pārbaude Atklāšanas pārbaudes objekts definē konkrētu pārbaudi, ko veic tīkla atklāšanas kārtula. Tam ir šādas īpašības. |Īpašība|[Tips](/manual/api/reference_commentary#data-types)|Apraksts| |--|--|------| |dcheckid|ID|Atklāšanas pārbaudes ID.| |druleid|ID|Tās atklāšanas kārtulas ID, kurai pieder pārbaude.| |key\_|string|Vienuma atslēga (ja `type` ir iestatīts uz "Zabbix aģents") vai SNMP OID (ja `type` ir iestatīts uz "SNMPv1 aģents", "SNMPv2 aģents" vai "SNMPv3 aģents").<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāta*, ja `type` ir iestatīts uz "Zabbix aģents", "SNMPv1 aģents", "SNMPv2 aģents" vai "SNMPv3 aģents"| |ports|string|Viens vai vairāki pārbaudāmo portu diapazoni, atdalīti ar komatiem.<br><br>Noklusējums: 0.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *atbalstīta*, ja `type` ir iestatīts uz "SSH" (0), "LDAP" (1), "SMTP" (2), "FTP" (3), "HTTP" (4), "POP" (5), "NNTP" (6), "IMAP" (7), "TCP" (8), "Zabbix aģents" (9), "SNMPv1 aģents" (10), "SNMPv2 aģents" (11), "SNMPv3 aģents" (13), "HTTPS" (14) vai "Telnet" (15)| |snmp\_community|string|SNMP kopiena.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāta*, ja `type` ir iestatīts uz "SNMPv1 aģents" vai "SNMPv2 aģents"| |snmpv3\_authpassphrase|string|Autentifikācijas parole.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *atbalstīta*, ja `type` ir iestatīts uz "SNMPv3 aģents" un `snmpv3_securitylevel` ir iestatīts uz "authNoPriv" vai "authPriv"| |snmpv3\_authprotocol|integer|Autentifikācijas protokols.<br><br>Iespējamās vērtības:<br>0 - *(noklusējums)* MD5;<br>1 - SHA1;<br>2 - SHA224;<br>3 - SHA256;<br>4 - SHA384;<br>5 - SHA512.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *atbalstīta*, ja `type` ir iestatīts uz "SNMPv3 aģents" un `snmpv3_securitylevel` ir iestatīts uz "authNoPriv" vai "authPriv"| |snmpv3\_contextname|string|SNMPv3 konteksta nosaukums.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *atbalstīta*, ja `type` ir iestatīts uz "SNMPv3 aģents"| |snmpv3\_privpassphrase|string|Privātuma parole.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *atbalstīta*, ja `type` ir iestatīts uz "SNMPv3 aģents" un `snmpv3_securitylevel` ir iestatīts uz "authPriv"| |snmpv3\_privprotocol|integer|Privātuma protokols.<br><br>Iespējamās vērtības:<br>0 - *(noklusējums)* DES;<br>1 - AES128;<br>2 - AES192;<br>3 - AES256;<br>4 - AES192C;<br>5 - AES256C.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *atbalstīta*, ja `type` ir iestatīts uz "SNMPv3 aģents" un `snmpv3_securitylevel` ir iestatīts uz "authPriv"| |snmpv3\_securitylevel|string|Drošības līmenis.<br><br>Iespējamās vērtības:<br>0 - noAuthNoPriv;<br>1 - authNoPriv;<br>2 - authPriv.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *atbalstīta*, ja `type` ir iestatīts uz "SNMPv3 aģents"| |snmpv3\_securityname|string|Drošības nosaukums.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *atbalstīta*, ja `type` ir iestatīts uz "SNMPv3 aģents"| |type|integer|Pārbaudes tips.<br><br>Iespējamās vērtības:<br>0 - SSH;<br>1 - LDAP;<br>2 - SMTP;<br>3 - FTP;<br>4 - HTTP;<br>5 - POP;<br>6 - NNTP;<br>7 - IMAP;<br>8 - TCP;<br>9 - Zabbix aģents;<br>10 - SNMPv1 aģents;<br>11 - SNMPv2 aģents;<br>12 - ICMP ping;<br>13 - SNMPv3 aģents;<br>14 - HTTPS;<br>15 - Telnet.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāta*| |uniq|integer|Vai izmantot šo pārbaudi kā ierīces unikalitātes kritēriju. Vienai atklāšanas kārtulai var konfigurēt tikai vienu unikālu pārbaudi.<br><br>Iespējamās vērtības:<br>0 - *(noklusējums)* neizmantot šo pārbaudi kā unikalitātes kritēriju;<br>1 - izmantot šo pārbaudi kā unikalitātes kritēriju.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *atbalstīta*, ja `type` ir iestatīts uz "Zabbix aģents", "SNMPv1 aģents", "SNMPv2 aģents" vai "SNMPv3 aģents"| |host\_source|integer|Avots hosta nosaukumam.<br><br>Iespējamās vērtības:<br>1 - *(noklusējums)* DNS;<br>2 - IP;<br>3 - šīs pārbaudes atklāšanas vērtība.| |name\_source|integer|Avots redzamajam nosaukumam.<br><br>Iespējamās vērtības:<br>0 - *(noklusējums)* nav norādīts;<br>1 - DNS;<br>2 - IP;<br>3 - šīs pārbaudes atklāšanas vērtība.| |allow\_redirect|integer|Atļaut situāciju, kad mērķis, kuram tiek veikts ICMP ping, atbild no citas IP adreses.<br><br>Iespējamās vērtības:<br>0 - *(noklusējums)* apstrādāt pāradresētās atbildes tā, it kā mērķa hosts nebūtu pieejams (kļūme);<br>1 - apstrādāt pāradresētās atbildes tā, it kā mērķa hosts būtu pieejams (veiksme).<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *atbalstīta*, ja `type` ir iestatīts uz "ICMP ping"| # Discovery check This class is designed to work with discovery checks. Object references: - [Discovery check](/manual/api/reference/dcheck/object#discovery-check) Available methods: - [dcheck.get](/manual/api/reference/dcheck/get) - retrieve discovery checks # Atklāšanas pārbaude Šī klase ir paredzēta darbam ar atklāšanas pārbaudēm. Objektu atsauces: - [Atklāšanas pārbaude](/manual/api/reference/dcheck/object#discovery-check) Pieejamās metodes: - [dcheck.get](/manual/api/reference/dcheck/get) - izgūt atklāšanas pārbaudes #### Discovery events Zabbix periodically scans the IP ranges defined in network discovery rules. Frequency of the check is configurable for each rule individually. Once a host or a service is discovered, a discovery event (or several events) are generated. Zabbix generates the following events: |Event|When generated| |--|--------| |Service Up|Every time Zabbix detects active service.| |Service Down|Every time Zabbix cannot detect service.| |Host Up|If at least one of the services is UP for the IP.| |Host Down|If all services are not responding.| |Service Discovered|If the service is back after downtime or discovered for the first time.| |Service Lost|If the service is lost after being up.| |Host Discovered|If host is back after downtime or discovered for the first time.| |Host Lost|If host is lost after being up.| #### Atklāšanas notikumi Zabbix periodiski skenē IP diapazonus, kas definēti tīkla atklāšanas noteikumos. Pārbaudes biežums ir konfigurējams katram noteikumam atsevišķi. Tiklīdz tiek atklāts hosts vai pakalpojums, tiek ģenerēts atklāšanas notikums (vai vairāki notikumi). Zabbix ģenerē šādus notikumus: |Notikums|Kad tiek ģenerēts| |--|--------| |Pakalpojums darbojas|Katru reizi, kad Zabbix nosaka aktīvu pakalpojumu.| |Pakalpojums nedarbojas|Katru reizi, kad Zabbix nevar noteikt pakalpojumu.| |Hosts darbojas|Ja IP adresei vismaz viens no pakalpojumiem ir pieejams.| |Hosts nedarbojas|Ja neviens no pakalpojumiem neatbild.| |Pakalpojums atklāts|Ja pakalpojums atkal ir pieejams pēc dīkstāves vai tiek atklāts pirmo reizi.| |Pakalpojums zaudēts|Ja pakalpojums tiek zaudēts pēc tam, kad tas bija pieejams.| |Hosts atklāts|Ja hosts atkal ir pieejams pēc dīkstāves vai tiek atklāts pirmo reizi.| |Hosts zaudēts|Ja hosts tiek zaudēts pēc tam, kad tas bija pieejams.| ### Discovery |Macro|Supported in|Description| |--|--------|--------| |{DISCOVERY.DEVICE.IPADDRESS}|→ Discovery notifications and commands|*IP address of the discovered device.*<br>Available always, does not depend on host being added.| |{DISCOVERY.DEVICE.DNS}|→ Discovery notifications and commands|*DNS name of the discovered device.*<br>Available always, does not depend on host being added.| |{DISCOVERY.DEVICE.STATUS}|→ Discovery notifications and commands|*Status of the discovered device*: can be either UP or DOWN.| |{DISCOVERY.DEVICE.UPTIME}|→ Discovery notifications and commands|*Time since the last change of discovery status for a particular device*, with precision down to a second.<br>For example: 1h 29m 01s.<br>For devices with status DOWN, this is the period of their downtime.| |{DISCOVERY.RULE.NAME}|→ Discovery notifications and commands|*Name of the discovery rule that discovered the presence or absence of the device or service.*| |{DISCOVERY.SERVICE.NAME}|→ Discovery notifications and commands|*Name of the service that was discovered.*<br>For example: HTTP.| |{DISCOVERY.SERVICE.PORT}|→ Discovery notifications and commands|*Port of the service that was discovered.*<br>For example: 80.| |{DISCOVERY.SERVICE.STATUS}|→ Discovery notifications and commands|*Status of the discovered service*: can be either UP or DOWN.| |{DISCOVERY.SERVICE.UPTIME} |→ Discovery notifications and commands |*Time since the last change of discovery status for a particular service*, with precision down to a second.<br>For example: 1h 29m 01s.<br>For services with status DOWN, this is the period of their downtime. | ### Atklāšana |Macro|Supported in|Description| |--|--------|--------| |{DISCOVERY.DEVICE.IPADDRESS}|→ Discovery notifications and commands|*Atklātās ierīces IP adrese.*<br>Vienmēr pieejams, nav atkarīgs no tā, vai hosts ir pievienots.| |{DISCOVERY.DEVICE.DNS}|→ Discovery notifications and commands|*Atklātās ierīces DNS nosaukums.*<br>Vienmēr pieejams, nav atkarīgs no tā, vai hosts ir pievienots.| |{DISCOVERY.DEVICE.STATUS}|→ Discovery notifications and commands|*Atklātās ierīces statuss*: var būt UP vai DOWN.| |{DISCOVERY.DEVICE.UPTIME}|→ Discovery notifications and commands|*Laiks kopš pēdējās atklāšanas statusa izmaiņas konkrētai ierīcei*, ar precizitāti līdz sekundei.<br>Piemēram: 1h 29m 01s.<br>Ierīcēm ar statusu DOWN tas ir dīkstāves periods.| |{DISCOVERY.RULE.NAME}|→ Discovery notifications and commands|*Atklāšanas noteikuma nosaukums, kas konstatēja ierīces vai pakalpojuma esamību vai neesamību.*| |{DISCOVERY.SERVICE.NAME}|→ Discovery notifications and commands|*Atklātā pakalpojuma nosaukums.*<br>Piemēram: HTTP.| |{DISCOVERY.SERVICE.PORT}|→ Discovery notifications and commands|*Atklātā pakalpojuma ports.*<br>Piemēram: 80.| |{DISCOVERY.SERVICE.STATUS}|→ Discovery notifications and commands|*Atklātā pakalpojuma statuss*: var būt UP vai DOWN.| |{DISCOVERY.SERVICE.UPTIME} |→ Discovery notifications and commands |*Laiks kopš pēdējās atklāšanas statusa izmaiņas konkrētam pakalpojumam*, ar precizitāti līdz sekundei.<br>Piemēram: 1h 29m 01s.<br>Pakalpojumiem ar statusu DOWN tas ir dīkstāves periods. | #### Discovery methods - [Network discovery](/manual/discovery/network_discovery) - automatically detect hosts and services available on your network. - [Active agent autoregistration](/manual/discovery/auto_registration) - allow active agents to automatically register themselves with the server. - [Low-level discovery](/manual/discovery/low_level_discovery) - automatically create items, triggers, graphs, and hosts for discovered entities like file systems or network interfaces using prototypes. #### Atklāšanas metodes - [Tīkla atklāšana](/manual/discovery/network_discovery) - automātiski noteikt tīklā pieejamos hosts un pakalpojumus. - [Aktīvā aģenta automātiskā reģistrācija](/manual/discovery/auto_registration) - ļaut aktīvajiem aģentiem automātiski reģistrēties serverī. - [Zema līmeņa atklāšana](/manual/discovery/low_level_discovery) - automātiski izveidot vienumus, trigerus, grafikus un hosts atklātajiem objektiem, piemēram, failu sistēmām vai tīkla saskarnēm, izmantojot prototipus. ##### Discovery of disabled systemd units It is also possible to discover **disabled** systemd units. In this case three macros are returned in the resulting JSON: - {#UNIT.PATH} - {#UNIT.ACTIVESTATE} - {#UNIT.UNITFILESTATE}. ::: noteimportant To have items and triggers created from prototypes for disabled systemd units, make sure to adjust (or remove) prohibiting LLD filters for {#UNIT.ACTIVESTATE} and {#UNIT.UNITFILESTATE}. ::: ##### Atspējotu systemd vienību atklāšana Ir iespējams arī atklāt **atspējotas** systemd vienības. Šajā gadījumā iegūtajā JSON tiek atgriezti trīs makrosi: - {#UNIT.PATH} - {#UNIT.ACTIVESTATE} - {#UNIT.UNITFILESTATE}. ::: noteimportant Lai no prototipiem tiktu izveidoti vienumi un trigeri atspējotām systemd vienībām, pārliecinieties, ka pielāgojat (vai noņemat) aizliedzošos LLD filtrus priekš {#UNIT.ACTIVESTATE} un {#UNIT.UNITFILESTATE}. ::: ### Discovery of Windows services [Low-level discovery](/manual/discovery/low_level_discovery) provides a way to automatically create items, triggers, and graphs for different entities on a computer. Zabbix can automatically start monitoring Windows services on your machine, without the need to know the exact name of a service or create items for each service manually. A filter can be used to generate real items, triggers, and graphs only for services of interest. ### Windows pakalpojumu atklāšana [Zema līmeņa atklāšana](/manual/discovery/low_level_discovery) nodrošina veidu, kā automātiski izveidot vienumus, trigerus un grafikus dažādām datora entītijām. Zabbix var automātiski sākt uzraudzīt Windows pakalpojumus jūsu datorā, bez nepieciešamības zināt precīzu pakalpojuma nosaukumu vai manuāli izveidot vienumus katram pakalpojumam. Filtru var izmantot, lai ģenerētu reālus vienumus, trigerus un grafikus tikai tiem pakalpojumiem, kas jūs interesē. # discoveryrule.copy # discoveryrule.copy # discoveryrule.create # discoveryrule.create # discoveryrule.delete # discoveryrule.delete # discoveryrule.get # discoveryrule.get # Discovery rule object The following objects are directly related to the `drule` API. # Atklāšanas kārtulas objekts Tālāk norādītie objekti ir tieši saistīti ar `drule` API. #### Discovery rule The discovery rule form contains five tabs, representing, from left to right, the data flow during discovery: - *Discovery rule* - specifies, most importantly, the built-in item or custom script to retrieve discovery data. - *Preprocessing* - applies some preprocessing to the discovered data. - *LLD macros* - allows to extract some macro values to use in discovered items, triggers, etc. - *Filters* - allows to filter the discovered values. - *Overrides* - allows to modify items, triggers, graphs or host prototypes when applying to specific discovered objects. The **Discovery rule** tab contains the item key to use for discovery (as well as some general discovery rule attributes): {width="600"} All mandatory input fields are marked with a red asterisk. |Parameter|Description| |--|--------| |*Name*|Name of discovery rule.| |*Type*|The type of check to perform discovery.<br>In this example we are using a *Zabbix agent* item type.<br>The discovery rule can also be a [dependent item](/manual/config/items/itemtypes/dependent_items), depending on a regular item. It cannot depend on another discovery rule. For a dependent item, select the respective type (*Dependent item*) and specify the master item in the 'Master item' field. The master item must exist.| |*Key*|Enter the discovery item key (up to 2048 characters).<br>For example, you may use the built-in `vfs.fs.discovery` item key to return a JSON string with the list of file systems present on the computer, their types and mount options.<br>Note that another option for filesystem discovery is using discovery results by the `vfs.fs.get` agent key (see [example](/manual/discovery/low_level_discovery/examples/mounted_filesystems)).| |*Update interval*|This field specifies how often Zabbix performs discovery. In the beginning, when you are just setting up file system discovery, you might wish to set it to a small interval, but once you know it works you can set it to 30 minutes or more, because file systems usually do not change very often.<br>[Time suffixes](/manual/appendix/suffixes) are supported, e.g. 30s, 1m, 2h, 1d.<br>[User macros](/manual/config/macros/user_macros) are supported.<br>*Note*: The update interval can only be set to '0' if custom intervals exist with a non-zero value. If set to '0', and a custom interval (flexible or scheduled) exists with a non-zero value, the item will be polled during the custom interval duration.<br>New discovery rules will be checked within 60 seconds of their creation, unless they have Scheduling or Flexible update interval and the *Update interval* is set to 0.<br>*Note* that for an existing discovery rule the discovery can be performed immediately by pushing the *Execute now* [button](#form-buttons).| |*Custom intervals*|You can create custom rules for checking the item:<br>**Flexible** - create an exception to the *Update interval* (interval with different frequency)<br>**Scheduling** - create a custom polling schedule.<br>For detailed information see [Custom intervals](/manual/config/items/item/custom_intervals).| |*Timeout*|Set the discovery check timeout. Select the timeout option:<br>**Global** - proxy/global timeout is used (displayed in the grayed out *Timeout* field);<br>**Override** - custom timeout is used (set in the *Timeout* field; allowed range: 1 - 600s). [Time suffixes](/manual/appendix/suffixes#time-suffixes), e.g. 30s, 1m, and [user macros](/manual/config/macros/user_macros) are supported.<br>Clicking the *Timeouts* link allows you to configure [proxy](/manual/distributed_monitoring/proxies#configuration) timeouts or [global](/manual/web_interface/frontend_sections/administration/general#timeouts) timeouts (if a proxy is not used). Note that the *Timeouts* link is visible only to users of *Super admin* type with permissions to *Administration* > [*General*](/manual/web_interface/frontend_sections/administration/general) or *Administration* > [*Proxies*](/manual/web_interface/frontend_sections/administration/proxies) frontend sections.| |*Delete lost resources*|Specify how soon the discovered entity will be deleted once its discovery status becomes "Not discovered anymore":<br>*Never* - it will not be deleted;<br>*Immediately* - it will be deleted immediately;<br>*After* - it will be deleted after the specified time period. The value must be greater than *Disable lost resources* value.<br>[Time suffixes](/manual/appendix/suffixes) are supported, e.g. 2h, 1d.<br>[User macros](/manual/config/macros/user_macros) are supported.<br>*Note*: Using "Immediately" is not recommended, since just wrongly editing the filter may end up in the entity being deleted with all the historical data.<br>Note that manually disabled resources will not be deleted by low-level discovery.| |*Disable lost resources*|Specify how soon the discovered entity will be disabled once its discovery status becomes "Not discovered anymore":<br>*Never* - it will not be disabled;<br>*Immediately* - it will be disabled immediately;<br>*After* - it will be disabled after the specified time period. The value should be greater than the discovery rule update interval.<br>Note that automatically disabled resources will become enabled again, if re-discovered by low-level discovery. Manually disabled resources will not become enabled again if re-discovered.<br>This field is not displayed if *Delete lost resources* is set to "Immediately".<br>[Time suffixes](/manual/appendix/suffixes) are supported, e.g. 2h, 1d.<br>[User macros](/manual/config/macros/user_macros) are supported.| |*Description*|Enter a description.| |*Enabled*|If checked, the rule will be processed.| ::: noteclassic Discovery rule history is not preserved. ::: #### Atklāšanas noteikums Atklāšanas noteikuma forma satur piecas cilnes, kas no kreisās uz labo pusi attēlo datu plūsmu atklāšanas laikā: - *Atklāšanas noteikums* - galvenokārt norāda iebūvēto vienumu vai pielāgoto skriptu, kas tiek izmantots atklāšanas datu iegūšanai. - *Pirmapstrāde* - piemēro atklātajiem datiem pirmapstrādi. - *LLD makro* - ļauj iegūt noteiktas makro vērtības, ko izmantot atklātajos vienumos, trigeros u. c. - *Filtri* - ļauj filtrēt atklātās vērtības. - *Pārrakstīšanas* - ļauj modificēt vienumus, trigerus, grafikus vai hostu prototipus, piemērojot tos konkrētiem atklātajiem objektiem. Cilne **Atklāšanas noteikums** satur vienuma atslēgu, kas jāizmanto atklāšanai (kā arī dažus vispārīgus atklāšanas noteikuma atribūtus): {width="600"} Visi obligātie ievades lauki ir atzīmēti ar sarkanu zvaigznīti. |Parameter|Description| |--|--------| |*Name*|Atklāšanas noteikuma nosaukums.| |*Type*|Pārbaudes veids, kas jāveic atklāšanai.<br>Šajā piemērā tiek izmantots *Zabbix aģents* vienuma tips.<br>Atklāšanas noteikums var būt arī [atkarīgs vienums](/manual/config/items/itemtypes/dependent_items), kas balstās uz parastu vienumu. Tas nevar būt atkarīgs no cita atklāšanas noteikuma. Atkarīgam vienumam izvēlieties attiecīgo tipu (*Dependent item*) un norādiet galveno vienumu laukā 'Master item'. Galvenajam vienumam ir jāeksistē.| |*Key*|Ievadiet atklāšanas vienuma atslēgu (līdz 2048 rakstzīmēm).<br>Piemēram, varat izmantot iebūvēto `vfs.fs.discovery` vienuma atslēgu, lai atgrieztu JSON virkni ar datorā esošo failu sistēmu sarakstu, to tipiem un montēšanas opcijām.<br>Ņemiet vērā, ka vēl viena failu sistēmu atklāšanas iespēja ir izmantot atklāšanas rezultātus ar `vfs.fs.get` aģents atslēgu (skatiet [piemēru](/manual/discovery/low_level_discovery/examples/mounted_filesystems)).| |*Update interval*|Šis lauks nosaka, cik bieži Zabbix veic atklāšanu. Sākumā, kad tikai iestatāt failu sistēmu atklāšanu, varat to iestatīt uz īsu intervālu, bet, kad pārliecināsieties, ka tas darbojas, varat to iestatīt uz 30 minūtēm vai ilgāk, jo failu sistēmas parasti nemainās ļoti bieži.<br>Tiek atbalstīti [laika sufiksi](/manual/appendix/suffixes), piemēram, 30s, 1m, 2h, 1d.<br>Tiek atbalstīti [lietotāja makro](/manual/config/macros/user_macros).<br>*Piezīme*: Update interval var iestatīt uz '0' tikai tad, ja pastāv pielāgoti intervāli ar vērtību, kas nav nulle. Ja tas ir iestatīts uz '0' un pastāv pielāgots intervāls (elastīgs vai plānots) ar vērtību, kas nav nulle, vienums tiks aptaujāts pielāgotā intervāla laikā.<br>Jauni atklāšanas noteikumi tiks pārbaudīti 60 sekunžu laikā pēc to izveides, ja vien tiem nav Scheduling vai Flexible update interval un *Update interval* nav iestatīts uz 0.<br>*Piezīme*, ka esošam atklāšanas noteikumam atklāšanu var veikt nekavējoties, nospiežot pogu *Execute now* [button](#form-buttons).| |*Custom intervals*|Varat izveidot pielāgotus noteikumus vienuma pārbaudei:<br>**Flexible** - izveido izņēmumu *Update interval* (intervāls ar citu biežumu)<br>**Scheduling** - izveido pielāgotu aptaujas grafiku.<br>Detalizētu informāciju skatiet sadaļā [Custom intervals](/manual/config/items/item/custom_intervals).| |*Timeout*|Iestatiet atklāšanas pārbaudes noildzi. Izvēlieties noildzes opciju:<br>**Global** - tiek izmantota starpniekservera/globalā noildze (tiek parādīta pelēkajā laukā *Timeout*);<br>**Override** - tiek izmantota pielāgota noildze (iestatīta laukā *Timeout*; atļautais diapazons: 1 - 600s). Tiek atbalstīti [laika sufiksi](/manual/appendix/suffixes#time-suffixes), piemēram, 30s, 1m, un [lietotāja makro](/manual/config/macros/user_macros).<br>Noklikšķinot uz saites *Timeouts*, varat konfigurēt [starpniekservera](/manual/distributed_monitoring/proxies#configuration) noildzes vai [globālās](/manual/web_interface/frontend_sections/administration/general#timeouts) noildzes (ja starpniekserveris netiek izmantots). Ņemiet vērā, ka saite *Timeouts* ir redzama tikai lietotājiem ar *Super admin* tipu un tiesībām uz *Administration* > [*General*](/manual/web_interface/frontend_sections/administration/general) vai *Administration* > [*Proxies*](/manual/web_interface/frontend_sections/administration/proxies) lietotāja saskarnes sadaļām.| |*Delete lost resources*|Norādiet, cik drīz atklātais objekts tiks dzēsts, tiklīdz tā atklāšanas statuss kļūst "Not discovered anymore":<br>*Never* - tas netiks dzēsts;<br>*Immediately* - tas tiks dzēsts nekavējoties;<br>*After* - tas tiks dzēsts pēc norādītā laika perioda. Vērtībai jābūt lielākai par *Disable lost resources* vērtību.<br>Tiek atbalstīti [laika sufiksi](/manual/appendix/suffixes), piemēram, 2h, 1d.<br>Tiek atbalstīti [lietotāja makro](/manual/config/macros/user_macros).<br>*Piezīme*: "Immediately" izmantošana nav ieteicama, jo, ja filtrs tiek nepareizi rediģēts, objekts var tikt dzēsts kopā ar visiem vēsturiskajiem datiem.<br>Ņemiet vērā, ka manuāli atspējoti resursi netiks dzēsti ar zemā līmeņa atklāšanu.| |*Disable lost resources*|Norādiet, cik drīz atklātais objekts tiks atspējots, tiklīdz tā atklāšanas statuss kļūst "Not discovered anymore":<br>*Never* - tas netiks atspējots;<br>*Immediately* - tas tiks atspējots nekavējoties;<br>*After* - tas tiks atspējots pēc norādītā laika perioda. Vērtībai jābūt lielākai par atklāšanas noteikuma atjaunināšanas intervālu.<br>Ņemiet vērā, ka automātiski atspējotie resursi atkal tiks iespējoti, ja tos atkārtoti atklās zemā līmeņa atklāšana. Manuāli atspējotie resursi netiks atkārtoti iespējoti, ja tie tiks atklāti vēlreiz.<br>Šis lauks netiek rādīts, ja *Delete lost resources* ir iestatīts uz "Immediately".<br>Tiek atbalstīti [laika sufiksi](/manual/appendix/suffixes), piemēram, 2h, 1d.<br>Tiek atbalstīti [lietotāja makro](/manual/config/macros/user_macros).| |*Description*|Ievadiet aprakstu.| |*Enabled*|Ja atzīmēts, noteikums tiks apstrādāts.| ::: noteclassic Atklāšanas noteikuma vēsture netiek saglabāta. ::: ### Discovery rule The discovery rule object defines a network discovery rule. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |druleid|ID|ID of the discovery rule.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*<br>- *required* for update operations| |iprange|string|One or several IP ranges to check, separated by commas.<br><br>Refer to the [network discovery configuration](/manual/discovery/network_discovery/rule) section for more information on supported formats of IP ranges.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |name|string|Name of the discovery rule.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |delay|string|Execution interval of the discovery rule.<br><br>Accepts seconds or time unit with suffix (e.g., 30s, 1m, 2h, 1d), or a user macro.<br><br>Default: 1h.| |proxyid|ID|ID of the proxy used for discovery.| |status|integer|Whether the discovery rule is enabled.<br><br>Possible values:<br>0 - *(default)* enabled;<br>1 - disabled.| |concurrency\_max|integer|Maximum number of concurrent checks per discovery rule.<br><br>Possible values:<br>0 - *(default)* unlimited number of checks;<br>1 - one check;<br>2-999 - custom number of checks.| |error|string|Error text if there have been any problems when executing the discovery rule.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| ### Atklāšanas kārtula Atklāšanas kārtulas objekts definē tīkla atklāšanas kārtulu. Tam ir šādas īpašības. |Īpašība|[Type](/manual/api/reference_commentary#data-types)|Apraksts| |--|--|------| |druleid|ID|Atklāšanas kārtulas ID.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *tikai lasāms*<br>- *obligāts* atjaunināšanas operācijām| |iprange|string|Viens vai vairāki pārbaudāmie IP diapazoni, atdalīti ar komatiem.<br><br>Papildinformāciju par atbalstītajiem IP diapazonu formātiem skatiet sadaļā [tīkla atklāšanas konfigurācija](/manual/discovery/network_discovery/rule).<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāts* izveides operācijām| |name|string|Atklāšanas kārtulas nosaukums.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāts* izveides operācijām| |delay|string|Atklāšanas kārtulas izpildes intervāls.<br><br>Pieņem sekundes vai laika vienību ar sufiksu (piemēram, 30s, 1m, 2h, 1d), vai lietotāja makrosu.<br><br>Noklusējums: 1h.| |proxyid|ID|Atklāšanai izmantotā starpniekservera ID.| |status|integer|Vai atklāšanas kārtula ir iespējota.<br><br>Iespējamās vērtības:<br>0 - *(noklusējums)* iespējota;<br>1 - atspējota.| |concurrency\_max|integer|Maksimālais vienlaicīgo pārbaužu skaits vienai atklāšanas kārtulai.<br><br>Iespējamās vērtības:<br>0 - *(noklusējums)* neierobežots pārbaužu skaits;<br>1 - viena pārbaude;<br>2-999 - pielāgots pārbaužu skaits.| |error|string|Kļūdas teksts, ja atklāšanas kārtulas izpildes laikā radušās problēmas.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *tikai lasāms*| # Discovery rule This class is designed to work with network discovery rules. ::: notetip This API is meant to work with network discovery rules. For low-level discovery rules, see [LLD rule API](discoveryrule). ::: Object references: - [Discovery rule](/manual/api/reference/drule/object#discovery-rule) Available methods: - [drule.create](/manual/api/reference/drule/create) - create new network discovery rules - [drule.delete](/manual/api/reference/drule/delete) - delete network discovery rules - [drule.get](/manual/api/reference/drule/get) - retrieve network discovery rules - [drule.update](/manual/api/reference/drule/update) - update network discovery rules # Atklāšanas kārtula Šī klase ir paredzēta darbam ar tīkla atklāšanas kārtulām. ::: notetip Šī API ir paredzēta darbam ar tīkla atklāšanas kārtulām. Zema līmeņa atklāšanas kārtulām skatiet [LLD kārtulu API](discoveryrule). ::: Objektu atsauces: - [Atklāšanas kārtula](/manual/api/reference/drule/object#discovery-rule) Pieejamās metodes: - [drule.create](/manual/api/reference/drule/create) - izveidot jaunas tīkla atklāšanas kārtulas - [drule.delete](/manual/api/reference/drule/delete) - dzēst tīkla atklāšanas kārtulas - [drule.get](/manual/api/reference/drule/get) - izgūt tīkla atklāšanas kārtulas - [drule.update](/manual/api/reference/drule/update) - atjaunināt tīkla atklāšanas kārtulas # discoveryrule.update # discoveryrule.update #### discoveryrule [ZBX-27780](https://support.zabbix.com/browse/ZBX-27780) Parameters `delay`, `history`, and `trends` in [LLD rule override operation objects](/manual/api/reference/discoveryrule/object#lld-rule-override-operation) once again support LLD macros. #### discoveryrule [ZBX-27780](https://support.zabbix.com/browse/ZBX-27780) Parametri `delay`, `history` un `trends` [LLD noteikuma pārrakstīšanas darbības objektos](/manual/api/reference/discoveryrule/object#lld-rule-override-operation) atkal atbalsta LLD makro. #### discoveryrule [ZBXNEXT-7578](https://support.zabbix.com/browse/ZBXNEXT-7578) `discoveryrule.get`, `discoveryrule.create`, `discoveryrule.update`: The properties `headers` and `query_fields` changed from name-indexed object to array of objects with separate `name` and `value` properties. #### discoveryrule [ZBXNEXT-7578](https://support.zabbix.com/browse/ZBXNEXT-7578) `discoveryrule.get`, `discoveryrule.create`, `discoveryrule.update`: Rekvizīti `headers` un `query_fields` tika mainīti no pēc nosaukuma indeksēta objekta uz objektu masīvu ar atsevišķiem `name` un `value` rekvizītiem. #### discoveryrule [ZBXNEXT-9150](https://support.zabbix.com/browse/ZBXNEXT-9150) Added new LLD rule `type` (22 - Browser).<br> [ZBXNEXT-8645](https://support.zabbix.com/browse/ZBXNEXT-8645) Added new [LLD rule preprocessing](/manual/api/reference/discoveryrule/object#lld-rule-preprocessing) type "SNMP get value" (30).<br> [ZBXNEXT-8645](https://support.zabbix.com/browse/ZBXNEXT-8645) Property `timeout` is now also supported if item `type` is set to "SNMP agent" (20) and `snmp_oid` starts with "`get[`".<br> [ZBXNEXT-1096](https://support.zabbix.com/browse/ZBXNEXT-1096) Property `timeout` is now supported if item `type` is set to "Zabbix agent" (0), "Simple check" (3) and `key_` does not start with "`vmware.`" and "`icmpping`", "Zabbix agent (active)" (7), "External check" (10), "Database monitor" (11), "SSH agent" (13), "TELNET agent" (14), "SNMP agent" (20) and `snmp_oid` starts with "`walk[`".<br> [ZBXNEXT-7726](https://support.zabbix.com/browse/ZBXNEXT-7726) Added support for [LLD rule preprocessing](/manual/api/reference/discoveryrule/object#lld-rule-preprocessing) type "Matches regular expression" (14).<br> [ZBXNEXT-6986](https://support.zabbix.com/browse/ZBXNEXT-6986) Deprecated method `discoveryrule.copy`.<br> [ZBXNEXT-7578](https://support.zabbix.com/browse/ZBXNEXT-7578) It is now possible to store more data for the `query_fields` property, have repeated `header` and `query_fields` entries.<br> [ZBXNEXT-2020](https://support.zabbix.com/browse/ZBXNEXT-2020) Added new properties `lifetime_type`, `enabled_lifetime` and `enabled_lifetime_type`.<br> [ZBXNEXT-2020](https://support.zabbix.com/browse/ZBXNEXT-2020) Changed default value of `lifetime` parameter from `30d` to `7d`.<br> [ZBX-21850](https://support.zabbix.com/browse/ZBX-21850) `discoveryrule.get`: Filter conditions will be sorted in the order of their placement in the formula. #### discoveryrule [ZBXNEXT-9150](https://support.zabbix.com/browse/ZBXNEXT-9150) Pievienots jauns LLD noteikuma `type` (22 - Browser).<br> [ZBXNEXT-8645](https://support.zabbix.com/browse/ZBXNEXT-8645) Pievienots jauns [LLD noteikuma pirmapstrādes](/manual/api/reference/discoveryrule/object#lld-rule-preprocessing) tips "SNMP get value" (30).<br> [ZBXNEXT-8645](https://support.zabbix.com/browse/ZBXNEXT-8645) Rekvizīts `timeout` tagad ir atbalstīts arī tad, ja vienuma `type` ir iestatīts uz "SNMP agent" (20) un `snmp_oid` sākas ar "`get[`".<br> [ZBXNEXT-1096](https://support.zabbix.com/browse/ZBXNEXT-1096) Rekvizīts `timeout` tagad ir atbalstīts, ja vienuma `type` ir iestatīts uz "Zabbix agent" (0), "Simple check" (3) un `key_` nesākas ar "`vmware.`" un "`icmpping`", "Zabbix agent (active)" (7), "External check" (10), "Database monitor" (11), "SSH agent" (13), "TELNET agent" (14), "SNMP agent" (20) un `snmp_oid` sākas ar "`walk[`".<br> [ZBXNEXT-7726](https://support.zabbix.com/browse/ZBXNEXT-7726) Pievienots atbalsts [LLD noteikuma pirmapstrādes](/manual/api/reference/discoveryrule/object#lld-rule-preprocessing) tipam "Matches regular expression" (14).<br> [ZBXNEXT-6986](https://support.zabbix.com/browse/ZBXNEXT-6986) Novecojis `discoveryrule.copy` metodes lietojums.<br> [ZBXNEXT-7578](https://support.zabbix.com/browse/ZBXNEXT-7578) Tagad ir iespējams saglabāt vairāk datu `query_fields` rekvizītam, var būt atkārtoti `header` un `query_fields` ieraksti.<br> [ZBXNEXT-2020](https://support.zabbix.com/browse/ZBXNEXT-2020) Pievienoti jauni rekvizīti `lifetime_type`, `enabled_lifetime` un `enabled_lifetime_type`.<br> [ZBXNEXT-2020](https://support.zabbix.com/browse/ZBXNEXT-2020) Mainīta parametra `lifetime` noklusējuma vērtība no `30d` uz `7d`.<br> [ZBX-21850](https://support.zabbix.com/browse/ZBX-21850) `discoveryrule.get`: Filtra nosacījumi tiks sakārtoti atbilstoši to izvietojumam formulā. ##### Discovery Zabbix can use low-level discovery rules (for example, *vmware.hv.discovery\[{$VMWARE.URL}\]*) to automatically discover VMware hypervisors and virtual machines. Moreover, Zabbix can use host prototypes to automatically generate real hosts for the discovered entities. For more information, see [*Host prototypes*](/manual/discovery/low_level_discovery/host_prototypes). ##### Atklāšana Zabbix var izmantot zema līmeņa atklāšanas noteikumus (piemēram, *vmware.hv.discovery\[{$VMWARE.URL}\]*) , lai automātiski atklātu VMware hipervizorus un virtuālās mašīnas. Turklāt Zabbix var izmantot hostu prototipus, lai automātiski ģenerētu reālus hostus atklātajām entītijām. Plašāku informāciju skatiet [*Hostu prototipi*](/manual/discovery/low_level_discovery/host_prototypes). #### Discovery Zabbix periodically scans the IP ranges defined in [network discovery rules](/manual/discovery/network_discovery/rule). The frequency of the check is configurable for each rule individually. Each rule has a set of service checks defined to be performed for the IP range. Discovery rules are processed by the discovery manager. The discovery manager creates a job per each rule with a list of tasks (network checks). Network checks are performed in parallel by the available discovery workers (the number is configurable in the frontend per each rule). The exception is SNMPv3 checks, which are processed by a single worker. Only checks with the same IP and port are scheduled sequentially because some devices will not accept parallel connections on the same port. The queue size of network checks is limited to 2000000 or 4 GB of memory approximately. If the queue becomes full then the discovery rule will be skipped and a warning message will be printed in the log. You may use the `zabbix[discovery_queue]` internal item to monitor the number of discovery checks in the queue. Discovery checks are processed independently from the other checks. If any checks do not find a service (or fail), other checks will still be processed. ::: noteclassic If a discovery rule is changed during execution, then the current discovery execution will be aborted. ::: Every check of a service and a host (IP) performed by the network discovery module generates a discovery event. |Event|Check of service result| |--|--------| |*Service Discovered*|The service is 'up' after it was 'down' or when discovered for the first time.| |*Service Up*|The service is 'up', after it was already 'up'.| |*Service Lost*|The service is 'down' after it was 'up'.| |*Service Down*|The service is 'down', after it was already 'down'.| |*Host Discovered*|At least one service of a host is 'up' after all services of that host were 'down' or a service is discovered which belongs to a not registered host.| |*Host Up*|At least one service of a host is 'up', after at least one service was already 'up'.| |*Host Lost*|All services of a host are 'down' after at least one was 'up'.| |*Host Down*|All services of a host are 'down', after they were already 'down'.| #### Atklāšana Zabbix periodiski skenē IP diapazonus, kas definēti [tīkla atklāšanas noteikumos](/manual/discovery/network_discovery/rule). Pārbaudes biežumu var konfigurēt katram noteikumam atsevišķi. Katram noteikumam ir definēts pakalpojumu pārbaužu kopums, kas jāveic IP diapazonam. Atklāšanas noteikumus apstrādā atklāšanas pārvaldnieks. Atklāšanas pārvaldnieks izveido darbu katram noteikumam ar uzdevumu sarakstu (tīkla pārbaudēm). Tīkla pārbaudes paralēli veic pieejamie atklāšanas darbinieki (to skaits ir konfigurējams lietotāja saskarnē katram noteikumam atsevišķi). Izņēmums ir SNMPv3 pārbaudes, kuras apstrādā viens darbinieks. Secīgi tiek ieplānotas tikai pārbaudes ar vienādu IP un portu, jo dažas ierīces nepieņem paralēlus savienojumus uz viena un tā paša porta. Tīkla pārbaužu rindas izmērs ir ierobežots līdz 2000000 vai aptuveni 4 GB atmiņas. Ja rinda kļūst pilna, atklāšanas noteikums tiks izlaists, un žurnālā tiks ierakstīts brīdinājuma ziņojums. Varat izmantot iekšējo vienumu `zabbix[discovery_queue]`, lai uzraudzītu atklāšanas pārbaužu skaitu rindā. Atklāšanas pārbaudes tiek apstrādātas neatkarīgi no citām pārbaudēm. Ja kāda pārbaude neatrod pakalpojumu (vai neizdodas), pārējās pārbaudes joprojām tiks apstrādātas. ::: noteclassic Ja atklāšanas noteikums izpildes laikā tiek mainīts, pašreizējā atklāšanas izpilde tiks pārtraukta. ::: Katras pakalpojuma un hosts (IP) pārbaudes, ko veic tīkla atklāšanas modulis, ģenerē atklāšanas notikumu. |Notikums|Pakalpojuma pārbaudes rezultāts| |--|--------| |*Pakalpojums atklāts*|Pakalpojums ir 'up' pēc tam, kad tas bija 'down', vai arī tiek atklāts pirmo reizi.| |*Pakalpojums ir pieejams*|Pakalpojums ir 'up', pēc tam, kad tas jau bija 'up'.| |*Pakalpojums zaudēts*|Pakalpojums ir 'down' pēc tam, kad tas bija 'up'.| |*Pakalpojums nav pieejams*|Pakalpojums ir 'down', pēc tam, kad tas jau bija 'down'.| |*Hosts atklāts*|Vismaz viens hosts pakalpojums ir 'up' pēc tam, kad visi šī hosts pakalpojumi bija 'down', vai arī tiek atklāts pakalpojums, kas pieder nereģistrētam hostam.| |*Hosts ir pieejams*|Vismaz viens hosts pakalpojums ir 'up', pēc tam, kad vismaz viens pakalpojums jau bija 'up'.| |*Hosts zaudēts*|Visi hosts pakalpojumi ir 'down' pēc tam, kad vismaz viens bija 'up'.| |*Hosts nav pieejams*|Visi hosts pakalpojumi ir 'down', pēc tam, kad tie jau bija 'down'.| #### Display #### Attēlošana #### Display Based on acknowledgment information it is possible to configure how the problem count is displayed in the dashboard or maps. To do that, you have to make selections in the *Problem display* option, available in both [map configuration](/manual/config/visualization/maps/map#creating-a-map) and the *Problems by severity* [dashboard widget](/manual/web_interface/frontend_sections/dashboards##adding-widgets). It is possible to display all problem count, unacknowledged problem count as separated from the total or unacknowledged problem count only. Based on problem update information (acknowledgment, etc.), it is possible to configure update operations - send a message or execute remote commands. #### Attēlošana Pamatojoties uz apstiprinājuma informāciju, ir iespējams konfigurēt, kā problēmu skaits tiek attēlots informācijas panelī vai kartēs. Lai to izdarītu, jāveic izvēles opcijā *Problem display*, kas ir pieejama gan [kartes konfigurācijā](/manual/config/visualization/maps/map#creating-a-map), gan [informācijas paneļa logrīkā](/manual/web_interface/frontend_sections/dashboards##adding-widgets) *Problems by severity*. Ir iespējams attēlot kopējo problēmu skaitu, neapstiprināto problēmu skaitu atsevišķi no kopējā skaita vai tikai neapstiprināto problēmu skaitu. Pamatojoties uz problēmas atjaunināšanas informāciju (apstiprinājums u.c.), ir iespējams konfigurēt atjaunināšanas darbības — nosūtīt ziņojumu vai izpildīt attālinātās komandas. #### Displaying data Once data is sent, you can navigate to *Monitoring* → [*Latest data*](/manual/web_interface/frontend_sections/monitoring/latest_data) to see the result: {width="600"} ::: noteclassic If a single numeric value is sent, the data [graph](/manual/config/visualization/graphs/simple) will show a horizontal line to the left and right of the value's time point. ::: #### Datu attēlošana Kad dati ir nosūtīti, varat pāriet uz *Monitoring* → [*Latest data*](/manual/web_interface/frontend_sections/monitoring/latest_data), lai redzētu rezultātu: {width="600"} ::: noteclassic Ja tiek nosūtīta viena skaitliska vērtība, datu [grafiks](/manual/config/visualization/graphs/simple) rādīs horizontālu līniju pa kreisi un pa labi no vērtības laika punkta. ::: ##### Displaying hosts in maintenance An orange wrench icon  next to the host name indicates that this host is in maintenance in: - *Dashboards* - *Monitoring > Problems* - *Inventory > Hosts > Host inventory details* - *Data collection > Hosts* (See 'Status' column)  Maintenance details are displayed when the mouse pointer is positioned over the icon. Additionally, hosts in maintenance get an orange background in *Monitoring > Maps*. ##### Hostu attēlošana uzturēšanas režīmā Oranža uzgriežņu atslēgas ikona  blakus hosta nosaukumam norāda, ka šis hosts atrodas uzturēšanas režīmā šeit: - *Paneļi* - *Uzraudzība > Problēmas* - *Inventārs > Hosti > Hosta inventāra informācija* - *Datu ievākšana > Hosti* (skatiet kolonnu 'Statuss')  Informācija par uzturēšanu tiek parādīta, kad peles rādītājs tiek novietots virs ikonas. Papildus tam hosti uzturēšanas režīmā tiek attēloti ar oranžu fonu sadaļā *Uzraudzība > Kartes*. #### Displaying options The **Displaying options** tab allows to define history data selection and visualization options for the pie chart: {width="600"} | | | | | |-|-|----------|----------------------------------------| |*History data selection*|<|<|Select the data source:<br>**Auto** - data are sourced according to the classic [algorithm](/manual/config/visualization/graphs/simple#generating-from-historytrends) (default);<br>**History** - data from history;<br>**Trends** - data from trends.| |*Draw*|<|<|Select the visualization style of the pie chart:<br>**Pie** - a full pie (sectors take up 100% of the radius);<br>**Doughnut** - a pie with empty circle in the middle (sectors use up to 50% of radius).| |*Space between sectors*|<|<|Select the space size (in units of 0-10) between sectors (default is "1").| |*Merge sectors smaller than N%*|<|<|Mark the checkbox to merge sectors smaller than the N%.<br>If enabled, select the color for the merged sectors and the percentage threshold (N) for merging small sectors.| |*Draw style: **Doughnut*** |<|<|<| | |*Width*|<|Select the doughnut width: 20, 30, 40 or 50% (default) of the radius.| |^|*Stroke width*|<|Select the width of the doughnut sector border (0-10).<br>Supported since Zabbix 7.0.1.| |^|*Show total value*|<|Mark the checkbox to show the total value in the middle of the doughnut chart.| |^| |*Size*|Select the size option for the total value:<br>**Auto** - the text is sized automatically to fit the doughnut middle readably;<br>**Custom** - specify the text size as height percentage from the total widget height.| |^|^|*Decimal places*|Specify the number of decimal places for the total value (0-6).| |^|^|*Units*|Specify the units for the total value.| |^|^|*Bold*|Mark the checkbox to display the total value in bold.| |^|^|*Color*|Select the color for the total value.| #### Attēlošanas opcijas Cilne **Attēlošanas opcijas** ļauj definēt vēstures datu atlases un vizualizācijas opcijas sektoru diagrammai: {width="600"} | | | | | |-|-|----------|----------------------------------------| |*Vēstures datu atlase*|<|<|Atlasiet datu avotu:<br>**Auto** - dati tiek iegūti atbilstoši klasiskajam [algoritmam](/manual/config/visualization/graphs/simple#generating-from-historytrends) (noklusējums);<br>**History** - dati no vēstures;<br>**Trends** - dati no tendencēm.| |*Zīmēt*|<|<|Atlasiet sektoru diagrammas vizualizācijas stilu:<br>**Pie** - pilns pīrāgs (sektori aizņem 100% no rādiusa);<br>**Doughnut** - pīrāgs ar tukšu apli vidū (sektori aizņem līdz 50% no rādiusa).| |*Atstarpe starp sektoriem*|<|<|Atlasiet atstarpes lielumu (0-10 vienībās) starp sektoriem (noklusējums ir "1").| |*Apvienot sektorus, kas mazāki par N%*|<|<|Atzīmējiet izvēles rūtiņu, lai apvienotu sektorus, kas ir mazāki par N%.<br>Ja šī opcija ir iespējota, atlasiet krāsu apvienotajiem sektoriem un procentu slieksni (N) mazo sektoru apvienošanai.| |*Zīmēšanas stils: **Doughnut*** |<|<|<| | |*Platums*|<|Atlasiet doughnut platumu: 20, 30, 40 vai 50% (noklusējums) no rādiusa.| |^|*Līnijas platums*|<|Atlasiet doughnut sektora apmales platumu (0-10).<br>Atbalstīts kopš Zabbix 7.0.1.| |^|*Rādīt kopējo vērtību*|<|Atzīmējiet izvēles rūtiņu, lai doughnut diagrammas vidū rādītu kopējo vērtību.| |^| |*Izmērs*|Atlasiet kopējās vērtības izmēra opciju:<br>**Auto** - teksta izmērs tiek automātiski pielāgots, lai tas lasāmi ietilptu doughnut vidū;<br>**Custom** - norādiet teksta izmēru kā augstuma procentu no visa logrīka augstuma.| |^|^|*Decimāldaļas*|Norādiet kopējās vērtības decimāldaļu skaitu (0-6).| |^|^|*Vienības*|Norādiet kopējās vērtības vienības.| |^|^|*Treknraksts*|Atzīmējiet izvēles rūtiņu, lai kopējo vērtību rādītu treknrakstā.| |^|^|*Krāsa*|Atlasiet kopējās vērtības krāsu.| #### Displaying options The **Displaying options** tab allows to define history data selection:  | | | |--|--------| |*History data selection*|Set the source of graph data:<br>**Auto** - data are sourced according to the classic graph [algorithm](/manual/config/visualization/graphs/simple#generating-from-historytrends) (default);<br>**History** - data from history;<br>**Trends** - data from trends.| |*Simple triggers*|Mark the checkbox to show the trigger thresholds for simple triggers. The thresholds will be drawn as dashed lines using the trigger severity color.<br>A simple trigger is a trigger with one function (only `last`, `max`, `min`, `avg`) for one item in the expression.<br>A maximum of three triggers can be drawn. Note that the trigger has to be within the drawn range to be visible.| |*Working time*|Mark the checkbox to show working time on the graph. Working time (working days) is displayed in graphs as a white background, while non-working time is displayed in gray (with the *Original blue* default frontend theme).| |*Percentile line (left)*|Mark the checkbox and enter the percentile value to show the specified percentile as a line on the left Y-axis of the graph.<br>If, for example, a 95% percentile is set, then the percentile line will be at the level where 95 percent of the values fall under.| |*Percentile line (right)*|Mark the checkbox and enter the percentile value to show the specified percentile as a line on the right Y-axis of the graph.<br>If, for example, a 95% percentile is set, then the percentile line will be at the level where 95 percent of the values fall under.| #### Parādīšanas opcijas Cilne **Parādīšanas opcijas** ļauj definēt vēstures datu atlasi:  | | | |--|--------| |*Vēstures datu atlase*|Iestatiet grafika datu avotu:<br>**Auto** - dati tiek iegūti atbilstoši klasiskā grafika [algoritmam](/manual/config/visualization/graphs/simple#generating-from-historytrends) (noklusējums);<br>**History** - dati no vēstures;<br>**Trends** - dati no tendencēm.| |*Vienkāršie trigeri*|Atzīmējiet izvēles rūtiņu, lai parādītu vienkāršo trigeru sliekšņus. Sliekšņi tiks attēloti kā pārtrauktas līnijas, izmantojot trigera nopietnības krāsu.<br>Vienkāršs trigeris ir trigeris ar vienu funkciju (tikai `last`, `max`, `min`, `avg`) vienam vienumam izteiksmē.<br>Var attēlot ne vairāk kā trīs trigerus. Ņemiet vērā, ka trigerim jāatrodas attēlotajā diapazonā, lai tas būtu redzams.| |*Darba laiks*|Atzīmējiet izvēles rūtiņu, lai grafikā parādītu darba laiku. Darba laiks (darba dienas) grafikos tiek attēlots ar baltu fonu, savukārt nedarba laiks tiek attēlots pelēkā krāsā (ar noklusējuma lietotāja saskarnes motīvu *Original blue*).| |*Percentiles līnija (pa kreisi)*|Atzīmējiet izvēles rūtiņu un ievadiet percentile vērtību, lai norādīto percentile parādītu kā līniju grafika kreisajā Y asī.<br>Piemēram, ja ir iestatīts 95% percentile, percentile līnija atradīsies līmenī, zem kura ir 95 procenti vērtību.| |*Percentiles līnija (pa labi)*|Atzīmējiet izvēles rūtiņu un ievadiet percentile vērtību, lai norādīto percentile parādītu kā līniju grafika labajā Y asī.<br>Piemēram, ja ir iestatīts 95% percentile, percentile līnija atradīsies līmenī, zem kura ir 95 procenti vērtību.| #### Displaying options The following parameters are supported for configuring *Displaying options*. |Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-|--------|--|--------|-------------------------------| |*History data selection*|<|0|source|0 - *(default)* Auto;<br>1 - History;<br>2 - Trends.| |*Draw*|<|0|draw_type|0 - *(default)* Pie;<br>1 - Doughnut.| |<|*Width*|0|width|20 - 20% of the radius;<br>30 - 30% of the radius;<br>40 - 40% of the radius;<br>50 - *(default)* 50% of the radius.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Draw* is set to "Doughnut"| |^|*Stroke width*|0|stroke|Possible values range from 0-10.<br><br>Default: 0.<br><br>This parameter is supported since Zabbix 7.0.1.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Draw* is set to "Doughnut"| |^|*Show total value*|0|total_show|0 - *(default)* Disabled;<br>1 - Enabled.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Draw* is set to "Doughnut"| |^|*Size*|0|value_size_type|0 - *(default)* Auto;<br>1 - Custom.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Show total value* is set to "Enabled"| |^|*Size* (value for custom size)|0|value_size|Possible values range from 1-100.<br><br>Default: 20.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Show total value* is set to "Enabled"| |^|*Decimal places*|0|decimal_places|Possible values range from 0-6.<br><br>Default: 2.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Show total value* is set to "Enabled"| |^|*Units* (checkbox)|0|units_show|0 - *(default)* Disabled;<br>1 - Enabled.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Show total value* is set to "Enabled"| |^|*Units* (value)|1|units|Any string value.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Units* (checkbox) is set to "Enabled"| |^|*Bold*|0|value_bold|0 - *(default)* Disabled;<br>1 - Enabled.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Show total value* is set to "Enabled"| |^|*Color*|1|value_color|Hexadecimal color code (e.g. `FF0000`).<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Show total value* is set to "Enabled"| |*Space between sectors*|<|0|space|Possible values range from 0-10.<br><br>Default: 1.| |*Merge sectors smaller than N%* (checkbox)|<|0|merge|0 - *(default)* Disabled;<br>1 - Enabled.| |*Merge sectors smaller than N%* (value)|<|0|merge_percent|Possible values range from 1-10.<br><br>Default: 1.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Merge sectors smaller than N%* (checkbox) is set to "Enabled"| |*Merge sectors smaller than N%* (color)|<|1|merge_color|Hexadecimal color code (e.g. `FF0000`).<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Merge sectors smaller than N%* (checkbox) is set to "Enabled"| #### Attēlošanas opcijas Tālāk norādītie parametri tiek atbalstīti *Attēlošanas opciju* konfigurēšanai. |Parametrs|<|[tips](/manual/api/reference/dashboard/object#dashboard-widget-field)|nosaukums|vērtība| |-|--------|--|--------|-------------------------------| |*Vēstures datu atlase*|<|0|source|0 - *(noklusējums)* Automātiski;<br>1 - Vēsture;<br>2 - Tendences.| |*Zīmēt*|<|0|draw_type|0 - *(noklusējums)* Pīrāgs;<br>1 - Donuts.| |<|*Platums*|0|width|20 - 20% no rādiusa;<br>30 - 30% no rādiusa;<br>40 - 40% no rādiusa;<br>50 - *(noklusējums)* 50% no rādiusa.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja *Zīmēt* ir iestatīts uz "Donuts"| |^|*Līnijas platums*|0|stroke|Iespējamās vērtības ir diapazonā no 0-10.<br><br>Noklusējums: 0.<br><br>Šis parametrs tiek atbalstīts kopš Zabbix 7.0.1.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja *Zīmēt* ir iestatīts uz "Donuts"| |^|*Rādīt kopējo vērtību*|0|total_show|0 - *(noklusējums)* Atspējots;<br>1 - Iespējots.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja *Zīmēt* ir iestatīts uz "Donuts"| |^|*Izmērs*|0|value_size_type|0 - *(noklusējums)* Automātiski;<br>1 - Pielāgots.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja *Rādīt kopējo vērtību* ir iestatīts uz "Iespējots"| |^|*Izmērs* (pielāgota izmēra vērtība)|0|value_size|Iespējamās vērtības ir diapazonā no 1-100.<br><br>Noklusējums: 20.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja *Rādīt kopējo vērtību* ir iestatīts uz "Iespējots"| |^|*Decimāldaļas*|0|decimal_places|Iespējamās vērtības ir diapazonā no 0-6.<br><br>Noklusējums: 2.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja *Rādīt kopējo vērtību* ir iestatīts uz "Iespējots"| |^|*Vienības* (atzīme)|0|units_show|0 - *(noklusējums)* Atspējots;<br>1 - Iespējots.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja *Rādīt kopējo vērtību* ir iestatīts uz "Iespējots"| |^|*Vienības* (vērtība)|1|units|Jebkura virknes vērtība.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja *Vienības* (atzīme) ir iestatīts uz "Iespējots"| |^|*Treknraksts*|0|value_bold|0 - *(noklusējums)* Atspējots;<br>1 - Iespējots.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja *Rādīt kopējo vērtību* ir iestatīts uz "Iespējots"| |^|*Krāsa*|1|value_color|Heksadecimāls krāsas kods (piem., `FF0000`).<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja *Rādīt kopējo vērtību* ir iestatīts uz "Iespējots"| |*Atstarpe starp sektoriem*|<|0|space|Iespējamās vērtības ir diapazonā no 0-10.<br><br>Noklusējums: 1.| |*Apvienot sektorus, kas mazāki par N%* (atzīme)|<|0|merge|0 - *(noklusējums)* Atspējots;<br>1 - Iespējots.| |*Apvienot sektorus, kas mazāki par N%* (vērtība)|<|0|merge_percent|Iespējamās vērtības ir diapazonā no 1-10.<br><br>Noklusējums: 1.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja *Apvienot sektorus, kas mazāki par N%* (atzīme) ir iestatīts uz "Iespējots"| |*Apvienot sektorus, kas mazāki par N%* (krāsa)|<|1|merge_color|Heksadecimāls krāsas kods (piem., `FF0000`).<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja *Apvienot sektorus, kas mazāki par N%* (atzīme) ir iestatīts uz "Iespējots"| ##### Displaying suppressed problems Normally problems for hosts in maintenance are suppressed, i.e. not displayed in the frontend. However, it is also possible to configure that suppressed problems are shown, by selecting the *Show suppressed problems* option in these locations: - *Dashboards* (in *Problem hosts*, *Problems*, *Problems by severity*, *Trigger overview* widget configuration) - *Monitoring* > *Problems* (in the filter) - *Monitoring* > *Maps* (in map configuration) - Global [notifications](/manual/web_interface/user_profile/global_notifications) (in user profile configuration) When suppressed problems are displayed, the following icon is displayed: . Rolling a mouse over the icon displays more details.  ##### Slēpto problēmu attēlošana Parasti problēmas hosts uzturēšanas režīmā tiek slēptas, t. i., tās netiek rādītas lietotāja saskarnē. Tomēr ir iespējams konfigurēt, lai slēptās problēmas tiktu rādītas, atlasot opciju *Rādīt slēptās problēmas* šādās vietās: - *Informācijas paneļi* (logrīku konfigurācijā *Problem hosts*, *Problems*, *Problems by severity*, *Trigger overview*) - *Monitoring* > *Problems* (filtrā) - *Monitoring* > *Maps* (kartes konfigurācijā) - Globālie [paziņojumi](/manual/web_interface/user_profile/global_notifications) (lietotāja profila konfigurācijā) Kad slēptās problēmas tiek rādītas, tiek attēlota šāda ikona: . Pārvietojot peles kursoru virs ikonas, tiek parādīta papildu informācija.  #### Display In *Monitoring → Maps* the respective color will be displayed on the link if the trigger goes into a problem state.  ::: noteclassic If multiple triggers go into a problem state, the problem with the highest severity will determine the link style and color. If multiple triggers with the same severity are assigned to the same map link, the one with the lowest ID takes precedence. Note also that: 1. *Minimum trigger severity* and *Show suppressed problem* settings from map configuration affect which problems are taken into account. 2. In the case of triggers with multiple problems (multiple problem generation), each problem may have a severity that differs from trigger severity (changed manually), may have different tags (due to macros), and may be suppressed. ::: #### Attēlošana Sadaļā *Monitoring → Maps* attiecīgā krāsa tiks attēlota uz saites, ja trigeris nonāks problēmas stāvoklī.  ::: noteclassic Ja vairāki trigeri nonāk problēmas stāvoklī, saites stilu un krāsu noteiks problēma ar visaugstāko nopietnību. Ja vienai un tai pašai kartes saitei ir piešķirti vairāki trigeri ar vienādu nopietnību, priekšroka tiek dota tam, kuram ir zemākais ID. Ņemiet vērā arī to, ka: 1. Kartes konfigurācijas iestatījumi *Minimum trigger severity* un *Show suppressed problem* ietekmē to, kuri problēmu gadījumi tiek ņemti vērā. 2. Trigeriem ar vairākām problēmām (multiple problem generation) katrai problēmai var būt atšķirīga nopietnība nekā trigerim (manuāli mainīta), var būt atšķirīgi tagi (makro dēļ) un tā var būt apspiesta. ::: ##### Display In the item list dependent items are displayed with their master item name as prefix. {width="600"} If a master item is deleted, so are all its dependent items. ##### Attēlojums Vienumu sarakstā atkarīgie vienumi tiek attēloti ar to galvenā vienuma nosaukumu kā prefiksu. {width="600"} Ja galvenais vienums tiek dzēsts, tiek dzēsti arī visi no tā atkarīgie vienumi. #### Display Once suppressed the problem is marked by a blinking  suppression icon in the *Info* column, before being hidden. The suppression icon is blinking while the suppression task is in the waiting list. Once the task manager has suppressed the problem, the icon will stop blinking. If the suppression icon keeps blinking for a long time, this may indicate a server problem, for example, if the server is down and the task manager cannot complete the task. The same logic applies to unsuppression. In the short period after the task is submitted and the server has not completed it, the unsuppression icon is blinking. A suppressed problem may be both hidden or shown, depending on the problem filter/widget settings. When shown in the problem list, a suppressed problem is marked by the suppression icon and suppression details are shown on mouseover:  Suppression details are also displayed in a popup when positioning the mouse on the suppression icon in the *Actions* column. #### Attēlošana Pēc apspiešanas problēma tiek atzīmēta ar mirgojošu  apspiešanas ikonu kolonnā *Info*, pirms tā tiek paslēpta. Apspiešanas ikona mirgo, kamēr apspiešanas uzdevums atrodas gaidīšanas sarakstā. Kad uzdevumu pārvaldnieks ir apspiedis problēmu, ikona pārstās mirgot. Ja apspiešanas ikona turpina mirgot ilgu laiku, tas var norādīt uz servera problēmu, piemēram, ja serveris nedarbojas un uzdevumu pārvaldnieks nevar pabeigt uzdevumu. Tāda pati loģika attiecas arī uz apspiešanas atcelšanu. Īsajā periodā pēc uzdevuma iesniegšanas, kamēr serveris to vēl nav pabeidzis, apspiešanas atcelšanas ikona mirgo. Apspiesta problēma var būt gan paslēpta, gan parādīta atkarībā no problēmu filtra/logrīka iestatījumiem. Ja apspiesta problēma tiek rādīta problēmu sarakstā, tā tiek atzīmēta ar apspiešanas ikonu, un, novietojot peles kursoru virs tās, tiek parādīta informācija par apspiešanu:  Informācija par apspiešanu tiek parādīta arī uznirstošajā logā, novietojot peles kursoru uz apspiešanas ikonas kolonnā *Actions*. #### Display options The following parameters are supported for configuring *Display options*. |Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-|--------|--|--------|-------------------------------| |*History data selection*|<|0|source|0 - *(default)* Auto;<br>1 - History;<br>2 - Trends.| |*Simple triggers*|<|0|simple_triggers|0 - *(default)* Disabled;<br>1 - Enabled.| |*Working time*|<|0|working_time|0 - *(default)* Disabled;<br>1 - Enabled.| |*Percentile line (left)*|<|<|<|<| |<|*Status*|0|percentile_left|0 - *(default)* Disabled;<br>1 - Enabled.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Y-axis* (in [*Data set*](#data-set) configuration) is set to "Left"| |^|*Value*|0|percentile_left_value|Possible values range from 1-100.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Y-axis* (in [*Data set*](#data-set) configuration) is set to "Left"| |*Percentile line (right)*|<|<|<|<| |<|*Status*|0|percentile_right|0 - *(default)* Disabled;<br>1 - Enabled.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Y-axis* (in [*Data set*](#data-set) configuration) is set to "Right"| |^|*Value*|0|percentile_right_value|Possible values range from 1-100.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Y-axis* (in [*Data set*](#data-set) configuration) is set to "Right"| #### Attēlošanas opcijas Tālāk norādītie parametri tiek atbalstīti *Attēlošanas opciju* konfigurēšanai. |Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-|--------|--|--------|-------------------------------| |*Vēstures datu atlase*|<|0|source|0 - *(noklusējums)* Automātiski;<br>1 - Vēsture;<br>2 - Tendences.| |*Vienkāršie trigeri*|<|0|simple_triggers|0 - *(noklusējums)* Atspējots;<br>1 - Iespējots.| |*Darba laiks*|<|0|working_time|0 - *(noklusējums)* Atspējots;<br>1 - Iespējots.| |*Procentiles līnija (kreisā)*|<|<|<|<| |<|*Statuss*|0|percentile_left|0 - *(noklusējums)* Atspējots;<br>1 - Iespējots.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja *Y-ass* ([*Datu kopas*](#data-set) konfigurācijā) ir iestatīta uz "Kreisā"| |^|*Vērtība*|0|percentile_left_value|Iespējamās vērtības ir diapazonā no 1 līdz 100.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja *Y-ass* ([*Datu kopas*](#data-set) konfigurācijā) ir iestatīta uz "Kreisā"| |*Procentiles līnija (labā)*|<|<|<|<| |<|*Statuss*|0|percentile_right|0 - *(noklusējums)* Atspējots;<br>1 - Iespējots.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja *Y-ass* ([*Datu kopas*](#data-set) konfigurācijā) ir iestatīta uz "Labā"| |^|*Vērtība*|0|percentile_right_value|Iespējamās vērtības ir diapazonā no 1 līdz 100.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *atbalstīts*, ja *Y-ass* ([*Datu kopas*](#data-set) konfigurācijā) ir iestatīta uz "Labā"| #### Display Symptom problems are displayed below the cause problem and marked accordingly in *Monitoring* -> *Problems* (and the *Problems* dashboard widget) - with an icon, smaller font and different background.  In collapsed view, only the cause problem is seen; the existence of symptom problems is indicated by the number in the beginning of the line and the icon for expanding the view.  It is also possible to additionally display symptom problems in normal font and in their own line. For that select *Show symptoms* in the filter settings or the widget configuration. #### Attēlošana Simptomu problēmas tiek attēlotas zem cēloņa problēmas un attiecīgi atzīmētas sadaļā *Monitoring* -> *Problems* (un paneļa logrīkā *Problems*) — ar ikonu, mazāku fontu un atšķirīgu fonu.  Sakļautajā skatā ir redzama tikai cēloņa problēma; par simptomu problēmu esamību norāda skaitlis rindas sākumā un ikona skata izvēršanai.  Ir iespējams arī papildus attēlot simptomu problēmas parastā fontā un atsevišķā rindā. Lai to izdarītu, filtra iestatījumos vai logrīka konfigurācijā atlasiet *Show symptoms*. #### Display To view web scenarios configured for a host, go to *Monitoring → Hosts*, locate the host in the list and click on the *Web* hyperlink in the last column. Click on the scenario name to get detailed information. {width="600"} An overview of web scenarios can also be displayed in *Dashboards* by the Web monitoring widget. Recent results of the web scenario execution are available in the *Monitoring → Latest data* section. #### Attēlošana Lai skatītu hostam konfigurētos tīmekļa scenārijus, dodieties uz *Monitoring → Hosts*, atrodiet hostu sarakstā un pēdējā kolonnā noklikšķiniet uz *Web* hipersaites. Noklikšķiniet uz scenārija nosaukuma, lai iegūtu detalizētu informāciju. {width="600"} Tīmekļa scenāriju pārskatu var arī attēlot *Dashboards* sadaļā, izmantojot tīmekļa monitoringa logrīku. Pēdējie tīmekļa scenārija izpildes rezultāti ir pieejami sadaļā *Monitoring → Latest data*. #### Display Users will see the following screen when trying to access Zabbix frontend while in maintenance mode. The screen is refreshed every 30 seconds in order to return to a normal state without user intervention when the maintenance is over.  IP addresses defined in *ZBX\_GUI\_ACCESS\_IP\_RANGE* will be able to access the frontend as usual. #### Attēlošana Lietotāji redzēs šādu ekrānu, mēģinot piekļūt Zabbix lietotāja saskarnei uzturēšanas režīmā. Ekrāns tiek atsvaidzināts ik pēc 30 sekundēm, lai pēc uzturēšanas beigām bez lietotāja iejaukšanās atgrieztos normālā stāvoklī.  IP adreses, kas definētas *ZBX\_GUI\_ACCESS\_IP\_RANGE*, varēs piekļūt lietotāja saskarnei kā parasti. #### DNS service performance The [net.dns.perf](/manual/config/items/itemtypes/zabbix_agent/#net.dns.perf) item now returns a response time instead of `0` when the DNS server responds with an error code (for example, `NXDOMAIN` or `SERVFAIL`). #### DNS pakalpojuma veiktspēja Vienums [net.dns.perf](/manual/config/items/itemtypes/zabbix_agent/#net.dns.perf) tagad atgriež atbildes laiku, nevis `0`, kad DNS serveris atbild ar kļūdas kodu (piemēram, `NXDOMAIN` vai `SERVFAIL`). #### DNS service performance The [net.dns.perf](/manual/config/items/itemtypes/zabbix_agent/#net.dns.perf) item now returns a response time instead of `0` when the DNS server responds with an error code (for example, `NXDOMAIN` or `SERVFAIL`). #### DNS pakalpojuma veiktspēja Vienums [net.dns.perf](/manual/config/items/itemtypes/zabbix_agent/#net.dns.perf) tagad atgriež atbildes laiku, nevis `0`, ja DNS serveris atbild ar kļūdas kodu (piemēram, `NXDOMAIN` vai `SERVFAIL`). ### Docker Compose Docker Compose is the quickest way to deploy Zabbix. It reads a configuration file (Compose file) and handles the entire setup—pulling Docker images, creating an internal network between containers, setting up storage, initializing the database, and starting everything in the correct order. The [official Zabbix Dockerfiles](https://github.com/zabbix/zabbix-docker) repository provides ready-to-use Docker Compose files and an `.env`-based configuration system supporting different operating systems, database backends, and Zabbix component configuration. 1\. Clone the repository, navigate to it, and switch to version 7.0: ```bash git clone https://github.com/zabbix/zabbix-docker.git cd zabbix-docker git checkout 7.0 ``` 2\. (Optional) Customize the deployment with [environment variables](#environment-variables). This step can be skipped for a default setup. 3\. Deploy the default setup—Zabbix server, web interface (running on Nginx), and a database backend (MySQL or PostgreSQL), each running in its own container on Alpine Linux. ```bash # With MySQL as the database: docker compose -f ./compose.yaml up -d # With PostgreSQL as the database: docker compose -f ./compose_pgsql.yaml up -d ``` After the containers are up and running (typically within 1–3 minutes), the Zabbix server starts and the web interface becomes available for [login](/manual/quickstart/basic_config/login#login). ::: noteclassic Use `docker compose ps` to check container status. All containers (except the `zabbix-docker-server-db-init-1` container) should have the `Up` status. If any show `Exited`, check their logs for errors with `docker logs -f <container-name>`. ::: ### Docker Compose Docker Compose ir ātrākais veids, kā izvietot Zabbix. Tas nolasa konfigurācijas failu (Compose failu) un apstrādā visu iestatīšanu — Docker attēlu lejupielādi, iekšējā tīkla izveidi starp konteineriem, krātuves iestatīšanu, datubāzes inicializēšanu un visa palaišanu pareizajā secībā. [Oficiālais Zabbix Dockerfiles](https://github.com/zabbix/zabbix-docker) repozitorijs nodrošina gatavus Docker Compose failus un uz `.env` balstītu konfigurācijas sistēmu, kas atbalsta dažādas operētājsistēmas, datubāzu aizmugursistēmas un Zabbix komponentu konfigurāciju. 1\. Klonējiet repozitoriju, pārejiet uz to un pārslēdzieties uz 7.0 versiju: ```bash git clone https://github.com/zabbix/zabbix-docker.git cd zabbix-docker git checkout 7.0 ``` 2\. (Neobligāti) Pielāgojiet izvietošanu ar [vides mainīgajiem](#environment-variables). Šo soli var izlaist noklusējuma iestatījumam. 3\. Izvietojiet noklusējuma iestatījumu — Zabbix serveris, lietotāja saskarne (darbojas uz Nginx) un datubāzes aizmugursistēma (MySQL vai PostgreSQL), katrs savā konteinerā uz Alpine Linux. ```bash # Ar MySQL kā datubāzi: docker compose -f ./compose.yaml up -d # Ar PostgreSQL kā datubāzi: docker compose -f ./compose_pgsql.yaml up -d ``` Kad konteineri ir palaisti un darbojas (parasti 1–3 minūšu laikā), Zabbix serveris tiek startēts un lietotāja saskarne kļūst pieejama [pieteikšanās](/manual/quickstart/basic_config/login#login) veikšanai. ::: noteclassic Izmantojiet `docker compose ps`, lai pārbaudītu konteineru statusu. Visiem konteineriem (izņemot `zabbix-docker-server-db-init-1` konteineru) jābūt statusam `Up`. Ja kādam ir statuss `Exited`, pārbaudiet to žurnālus, lai atrastu kļūdas, izmantojot `docker logs -f <container-name>`. ::: ### Docker Compose file upgrade These instructions upgrade the Docker Compose files used for deploying Zabbix components. Follow these instructions if you installed Zabbix using [Docker Compose](/manual/installation/containers#docker-compose). 1\. Check all containers to identify their names and current image versions: ```bash docker ps -a # CONTAINER ID IMAGE (...) NAMES # d095f486deef zabbix/zabbix-server-mysql:alpine-6.4-latest (...) zabbix-docker-zabbix-server-1 # 70627d833da0 zabbix/zabbix-web-nginx-mysql:alpine-6.4-latest (...) zabbix-docker-zabbix-web-nginx-mysql-1 # aaaa664cc185 zabbix/zabbix-server-mysql:alpine-6.4-latest (...) zabbix-docker-server-db-init-1 # 9ab3e77492ff mysql:8.0-oracle (...) zabbix-docker-mysql-server-1 ``` 2\. Navigate to the Zabbix Docker repository you previously cloned, pull the latest updates, and switch to the 7.0 branch: ::: noteimportant If you have modified `.env`, `compose.yaml`, or other files in your local repository, a `git pull` may overwrite them. Back up any local changes before running this step. ::: ```bash cd zabbix-docker git pull git checkout 7.0 ``` 3\. Deploy Zabbix components using the updated Docker Compose file: ```bash # With MySQL as the database: docker compose -f ./compose.yaml up -d # With PostgreSQL as the database: docker compose -f ./compose_pgsql.yaml up -d ``` ::: noteclassic After all containers are recreated and started, it may take 1—3 minutes before data collection resumes. For more information on running Zabbix containers, see [Docker Compose](/manual/installation/containers#docker-compose). ::: 4\. Verify that the upgrade was successful by checking the container logs (replace `zabbix-docker-zabbix-server-1` with the name of your component's container): ```bash docker logs -f zabbix-docker-zabbix-server-1 ``` ### Docker Compose faila jaunināšana Šīs instrukcijas atjaunina Docker Compose failus, kas tiek izmantoti Zabbix komponentu izvietošanai. Izpildiet šīs instrukcijas, ja Zabbix instalējāt, izmantojot [Docker Compose](/manual/installation/containers#docker-compose). 1\. Pārbaudiet visus konteinerus, lai noteiktu to nosaukumus un pašreizējās attēlu versijas: ```bash docker ps -a # CONTAINER ID IMAGE (...) NAMES # d095f486deef zabbix/zabbix-server-mysql:alpine-6.4-latest (...) zabbix-docker-zabbix-server-1 # 70627d833da0 zabbix/zabbix-web-nginx-mysql:alpine-6.4-latest (...) zabbix-docker-zabbix-web-nginx-mysql-1 # aaaa664cc185 zabbix/zabbix-server-mysql:alpine-6.4-latest (...) zabbix-docker-server-db-init-1 # 9ab3e77492ff mysql:8.0-oracle (...) zabbix-docker-mysql-server-1 ``` 2\. Pārejiet uz Zabbix Docker repozitoriju, ko iepriekš klonējāt, ielādējiet jaunākos atjauninājumus un pārslēdzieties uz 7.0 zaru: ::: noteimportant Ja savā lokālajā repozitorijā esat modificējis `.env`, `compose.yaml` vai citus failus, `git pull` var tos pārrakstīt. Pirms šīs darbības veikšanas izveidojiet vietējo izmaiņu rezerves kopiju. ::: ```bash cd zabbix-docker git pull git checkout 7.0 ``` 3\. Izvietojiet Zabbix komponentus, izmantojot atjaunināto Docker Compose failu: ```bash # Ar MySQL kā datubāzi: docker compose -f ./compose.yaml up -d # Ar PostgreSQL kā datubāzi: docker compose -f ./compose_pgsql.yaml up -d ``` ::: noteclassic Pēc tam, kad visi konteineri ir atkārtoti izveidoti un palaisti, var paiet 1—3 minūtes, līdz datu vākšana tiek atsākta. Papildinformāciju par Zabbix konteineru palaišanu skatiet sadaļā [Docker Compose](/manual/installation/containers#docker-compose). ::: 4\. Pārbaudiet, vai jaunināšana bija veiksmīga, apskatot konteineru žurnālus (aizstājiet `zabbix-docker-zabbix-server-1` ar sava komponenta konteinera nosaukumu): ```bash docker logs -f zabbix-docker-zabbix-server-1 ``` ##### docker.container_info[<ID>,<info>] {#docker.container.info} <br> Low-level information about a container.<br> Return value: The output of the [ContainerInspect](https://docs.docker.com/engine/api/v1.28/#operation/ContainerInspect) API call serialized as JSON. Parameters: - **ID** - the ID or name of the container;<br> - **info** - the amount of information returned. Supported values: *short* (default) or *full*. The Agent 2 user ('zabbix') must be added to the 'docker' [group](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) for sufficient privileges. Otherwise the check will fail. ##### docker.container_info[<ID>,<info>] {#docker.container.info} <br> Zema līmeņa informācija par konteineru.<br> Atgrieztā vērtība: [ContainerInspect](https://docs.docker.com/engine/api/v1.28/#operation/ContainerInspect) API izsaukuma izvade, serializēta kā JSON. Parametri: - **ID** - konteinera ID vai nosaukums;<br> - **info** - atgrieztās informācijas apjoms. Atbalstītās vērtības: *short* (noklusējums) vai *full*. Agent 2 lietotājs ('zabbix') ir jāpievieno 'docker' [grupai](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user), lai nodrošinātu pietiekamas privilēģijas. Pretējā gadījumā pārbaude neizdosies. ##### docker.containers.discovery[<options>] {#docker.containers.discovery} <br> Returns the list of containers. Used for [low-level discovery](/manual/discovery/low_level_discovery/).<br> Return value: *JSON object*. Parameter: - **options** - specify whether all or only running containers should be discovered. Supported values: *true* - return all containers; *false* - return only running containers (default). The Agent 2 user ('zabbix') must be added to the 'docker' [group](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) for sufficient privileges. Otherwise the check will fail. ##### docker.containers.discovery[<options>] {#docker.containers.discovery} <br> Atgriež konteineru sarakstu. Izmanto [zema līmeņa atklāšanai](/manual/discovery/low_level_discovery/).<br> Atgrieztā vērtība: *JSON objekts*. Parametrs: - **options** - norāda, vai jāatklāj visi konteineri vai tikai darbojošies konteineri. Atbalstītās vērtības: *true* - atgriezt visus konteinerus; *false* - atgriezt tikai darbojošos konteinerus (noklusējums). Lai nodrošinātu pietiekamas privilēģijas, Agent 2 lietotājs ('zabbix') jāpievieno 'docker' [grupai](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user). Pretējā gadījumā pārbaude neizdosies. ##### docker.containers {#docker.containers} <br> The list of containers.<br> Return value: The output of the [ContainerList](https://docs.docker.com/engine/api/v1.28/#operation/ContainerList) API call serialized as JSON. The Agent 2 user ('zabbix') must be added to the 'docker' [group](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) for sufficient privileges. Otherwise the check will fail. ##### docker.containers {#docker.containers} <br> Konteineru saraksts.<br> Atgrieztā vērtība: [ContainerList](https://docs.docker.com/engine/api/v1.28/#operation/ContainerList) API izsaukuma izvade, serializēta kā JSON. Agent 2 lietotājs ('zabbix') ir jāpievieno 'docker' [grupai](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user), lai nodrošinātu pietiekamas privilēģijas. Pretējā gadījumā pārbaude neizdosies. ##### docker.container_stats[<ID>] {#docker.container.stats} <br> The container resource usage statistics.<br> Return value: The output of the [ContainerStats](https://docs.docker.com/engine/api/v1.28/#operation/ContainerStats) API call and CPU usage percentage serialized as JSON. Parameter: - **ID** - the ID or name of the container. The Agent 2 user ('zabbix') must be added to the 'docker' [group](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) for sufficient privileges. Otherwise the check will fail. ##### docker.container_stats[<ID>] {#docker.container.stats} <br> Konteinera resursu izmantošanas statistika.<br> Atgrieztā vērtība: [ContainerStats](https://docs.docker.com/engine/api/v1.28/#operation/ContainerStats) API izsaukuma izvade un CPU izmantošanas procentuālā vērtība, serializēta kā JSON. Parametrs: - **ID** - konteinera ID vai nosaukums. Agent 2 lietotājs ('zabbix') ir jāpievieno 'docker' [grupai](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user), lai nodrošinātu pietiekamas privilēģijas. Pretējā gadījumā pārbaude neizdosies. ##### docker.data.usage {#docker.data.usage} <br> Information about the current data usage.<br> Return value: The output of the [SystemDataUsage](https://docs.docker.com/engine/api/v1.28/#operation/SystemDataUsage) API call serialized as JSON. The Agent 2 user ('zabbix') must be added to the 'docker' [group](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) for sufficient privileges. Otherwise the check will fail. ##### docker.data.usage {#docker.data.usage} <br> Informācija par pašreizējo datu lietojumu.<br> Atgrieztā vērtība: [SystemDataUsage](https://docs.docker.com/engine/api/v1.28/#operation/SystemDataUsage) API izsaukuma izvade, serializēta kā JSON. Lai nodrošinātu pietiekamas privilēģijas, Agent 2 lietotājs ('zabbix') jāpievieno 'docker' [grupai](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user). Pretējā gadījumā pārbaude neizdosies. ##### docker.images.discovery {#docker.images.discovery} <br> Returns the list of images. Used for [low-level discovery](/manual/discovery/low_level_discovery/).<br> Return value: *JSON object*. The Agent 2 user ('zabbix') must be added to the 'docker' [group](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) for sufficient privileges. Otherwise the check will fail. ##### docker.images.discovery {#docker.images.discovery} <br> Atgriež attēlu sarakstu. Izmanto [zemā līmeņa atklāšanai](/manual/discovery/low_level_discovery/).<br> Atgrieztā vērtība: *JSON objekts*. Lietotājs Agent 2 ('zabbix') ir jāpievieno 'docker' [grupai](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user), lai nodrošinātu pietiekamas privilēģijas. Pretējā gadījumā pārbaude neizdosies. ##### docker.images {#docker.images} <br> Returns the list of images.<br> Return value: The output of the [ImageList](https://docs.docker.com/engine/api/v1.28/#operation/ImageList) API call serialized as JSON. The Agent 2 user ('zabbix') must be added to the 'docker' [group](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) for sufficient privileges. Otherwise the check will fail. ##### docker.images {#docker.images} <br> Atgriež attēlu sarakstu.<br> Atgrieztā vērtība: [ImageList](https://docs.docker.com/engine/api/v1.28/#operation/ImageList) API izsaukuma izvade, serializēta kā JSON. Lai nodrošinātu pietiekamas privilēģijas, Agent 2 lietotājs ('zabbix') jāpievieno 'docker' [grupai](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user). Pretējā gadījumā pārbaude neizdosies. ##### docker.info {#docker.info} <br> The system information.<br> Return value: The output of the [SystemInfo](https://docs.docker.com/engine/api/v1.28/#operation/SystemInfo) API call serialized as JSON. The Agent 2 user ('zabbix') must be added to the 'docker' [group](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) for sufficient privileges. Otherwise the check will fail. ##### docker.info {#docker.info} <br> Sistēmas informācija.<br> Atgrieztā vērtība: [SystemInfo](https://docs.docker.com/engine/api/v1.28/#operation/SystemInfo) API izsaukuma izvade, serializēta kā JSON. Lai nodrošinātu pietiekamas privilēģijas, Agent 2 lietotājs ('zabbix') jāpievieno [grupai](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) 'docker'. Pretējā gadījumā pārbaude neizdosies. ### Docker (manual deployment) Use manual deployment when you want to deploy Zabbix step by step, run individual components, integrate them with an existing environment, or use an alternative container runtime such as Podman. For example, to deploy a Zabbix proxy, run the following command: ```bash docker run --name zabbix-proxy-sqlite3 \ -e ZBX_SERVER_HOST=192.0.2.1 \ -e ZBX_PROXYMODE=0 \ -e ZBX_HOSTNAME=zabbix-proxy-sqlite3 \ -v zabbix-proxy-data:/var/lib/zabbix/db_data \ --init \ -d \ zabbix/zabbix-proxy-sqlite3:alpine-7.0-latest ``` :::noteimportant Zabbix (7.0.0-7.0.2) must not be run as `PID1`/`init` process in containers. ::: This command: - Pulls the `zabbix/zabbix-proxy-sqlite3:alpine-7.0-latest` [Docker image](#available-docker-images). - Creates and starts a `zabbix-proxy-sqlite3` container based on the Docker image (with [`--init`](https://docs.docker.com/reference/cli/docker/container/run/#init) and [`-d`](https://docs.docker.com/reference/cli/docker/container/run/#detach) flags). - Configures the Zabbix proxy [`Server`](/manual/appendix/config/zabbix_proxy#server) parameter via the `ZBX_SERVER_HOST` environment variable. This parameter specifies the IP address of the Zabbix server from which the proxy will retrieve configuration data and to which it will send collected data. Note that other variables required for active proxy operation use default values and can be omitted. ::: noteclassic Environment variables correspond to Zabbix component configuration parameters using a different naming style (e.g., `ZBX_SERVER_HOST` corresponds to [`Server`](/manual/appendix/config/zabbix_proxy#server)). Some variables are Docker-specific, and some configuration parameters cannot be changed (e.g., `PIDFile` and `LogType`). When using environment variables, please refer to the *Environment variables* section in each component's [Docker image](#available-docker-images) description on Docker Hub. ::: - Connects a storage location managed by Docker (e.g., `/var/lib/docker/volumes/zabbix-proxy-data/`) to the container's `/var/lib/zabbix` directory so that Zabbix proxy data is stored permanently, even if the container is removed. ::: noteclassic For more information on each volume, see the *Allowed volumes* section in each component's [Docker image](#available-docker-images) description on Docker Hub. ::: After deploying the Zabbix proxy container, you can proceed to [add the proxy](/manual/distributed_monitoring/proxies#configuration) in your Zabbix web interface and [configure hosts](/manual/config/hosts/host#configuration) to be monitored by this proxy. The examples below cover three additional deployment scenarios: - Zabbix server (MySQL) with Java gateway - Zabbix server (PostgreSQL) with SNMP traps - Zabbix server (MySQL) with Java gateway on RHEL 8–10 For more examples, please refer to each component's [Docker image](#available-docker-images) description on Docker Hub. ### Docker (manuāla izvietošana) Izmantojiet manuālu izvietošanu, ja vēlaties izvietot Zabbix soli pa solim, palaist atsevišķus komponentus, integrēt tos ar esošu vidi vai izmantot alternatīvu konteineru izpildlaiku, piemēram, Podman. Piemēram, lai izvietotu Zabbix starpniekserveri, palaidiet šādu komandu: ```bash docker run --name zabbix-proxy-sqlite3 \ -e ZBX_SERVER_HOST=192.0.2.1 \ -e ZBX_PROXYMODE=0 \ -e ZBX_HOSTNAME=zabbix-proxy-sqlite3 \ -v zabbix-proxy-data:/var/lib/zabbix/db_data \ --init \ -d \ zabbix/zabbix-proxy-sqlite3:alpine-7.0-latest ``` :::noteimportant Zabbix (7.0.0-7.0.2) nedrīkst darbināt kā `PID1`/`init` procesu konteineros. ::: Šī komanda: - Lejupielādē `zabbix/zabbix-proxy-sqlite3:alpine-7.0-latest` [Docker attēlu](#available-docker-images). - Izveido un palaiž `zabbix-proxy-sqlite3` konteineru, pamatojoties uz Docker attēlu (ar [`--init`](https://docs.docker.com/reference/cli/docker/container/run/#init) un [`-d`](https://docs.docker.com/reference/cli/docker/container/run/#detach) karodziņiem). - Konfigurē Zabbix starpniekservera [`Server`](/manual/appendix/config/zabbix_proxy#server) parametru, izmantojot vides mainīgo `ZBX_SERVER_HOST`. Šis parametrs norāda Zabbix servera IP adresi, no kura starpniekserveris izgūs konfigurācijas datus un uz kuru tas nosūtīs savāktos datus. Ņemiet vērā, ka citi mainīgie, kas nepieciešami aktīvai starpniekservera darbībai, izmanto noklusējuma vērtības, un tos var neiekļaut. ::: noteclassic Vides mainīgie atbilst Zabbix komponentu konfigurācijas parametriem, izmantojot atšķirīgu nosaukumu veidošanas stilu (piem., `ZBX_SERVER_HOST` atbilst [`Server`](/manual/appendix/config/zabbix_proxy#server)). Daži mainīgie ir specifiski Docker, un dažus konfigurācijas parametrus nevar mainīt (piem., `PIDFile` un `LogType`). Izmantojot vides mainīgos, lūdzu, skatiet sadaļu *Environment variables* katra komponenta [Docker attēla](#available-docker-images) aprakstā Docker Hub. ::: - Pievieno Docker pārvaldītu glabāšanas vietu (piem., `/var/lib/docker/volumes/zabbix-proxy-data/`) konteinera `/var/lib/zabbix` direktorijam, lai Zabbix starpniekservera dati tiktu saglabāti pastāvīgi pat tad, ja konteiners tiek noņemts. ::: noteclassic Lai iegūtu vairāk informācijas par katru sējumu, skatiet sadaļu *Allowed volumes* katra komponenta [Docker attēla](#available-docker-images) aprakstā Docker Hub. ::: Pēc Zabbix starpniekservera konteinera izvietošanas varat turpināt ar [starpniekservera pievienošanu](/manual/distributed_monitoring/proxies#configuration) savā Zabbix lietotāja saskarnē un [hosts konfigurēšanu](/manual/config/hosts/host#configuration), lai tos uzraudzītu ar šo starpniekserveri. Tālāk redzamie piemēri aptver trīs papildu izvietošanas scenārijus: - Zabbix serveris (MySQL) ar Java gateway - Zabbix serveris (PostgreSQL) ar SNMP trapiem - Zabbix serveris (MySQL) ar Java gateway uz RHEL 8–10 Lai iegūtu vairāk piemēru, lūdzu, skatiet katra komponenta [Docker attēla](#available-docker-images) aprakstu Docker Hub. ##### docker.ping {#docker.ping} <br> Test if the Docker daemon is alive or not.<br> Return value: *1* - the connection is alive; *0* - the connection is broken. The Agent 2 user ('zabbix') must be added to the 'docker' [group](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) for sufficient privileges. Otherwise the check will fail. ##### docker.ping {#docker.ping} <br> Pārbauda, vai Docker dēmons darbojas vai nē.<br> Atgrieztā vērtība: *1* — savienojums darbojas; *0* — savienojums ir pārtraukts. Aģenta 2 lietotājs ('zabbix') ir jāpievieno 'docker' [grupai](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user), lai nodrošinātu pietiekamas privilēģijas. Pretējā gadījumā pārbaude neizdosies. #### Documentation link for each standard item Each standard item now has a direct link from the frontend to its documentation page. {width="600"} The links are placed under the question mark icon, when opening the item helper window from the item configuration form (click on *Select* next to the item key field). #### Dokumentācijas saite katram standarta vienumam Katram standarta vienumam tagad ir tieša saite no lietotāja saskarnes uz tā dokumentācijas lapu. {width="600"} Saites ir izvietotas zem jautājuma zīmes ikonas, atverot vienuma palīdzības logu no vienuma konfigurācijas formas (noklikšķiniet uz *Select* blakus vienuma atslēgas laukam). ##### Does not match regular expression {#doesnotmatchregexp} Specify a regular expression that a value must not match. If you mark the *Custom on fail* checkbox, it is possible to specify custom error-handling options: either to discard the value, set a specified value, or set a specified error message. In case of a failed preprocessing step, the item will not become unsupported if the option to discard the value or set a specified value is selected. ##### Neatbilst regulārajai izteiksmei {#doesnotmatchregexp} Norādiet regulāro izteiksmi, kurai vērtība nedrīkst atbilst. Ja atzīmējat izvēles rūtiņu *Pielāgots kļūmes gadījumā*, ir iespējams norādīt pielāgotas kļūdu apstrādes opcijas: vai nu atmest vērtību, iestatīt norādīto vērtību vai iestatīt norādīto kļūdas ziņojumu. Neveiksmīga priekšapstrādes soļa gadījumā vienums nekļūs par neatbalstītu, ja ir atlasīta opcija atmest vērtību vai iestatīt norādīto vērtību. #### Double precision data types on TimescaleDB Before upgrading to Zabbix 7.0.0, it is necessary to manually upgrade TimescaleDB to use double precision data types if TimescaleDB is used with compression. You can tell if TimescaleDB is not using double precision data types by the warning in the [System information](/manual/web_interface/frontend_sections/reports/status_of_zabbix) frontend section or Zabbix server log: "Database is not upgraded to use double precision values. Support for the old numeric type will be removed in future versions." For more information, see [Upgrading to numeric values of extended range](/manual/appendix/install/db_float_range). #### Dubultprecizitātes datu tipi TimescaleDB Pirms jaunināšanas uz Zabbix 7.0.0, ja TimescaleDB tiek izmantots ar saspiešanu, ir nepieciešams manuāli jaunināt TimescaleDB, lai izmantotu dubultprecizitātes datu tipus. Var noteikt, ka TimescaleDB neizmanto dubultprecizitātes datu tipus, pēc brīdinājuma [Sistēmas informācija](/manual/web_interface/frontend_sections/reports/status_of_zabbix) lietotāja saskarne sadaļā vai Zabbix servera žurnālā: "Datubāze nav jaunināta, lai izmantotu dubultprecizitātes vērtības. Atbalsts vecajam skaitliskajam tipam tiks noņemts nākamajās versijās." Plašāku informāciju skatiet sadaļā [Jaunināšana uz paplašināta diapazona skaitliskajām vērtībām](/manual/appendix/install/db_float_range). # drule.create # drule.create # drule.delete # drule.delete # drule.get # drule.get # drule.update # drule.update #### drule [ZBX-23760](https://support.zabbix.com/browse/ZBX-23760) `drule.update`: It is no longer possible to delete a discovery rule check that is used in action condition. In such case, an error message is returned instead of automatically disabling the action. #### drule [ZBX-23760](https://support.zabbix.com/browse/ZBX-23760) `drule.update`: vairs nav iespējams dzēst atklāšanas noteikuma pārbaudi, kas tiek izmantota darbības nosacījumā. Šādā gadījumā tiek atgriezts kļūdas ziņojums, nevis automātiski atspējota darbība. #### drule [ZBXNEXT-2732](https://support.zabbix.com/browse/ZBXNEXT-2732) Added new property `concurrency_max`.<br> [ZBXNEXT-8500](https://support.zabbix.com/browse/ZBXNEXT-8500) Renamed `proxy_hostid` to `proxyid` #### drule [ZBXNEXT-2732](https://support.zabbix.com/browse/ZBXNEXT-2732) Pievienots jauns īpašums `concurrency_max`.<br> [ZBXNEXT-8500](https://support.zabbix.com/browse/ZBXNEXT-8500) Pārdēvēts `proxy_hostid` uz `proxyid` # dservice.get # dservice.get #### Dummy module Zabbix includes a sample module written in C language. The module is located under src/modules/dummy: ```bash alex@alex:~trunk/src/modules/dummy$ ls -l -rw-rw-r-- 1 alex alex 9019 Apr 24 17:54 dummy.c -rw-rw-r-- 1 alex alex 67 Apr 24 17:54 Makefile -rw-rw-r-- 1 alex alex 245 Apr 24 17:54 README ``` The module is well documented, it can be used as a template for your own modules. After ./configure has been run in the root of Zabbix source tree as described above, just run **make** in order to build **dummy.so**. ```c /* ** Zabbix ** Copyright (C) 2001-2020 Zabbix SIA ** ** This program is free software; you can redistribute it and/or modify ** it under the terms of the GNU General Public License as published by ** the Free Software Foundation; either version 2 of the License, or ** (at your option) any later version. ** ** This program is distributed in the hope that it will be useful, ** but WITHOUT ANY WARRANTY; without even the implied warranty of ** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the ** GNU General Public License for more details. ** ** You should have received a copy of the GNU General Public License ** along with this program; if not, write to the Free Software ** Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. **/ #include <stdlib.h> #include <string.h> #include <time.h> #include <stdint.h> #include "module.h" /* the variable keeps timeout setting for item processing */ static int item_timeout = 0; /* module SHOULD define internal functions as static and use a naming pattern different from Zabbix internal */ /* symbols (zbx_*) and loadable module API functions (zbx_module_*) to avoid conflicts */ static int dummy_ping(AGENT_REQUEST *request, AGENT_RESULT *result); static int dummy_echo(AGENT_REQUEST *request, AGENT_RESULT *result); static int dummy_random(AGENT_REQUEST *request, AGENT_RESULT *result); static ZBX_METRIC keys[] = /* KEY FLAG FUNCTION TEST PARAMETERS */ { {"dummy.ping", 0, dummy_ping, NULL}, {"dummy.echo", CF_HAVEPARAMS, dummy_echo, "a message"}, {"dummy.random", CF_HAVEPARAMS, dummy_random, "1,1000"}, {NULL} }; /****************************************************************************** * * * Function: zbx_module_api_version * * * * Purpose: returns version number of the module interface * * * * Return value: ZBX_MODULE_API_VERSION - version of module.h module is * * compiled with, in order to load module successfully Zabbix * * MUST be compiled with the same version of this header file * * * ******************************************************************************/ int zbx_module_api_version(void) { return ZBX_MODULE_API_VERSION; } /****************************************************************************** * * * Function: zbx_module_item_timeout * * * * Purpose: set timeout value for processing of items * * * * Parameters: timeout - timeout in seconds, 0 - no timeout set * * * ******************************************************************************/ void zbx_module_item_timeout(int timeout) { item_timeout = timeout; } /****************************************************************************** * * * Function: zbx_module_item_list * * * * Purpose: returns list of item keys supported by the module * * * * Return value: list of item keys * * * ******************************************************************************/ ZBX_METRIC *zbx_module_item_list(void) { return keys; } static int dummy_ping(AGENT_REQUEST *request, AGENT_RESULT *result) { SET_UI64_RESULT(result, 1); return SYSINFO_RET_OK; } static int dummy_echo(AGENT_REQUEST *request, AGENT_RESULT *result) { char *param; if (1 != request->nparam) { /* set optional error message */ SET_MSG_RESULT(result, strdup("Invalid number of parameters.")); return SYSINFO_RET_FAIL; } param = get_rparam(request, 0); SET_STR_RESULT(result, strdup(param)); return SYSINFO_RET_OK; } /****************************************************************************** * * * Function: dummy_random * * * * Purpose: a main entry point for processing of an item * * * * Parameters: request - structure that contains item key and parameters * * request->key - item key without parameters * * request->nparam - number of parameters * * request->params[N-1] - pointers to item key parameters * * request->types[N-1] - item key parameters types: * * REQUEST_PARAMETER_TYPE_UNDEFINED (key parameter is empty) * * REQUEST_PARAMETER_TYPE_ARRAY (array) * * REQUEST_PARAMETER_TYPE_STRING (quoted or unquoted string) * * * * result - structure that will contain result * * * * Return value: SYSINFO_RET_FAIL - function failed, item will be marked * * as not supported by zabbix * * SYSINFO_RET_OK - success * * * * Comment: get_rparam(request, N-1) can be used to get a pointer to the Nth * * parameter starting from 0 (first parameter). Make sure it exists * * by checking value of request->nparam. * * In the same manner get_rparam_type(request, N-1) can be used to * * get a parameter type. * * * ******************************************************************************/ static int dummy_random(AGENT_REQUEST *request, AGENT_RESULT *result) { char *param1, *param2; int from, to; if (2 != request->nparam) { /* set optional error message */ SET_MSG_RESULT(result, strdup("Invalid number of parameters.")); return SYSINFO_RET_FAIL; } param1 = get_rparam(request, 0); param2 = get_rparam(request, 1); /* there is no strict validation of parameters and types for simplicity sake */ from = atoi(param1); to = atoi(param2); if (from > to) { SET_MSG_RESULT(result, strdup("Invalid range specified.")); return SYSINFO_RET_FAIL; } SET_UI64_RESULT(result, from + rand() % (to - from + 1)); return SYSINFO_RET_OK; } /****************************************************************************** * * * Function: zbx_module_init * * * * Purpose: the function is called on agent startup * * It should be used to call any initialization routines * * * * Return value: ZBX_MODULE_OK - success * * ZBX_MODULE_FAIL - module initialization failed * * * * Comment: the module won't be loaded in case of ZBX_MODULE_FAIL * * * ******************************************************************************/ int zbx_module_init(void) { /* initialization for dummy.random */ srand(time(NULL)); return ZBX_MODULE_OK; } /****************************************************************************** * * * Function: zbx_module_uninit * * * * Purpose: the function is called on agent shutdown * * It should be used to cleanup used resources if there are any * * * * Return value: ZBX_MODULE_OK - success * * ZBX_MODULE_FAIL - function failed * * * ******************************************************************************/ int zbx_module_uninit(void) { return ZBX_MODULE_OK; } /****************************************************************************** * * * Functions: dummy_history_float_cb * * dummy_history_integer_cb * * dummy_history_string_cb * * dummy_history_text_cb * * dummy_history_log_cb * * * * Purpose: callback functions for storing historical data of types float, * * integer, string, text and log respectively in external storage * * * * Parameters: history - array of historical data * * history_num - number of elements in history array * * * ******************************************************************************/ static void dummy_history_float_cb(const ZBX_HISTORY_FLOAT *history, int history_num) { int i; for (i = 0; i < history_num; i++) { /* do something with history[i].itemid, history[i].clock, history[i].ns, history[i].value, ... */ } } static void dummy_history_integer_cb(const ZBX_HISTORY_INTEGER *history, int history_num) { int i; for (i = 0; i < history_num; i++) { /* do something with history[i].itemid, history[i].clock, history[i].ns, history[i].value, ... */ } } static void dummy_history_string_cb(const ZBX_HISTORY_STRING *history, int history_num) { int i; for (i = 0; i < history_num; i++) { /* do something with history[i].itemid, history[i].clock, history[i].ns, history[i].value, ... */ } } static void dummy_history_text_cb(const ZBX_HISTORY_TEXT *history, int history_num) { int i; for (i = 0; i < history_num; i++) { /* do something with history[i].itemid, history[i].clock, history[i].ns, history[i].value, ... */ } } static void dummy_history_log_cb(const ZBX_HISTORY_LOG *history, int history_num) { int i; for (i = 0; i < history_num; i++) { /* do something with history[i].itemid, history[i].clock, history[i].ns, history[i].value, ... */ } } /****************************************************************************** * * * Function: zbx_module_history_write_cbs * * * * Purpose: returns a set of module functions Zabbix will call to export * * different types of historical data * * * * Return value: structure with callback function pointers (can be NULL if * * module is not interested in data of certain types) * * * ******************************************************************************/ ZBX_HISTORY_WRITE_CBS zbx_module_history_write_cbs(void) { static ZBX_HISTORY_WRITE_CBS dummy_callbacks = { dummy_history_float_cb, dummy_history_integer_cb, dummy_history_string_cb, dummy_history_text_cb, dummy_history_log_cb, }; return dummy_callbacks; } ``` The module exports three new items: - `dummy.ping` - always returns '1' - `dummy.echo[param1]` - returns the first parameter as it is, for example, `dummy.echo[ABC]` will return ABC - `dummy.random[param1, param2]` - returns a random number within the range of param1-param2, for example, `dummy.random[1,1000000]` #### Demonstrācijas modulis Zabbix ietver C valodā rakstītu moduļa paraugu. Modulis atrodas mapē src/modules/dummy: ```bash alex@alex:~trunk/src/modules/dummy$ ls -l -rw-rw-r-- 1 alex alex 9019 Apr 24 17:54 dummy.c -rw-rw-r-- 1 alex alex 67 Apr 24 17:54 Makefile -rw-rw-r-- 1 alex alex 245 Apr 24 17:54 README ``` Modulis ir labi dokumentēts, to var izmantot kā veidni saviem moduļiem. Pēc tam, kad Zabbix pirmkoda koka saknē ir izpildīts ./configure, kā aprakstīts iepriekš, vienkārši palaidiet **make**, lai izveidotu **dummy.so**. ```c /* ** Zabbix ** Copyright (C) 2001-2020 Zabbix SIA ** ** This program is free software; you can redistribute it and/or modify ** it under the terms of the GNU General Public License as published by ** the Free Software Foundation; either version 2 of the License, or ** (at your option) any later version. ** ** This program is distributed in the hope that it will be useful, ** but WITHOUT ANY WARRANTY; without even the implied warranty of ** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the ** GNU General Public License for more details. ** ** You should have received a copy of the GNU General Public License ** along with this program; if not, write to the Free Software ** Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. **/ #include <stdlib.h> #include <string.h> #include <time.h> #include <stdint.h> #include "module.h" /* the variable keeps timeout setting for item processing */ static int item_timeout = 0; /* module SHOULD define internal functions as static and use a naming pattern different from Zabbix internal */ /* symbols (zbx_*) and loadable module API functions (zbx_module_*) to avoid conflicts */ static int dummy_ping(AGENT_REQUEST *request, AGENT_RESULT *result); static int dummy_echo(AGENT_REQUEST *request, AGENT_RESULT *result); static int dummy_random(AGENT_REQUEST *request, AGENT_RESULT *result); static ZBX_METRIC keys[] = /* KEY FLAG FUNCTION TEST PARAMETERS */ { {"dummy.ping", 0, dummy_ping, NULL}, {"dummy.echo", CF_HAVEPARAMS, dummy_echo, "a message"}, {"dummy.random", CF_HAVEPARAMS, dummy_random, "1,1000"}, {NULL} }; /****************************************************************************** * * * Function: zbx_module_api_version * * * * Purpose: returns version number of the module interface * * * * Return value: ZBX_MODULE_API_VERSION - version of module.h module is * * compiled with, in order to load module successfully Zabbix * * MUST be compiled with the same version of this header file * * * ******************************************************************************/ int zbx_module_api_version(void) { return ZBX_MODULE_API_VERSION; } /****************************************************************************** * * * Function: zbx_module_item_timeout * * * * Purpose: set timeout value for processing of items * * * * Parameters: timeout - timeout in seconds, 0 - no timeout set * * * ******************************************************************************/ void zbx_module_item_timeout(int timeout) { item_timeout = timeout; } /****************************************************************************** * * * Function: zbx_module_item_list * * * * Purpose: returns list of item keys supported by the module * * * * Return value: list of item keys * * * ******************************************************************************/ ZBX_METRIC *zbx_module_item_list(void) { return keys; } static int dummy_ping(AGENT_REQUEST *request, AGENT_RESULT *result) { SET_UI64_RESULT(result, 1); return SYSINFO_RET_OK; } static int dummy_echo(AGENT_REQUEST *request, AGENT_RESULT *result) { char *param; if (1 != request->nparam) { /* set optional error message */ SET_MSG_RESULT(result, strdup("Invalid number of parameters.")); return SYSINFO_RET_FAIL; } param = get_rparam(request, 0); SET_STR_RESULT(result, strdup(param)); return SYSINFO_RET_OK; } /****************************************************************************** * * * Function: dummy_random * * * * Purpose: a main entry point for processing of an item * * * * Parameters: request - structure that contains item key and parameters * * request->key - item key without parameters * * request->nparam - number of parameters * * request->params[N-1] - pointers to item key parameters * * request->types[N-1] - item key parameters types: * * REQUEST_PARAMETER_TYPE_UNDEFINED (key parameter is empty) * * REQUEST_PARAMETER_TYPE_ARRAY (array) * * REQUEST_PARAMETER_TYPE_STRING (quoted or unquoted string) * * * * result - structure that will contain result * * * * Return value: SYSINFO_RET_FAIL - function failed, item will be marked * * as not supported by zabbix * * SYSINFO_RET_OK - success * * * * Comment: get_rparam(request, N-1) can be used to get a pointer to the Nth * * parameter starting from 0 (first parameter). Make sure it exists * * by checking value of request->nparam. * * In the same manner get_rparam_type(request, N-1) can be used to * * get a parameter type. * * * ******************************************************************************/ static int dummy_random(AGENT_REQUEST *request, AGENT_RESULT *result) { char *param1, *param2; int from, to; if (2 != request->nparam) { /* set optional error message */ SET_MSG_RESULT(result, strdup("Invalid number of parameters.")); return SYSINFO_RET_FAIL; } param1 = get_rparam(request, 0); param2 = get_rparam(request, 1); /* there is no strict validation of parameters and types for simplicity sake */ from = atoi(param1); to = atoi(param2); if (from > to) { SET_MSG_RESULT(result, strdup("Invalid range specified.")); return SYSINFO_RET_FAIL; } SET_UI64_RESULT(result, from + rand() % (to - from + 1)); return SYSINFO_RET_OK; } /****************************************************************************** * * * Function: zbx_module_init * * * * Purpose: the function is called on agent startup * * It should be used to call any initialization routines * * * * Return value: ZBX_MODULE_OK - success * * ZBX_MODULE_FAIL - module initialization failed * * * * Comment: the module won't be loaded in case of ZBX_MODULE_FAIL * * * ******************************************************************************/ int zbx_module_init(void) { /* initialization for dummy.random */ srand(time(NULL)); return ZBX_MODULE_OK; } /****************************************************************************** * * * Function: zbx_module_uninit * * * * Purpose: the function is called on agent shutdown * * It should be used to cleanup used resources if there are any * * * * Return value: ZBX_MODULE_OK - success * * ZBX_MODULE_FAIL - function failed * * * ******************************************************************************/ int zbx_module_uninit(void) { return ZBX_MODULE_OK; } /****************************************************************************** * * * Functions: dummy_history_float_cb * * dummy_history_integer_cb * * dummy_history_string_cb * * dummy_history_text_cb * * dummy_history_log_cb * * * * Purpose: callback functions for storing historical data of types float, * * integer, string, text and log respectively in external storage * * * * Parameters: history - array of historical data * * history_num - number of elements in history array * * * ******************************************************************************/ static void dummy_history_float_cb(const ZBX_HISTORY_FLOAT *history, int history_num) { int i; for (i = 0; i < history_num; i++) { /* do something with history[i].itemid, history[i].clock, history[i].ns, history[i].value, ... */ } } static void dummy_history_integer_cb(const ZBX_HISTORY_INTEGER *history, int history_num) { int i; for (i = 0; i < history_num; i++) { /* do something with history[i].itemid, history[i].clock, history[i].ns, history[i].value, ... */ } } static void dummy_history_string_cb(const ZBX_HISTORY_STRING *history, int history_num) { int i; for (i = 0; i < history_num; i++) { /* do something with history[i].itemid, history[i].clock, history[i].ns, history[i].value, ... */ } } static void dummy_history_text_cb(const ZBX_HISTORY_TEXT *history, int history_num) { int i; for (i = 0; i < history_num; i++) { /* do something with history[i].itemid, history[i].clock, history[i].ns, history[i].value, ... */ } } static void dummy_history_log_cb(const ZBX_HISTORY_LOG *history, int history_num) { int i; for (i = 0; i < history_num; i++) { /* do something with history[i].itemid, history[i].clock, history[i].ns, history[i].value, ... */ } } /****************************************************************************** * * * Function: zbx_module_history_write_cbs * * * * Purpose: returns a set of module functions Zabbix will call to export * * different types of historical data * * * * Return value: structure with callback function pointers (can be NULL if * * module is not interested in data of certain types) * * * ******************************************************************************/ ZBX_HISTORY_WRITE_CBS zbx_module_history_write_cbs(void) { static ZBX_HISTORY_WRITE_CBS dummy_callbacks = { dummy_history_float_cb, dummy_history_integer_cb, dummy_history_string_cb, dummy_history_text_cb, dummy_history_log_cb, }; return dummy_callbacks; } ``` Modulis eksportē trīs jaunus vienumus: - `dummy.ping` - vienmēr atgriež '1' - `dummy.echo[param1]` - atgriež pirmo parametru tādu, kāds tas ir, piemēram, `dummy.echo[ABC]` atgriezīs ABC - `dummy.random[param1, param2]` - atgriež nejaušu skaitli param1-param2 diapazonā, piemēram, `dummy.random[1,1000000]` ##### Duo Universal Prompt For Duo Universal Prompt, users must verify their identity using the [Duo Mobile](https://duo.com/product/multi-factor-authentication-mfa/duo-mobile-app) authenticator app. ::: noteimportant The Duo Universal Prompt MFA method requires the installation of the [php-curl](/manual/installation/requirements#frontend) extension, access to Zabbix over HTTPS, and permission for outbound connections to Duo servers. Moreover, if you have [enabled Content Security Policy (CSP) on the web server](/manual/best_practices/security/web_server#enabling-content-security-policy-csp-on-the-web-server), make sure to add "duo.com" to the CSP directive in your virtual host's configuration file. ::: 1\. Signup for a free Duo admin account at [Duo Signup](https://signup.duo.com). 2\. Open the Duo Admin Panel, go to *Applications* → [*Protect an Application*](https://duo.com/docs/protecting-applications), search for the *Web SDK* application, and click *Protect*. 3\. Note the credentials (Client ID, Client secret, API hostname) required for configuring the MFA method in Zabbix. 4\. Go to MFA settings in Zabbix under *Users* → *Authentication* and enable multi-factor authentication. 5\. Add a new MFA [method](#method-configuration) with the following configuration: - Type: Duo Universal Prompt - Name: Zabbix Duo - API hostname: (use API hostname from Duo) - Client ID: (use Client ID from Duo) - Client secret: (use Client secret from Duo) 6\. Click the *Add* button and then the *Update* button. 7\. Go to *Users* → [*User groups*](/manual/web_interface/frontend_sections/users/user_groups) and create a new user group with the following [configuration](/manual/config/users_and_usergroups/usergroup#configuration): - Group name: Duo group - Users: Admin - Multi-factor authentication: Default (or "Zabbix Duo" if it is not set as default) 8\. Log out of Zabbix and log back in using your credentials. Upon successful login, you will be prompted to enroll in MFA and redirected to Duo. Complete the Duo setup and verify your user with your phone's Duo app to log in. 9\. For subsequent logins, use the appropriate MFA method provided by the Duo app (such as retrieving a verification code, responding to push notifications, or using hard keys), and enter the required information during login. ##### Duo Universal Prompt Lai izmantotu Duo Universal Prompt, lietotājiem ir jāapstiprina sava identitāte, izmantojot autentifikācijas lietotni [Duo Mobile](https://duo.com/product/multi-factor-authentication-mfa/duo-mobile-app). ::: noteimportant Duo Universal Prompt MFA metodei ir nepieciešama [php-curl](/manual/installation/requirements#frontend) paplašinājuma instalēšana, piekļuve Zabbix, izmantojot HTTPS, un atļauja izejošajiem savienojumiem ar Duo serveriem. Turklāt, ja [tīmekļa serverī ir iespējota Content Security Policy (CSP)](/manual/best_practices/security/web_server#enabling-content-security-policy-csp-on-the-web-server), pārliecinieties, ka virtuālā resursdatora konfigurācijas failā CSP direktīvai pievienojat "duo.com". ::: 1\. Reģistrējieties bezmaksas Duo administratora kontam vietnē [Duo Signup](https://signup.duo.com). 2\. Atveriet Duo Admin Panel, dodieties uz *Applications* → [*Protect an Application*](https://duo.com/docs/protecting-applications), atrodiet *Web SDK* lietotni un noklikšķiniet uz *Protect*. 3\. Pierakstiet akreditācijas datus (Client ID, Client secret, API hostname), kas nepieciešami MFA metodes konfigurēšanai Zabbix. 4\. Dodieties uz MFA iestatījumiem Zabbix sadaļā *Users* → *Authentication* un iespējojiet daudzfaktoru autentifikāciju. 5\. Pievienojiet jaunu MFA [metodi](#method-configuration) ar šādu konfigurāciju: - Type: Duo Universal Prompt - Name: Zabbix Duo - API hostname: (use API hostname from Duo) - Client ID: (use Client ID from Duo) - Client secret: (use Client secret from Duo) 6\. Noklikšķiniet uz pogas *Add* un pēc tam uz pogas *Update*. 7\. Dodieties uz *Users* → [*User groups*](/manual/web_interface/frontend_sections/users/user_groups) un izveidojiet jaunu lietotāju grupu ar šādu [konfigurāciju](/manual/config/users_and_usergroups/usergroup#configuration): - Group name: Duo group - Users: Admin - Multi-factor authentication: Default (or "Zabbix Duo" if it is not set as default) 8\. Izrakstieties no Zabbix un piesakieties vēlreiz, izmantojot savus akreditācijas datus. Pēc veiksmīgas pieteikšanās jums tiks piedāvāts reģistrēties MFA un jūs tiksiet novirzīts uz Duo. Pabeidziet Duo iestatīšanu un apstipriniet savu lietotāju ar tālruņa Duo lietotni, lai pieteiktos. 9\. Turpmākajām pieteikšanās reizēm izmantojiet atbilstošo MFA metodi, ko nodrošina Duo lietotne (piemēram, verifikācijas koda iegūšanu, push paziņojumu apstiprināšanu vai hard key izmantošanu), un pieteikšanās laikā ievadiet nepieciešamo informāciju. ##### During initialization When creating a `ZabbixAPI` instance, you can provide the Zabbix web interface URL and your credentials all at once: ```python # Username and password: api = ZabbixAPI(url="127.0.0.1/zabbix", user="Admin", password="zabbix") # API token: api = ZabbixAPI(url="127.0.0.1/zabbix", token="your_api_token") ``` If you prefer to group connection parameters, you can pass them as a Python dictionary and unpack it using Python's keyword argument syntax: ```python ZABBIX_AUTH = { "url": "127.0.0.1/zabbix", "user": "Admin", "password": "zabbix" } api = ZabbixAPI(**ZABBIX_AUTH) ``` ##### Inicializācijas laikā Veidojot `ZabbixAPI` instanci, varat uzreiz norādīt Zabbix tīmekļa saskarnes URL un savus akreditācijas datus: ```python # Lietotājvārds un parole: api = ZabbixAPI(url="127.0.0.1/zabbix", user="Admin", password="zabbix") # API marķieris: api = ZabbixAPI(url="127.0.0.1/zabbix", token="your_api_token") ``` Ja vēlaties grupēt savienojuma parametrus, varat tos nodot kā Python vārdnīcu un izpakot, izmantojot Python atslēgvārdu argumentu sintaksi: ```python ZABBIX_AUTH = { "url": "127.0.0.1/zabbix", "user": "Admin", "password": "zabbix" } api = ZabbixAPI(**ZABBIX_AUTH) ``` #### Dynamic indexes with walk[] Dynamic indexes (for example, interface indexes) can shift when hardware is reconfigured. To accommodate this behavior, a master SNMP walk discovery rule is created with a key such as: ```bash walk[1.3.6.1.2.1.2.2.1.10] ``` After SNMP walk to JSON preprocessing, the result might resemble: ```json [ { "{#SNMPINDEX}": "2", "{#VALUE}": "123456" }, { "{#SNMPINDEX}": "3", "{#VALUE}": "654321" } ] ``` A dependent item prototype uses the `{#SNMPINDEX}` macro to construct the key: ```default net.if.in[{#SNMPINDEX}] ``` Preprocessing for this prototype includes "SNMP walk value" name with "1.3.6.1.2.1.2.2.1.10.{#SNMPINDEX}" OID in the *Parameter* field. *Format*: "Unchanged". At runtime, actual items such as `net.if.in[2]` and `net.if.in[3]` are created. If a given interface index changes (for example, if the index `2` is replaced by `5` in the SNMP table), then on the next run of the discovery rule: - The old dependent item net.if.in[2] is marked as "lost" or removed, and no new data is gathered for that item. - A new dependent item net.if.in[5] is created, starting with an empty history. - Historical data from net.if.in[2] is not automatically moved to net.if.in[5]. Trigger prototype example: ```default {Template_Interface:net.if.in[{#SNMPINDEX}].last()} > 1000000000 ``` Graph prototype example includes items: ```default net.if.in[{#SNMPINDEX}] net.if.out[{#SNMPINDEX}] ``` This configuration ensures reliable monitoring of tables with dynamic indexes while minimizing SNMP traffic—only a single SNMP walk per poll cycle is required, with dependent item prototypes extracting the necessary values. #### Dinamiskie indeksi ar walk[] Dinamiskie indeksi (piemēram, saskarņu indeksi) var mainīties, kad tiek pārkonfigurēta aparatūra. Lai pielāgotos šādai darbībai, tiek izveidots galvenais SNMP walk atklāšanas kārtulas vienums ar atslēgu, piemēram: ```bash walk[1.3.6.1.2.1.2.2.1.10] ``` Pēc SNMP walk uz JSON priekšapstrādes rezultāts var izskatīties šādi: ```json [ { "{#SNMPINDEX}": "2", "{#VALUE}": "123456" }, { "{#SNMPINDEX}": "3", "{#VALUE}": "654321" } ] ``` Atkarīgā vienuma prototips izmanto makrosu `{#SNMPINDEX}`, lai izveidotu atslēgu: ```default net.if.in[{#SNMPINDEX}] ``` Šī prototipa priekšapstrāde ietver "SNMP walk value" nosaukumu ar OID "1.3.6.1.2.1.2.2.1.10.{#SNMPINDEX}" laukā *Parameter*. *Format*: "Unchanged". Izpildes laikā tiek izveidoti faktiskie vienumi, piemēram, `net.if.in[2]` un `net.if.in[3]`. Ja konkrētas saskarnes indekss mainās (piemēram, ja indekss `2` SNMP tabulā tiek aizstāts ar `5`), tad nākamajā atklāšanas kārtulas izpildes reizē: - Vecais atkarīgais vienums net.if.in[2] tiek atzīmēts kā "lost" vai noņemts, un šim vienumam vairs netiek ievākti jauni dati. - Tiek izveidots jauns atkarīgais vienums net.if.in[5], sākot ar tukšu vēsturi. - Vēsturiskie dati no net.if.in[2] netiek automātiski pārvietoti uz net.if.in[5]. Trigera prototipa piemērs: ```default {Template_Interface:net.if.in[{#SNMPINDEX}].last()} > 1000000000 ``` Grafika prototipa piemērs ietver vienumus: ```default net.if.in[{#SNMPINDEX}] net.if.out[{#SNMPINDEX}] ``` Šī konfigurācija nodrošina uzticamu tabulu ar dinamiskiem indeksiem uzraudzību, vienlaikus samazinot SNMP datplūsmu — katram aptaujas ciklam ir nepieciešams tikai viens SNMP walk, bet atkarīgo vienumu prototipi iegūst nepieciešamās vērtības. #### Dynamic parameters Multiple widgets have parameters that enable them to share configuration data between other widgets or the dashboard. #### Dinamiskie parametri Vairākiem logrīkiem ir parametri, kas ļauj tiem koplietot konfigurācijas datus ar citiem logrīkiem vai informācijas paneli. #### Dynamic unit size in Clock widget The [Clock](/manual/web_interface/frontend_sections/dashboards/widgets/clock) widget's digital clock information unit (date, time, time zone) size now dynamically adjusts to fill all available space based on displayed units, widget size, and display scaling. Configuration parameters for setting the unit size have been removed. #### Dinamiska vienību izmēra pielāgošana Clock logrīkā [Clock](/manual/web_interface/frontend_sections/dashboards/widgets/clock) logrīka digitālā pulksteņa informācijas vienību (datums, laiks, laika josla) izmērs tagad tiek dinamiski pielāgots, lai aizpildītu visu pieejamo vietu, ņemot vērā attēlotās vienības, logrīka izmēru un displeja mērogošanu. Konfigurācijas parametri vienību izmēra iestatīšanai ir noņemti. ##### Easy Connect Easy Connect uses the following parameters to connect to the database: - *Host* - the host name or IP address of the database server computer (DBHost parameter in the configuration file). - *Port* - the listening port on the database server (DBPort parameter in the configuration file; if not set the default 1521 port will be used). - <service\_name> - the service name of the database you want to access (DBName parameter in the configuration file). **Example** Database parameters set in the server or proxy configuration file (zabbix\_server.conf and zabbix\_proxy.conf): DBHost=localhost DBPort=1521 DBUser=myusername DBName=ORCL DBPassword=mypassword Connection string used by Zabbix to establish connection: DBUser/DBPassword@DBHost:DBPort/DBName During Zabbix frontend installation, set the corresponding parameters in the *Configure DB connection* step of the setup wizard: - Database host: localhost - Database port: 1521 - Database name: ORCL - User: myusername - Password: mypassword {width="600"} Alternatively, these parameters can be set in the frontend configuration file (zabbix.conf.php): $DB["TYPE"] = 'ORACLE'; $DB["SERVER"] = 'localhost'; $DB["PORT"] = '1521'; $DB["DATABASE"] = 'ORCL'; $DB["USER"] = 'myusername'; $DB["PASSWORD"] = 'mypassword'; ##### Easy Connect Easy Connect izmanto šādus parametrus, lai izveidotu savienojumu ar datubāzi: - *Host* - datubāzes servera datora resursdatora nosaukums vai IP adrese (DBHost parametrs konfigurācijas failā). - *Port* - klausīšanās ports datubāzes serverī (DBPort parametrs konfigurācijas failā; ja nav iestatīts, tiks izmantots noklusējuma 1521 ports). - <service\_name> - datubāzes pakalpojuma nosaukums, kuram vēlaties piekļūt (DBName parametrs konfigurācijas failā). **Piemērs** Datubāzes parametri, kas iestatīti servera vai starpniekserveris konfigurācijas failā (zabbix\_server.conf un zabbix\_proxy.conf): DBHost=localhost DBPort=1521 DBUser=myusername DBName=ORCL DBPassword=mypassword Savienojuma virkne, ko Zabbix izmanto savienojuma izveidei: DBUser/DBPassword@DBHost:DBPort/DBName Zabbix lietotāja saskarne instalēšanas laikā iestatiet atbilstošos parametrus iestatīšanas vedņa solī *Configure DB connection*: - Datubāzes hosts: localhost - Datubāzes ports: 1521 - Datubāzes nosaukums: ORCL - Lietotājs: myusername - Parole: mypassword {width="600"} Alternatīvi šos parametrus var iestatīt lietotāja saskarnes konfigurācijas failā (zabbix.conf.php): $DB["TYPE"] = 'ORACLE'; $DB["SERVER"] = 'localhost'; $DB["PORT"] = '1521'; $DB["DATABASE"] = 'ORCL'; $DB["USER"] = 'myusername'; $DB["PASSWORD"] = 'mypassword'; #### Editing a dashboard When **editing** a dashboard, the following options are available: | | | | |-|----------|----------------------------------------| ||<|Edit general dashboard [parameters](#creating-a-dashboard).| ||<|Add a new widget.<br>Clicking on the arrow button will open the action menu (see action descriptions below).| | ||*Add widget* - add a new widget<br>*Add page* - add a new page<br>*Paste widget* - paste a copied widget. This option is grayed out if no widget has been copied. Only one entity (widget or page) can be copied at one time.<br>*Paste page* - paste a copied page. This option is grayed out if no page has been copied.| ||<|Save dashboard changes.| ||<|Cancel dashboard changes.| #### Informācijas paneļa rediģēšana Rediģējot informācijas paneli, ir pieejamas šādas opcijas: | | | | |-|----------|----------------------------------------| ||<|Rediģēt vispārīgos informācijas paneļa [parametrus](#creating-a-dashboard).| ||<|Pievienot jaunu logrīku.<br>Noklikšķinot uz bultiņas pogas, tiks atvērta darbību izvēlne (skatiet darbību aprakstus tālāk).| | ||*Pievienot logrīku* - pievienot jaunu logrīku<br>*Pievienot lapu* - pievienot jaunu lapu<br>*Ielīmēt logrīku* - ielīmēt kopētu logrīku. Šī opcija ir pelēkota, ja nav kopēts neviens logrīks. Vienlaikus var kopēt tikai vienu entītiju (logrīku vai lapu).<br>*Ielīmēt lapu* - ielīmēt kopētu lapu. Šī opcija ir pelēkota, ja nav kopēta neviena lapa.| ||<|Saglabāt informācijas paneļa izmaiņas.| ||<|Atcelt informācijas paneļa izmaiņas.| ##### Editing linked entities If you try to edit an item or a trigger that was linked from the template, you may realize that many key options are disabled for editing. This makes sense as the idea of templates is that things are edited in a one-touch manner on the template level. However, you still can, for example, enable/disable an item on individual hosts and set the update interval, history length and some other parameters. If you want to edit the entity fully, you have to edit it on the template level (template level shortcut is displayed in the form name), keeping in mind that these changes will affect all hosts that have this template linked to them. ::: noteimportant Any customizations to the entities implemented on a template-level will override the previous customizations of the entities on a host-level. ::: ##### Saistīto entītiju rediģēšana Ja mēģināsiet rediģēt vienumu vai trigeri, kas tika saistīts no veidnes, varat pamanīt, ka daudzas galvenās opcijas rediģēšanai nav pieejamas. Tas ir loģiski, jo veidņu ideja ir tāda, ka viss tiek rediģēts centralizēti veidnes līmenī. Tomēr jūs joprojām varat, piemēram, iespējot/atspējot vienumu atsevišķos hostos un iestatīt atjaunināšanas intervālu, vēstures glabāšanas ilgumu un dažus citus parametrus. Ja vēlaties pilnībā rediģēt entītiju, tā ir jārediģē veidnes līmenī (veidnes līmeņa saīsne tiek parādīta formas nosaukumā), ņemot vērā, ka šīs izmaiņas ietekmēs visus hostus, kuriem šī veidne ir piesaistīta. ::: noteimportant Jebkādi entītiju pielāgojumi, kas veikti veidnes līmenī, pārrakstīs iepriekšējos entītiju pielāgojumus hosta līmenī. ::: ### Editing services Click on the *Edit* button to access the edit mode. When in edit mode, the listing is complemented with checkboxes before the entries and also these additional options: -  - add a child service to this service -  - edit this service -  - delete this service {width="600"} To [configure](/manual/it_services/service_tree#service-configuration) a new service, click on the *Create service* button in the top right-hand corner. ### Pakalpojumu rediģēšana Noklikšķiniet uz pogas *Edit*, lai piekļūtu rediģēšanas režīmam. Rediģēšanas režīmā saraksts tiek papildināts ar izvēles rūtiņām pirms ierakstiem, kā arī ar šīm papildu opcijām: -  - pievienot šim pakalpojumam pakārtotu pakalpojumu -  - rediģēt šo pakalpojumu -  - dzēst šo pakalpojumu {width="600"} Lai [konfigurētu](/manual/it_services/service_tree#service-configuration) jaunu pakalpojumu, noklikšķiniet uz pogas *Create service* augšējā labajā stūrī. ##### e {#e} The Euler's number (2.718281828459045). Example: e() ##### e {#e} Eilera skaitlis (2.718281828459045). Piemērs: e() #### Effect of maintenance periods [Maintenance](/manual/maintenance) does not automatically exclude time from the availability report. Only maintenance [configured](/manual/maintenance#configuration) as *No data collection* stops polling (so no problems are generated) and therefore leaves the availability percentage unchanged for affected triggers. #### Uzturēšanas periodu ietekme [Uzturēšana](/manual/maintenance) automātiski neizslēdz laiku no pieejamības pārskata. Tikai uzturēšana, kas [konfigurēta](/manual/maintenance#configuration) kā *Datu vākšana nenotiek*, aptur aptaujāšanu (tāpēc problēmas netiek ģenerētas) un tādējādi atstāj pieejamības procentu nemainīgu ietekmētajiem trigeriem. ##### Element configuration ##### Elementa konfigurācija #### Element The `Element` object is returned by the [`Browser`](#browser) object `findElement()`/`findElements()` methods and cannot be constructed directly. The `Element` object represents an element in the web page and provides methods to interact with it. The following methods are supported with the `Element` object. |Method|Description| |--|--------| |`getAttribute(name)`|Return an attribute value string of the element attribute (or return `null` if the specified attribute was not found).<br><br>Parameters:<br>`name` - (string) Attribute name.| |`getProperty(name)`|Return a property value string of the element property (or return `null` if the specified property was not found).<br><br>Parameters:<br>`name` - (string) Property name.| |`getText()`|Return a text value string of the element text.| |`click()`|Click on an element.| |`clear()`|Clear the content of an editable element.| |`sendKeys(keys)`|Send keys.<br><br>Parameters:<br>`keys` - (string) Keys to send.| #### Elements `Element` objekts tiek atgriezts ar [`Browser`](#browser) objekta `findElement()`/`findElements()` metodēm, un to nevar izveidot tieši. `Element` objekts attēlo elementu tīmekļa lapā un nodrošina metodes mijiedarbībai ar to. Ar `Element` objektu tiek atbalstītas šādas metodes. |Method|Description| |--|--------| |`getAttribute(name)`|Atgriež elementa atribūta vērtību kā virkni (vai atgriež `null`, ja norādītais atribūts netika atrasts).<br><br>Parameters:<br>`name` - (string) Atribūta nosaukums.| |`getProperty(name)`|Atgriež elementa īpašības vērtību kā virkni (vai atgriež `null`, ja norādītā īpašība netika atrasta).<br><br>Parameters:<br>`name` - (string) Īpašības nosaukums.| |`getText()`|Atgriež elementa teksta vērtību kā virkni.| |`click()`|Noklikšķina uz elementa.| |`clear()`|Notīra rediģējama elementa saturu.| |`sendKeys(keys)`|Nosūta taustiņsitienus.<br><br>Parameters:<br>`keys` - (string) Nosūtāmie taustiņsitieni.| **Email** The following additional elements are exported only for the *Email* media type. |Element|<|Type|Description| |-|---|---|-----------------------| |provider|<|string|Email provider.| |smtp\_server|<|string|SMTP server.| |smtp\_port|<|integer|SMTP server port to connect to.<br>Default: 25.| |smtp\_helo|<|string|SMTP helo.| |smtp\_email|<|string|Email address from which notifications will be sent.| |smtp\_security|<|string|SMTP connection security level to use.<br>Possible values:^[1](#footnotes)^ NONE (0, default), STARTTLS (1), SSL\_OR\_TLS (2).| |smtp\_verify\_host|<|string|SSL verify host for SMTP.<br>Possible values:^[1](#footnotes)^ NO (0, default), YES (1).| |smtp\_verify\_peer|<|string|SSL verify peer for SMTP.<br>Possible values:^[1](#footnotes)^ NO (0, default), YES (1).| |smtp\_authentication|<|string|SMTP authentication method to use.<br>Possible values:^[1](#footnotes)^ NONE (0, default), PASSWORD (1).| |username|<|string|Username.| |password|<|string|Authentication password.| |message\_format|<|string|Message format.<br>Possible values:^[1](#footnotes)^ TEXT (0), HTML (1, default).| ::: noteclassic See also: [Media type object](/manual/api/reference/mediatype/object) (refer to the relevant property with a matching name). ::: **Email** Tālāk norādītie papildu elementi tiek eksportēti tikai *Email* multivides tipam. |Element|<|Type|Description| |-|---|---|-----------------------| |provider|<|string|E-pasta pakalpojuma sniedzējs.| |smtp\_server|<|string|SMTP serveris.| |smtp\_port|<|integer|SMTP servera ports savienojumam.<br>Noklusējums: 25.| |smtp\_helo|<|string|SMTP helo.| |smtp\_email|<|string|E-pasta adrese, no kuras tiks sūtīti paziņojumi.| |smtp\_security|<|string|SMTP savienojuma drošības līmenis, ko izmantot.<br>Iespējamās vērtības:^[1](#footnotes)^ NONE (0, noklusējums), STARTTLS (1), SSL\_OR\_TLS (2).| |smtp\_verify\_host|<|string|SMTP SSL resursdatora pārbaude.<br>Iespējamās vērtības:^[1](#footnotes)^ NO (0, noklusējums), YES (1).| |smtp\_verify\_peer|<|string|SMTP SSL vienaudža pārbaude.<br>Iespējamās vērtības:^[1](#footnotes)^ NO (0, noklusējums), YES (1).| |smtp\_authentication|<|string|Izmantojamā SMTP autentifikācijas metode.<br>Iespējamās vērtības:^[1](#footnotes)^ NONE (0, noklusējums), PASSWORD (1).| |username|<|string|Lietotājvārds.| |password|<|string|Autentifikācijas parole.| |message\_format|<|string|Ziņojuma formāts.<br>Iespējamās vērtības:^[1](#footnotes)^ TEXT (0), HTML (1, noklusējums).| ::: noteclassic Skatiet arī: [Media type object](/manual/api/reference/mediatype/object) (skatiet attiecīgo īpašību ar atbilstošu nosaukumu). ::: #### Ember+ A new plugin for direct monitoring of Ember+ by Zabbix agent 2 has been added. For more information, see: - [Ember+ plugin readme](https://git.zabbix.com/projects/AP/repos/ember-plus/browse) - [Agent 2 items](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#ember.get) - [Ember+ plugin parameters](/manual/appendix/config/zabbix_agent2_plugins/ember_plus_plugin) - [Agent 2 installation](/manual/concepts/agent2#installation) #### Ember+ Ir pievienots jauns spraudnis Ember+ tiešai uzraudzībai, izmantojot Zabbix aģents 2. Papildu informāciju skatiet: - [Ember+ spraudņa readme](https://git.zabbix.com/projects/AP/repos/ember-plus/browse) - [Aģents 2 vienumi](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#ember.get) - [Ember+ spraudņa parametri](/manual/appendix/config/zabbix_agent2_plugins/ember_plus_plugin) - [Aģents 2 instalēšana](/manual/concepts/agent2#installation) ##### ember.get[<uri>,<path>] {#ember.get} <br> Returns the result of the required device.<br> Return value: *JSON object*. Parameters: - **uri** - Ember+ device URI. Default: 127.0.0.1:9998;<br> - **path** - OID path to device. Empty by default, returns root collection data.<br> ##### ember.get[<uri>,<path>] {#ember.get} <br> Atgriež pieprasītās ierīces rezultātu.<br> Atgrieztā vērtība: *JSON objekts*. Parametri: - **uri** - Ember+ ierīces URI. Noklusējums: 127.0.0.1:9998;<br> - **path** - OID ceļš uz ierīci. Pēc noklusējuma tukšs, atgriež saknes kolekcijas datus.<br> #### Empty values allowed in agent 2 plugin configuration Empty values are now allowed in plugin-related configuration parameters on Zabbix agent 2. #### Tukšas vērtības ir atļautas aģents 2 spraudņa konfigurācijā Tagad tukšas vērtības ir atļautas ar spraudņiem saistītajos konfigurācijas parametros Zabbix aģents 2. ##### EnableGlobalScripts Enable global scripts on Zabbix server.<br> Note: Global script execution is enabled by default. However, for new installations starting with Zabbix 7.0, EnableGlobalScripts is explicitly set to `0` (disabled). Default: `1`<br> Values: 0 - disable; 1 - enable ##### EnableGlobalScripts Iespējot globālos skriptus Zabbix serverī.<br> Piezīme: globālo skriptu izpilde pēc noklusējuma ir iespējota. Tomēr jaunām instalācijām, sākot ar Zabbix 7.0, EnableGlobalScripts ir skaidri iestatīts uz `0` (atspējots). Noklusējums: `1`<br> Vērtības: 0 - atspējot; 1 - iespējot ##### EnablePersistentBuffer Enable the usage of local persistent storage for active items. If persistent storage is disabled, the memory buffer will be used. Default: `0`<br> Values: 0 - disabled, 1 - enabled ##### EnablePersistentBuffer Iespējot lokālās pastāvīgās krātuves izmantošanu aktīvajiem vienumiem. Ja pastāvīgā krātuve ir atspējota, tiks izmantots atmiņas buferis. Noklusējums: `0`<br> Vērtības: 0 - atspējots, 1 - iespējots ##### EnablePersistentBuffer Enable the usage of local persistent storage for active items. If persistent storage is disabled, the memory buffer will be used. Default: `0`<br> Values: 0 - disabled, 1 - enabled ##### EnablePersistentBuffer Iespējot lokālās pastāvīgās krātuves izmantošanu aktīvajiem vienumiem. Ja pastāvīgā krātuve ir atspējota, tiks izmantots atmiņas buferis. Noklusējums: `0`<br> Vērtības: 0 - atspējots, 1 - iespējots ##### EnableRemoteCommands Allow remote commands from Zabbix server.<br> This parameter is **deprecated**, use `AllowKey=system.run[*]` or `DenyKey=system.run[*]` instead.<br> It is an internal alias for `AllowKey`/`DenyKey` parameters depending on value: - 0 - `DenyKey=system.run[*]` - 1 - `AllowKey=system.run[*]` Default: `0`<br> Values: 0 - do not allow, 1 - allow ##### EnableRemoteCommands Atļaut attālinātās komandas no Zabbix serveris.<br> Šis parametrs ir **novecojis**, tā vietā izmantojiet `AllowKey=system.run[*]` vai `DenyKey=system.run[*]`.<br> Tas ir iekšējs aizstājvārds `AllowKey`/`DenyKey` parametriem atkarībā no vērtības: - 0 - `DenyKey=system.run[*]` - 1 - `AllowKey=system.run[*]` Noklusējums: `0`<br> Vērtības: 0 - neatļaut, 1 - atļaut ##### EnableRemoteCommands Allow remote commands from Zabbix server.<br> This parameter is **deprecated**, use `AllowKey=system.run[*]` or `DenyKey=system.run[*]` instead.<br> It is an internal alias for `AllowKey`/`DenyKey` parameters depending on value: - 0 - `DenyKey=system.run[*]` - 1 - `AllowKey=system.run[*]` Default: `0`<br> Values: 0 - do not allow, 1 - allow ##### EnableRemoteCommands Atļaut attālinātas komandas no Zabbix serveris.<br> Šis parametrs ir **novecojis**, tā vietā izmantojiet `AllowKey=system.run[*]` vai `DenyKey=system.run[*]`.<br> Tas ir iekšējs aizstājvārds `AllowKey`/`DenyKey` parametriem atkarībā no vērtības: - 0 - `DenyKey=system.run[*]` - 1 - `AllowKey=system.run[*]` Noklusējums: `0`<br> Vērtības: 0 - neatļaut, 1 - atļaut ##### EnableRemoteCommands Whether remote commands from Zabbix server are allowed. Default: `0`<br> Values: 0 - not allowed; 1 - allowed ##### EnableRemoteCommands Vai ir atļautas attālinātās komandas no Zabbix serveris. Noklusējums: `0`<br> Vērtības: 0 - nav atļautas; 1 - atļautas #### Enabling a host Enable host monitoring, that is, set its status to "0". [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "host.update", "params": { "hostid": "10126", "status": 0 }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10126" ] }, "id": 1 } ``` #### Hosta iespējošana Iespējojiet hosta uzraudzību, tas ir, iestatiet tā statusu uz "0". [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "host.update", "params": { "hostid": "10126", "status": 0 }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10126" ] }, "id": 1 } ``` #### Enabling a media type Enable a media type, that is, set its status to "0". [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "mediatype.update", "params": { "mediatypeid": "6", "status": "0" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "mediatypeids": [ "6" ] }, "id": 1 } ``` #### Mediju tipa iespējošana Iespējojiet mediju tipu, tas ir, iestatiet tā statusu uz "0". [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "mediatype.update", "params": { "mediatypeid": "6", "status": "0" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "mediatypeids": [ "6" ] }, "id": 1 } ``` #### Enabling an item Enable an item, that is, set its status to "0". [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "item.update", "params": { "itemid": "10092", "status": 0 }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "10092" ] }, "id": 1 } ``` #### Vienuma iespējošana Iespējojiet vienumu, tas ir, iestatiet tā statusu uz "0". [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "item.update", "params": { "itemid": "10092", "status": 0 }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "10092" ] }, "id": 1 } ``` #### Enabling a trigger Enable a trigger, that is, set its status to "0". [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "trigger.update", "params": { "triggerid": "13938", "status": 0 }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "13938" ] }, "id": 1 } ``` #### Trigera iespējošana Iespējojiet trigeri, tas ir, iestatiet tā statusu uz "0". [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "trigger.update", "params": { "triggerid": "13938", "status": 0 }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "13938" ] }, "id": 1 } ``` #### Enabling a trigger prototype Enable a trigger prototype, that is, set its status to "0". [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "triggerprototype.update", "params": { "triggerid": "13938", "status": 0 }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "13938" ] }, "id": 1 } ``` #### Trigera prototipa iespējošana Iespējojiet trigera prototipu, tas ir, iestatiet tā statusu uz "0". [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "triggerprototype.update", "params": { "triggerid": "13938", "status": 0 }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "13938" ] }, "id": 1 } ``` #### Enabling a user group and updating permissions Enable a user group and provide read-write access for it to host groups "2" and "4". [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "usergroup.update", "params": { "usrgrpid": "17", "users_status": "0", "hostgroup_rights": [ { "id": "2", "permission": 3 }, { "id": "4", "permission": 3 } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "usrgrpids": [ "17" ] }, "id": 1 } ``` #### Lietotāju grupas iespējošana un atļauju atjaunināšana Iespējojiet lietotāju grupu un piešķiriet tai lasīšanas-rakstīšanas piekļuvi hostu grupām "2" un "4". [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "usergroup.update", "params": { "usrgrpid": "17", "users_status": "0", "hostgroup_rights": [ { "id": "2", "permission": 3 }, { "id": "4", "permission": 3 } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "usrgrpids": [ "17" ] }, "id": 1 } ``` #### Enabling a web scenario Enable a web scenario, that is, set its status to "0". [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "httptest.update", "params": { "httptestid": "5", "status": 0 }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "httptestids": [ "5" ] }, "id": 1 } ``` #### Tīmekļa scenārija iespējošana Iespējojiet tīmekļa scenāriju, tas ir, iestatiet tā statusu uz "0". [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "httptest.update", "params": { "httptestid": "5", "status": 0 }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "httptestids": [ "5" ] }, "id": 1 } ``` #### Enabling Content Security Policy (CSP) on the web server To protect Zabbix frontend against Cross Site Scripting (XSS), data injection, and similar attacks, we recommend enabling Content Security Policy on the web server. To do so, configure the web server to return the [HTTP header](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Security-Policy). ::: noteimportant The following CSP header configuration is only for the default Zabbix frontend installation and for cases when all content originates from the site's domain (excluding subdomains). A different CSP header configuration may be required if you are, for example, configuring the [*URL*](/manual/web_interface/frontend_sections/dashboards/widgets/url) widget to display content from the site's subdomains or external domains, switching from *OpenStreetMap* to another map engine, or adding external CSS or widgets. If you're using the Duo Universal Prompt [multi-factor authentication](/manual/web_interface/frontend_sections/users/authentication/mfa) method, make sure to add "duo.com" to the CSP directive in your virtual host's configuration file. ::: To enable CSP for your Zabbix frontend in Apache configuration, follow these steps: 1\. Locate your virtual host's configuration file: - `/etc/httpd/conf/httpd.conf` on RHEL-based systems - `/etc/apache2/sites-available/000-default.conf` on Debian/Ubuntu 2\. Add the following directive to your virtual host's configuration file: ```ini <VirtualHost *:*> Header set Content-Security-Policy: "default-src 'self' *.openstreetmap.org; script-src 'self' 'unsafe-inline' 'unsafe-eval'; connect-src 'self'; img-src 'self' data: *.openstreetmap.org; style-src 'self' 'unsafe-inline'; base-uri 'self'; form-action 'self';" </VirtualHost> ``` 3\. Restart the Apache service to apply the changes: ```bash # On RHEL-based systems: systemctl restart httpd.service # On Debian/Ubuntu systemctl restart apache2.service ``` #### Satura drošības politikas (CSP) iespējošana tīmekļa serverī Lai aizsargātu Zabbix lietotāja saskarni pret Cross Site Scripting (XSS), datu ievadīšanu un līdzīgiem uzbrukumiem, mēs iesakām tīmekļa serverī iespējot Content Security Policy. Lai to izdarītu, konfigurējiet tīmekļa serveri tā, lai tas atgrieztu [HTTP galveni](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Security-Policy). ::: noteimportant Tālāk norādītā CSP galvenes konfigurācija ir paredzēta tikai noklusējuma Zabbix lietotāja saskarnes instalācijai un gadījumiem, kad viss saturs nāk no vietnes domēna (izņemot apakšdomēnus). Var būt nepieciešama cita CSP galvenes konfigurācija, ja, piemēram, konfigurējat [*URL*](/manual/web_interface/frontend_sections/dashboards/widgets/url) logrīku, lai attēlotu saturu no vietnes apakšdomēniem vai ārējiem domēniem, pārslēdzaties no *OpenStreetMap* uz citu kartes dzinēju vai pievienojat ārēju CSS vai logrīkus. Ja izmantojat Duo Universal Prompt [vairāku faktoru autentifikācijas](/manual/web_interface/frontend_sections/users/authentication/mfa) metodi, noteikti pievienojiet "duo.com" CSP direktīvai sava virtuālā resursdatora konfigurācijas failā. ::: Lai Apache konfigurācijā iespējotu CSP jūsu Zabbix lietotāja saskarnei, veiciet šīs darbības: 1\. Atrodiet sava virtuālā resursdatora konfigurācijas failu: - `/etc/httpd/conf/httpd.conf` RHEL bāzētās sistēmās - `/etc/apache2/sites-available/000-default.conf` Debian/Ubuntu 2\. Pievienojiet šādu direktīvu sava virtuālā resursdatora konfigurācijas failam: ```ini <VirtualHost *:*> Header set Content-Security-Policy: "default-src 'self' *.openstreetmap.org; script-src 'self' 'unsafe-inline' 'unsafe-eval'; connect-src 'self'; img-src 'self' data: *.openstreetmap.org; style-src 'self' 'unsafe-inline'; base-uri 'self'; form-action 'self';" </VirtualHost> ``` 3\. Restartējiet Apache pakalpojumu, lai piemērotu izmaiņas: ```bash # On RHEL-based systems: systemctl restart httpd.service # On Debian/Ubuntu systemctl restart apache2.service ``` ### Enabling high availability ### Augstas pieejamības iespējošana #### Enabling HTTP Strict Transport Security (HSTS) on the web server To protect Zabbix frontend against protocol downgrade attacks, we recommend enabling the [HSTS](https://en.wikipedia.org/wiki/HTTP_Strict_Transport_Security) policy on the web server. To enable the HSTS policy for your Zabbix frontend in Apache configuration, follow these steps: 1\. Locate your virtual host's configuration file: - `/etc/httpd/conf/httpd.conf` on RHEL-based systems - `/etc/apache2/sites-available/000-default.conf` on Debian/Ubuntu 2\. Add the following directive to your virtual host's configuration file: ```ini <VirtualHost *:*> Header set Strict-Transport-Security "max-age=31536000" </VirtualHost> ``` 3\. Restart the Apache service to apply the changes: ```bash # On RHEL-based systems: systemctl restart httpd.service # On Debian/Ubuntu systemctl restart apache2.service ``` #### HTTP Strict Transport Security (HSTS) iespējošana tīmekļa serverī Lai aizsargātu Zabbix lietotāja saskarni pret protokola pazemināšanas uzbrukumiem, iesakām tīmekļa serverī iespējot [HSTS](https://en.wikipedia.org/wiki/HTTP_Strict_Transport_Security) politiku. Lai Apache konfigurācijā iespējotu HSTS politiku jūsu Zabbix lietotāja saskarnei, veiciet šādas darbības: 1\. Atrodiet sava virtuālā resursdatora konfigurācijas failu: - `/etc/httpd/conf/httpd.conf` RHEL bāzētās sistēmās - `/etc/apache2/sites-available/000-default.conf` Debian/Ubuntu 2\. Pievienojiet šādu direktīvu sava virtuālā resursdatora konfigurācijas failam: ```ini <VirtualHost *:*> Header set Strict-Transport-Security "max-age=31536000" </VirtualHost> ``` 3\. Restartējiet Apache pakalpojumu, lai piemērotu izmaiņas: ```bash # On RHEL-based systems: systemctl restart httpd.service # On Debian/Ubuntu systemctl restart apache2.service ``` #### Enabling MIB files On RedHat-based systems, MIB files should be enabled by default. On Debian-based systems, you have to edit the file `/etc/snmp/snmp.conf` and comment out the line that says `mibs :` # As the snmp packages come without MIB files due to license reasons, loading # of MIBs is disabled by default. If you added the MIBs you can re-enable # loading them by commenting out the following line. mibs : #### MIB failu iespējošana Sistēmās, kuru pamatā ir RedHat, MIB failiem pēc noklusējuma jābūt iespējotiem. Sistēmās, kuru pamatā ir Debian, jums ir jārediģē fails `/etc/snmp/snmp.conf` un jāizkomentē rinda `mibs :` # Tā kā snmp pakotnes tiek piegādātas bez MIB failiem licencēšanas iemeslu dēļ, ielāde # MIB failiem pēc noklusējuma ir atspējota. Ja esat pievienojis MIB failus, varat atkārtoti iespējot # to ielādi, izkomentējot šādu rindu. mibs : #### Enabling multiple hosts Enable monitoring of two hosts, that is, set their status to "0". [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "host.massupdate", "params": { "hosts": [ { "hostid": "69665" }, { "hostid": "69666" } ], "status": 0 }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "69665", "69666" ] }, "id": 1 } ``` #### Vairāku hosts iespējošana Iespējojiet divu hosts uzraudzību, tas ir, iestatiet to statusu uz "0". [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "host.massupdate", "params": { "hosts": [ { "hostid": "69665" }, { "hostid": "69666" } ], "status": 0 }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "69665", "69666" ] }, "id": 1 } ``` #### Enabling remote JMX monitoring for Java application A Java application does not need any additional software installed, but it needs to be started with the command-line options specified below to have support for remote JMX monitoring. As a bare minimum, if you just wish to get started by monitoring a simple Java application on a local host with no security enforced, start it with these options: java \ -Dcom.sun.management.jmxremote \ -Dcom.sun.management.jmxremote.port=12345 \ -Dcom.sun.management.jmxremote.authenticate=false \ -Dcom.sun.management.jmxremote.ssl=false \ -Dcom.sun.management.jmxremote.registry.ssl=false \ -jar /path/to/your/application.jar This makes Java listen for incoming JMX connections on port 12345, from local host only, and tells it not to require authentication or SSL. If you want to allow connections on another interface, set the -Djava.rmi.server.hostname parameter to the IP of that interface. If you wish to be more stringent about security, there are many other Java options available to you. For instance, the next example starts the application with a more versatile set of options and opens it to a wider network, not just local host. java \ -Djava.rmi.server.hostname=192.168.3.14 \ -Dcom.sun.management.jmxremote \ -Dcom.sun.management.jmxremote.port=12345 \ -Dcom.sun.management.jmxremote.authenticate=true \ -Dcom.sun.management.jmxremote.password.file=/etc/java-6-openjdk/management/jmxremote.password \ -Dcom.sun.management.jmxremote.access.file=/etc/java-6-openjdk/management/jmxremote.access \ -Dcom.sun.management.jmxremote.ssl=true \ -Dcom.sun.management.jmxremote.registry.ssl=true \ -Djavax.net.ssl.keyStore=$YOUR_KEY_STORE \ -Djavax.net.ssl.keyStorePassword=$YOUR_KEY_STORE_PASSWORD \ -Djavax.net.ssl.trustStore=$YOUR_TRUST_STORE \ -Djavax.net.ssl.trustStorePassword=$YOUR_TRUST_STORE_PASSWORD \ -Dcom.sun.management.jmxremote.ssl.need.client.auth=true \ -jar /path/to/your/application.jar Most (if not all) of these settings can be specified in `$JRE/lib/management/management.properties` (or wherever that file is on your system). Note that if you wish to use SSL, you have to modify startup.sh script by adding `-Djavax.net.ssl.*` options to Java gateway, so that it knows where to find key and trust stores. See [Monitoring and Management Using JMX](http://download.oracle.com/javase/1.5.0/docs/guide/management/agent.html) for a detailed description. #### Attālās JMX uzraudzības iespējošana Java lietojumprogrammai Java lietojumprogrammai nav nepieciešama papildu programmatūras instalēšana, taču tā ir jāpalaiž ar tālāk norādītajām komandrindas opcijām, lai nodrošinātu attālās JMX uzraudzības atbalstu. Kā minimālā prasība, ja vēlaties vienkārši sākt ar vienkāršas Java lietojumprogrammas uzraudzību lokālajā hostā bez ieviestas drošības, palaidiet to ar šādām opcijām: java \ -Dcom.sun.management.jmxremote \ -Dcom.sun.management.jmxremote.port=12345 \ -Dcom.sun.management.jmxremote.authenticate=false \ -Dcom.sun.management.jmxremote.ssl=false \ -Dcom.sun.management.jmxremote.registry.ssl=false \ -jar /path/to/your/application.jar Tas liek Java klausīties ienākošos JMX savienojumus 12345. portā tikai no lokālā hosta un norāda, ka nav nepieciešama autentifikācija vai SSL. Ja vēlaties atļaut savienojumus citā saskarnē, iestatiet -Djava.rmi.server.hostname parametru uz šīs saskarnes IP adresi. Ja vēlaties ievērot stingrākas drošības prasības, jums ir pieejamas daudzas citas Java opcijas. Piemēram, nākamais piemērs palaiž lietojumprogrammu ar daudzpusīgāku opciju kopu un atver to plašākam tīklam, ne tikai lokālajam hostam. java \ -Djava.rmi.server.hostname=192.168.3.14 \ -Dcom.sun.management.jmxremote \ -Dcom.sun.management.jmxremote.port=12345 \ -Dcom.sun.management.jmxremote.authenticate=true \ -Dcom.sun.management.jmxremote.password.file=/etc/java-6-openjdk/management/jmxremote.password \ -Dcom.sun.management.jmxremote.access.file=/etc/java-6-openjdk/management/jmxremote.access \ -Dcom.sun.management.jmxremote.ssl=true \ -Dcom.sun.management.jmxremote.registry.ssl=true \ -Djavax.net.ssl.keyStore=$YOUR_KEY_STORE \ -Djavax.net.ssl.keyStorePassword=$YOUR_KEY_STORE_PASSWORD \ -Djavax.net.ssl.trustStore=$YOUR_TRUST_STORE \ -Djavax.net.ssl.trustStorePassword=$YOUR_TRUST_STORE_PASSWORD \ -Dcom.sun.management.jmxremote.ssl.need.client.auth=true \ -jar /path/to/your/application.jar Lielāko daļu (ja ne visus) no šiem iestatījumiem var norādīt `$JRE/lib/management/management.properties` (vai vietā, kur šis fails atrodas jūsu sistēmā). Ņemiet vērā, ka, ja vēlaties izmantot SSL, jums ir jāmaina startup.sh skripts, pievienojot `-Djavax.net.ssl.*` opcijas Java gateway, lai tas zinātu, kur atrast atslēgu un uzticamības krātuves. Detalizētu aprakstu skatiet [Monitoring and Management Using JMX](http://download.oracle.com/javase/1.5.0/docs/guide/management/agent.html). ### Encoding settings To make sure that the acquired data are not corrupted you may specify the correct encoding for processing the check (e.g. 'vfs.file.contents') in the `encoding` parameter. The list of supported encodings (code page identifiers) may be found in documentation for [libiconv](http://www.gnu.org/software/libiconv/) (GNU Project) or in Microsoft Windows SDK documentation for ["Code Page Identifiers"](https://learn.microsoft.com/en-us/windows/win32/intl/code-page-identifiers). Note that Microsoft sometimes marks some code pages as "available only to managed applications" — i.e. exposed only via the .NET runtime and not available through the native Win32 APIs. Zabbix agent implements its own encoding-conversion logic, therefore those code pages are supported by Zabbix agent even when the native Windows functions do not provide them. If no encoding is specified in the `encoding` parameter the following resolution strategies are applied: - If encoding is not specified (or is an empty string) it is assumed to be UTF-8, the data is processed "as-is"; - BOM analysis - applicable for items 'vfs.file.contents', 'vfs.file.regexp', 'vfs.file.regmatch'. An attempt is made to determine the correct encoding by using the byte order mark (BOM) at the beginning of the file. If BOM is not present - standard resolution (see above) is applied instead. ### Kodējuma iestatījumi Lai nodrošinātu, ka iegūtie dati netiek bojāti, `encoding` parametrā var norādīt pareizo kodējumu pārbaudes apstrādei (piem., 'vfs.file.contents'). Atbalstīto kodējumu (kodu lapu identifikatoru) sarakstu var atrast dokumentācijā par [libiconv](http://www.gnu.org/software/libiconv/) (GNU Project) vai Microsoft Windows SDK dokumentācijā sadaļā ["Code Page Identifiers"](https://learn.microsoft.com/en-us/windows/win32/intl/code-page-identifiers). Ņemiet vērā, ka Microsoft dažkārt atzīmē dažas kodu lapas kā "pieejamas tikai pārvaldītām lietotnēm" — t. i., tās ir pieejamas tikai caur .NET izpildlaiku un nav pieejamas, izmantojot vietējās Win32 API. Zabbix aģents īsteno savu kodējuma konvertēšanas loģiku, tāpēc šīs kodu lapas ir atbalstītas Zabbix aģentā pat tad, ja vietējās Windows funkcijas tās nenodrošina. Ja `encoding` parametrā nav norādīts kodējums, tiek piemērotas šādas noteikšanas stratēģijas: - Ja kodējums nav norādīts (vai ir tukša virkne), tiek pieņemts, ka tas ir UTF-8, un dati tiek apstrādāti "kā ir"; - BOM analīze - attiecas uz vienumiem 'vfs.file.contents', 'vfs.file.regexp', 'vfs.file.regmatch'. Tiek mēģināts noteikt pareizo kodējumu, izmantojot baitu secības marķieri (BOM) faila sākumā. Ja BOM nav pieejams, tā vietā tiek piemērota standarta noteikšana (skat. iepriekš). ## Encryption ## Šifrēšana ## Encryption tab The *Encryption* tab lets you configure TLS [encryption](/manual/encryption) between Zabbix components by uploading the required certificate files. To enable secure communication using certificates, select *CERTIFICATE* and upload the following files from your computer: - *Root CA certificates* - used to verify the authenticity of peer certificates. Click *Choose file* and select the file containing trusted Root CA certificates (typically a `.crt` or `.pem` file, PEM-encoded). - *Certificate chain* - represents the chain of trust for your own certificate. Click *Choose file* and select the PEM-encoded file (e.g., `.crt` or `.pem`) that includes your certificate and any intermediate CA certificates. - *Private key* - the private key corresponding to your certificate. Click *Choose file* and select the PEM-encoded `.key` file. - *Revoked certificates* (optional) - if you maintain a Certificate Revocation List (CRL), click *Choose file* and select the CRL file to specify certificates that should no longer be trusted. After selecting the files, click *Save*. The files will be uploaded, validated, and applied to configure TLS encryption between Zabbix components. {width="600"} ## Šifrēšanas cilne Cilne *Šifrēšana* ļauj konfigurēt TLS [šifrēšanu](/manual/encryption) starp Zabbix komponentiem, augšupielādējot nepieciešamos sertifikātu failus. Lai iespējotu drošu saziņu, izmantojot sertifikātus, atlasiet *CERTIFICATE* un augšupielādējiet no sava datora šādus failus: - *Saknes CA sertifikāti* — tiek izmantoti, lai pārbaudītu otras puses sertifikātu autentiskumu. Noklikšķiniet uz *Choose file* un atlasiet failu, kurā ir uzticami saknes CA sertifikāti (parasti `.crt` vai `.pem` fails PEM kodējumā). - *Sertifikātu ķēde* — attēlo uzticamības ķēdi jūsu sertifikātam. Noklikšķiniet uz *Choose file* un atlasiet PEM kodētu failu (piemēram, `.crt` vai `.pem`), kas ietver jūsu sertifikātu un visus starpniek-CA sertifikātus. - *Privātā atslēga* — privātā atslēga, kas atbilst jūsu sertifikātam. Noklikšķiniet uz *Choose file* un atlasiet PEM kodētu `.key` failu. - *Atsauktie sertifikāti* (neobligāti) — ja uzturat sertifikātu atsaukšanas sarakstu (CRL), noklikšķiniet uz *Choose file* un atlasiet CRL failu, lai norādītu sertifikātus, kuriem vairs nevajadzētu uzticēties. Pēc failu atlasīšanas noklikšķiniet uz *Save*. Faili tiks augšupielādēti, pārbaudīti un piemēroti, lai konfigurētu TLS šifrēšanu starp Zabbix komponentiem. {width="600"} ##### Encryption The **Encryption** tab allows you to require [encrypted](/manual/encryption) connections with the host. |Parameter|Description| |--|--------| |*Connections to host*|How Zabbix server or proxy connects to Zabbix agent on a host: no encryption (default), using PSK (pre-shared key) or certificate.| |*Connections from host*|Select what type of connections are allowed from the host (i.e. from Zabbix agent and Zabbix sender). Several connection types can be selected at the same time (useful for testing and switching to other connection type). Default is "No encryption".| |*Issuer*|Allowed issuer of certificate. Certificate is first validated with CA (certificate authority). If it is valid, signed by the CA, then the *Issuer* field can be used to further restrict allowed CA. This field is intended to be used if your Zabbix installation uses certificates from multiple CAs. If this field is empty then any CA is accepted.| |*Subject*|Allowed subject of certificate. Certificate is first validated with CA. If it is valid, signed by the CA, then the *Subject* field can be used to allow only one value of *Subject* string. If this field is empty then any valid certificate signed by the configured CA is accepted.| |*PSK identity*|Pre-shared key identity string.<br>Do not put sensitive information in the PSK identity, it is transmitted unencrypted over the network to inform a receiver which PSK to use.| |*PSK*|Pre-shared key (hex-string). Maximum length: 512 hex-digits (256-byte PSK) if Zabbix uses GnuTLS or OpenSSL library, 64 hex-digits (32-byte PSK) if Zabbix uses mbed TLS (PolarSSL) library. Example: 1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952| ##### Šifrēšana Cilne **Šifrēšana** ļauj pieprasīt [šifrētus](/manual/encryption) savienojumus ar hostu. |Parameter|Description| |--|--------| |*Connections to host*|Kā Zabbix serveris vai starpniekserveris savienojas ar Zabbix aģentu uz hosta: bez šifrēšanas (noklusējums), izmantojot PSK (iepriekš koplietota atslēga) vai sertifikātu.| |*Connections from host*|Atlasiet, kāda veida savienojumi ir atļauti no hosta (t. i., no Zabbix aģenta un Zabbix sender). Vienlaikus var atlasīt vairākus savienojumu veidus (noderīgi testēšanai un pārslēgšanai uz citu savienojuma veidu). Noklusējums ir "No encryption".| |*Issuer*|Atļautais sertifikāta izdevējs. Sertifikāts vispirms tiek validēts ar CA (sertifikātu centru). Ja tas ir derīgs un parakstīts ar CA, tad lauku *Issuer* var izmantot, lai papildus ierobežotu atļauto CA. Šis lauks ir paredzēts izmantošanai, ja jūsu Zabbix instalācijā tiek izmantoti sertifikāti no vairākām CA. Ja šis lauks ir tukšs, tiek pieņemta jebkura CA.| |*Subject*|Atļautais sertifikāta subjekts. Sertifikāts vispirms tiek validēts ar CA. Ja tas ir derīgs un parakstīts ar CA, tad lauku *Subject* var izmantot, lai atļautu tikai vienu *Subject* virknes vērtību. Ja šis lauks ir tukšs, tiek pieņemts jebkurš derīgs sertifikāts, ko parakstījusi konfigurētā CA.| |*PSK identity*|Iepriekš koplietotās atslēgas identitātes virkne.<br>Neievietojiet sensitīvu informāciju PSK identitātē, jo tā tiek pārsūtīta tīklā nešifrētā veidā, lai saņēmējam norādītu, kuru PSK izmantot.| |*PSK*|Iepriekš koplietotā atslēga (heksadecimāla virkne). Maksimālais garums: 512 heksadecimālie cipari (256 baitu PSK), ja Zabbix izmanto GnuTLS vai OpenSSL bibliotēku, 64 heksadecimālie cipari (32 baitu PSK), ja Zabbix izmanto mbed TLS (PolarSSL) bibliotēku. Piemērs: 1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952| ### Encryption with certificate authority verification ### Šifrēšana ar sertifikātu iestādes verifikāciju ### Encryption with certificate authority verification Copy required MySQL CA to the Zabbix frontend server, assign proper permissions to allow the webserver to read this file. ::: noteclassic This mode doesn't work on SLES 12 and RHEL 7 due to older MySQL libraries. ::: ### Šifrēšana ar sertifikātu iestādes verifikāciju Kopējiet nepieciešamo MySQL CA uz Zabbix lietotāja saskarnes serveri un piešķiriet atbilstošas atļaujas, lai tīmekļa serveris varētu nolasīt šo failu. ::: noteclassic Šis režīms nedarbojas SLES 12 un RHEL 7 dēļ vecākām MySQL bibliotēkām. ::: ### Encryption with full verification ### Šifrēšana ar pilnu verifikāciju ### Encryption with full verification ### Šifrēšana ar pilnu verifikāciju #### Enforcing root URL redirect to Zabbix SSL On RHEL-based systems, add a virtual host to Apache configuration (`/etc/httpd/conf/httpd.conf`) and set a permanent redirect for document root to Zabbix SSL URL. Note that `example.com` should be replaced with the actual name of the server. ```ini # Add lines: <VirtualHost *:*> ServerName example.com Redirect permanent / https://example.com </VirtualHost> ``` Restart the Apache service to apply the changes: ```bash systemctl restart httpd.service ``` #### Saknes URL novirzīšanas uz Zabbix SSL piespiešana Uz RHEL bāzētām sistēmām pievienojiet virtuālo hostu Apache konfigurācijai (`/etc/httpd/conf/httpd.conf`) un iestatiet pastāvīgu dokumentu saknes novirzīšanu uz Zabbix SSL URL. Ņemiet vērā, ka `example.com` ir jāaizstāj ar faktisko servera nosaukumu. ```ini # Pievienojiet rindas: <VirtualHost *:*> ServerName example.com Redirect permanent / https://example.com </VirtualHost> ``` Pārstartējiet Apache pakalpojumu, lai piemērotu izmaiņas: ```bash systemctl restart httpd.service ``` #### Enforcing Secure and SameSite session cookies in Zabbix When configuring Zabbix, it is essential to enforce secure and SameSite attributes for session cookies to enhance security and prevent cross-site request forgery (CSRF) attacks. However, enforcing ``SameSite=Strict`` may cause issues in certain scenarios, such as: - Dashboard URL widgets displaying "user not logged in" when embedding same-domain iframes. - Users accessing the dashboard via HTTP instead of HTTPS may face login issues. - Inability to share URLs to specific Zabbix menu sections or hosts. To mitigate these issues, users should have a way to adjust the SameSite policy. 1\. Secure cookies Setting the ``secure`` flag ensures that cookies are only transmitted over HTTPS, preventing exposure over unencrypted connections. To enable secure cookies in Zabbix, add or modify the following setting in the web server configuration: For Apache: Header always edit Set-Cookie ^(.*)$ $1;Secure For Nginx: proxy_cookie_path / "/; Secure"; Ensure that your Zabbix frontend is accessed via HTTPS; otherwise, cookies with the ``Secure`` flag will not be sent. 2\. Configuring the SameSite attribute Web server settings can also enforce the SameSite attribute: For Apache: <IfModule mod_headers.c> Header onsuccess edit Set-Cookie (.*) "$1; SameSite=Strict" </IfModule> For Nginx (version 1.19.3+): proxy_cookie_flags ~ samesite=Strict; # Replace ~ with 'zbx_session' for specificity #### Drošu un SameSite sesijas sīkfailu ieviešana Zabbix Konfigurējot Zabbix, ir svarīgi piespiest sesijas sīkfailiem izmantot drošos un SameSite atribūtus, lai uzlabotu drošību un novērstu starpvietņu pieprasījumu viltošanas (CSRF) uzbrukumus. Tomēr ``SameSite=Strict`` ieviešana var radīt problēmas noteiktos scenārijos, piemēram: - Informācijas paneļa URL sīkrīki rāda "user not logged in", ja tiek iegulti viena domēna iframe. - Lietotāji, kas piekļūst informācijas panelim, izmantojot HTTP, nevis HTTPS, var saskarties ar pieteikšanās problēmām. - Nav iespējams kopīgot URL uz konkrētām Zabbix izvēlnes sadaļām vai hostiem. Lai mazinātu šīs problēmas, lietotājiem jābūt iespējai pielāgot SameSite politiku. 1\. Drošie sīkfaili Iestatot ``secure`` karodziņu, tiek nodrošināts, ka sīkfaili tiek pārsūtīti tikai pa HTTPS, tādējādi novēršot to atklāšanu nešifrētos savienojumos. Lai Zabbix iespējotu drošos sīkfailus, tīmekļa servera konfigurācijā pievienojiet vai modificējiet šādu iestatījumu: Apache: Header always edit Set-Cookie ^(.*)$ $1;Secure Nginx: proxy_cookie_path / "/; Secure"; Pārliecinieties, ka jūsu Zabbix lietotāja saskarne ir pieejama, izmantojot HTTPS; pretējā gadījumā sīkfaili ar ``Secure`` karodziņu netiks nosūtīti. 2\. SameSite atribūta konfigurēšana Tīmekļa servera iestatījumi var arī piespiest SameSite atribūtu: Apache: <IfModule mod_headers.c> Header onsuccess edit Set-Cookie (.*) "$1; SameSite=Strict" </IfModule> Nginx (versija 1.19.3+): proxy_cookie_flags ~ samesite=Strict; # Replace ~ with 'zbx_session' for specificity #### Enhanced precision in net.dns.get query time The [``net.dns.get``](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#net.dns.get) item now reports the ``query_time`` attribute with microsecond precision, increasing from two to six decimal places. For more details on the return values, refer to the [Return values for net.dns.get](/manual/appendix/items/return_values_net_dns_get) page. #### Uzlabota precizitāte net.dns.get vaicājuma laikā [``net.dns.get``](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#net.dns.get) vienums tagad atgriež ``query_time`` atribūtu ar mikrosekundes precizitāti, palielinot decimāldaļu skaitu no divām līdz sešām. Plašāku informāciju par atgrieztajām vērtībām skatiet lapā [Return values for net.dns.get](/manual/appendix/items/return_values_net_dns_get). ##### Entity uniqueness criteria When adding entities (items, triggers, etc.) from a template it is important to know what of those entities already exist on the host and need to be updated and what entities differ. The uniqueness criteria for deciding upon the sameness/difference are: - for items - the item key; - for triggers - trigger name and expression; - for custom graphs - graph name and its items. ##### Entītiju unikalitātes kritēriji Pievienojot entītijas (vienumus, trigerus u.c.) no veidnes, ir svarīgi zināt, kuras no šīm entītijām jau pastāv hostā un ir jāatjaunina, un kuras entītijas atšķiras. Unikalitātes kritēriji, pēc kuriem nosaka vienādību/atšķirību, ir šādi: - vienumiem — vienuma atslēga; - trigeriem — trigeru nosaukums un izteiksme; - pielāgotajiem grafikiem — grafika nosaukums un tā vienumi. #### Environment variables Docker Compose behavior and Zabbix component configuration can both be customized using environment variables. **Compose-level variables** (defined in the [`.env` file](https://github.com/zabbix/zabbix-docker/blob/7.0/.env)) control which Docker images, ports, and network IP ranges are used. You can use these variables inline before the `docker compose` command, or edit the `.env` file. For example, the following command deploys a complete multi-container Zabbix setup using an Ubuntu-based image (instead of the default Alpine Linux) and exposing the web interface via Nginx on custom HTTP (8282) and HTTPS (8443) ports: ```bash OS=ubuntu \ ZABBIX_WEB_NGINX_HTTP_PORT=8282 \ ZABBIX_WEB_NGINX_HTTPS_PORT=8443 \ docker compose -f ./compose.yaml up -d ``` **Component-level variables** (defined in the [`env_vars/.env_<component>`](https://github.com/zabbix/zabbix-docker/blob/7.0/env_vars/) files) control Zabbix component configuration. Edit the respective `.env_<component>` file before running the `docker compose` command. For example, you can adjust Zabbix server passive poller count and cache settings, as well as configure the web interface timezone by editing the following variables: ```ini # env_vars/.env_srv ZBX_STARTPOLLERS=20 ZBX_CACHESIZE=64M ZBX_HISTORYCACHESIZE=32M # env_vars/.env_web PHP_TZ=Europe/Paris ``` ::: noteclassic Component-level environment variables correspond to Zabbix component configuration parameters using a different naming style (e.g., `ZBX_STARTPOLLERS` corresponds to [`StartPollers`](/manual/appendix/config/zabbix_server#startpollers)). Some variables are Docker-specific, and some configuration parameters cannot be changed (e.g., `PIDFile` and `LogType`). When using environment variables, please refer to the *Environment variables* section in each component's [Docker image](#available-docker-images) description on Docker Hub. ::: #### Vides mainīgie Docker Compose darbību un Zabbix komponentu konfigurāciju var pielāgot, izmantojot vides mainīgos. **Compose līmeņa mainīgie** (definēti [`.env` failā](https://github.com/zabbix/zabbix-docker/blob/7.0/.env)) nosaka, kuri Docker attēli, porti un tīkla IP diapazoni tiek izmantoti. Šos mainīgos var norādīt tieši pirms `docker compose` komandas vai rediģēt `.env` failu. Piemēram, šāda komanda izvieto pilnu vairāku konteineru Zabbix konfigurāciju, izmantojot uz Ubuntu balstītu attēlu (nevis noklusējuma Alpine Linux) un publicējot lietotāja saskarni caur Nginx, izmantojot pielāgotus HTTP (8282) un HTTPS (8443) portus: ```bash OS=ubuntu \ ZABBIX_WEB_NGINX_HTTP_PORT=8282 \ ZABBIX_WEB_NGINX_HTTPS_PORT=8443 \ docker compose -f ./compose.yaml up -d ``` **Komponentu līmeņa mainīgie** (definēti [`env_vars/.env_<component>`](https://github.com/zabbix/zabbix-docker/blob/7.0/env_vars/) failos) nosaka Zabbix komponentu konfigurāciju. Pirms `docker compose` komandas palaišanas rediģējiet attiecīgo `.env_<component>` failu. Piemēram, varat pielāgot Zabbix servera pasīvo aptaujātāju skaitu un kešatmiņas iestatījumus, kā arī konfigurēt lietotāja saskarnes laika joslu, rediģējot šādus mainīgos: ```ini # env_vars/.env_srv ZBX_STARTPOLLERS=20 ZBX_CACHESIZE=64M ZBX_HISTORYCACHESIZE=32M # env_vars/.env_web PHP_TZ=Europe/Paris ``` ::: noteclassic Komponentu līmeņa vides mainīgie atbilst Zabbix komponentu konfigurācijas parametriem, izmantojot atšķirīgu nosaukumu veidošanas stilu (piem., `ZBX_STARTPOLLERS` atbilst [`StartPollers`](/manual/appendix/config/zabbix_server#startpollers)). Daži mainīgie ir specifiski Docker, un dažus konfigurācijas parametrus nevar mainīt (piem., `PIDFile` un `LogType`). Izmantojot vides mainīgos, lūdzu, skatiet sadaļu *Environment variables* katra komponenta [Docker attēla](#available-docker-images) aprakstā Docker Hub. ::: #### Error handling Up to the present moment, everything you have tried has worked fine. But what would happen if you tried making an incorrect call to the API? Try to create another host by calling [`host.create`](/manual/api/reference/host/create) but omitting the mandatory `groups` parameter: ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \ --header 'Content-Type: application/json-rpc' \ --data '{"jsonrpc":"2.0","method":"host.create","params":{"host":"Linux server","interfaces":[{"type":1,"main":1,"useip":1,"ip":"192.168.3.1","dns":"","port":"10050"}]},"id":7}' ``` The response will then contain an error message: ```json { "jsonrpc": "2.0", "error": { "code": -32602, "message": "Invalid params.", "data": "No groups for host \"Linux server\"." }, "id": 7 } ``` If an error has occurred, instead of the `result` property, the response object will contain the `error` property with the following data: - `code` - an error code; - `message` - a short error summary; - `data` - a more detailed error message. Errors can occur in various cases, such as, using incorrect input values, a session timeout or trying to access non-existing objects. Your application should be able to gracefully handle these kinds of errors. #### Kļūdu apstrāde Līdz šim viss, ko jūs mēģinājāt, darbojās pareizi. Bet kas notiktu, ja jūs mēģinātu veikt nepareizu API izsaukumu? Mēģiniet izveidot vēl vienu hostu, izsaucot [`host.create`](/manual/api/reference/host/create), bet izlaižot obligāto `groups` parametru: ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \ --header 'Content-Type: application/json-rpc' \ --data '{"jsonrpc":"2.0","method":"host.create","params":{"host":"Linux server","interfaces":[{"type":1,"main":1,"useip":1,"ip":"192.168.3.1","dns":"","port":"10050"}]},"id":7}' ``` Atbilde tad saturēs kļūdas ziņojumu: ```json { "jsonrpc": "2.0", "error": { "code": -32602, "message": "Invalid params.", "data": "No groups for host \"Linux server\"." }, "id": 7 } ``` Ja ir notikusi kļūda, atbildes objektā `result` īpašības vietā būs `error` īpašība ar šādiem datiem: - `code` - kļūdas kods; - `message` - īss kļūdas kopsavilkums; - `data` - detalizētāks kļūdas ziņojums. Kļūdas var rasties dažādos gadījumos, piemēram, izmantojot nepareizas ievades vērtības, sesijas noildzes gadījumā vai mēģinot piekļūt neeksistējošiem objektiem. Jūsu lietojumprogrammai jāspēj šāda veida kļūdas apstrādāt korekti. #### Error messages ODBC error messages are structured into fields to provide detailed information. For example, an error message might look like this: Cannot execute ODBC query: [SQL_ERROR]:[42601][7][ERROR: syntax error at or near ";"; Error while executing the query] - "`Cannot execute ODBC query`" - Zabbix message - "`[SQL_ERROR]`" - ODBC return code - "`[42601]`" - SQLState - "`[7]`" - Native error code - "`[ERROR: syntax error at or near ";"; Error while executing the query]`" - Native error message Note that the error message length is limited to 2048 bytes, so the message can be truncated. If there is more than one ODBC diagnostic record, Zabbix tries to concatenate them (separated with `|`) as far as the length limit allows. #### Kļūdu ziņojumi ODBC kļūdu ziņojumi ir strukturēti laukos, lai sniegtu detalizētu informāciju. Piemēram, kļūdas ziņojums var izskatīties šādi: Cannot execute ODBC query: [SQL_ERROR]:[42601][7][ERROR: syntax error at or near ";"; Error while executing the query] - "`Cannot execute ODBC query`" - Zabbix ziņojums - "`[SQL_ERROR]`" - ODBC atgriešanas kods - "`[42601]`" - SQLState - "`[7]`" - vietējās kļūdas kods - "`[ERROR: syntax error at or near ";"; Error while executing the query]`" - vietējās kļūdas ziņojums Ņemiet vērā, ka kļūdas ziņojuma garums ir ierobežots līdz 2048 baitiem, tāpēc ziņojums var tikt saīsināts. Ja ir vairāk nekā viens ODBC diagnostikas ieraksts, Zabbix mēģina tos savienot vienā ziņojumā (atdalot ar `|`) tik tālu, cik to pieļauj garuma ierobežojums. #### Errors with fping execution in rootless containers When containers are running in rootless mode or in a specific-restrictions environment, you may face errors related to fping execution when performing ICMP checks, such as `fping: Operation not permitted` or all packets to all resources lost. To fix this problem add `--cap-add=net_raw` to "docker run" or "podman run" commands. Additionally fping execution in non-root environments may require sysctl modification, i.e.: ```bash sudo sysctl -w "net.ipv4.ping_group_range=0 1995" ``` where "1995" is the zabbix GID. For more details, see [ZBX-22833](https://support.zabbix.com/browse/ZBX-22833). #### Kļūdas ar fping izpildi rootless konteineros Ja konteineri darbojas rootless režīmā vai vidē ar specifiskiem ierobežojumiem, veicot ICMP pārbaudes, var rasties ar fping izpildi saistītas kļūdas, piemēram, `fping: Operation not permitted`, vai arī var tikt zaudētas visas paketes uz visiem resursiem. Lai novērstu šo problēmu, pievienojiet `--cap-add=net_raw` komandām "docker run" vai "podman run". Papildus tam fping izpilde vidēs bez root tiesībām var prasīt sysctl modifikāciju, piemēram: ```bash sudo sysctl -w "net.ipv4.ping_group_range=0 1995" ``` kur "1995" ir zabbix GID. Plašāku informāciju skatiet [ZBX-22833](https://support.zabbix.com/browse/ZBX-22833). #### Escalation examples #### Eskalācijas piemēri #### Escaping of backslashes in history function parameters Proper escaping of backslashes has been added in history function string parameters. As additional backslashes are added during the upgrade from pre-7.0 Zabbix versions, this leads to longer parameters which may result in broken trigger functions if the parameter length exceeds the maximum data size of 255 characters. To avoid this problem it is suggested to manually move long parameters into user macros before the upgrade. Note that since Zabbix 7.0.11 additional checks for the resulting parameter length have been added for upgrades from pre-7.0 Zabbix versions. If the resulting length exceeds the maximum size, such parameters are **not upgraded** while printing a warning in the logs asking users to fix the listed parameters manually. See also [escaping-related upgrade issues](/manual/installation/known_issues/db_upgrade_escaping). #### Atpakaļsvītru atsoļošanas simbolu apstrāde vēstures funkciju parametros Vēstures funkciju virkņu parametros ir pievienota pareiza atpakaļsvītru atsoļošana. Tā kā jaunas atpakaļsvītras tiek pievienotas jaunināšanas laikā no Zabbix versijām, kas ir vecākas par 7.0, tas noved pie garākiem parametriem, kas var izraisīt bojātas trigeru funkcijas, ja parametra garums pārsniedz maksimālo datu apjomu 255 rakstzīmes. Lai izvairītos no šīs problēmas, pirms jaunināšanas ieteicams garos parametrus manuāli pārvietot uz lietotāja makro. Ņemiet vērā, ka kopš Zabbix 7.0.11 jaunināšanai no Zabbix versijām, kas ir vecākas par 7.0, ir pievienotas papildu pārbaudes iegūtā parametra garumam. Ja iegūtais garums pārsniedz maksimālo izmēru, šādi parametri **netiek jaunināti**, un žurnālos tiek izvadīts brīdinājums ar aicinājumu lietotājiem manuāli labot uzskaitītos parametrus. Skatiet arī [ar atsoļošanu saistītās jaunināšanas problēmas](/manual/installation/known_issues/db_upgrade_escaping). #### Escaping of backslashes in history function parameters Proper escaping of backslashes has been added in history function string parameters since Zabbix 7.0.0. As additional backslashes are added during the upgrade from pre-7.0 Zabbix versions, this leads to longer parameters which may result in broken trigger functions if the parameter length exceeds the maximum data size of 255 characters. To avoid this problem it is suggested to manually move long parameters into user macros before the upgrade. Note that since Zabbix 7.0.11 additional checks for the resulting parameter length have been added for upgrades from pre-7.0 Zabbix versions. If the resulting length exceeds the maximum size, such parameters are **not upgraded** while printing a warning in the logs asking users to fix the listed parameters manually. See also [escaping-related upgrade issues](/manual/installation/known_issues/db_upgrade_escaping). #### Atpakaļsvītru atsoļošanas simbolu apstrāde vēstures funkciju parametros Pareiza atpakaļsvītru atsoļošana ir pievienota vēstures funkciju virkņu parametros kopš Zabbix 7.0.0. Tā kā jaunas atpakaļsvītras tiek pievienotas jaunināšanas laikā no Zabbix versijām, kas ir vecākas par 7.0, tas noved pie garākiem parametriem, kas var izraisīt trigeru funkciju darbības traucējumus, ja parametra garums pārsniedz maksimālo datu apjomu 255 rakstzīmes. Lai izvairītos no šīs problēmas, pirms jaunināšanas ieteicams manuāli pārvietot garos parametrus lietotāja makrosos. Ņemiet vērā, ka kopš Zabbix 7.0.11 jaunināšanai no Zabbix versijām, kas ir vecākas par 7.0, ir pievienotas papildu pārbaudes iegūtā parametra garumam. Ja iegūtais garums pārsniedz maksimālo izmēru, šādi parametri **netiek jaunināti**, un žurnālos tiek parādīts brīdinājums, aicinot lietotājus manuāli labot uzskaitītos parametrus. Skatiet arī [ar atsoļošanu saistītās jaunināšanas problēmas](/manual/installation/known_issues/db_upgrade_escaping). #### Essential reference - [Installation and setup](/manual/appendix/install) - database creation, server and agent installation and configuration. - [Process configuration](/manual/appendix/config) - configuration parameters for Zabbix server, proxy, agent, and more. - [Items](/manual/appendix/items) - item key reference and supported data types. - [Macros](/manual/appendix/macros) - built-in and user macro syntax and usage. #### Būtiska atsauce - [Instalēšana un iestatīšana](/manual/appendix/install) - datubāzes izveide, servera un aģenta instalēšana un konfigurēšana. - [Procesu konfigurācija](/manual/appendix/config) - Zabbix servera, starpniekservera, aģenta un citu komponentu konfigurācijas parametri. - [Vienumi](/manual/appendix/items) - vienumu atslēgu atsauce un atbalstītie datu tipi. - [Makrosi](/manual/appendix/macros) - iebūvēto un lietotāja makrosu sintakse un lietošana. #### Evaluation period An evaluation period is used in functions referencing the item history. It allows to specify the interval we are interested in. It can be specified as time period (30s, 10m, 1h) or as a value range (\#5 - for five latest values). The evaluation period is measured up to "now" - where "now" is the latest recalculation time of the trigger (see [Calculation time](#calculation-time) above); "now" is not the "now" time of the server. The evaluation period specifies either: - All values between "now - time period" and "now" (or, with time shift applied, between "now - time shift - time period" and "now - time shift"). - The specified number of values from the past, up to "now". If no data exists for the specified evaluation period, the trigger or calculated item using this function becomes unsupported. Note that: - If only a single function (referencing data history) is used in the trigger, "now" is always the latest received value. For example, if the last value was received an hour ago, the evaluation period will be regarded as up to the latest value an hour ago. - A new trigger is calculated as soon as the first value is received (history functions); it will be calculated within 30 seconds for [date and time](/manual/appendix/functions/time) and [nodata()](/manual/appendix/functions/history#nodata) functions. Thus the trigger will be calculated even though perhaps the set evaluation period (for example, one hour) has not yet passed since the trigger was created. The trigger will also be calculated after the first value, even though the evaluation range was set, for example, to ten latest values. #### Novērtēšanas periods Novērtēšanas periods tiek izmantots funkcijās, kas atsaucas uz vienuma vēsturi. Tas ļauj norādīt interesējošo intervālu. To var norādīt kā laika periodu (30s, 10m, 1h) vai kā vērtību diapazonu (\#5 - pēdējām piecām vērtībām). Novērtēšanas periods tiek mērīts līdz "tagad" - kur "tagad" ir trigeris pēdējais pārrēķina laiks (skatiet iepriekš [Aprēķina laiks](#calculation-time)); "tagad" nav servera "tagad" laiks. Novērtēšanas periods nosaka vienu no šādiem: - Visas vērtības starp "tagad - laika periods" un "tagad" (vai, ja ir piemērota laika nobīde, starp "tagad - laika nobīde - laika periods" un "tagad - laika nobīde"). - Norādīto vērtību skaitu no pagātnes līdz "tagad". Ja norādītajā novērtēšanas periodā nav datu, trigeris vai aprēķinātais vienums, kas izmanto šo funkciju, kļūst neatbalstīts. Ņemiet vērā, ka: - Ja trigerī tiek izmantota tikai viena funkcija (kas atsaucas uz datu vēsturi), "tagad" vienmēr ir pēdējā saņemtā vērtība. Piemēram, ja pēdējā vērtība tika saņemta pirms stundas, novērtēšanas periods tiks uzskatīts par spēkā esošu līdz pēdējai vērtībai pirms stundas. - Jauns trigeris tiek aprēķināts, tiklīdz tiek saņemta pirmā vērtība (vēstures funkcijas); tas tiks aprēķināts 30 sekunžu laikā funkcijām [date and time](/manual/appendix/functions/time) un [nodata()](/manual/appendix/functions/history#nodata). Tādējādi trigeris tiks aprēķināts pat tad, ja, iespējams, iestatītais novērtēšanas periods (piemēram, viena stunda) vēl nav pagājis kopš trigera izveides. Trigeris tiks aprēķināts arī pēc pirmās vērtības, pat ja novērtēšanas diapazons tika iestatīts, piemēram, uz desmit jaunākajām vērtībām. # event.acknowledge # event.acknowledge #### Event correlation Create custom event correlation rules. [Correlation API](/manual/api/reference/correlation) #### Notikumu korelācija Izveidojiet pielāgotus notikumu korelācijas noteikumus. [Korelācijas API](/manual/api/reference/correlation) ##### Event correlation Event correlation (also called global event correlation) is a way to set up custom event closing (resulting in OK event generation) rules. The rules define how the new problem events are paired with existing problem events and allow to close the new event or the matched events by generating corresponding OK events. However, event correlation must be configured very carefully, as it can negatively affect event processing performance or, if misconfigured, close more events than intended (in the worst case even all problem events could be closed). A few configuration tips: 1. always reduce the correlation scope by setting a unique tag for the control event (the event that is paired with old events) and use the 'new event tag' correlation condition 2. don't forget to add a condition based on the old event when using 'close old event' operation, or all existing problems could be closed 3. avoid using common tag names used by different correlation configurations ##### Notikumu korelācija Notikumu korelācija (saukta arī par globālo notikumu korelāciju) ir veids, kā iestatīt pielāgotus notikumu aizvēršanas noteikumus (kā rezultātā tiek ģenerēts OK notikums). Noteikumi nosaka, kā jaunie problēmu notikumi tiek sapāroti ar esošajiem problēmu notikumiem, un ļauj aizvērt jauno notikumu vai atrastos notikumus, ģenerējot atbilstošus OK notikumus. Tomēr notikumu korelācija ir jākonfigurē ļoti uzmanīgi, jo tā var negatīvi ietekmēt notikumu apstrādes veiktspēju vai, nepareizi konfigurēta, aizvērt vairāk notikumu, nekā paredzēts (sliktākajā gadījumā var tikt aizvērti pat visi problēmu notikumi). Daži konfigurācijas ieteikumi: 1. vienmēr samaziniet korelācijas tvērumu, iestatot unikālu birku kontroles notikumam (notikumam, kas tiek sapārots ar vecajiem notikumiem), un izmantojiet korelācijas nosacījumu 'jaunā notikuma birka' 2. neaizmirstiet pievienot nosacījumu, kas balstīts uz veco notikumu, izmantojot darbību 'aizvērt veco notikumu', pretējā gadījumā var tikt aizvērtas visas esošās problēmas 3. izvairieties no bieži lietotu birku nosaukumu izmantošanas, ko lieto dažādas korelācijas konfigurācijas # event.get # event.get ##### eventlog.count[name,<regexp>,<severity>,<source>,<eventid>,<maxproclines>,<mode>] {#eventlog.count} <br> The count of lines in the Windows event log.<br> Return value: *Integer*. Parameters: - **name** - the name of the event log channel (*Log Name* in the Event Viewer GUI);<br> - **regexp** - a regular [expression](/manual/regular_expressions#overview) describing the required pattern (case sensitive);<br> - **severity** - a regular expression describing severity (case insensitive). This parameter accepts a regular expression based on the following values: "Information", "Warning", "Error", "Critical", "Verbose" (running on Windows Vista or newer).<br> - **source** - a regular expression describing the source identifier (case insensitive);<br> - **eventid** - a regular expression describing the event identifier(s) (case sensitive);<br> - **maxproclines** - the maximum number of new lines per second the agent will analyze (cannot exceed 10000). The default value is 10*'MaxLinesPerSecond' in [zabbix_agentd.conf](/manual/appendix/config/zabbix_agentd_win).<br> - **mode** - possible values: - *all* (default); - *skip* - skip the processing of older data (affects only newly created items). Comments: - The item must be configured as an [active check](/manual/appendix/items/activepassive#active-checks); - The agent is unable to send in events from the "Forwarded events" log; - Windows Eventing 6.0 is supported; - Selecting a non-Log [type of information](/manual/config/items/item#configuration) for this item will lead to the loss of local timestamp, as well as log severity and source information; - See also additional information on [log monitoring](/manual/config/items/itemtypes/zabbix_agent/log_items). Examples: ```default eventlog.count[System,,"Warning|Error"] eventlog.count[Windows PowerShell,,,,,,skip] ``` ##### eventlog.count[name,<regexp>,<severity>,<source>,<eventid>,<maxproclines>,<mode>] {#eventlog.count} <br> Windows notikumu žurnāla rindu skaits.<br> Atgrieztā vērtība: *Integer*. Parametri: - **name** - notikumu žurnāla kanāla nosaukums (*Log Name* Event Viewer GUI);<br> - **regexp** - regulāra [izteiksme](/manual/regular_expressions#overview), kas apraksta nepieciešamo modeli (reģistrjutīga);<br> - **severity** - regulāra izteiksme, kas apraksta nopietnības līmeni (nav reģistrjutīga). Šis parametrs pieņem regulāru izteiksmi, pamatojoties uz šādām vērtībām: "Information", "Warning", "Error", "Critical", "Verbose" (darbojoties Windows Vista vai jaunākā versijā).<br> - **source** - regulāra izteiksme, kas apraksta avota identifikatoru (nav reģistrjutīga);<br> - **eventid** - regulāra izteiksme, kas apraksta notikuma identifikatoru(-us) (reģistrjutīga);<br> - **maxproclines** - maksimālais jauno rindu skaits sekundē, ko aģents analizēs (nedrīkst pārsniegt 10000). Noklusējuma vērtība ir 10*'MaxLinesPerSecond' failā [zabbix_agentd.conf](/manual/appendix/config/zabbix_agentd_win).<br> - **mode** - iespējamās vērtības: - *all* (noklusējums); - *skip* - izlaist vecāku datu apstrādi (ietekmē tikai jaunizveidotos vienumus). Komentāri: - vienumam jābūt konfigurētam kā [aktīvai pārbaudei](/manual/appendix/items/activepassive#active-checks); - aģents nevar nosūtīt notikumus no žurnāla "Forwarded events"; - tiek atbalstīts Windows Eventing 6.0; - izvēloties šim vienumam ne-Log [informācijas tipu](/manual/config/items/item#configuration), tiks zaudēts lokālais laikspiedols, kā arī žurnāla nopietnības līmenis un avota informācija; - skatiet arī papildu informāciju par [žurnālu uzraudzību](/manual/config/items/itemtypes/zabbix_agent/log_items). Piemēri: ```default eventlog.count[System,,"Warning|Error"] eventlog.count[Windows PowerShell,,,,,,skip] ``` ##### eventlog[name,<regexp>,<severity>,<source>,<eventid>,<maxlines>,<mode>] {#eventlog} <br> The event log monitoring.<br> Return value: *Log*. Parameters: - **name** - the name of the event log channel (*Log Name* in the Event Viewer GUI);<br> - **regexp** - a regular [expression](/manual/regular_expressions#overview) describing the required pattern (case sensitive);<br> - **severity** - a regular expression describing severity (case insensitive). This parameter accepts a regular expression based on the following values: "Information", "Warning", "Error", "Critical", "Verbose" (running on Windows Vista or newer).<br> - **source** - a regular expression describing the source identifier (case insensitive);<br> - **eventid** - a regular expression describing the event identifier(s) (case sensitive);<br> - **maxlines** - the maximum number of new lines per second the agent will send to Zabbix server or proxy. This parameter overrides the value of `MaxLinesPerSecond` in [`zabbix_agentd.conf`](/manual/appendix/config/zabbix_agentd_win).<br> - **mode** - possible values: - *all* (default); - *skip* - skip the processing of older data (affects only newly created items). Comments: - The item must be configured as an [active check](/manual/appendix/items/activepassive#active-checks); - The agent is unable to send in events from the "Forwarded events" log; - Windows Eventing 6.0 is supported; - Selecting a non-Log [type of information](/manual/config/items/item#configuration) for this item will lead to the loss of local timestamp, as well as log severity and source information; - See also additional information on [log monitoring](/manual/config/items/itemtypes/zabbix_agent/log_items). Examples: ```default eventlog[Application] eventlog[Microsoft-Windows-Application-Experience/Program-Compatibility-Assistant] eventlog[Security,,"Failure Audit",,^(529|680)$] eventlog[System,,"Warning|Error"] eventlog[System,,,,^1$] eventlog[Windows PowerShell,,,,,,skip] eventlog[System,,,,@TWOSHORT] #here a custom regular expression named `TWOSHORT` is referenced (defined as a *Result is TRUE* type, the expression itself being `^1$|^70$`). ``` ##### eventlog[name,<regexp>,<severity>,<source>,<eventid>,<maxlines>,<mode>] {#eventlog} <br> Notikumu žurnāla uzraudzība.<br> Atgrieztā vērtība: *Log*. Parametri: - **name** - notikumu žurnāla kanāla nosaukums (*Log Name* Event Viewer GUI);<br> - **regexp** - regulāra [izteiksme](/manual/regular_expressions#overview), kas apraksta nepieciešamo rakstu (reģistrjutīga);<br> - **severity** - regulāra izteiksme, kas apraksta nopietnības līmeni (nereģistrjutīga). Šis parametrs pieņem regulāru izteiksmi, kas balstīta uz šādām vērtībām: "Information", "Warning", "Error", "Critical", "Verbose" (darbojoties Windows Vista vai jaunākā versijā).<br> - **source** - regulāra izteiksme, kas apraksta avota identifikatoru (nereģistrjutīga);<br> - **eventid** - regulāra izteiksme, kas apraksta notikuma identifikatoru(s) (reģistrjutīga);<br> - **maxlines** - maksimālais jauno rindu skaits sekundē, ko aģents nosūtīs uz Zabbix serveris vai starpniekserveris. Šis parametrs pārraksta `MaxLinesPerSecond` vērtību [`zabbix_agentd.conf`](/manual/appendix/config/zabbix_agentd_win).<br> - **mode** - iespējamās vērtības: - *all* (noklusējums); - *skip* - izlaist vecāku datu apstrādi (ietekmē tikai jaunizveidotos vienumus). Komentāri: - vienumam jābūt konfigurētam kā [aktīvai pārbaudei](/manual/appendix/items/activepassive#active-checks); - aģents nevar nosūtīt notikumus no žurnāla "Forwarded events"; - tiek atbalstīts Windows Eventing 6.0; - izvēloties šim vienumam ne-Log [informācijas tipu](/manual/config/items/item#configuration), tiks zaudēts lokālais laikspiedols, kā arī žurnāla nopietnības līmenis un avota informācija; - skatiet arī papildu informāciju par [žurnālu uzraudzību](/manual/config/items/itemtypes/zabbix_agent/log_items). Piemēri: ```default eventlog[Application] eventlog[Microsoft-Windows-Application-Experience/Program-Compatibility-Assistant] eventlog[Security,,"Failure Audit",,^(529|680)$] eventlog[System,,"Warning|Error"] eventlog[System,,,,^1$] eventlog[Windows PowerShell,,,,,,skip] eventlog[System,,,,@TWOSHORT] #šeit tiek atsaukta pielāgota regulārā izteiksme ar nosaukumu `TWOSHORT` (definēta kā *Result is TRUE* tipa, pati izteiksme ir `^1$|^70$`). ``` ### Event ::: noteclassic Events are created by the Zabbix server and cannot be modified via the API. ::: The event object has the following properties. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |eventid|ID|ID of the event.| |source|integer|Type of the event.<br><br>Possible values:<br>0 - event created by a trigger;<br>1 - event created by a discovery rule;<br>2 - event created by active agent autoregistration;<br>3 - internal event;<br>4 - event created on service status update.| |object|integer|Type of object that is related to the event.<br><br>Possible values if `source` is set to "event created by a trigger":<br>0 - trigger.<br><br>Possible values if `source` is set to "event created by a discovery rule":<br>1 - discovered host;<br>2 - discovered service.<br><br>Possible values if `source` is set to "event created by active agent autoregistration":<br>3 - auto-registered host.<br><br>Possible values if `source` is set to "internal event":<br>0 - trigger;<br>4 - item;<br>5 - LLD rule.<br><br>Possible values if `source` is set to "event created on service status update":<br>6 - service.| |objectid|ID|ID of the related object.| |acknowledged|integer|Whether the event has been acknowledged.| |clock|timestamp|Time when the event was created.| |ns|integer|Nanoseconds when the event was created.| |name|string|Resolved event name.| |value|integer|State of the related object.<br><br>Possible values if `source` is set to "event created by a trigger" or "event created on service status update":<br>0 - OK;<br>1 - problem.<br><br>Possible values if `source` is set to "event created by a discovery rule":<br>0 - host or service up;<br>1 - host or service down;<br>2 - host or service discovered;<br>3 - host or service lost.<br><br>Possible values if `source` is set to "internal event":<br>0 - "normal" state;<br>1 - "unknown" or "not supported" state.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `source` is set to "event created by a trigger", "event created by a discovery rule", "internal event", or "event created on service status update"| |severity|integer|Event current severity.<br><br>Possible values:<br>0 - not classified;<br>1 - information;<br>2 - warning;<br>3 - average;<br>4 - high;<br>5 - disaster.| |r\_eventid|ID|ID of the recovery event.| |c\_eventid|ID|ID of the event that was used to override (close) current event under global correlation rule. See `correlationid` to identify exact correlation rule.<br>This parameter is only defined when the event is closed by global correlation rule.| |cause_eventid|ID|ID of the cause event.| |correlationid|ID|ID of the correlation rule that generated closing of the problem.<br>This parameter is only defined when the event is closed by global correlation rule.| |userid|ID|ID of the user that closed the event (if the event was closed manually).| |suppressed|integer|Whether the event is suppressed.<br><br>Possible values:<br>0 - event is in normal state;<br>1 - event is suppressed.| |opdata|string|Operational data with expanded macros.| |urls|array|Active [media type URLs](/manual/api/reference/problem/object#media-type-url).| ### Notikums ::: noteclassic Notikumus izveido Zabbix serveris, un tos nevar modificēt, izmantojot API. ::: Notikuma objektam ir šādas īpašības. |Īpašība|[Tips](/manual/api/reference_commentary#data-types)|Apraksts| |--|--|------| |eventid|ID|Notikuma ID.| |source|integer|Notikuma tips.<br><br>Iespējamās vērtības:<br>0 - notikums, ko izveidojis trigeris;<br>1 - notikums, ko izveidojis atklāšanas noteikums;<br>2 - notikums, ko izveidojusi aktīva aģenta automātiskā reģistrācija;<br>3 - iekšējs notikums;<br>4 - notikums, kas izveidots, atjauninot pakalpojuma statusu.| |object|integer|Objekta tips, kas ir saistīts ar notikumu.<br><br>Iespējamās vērtības, ja `source` ir iestatīts uz "notikums, ko izveidojis trigeris":<br>0 - trigeris.<br><br>Iespējamās vērtības, ja `source` ir iestatīts uz "notikums, ko izveidojis atklāšanas noteikums":<br>1 - atklāts hosts;<br>2 - atklāts pakalpojums.<br><br>Iespējamās vērtības, ja `source` ir iestatīts uz "notikums, ko izveidojusi aktīva aģenta automātiskā reģistrācija":<br>3 - automātiski reģistrēts hosts.<br><br>Iespējamās vērtības, ja `source` ir iestatīts uz "iekšējs notikums":<br>0 - trigeris;<br>4 - vienums;<br>5 - LLD noteikums.<br><br>Iespējamās vērtības, ja `source` ir iestatīts uz "notikums, kas izveidots, atjauninot pakalpojuma statusu":<br>6 - pakalpojums.| |objectid|ID|Saistītā objekta ID.| |acknowledged|integer|Vai notikums ir apstiprināts.| |clock|timestamp|Laiks, kad notikums tika izveidots.| |ns|integer|Nanosekundes, kad notikums tika izveidots.| |name|string|Atrisinātais notikuma nosaukums.| |value|integer|Saistītā objekta stāvoklis.<br><br>Iespējamās vērtības, ja `source` ir iestatīts uz "notikums, ko izveidojis trigeris" vai "notikums, kas izveidots, atjauninot pakalpojuma statusu":<br>0 - OK;<br>1 - problēma.<br><br>Iespējamās vērtības, ja `source` ir iestatīts uz "notikums, ko izveidojis atklāšanas noteikums":<br>0 - hosts vai pakalpojums darbojas;<br>1 - hosts vai pakalpojums nedarbojas;<br>2 - hosts vai pakalpojums atklāts;<br>3 - hosts vai pakalpojums zaudēts.<br><br>Iespējamās vērtības, ja `source` ir iestatīts uz "iekšējs notikums":<br>0 - "normāls" stāvoklis;<br>1 - "nezināms" vai "nav atbalstīts" stāvoklis.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *atbalstīts*, ja `source` ir iestatīts uz "notikums, ko izveidojis trigeris", "notikums, ko izveidojis atklāšanas noteikums", "iekšējs notikums" vai "notikums, kas izveidots, atjauninot pakalpojuma statusu"| |severity|integer|Notikuma pašreizējā nopietnība.<br><br>Iespējamās vērtības:<br>0 - nav klasificēts;<br>1 - informācija;<br>2 - brīdinājums;<br>3 - vidēja;<br>4 - augsta;<br>5 - katastrofa.| |r\_eventid|ID|Atkopšanas notikuma ID.| |c\_eventid|ID|Notikuma ID, kas tika izmantots, lai aizstātu (aizvērtu) pašreizējo notikumu saskaņā ar globālās korelācijas noteikumu. Skatiet `correlationid`, lai noteiktu precīzu korelācijas noteikumu.<br>Šis parametrs ir definēts tikai tad, ja notikums ir aizvērts ar globālās korelācijas noteikumu.| |cause_eventid|ID|Cēloņa notikuma ID.| |correlationid|ID|Korelācijas noteikuma ID, kas izraisīja problēmas aizvēršanu.<br>Šis parametrs ir definēts tikai tad, ja notikums ir aizvērts ar globālās korelācijas noteikumu.| |userid|ID|Lietotāja ID, kurš aizvēra notikumu (ja notikums tika aizvērts manuāli).| |suppressed|integer|Vai notikums ir apspiests.<br><br>Iespējamās vērtības:<br>0 - notikums ir normālā stāvoklī;<br>1 - notikums ir apspiests.| |opdata|string|Operatīvie dati ar izvērstām makrokomandām.| |urls|array|Aktīvie [mediju tipa URL](/manual/api/reference/problem/object#media-type-url).| # Event object The following objects are directly related to the `event` API. # Notikuma objekts Tālāk norādītie objekti ir tieši saistīti ar `event` API. ### Events |Macro|Supported in|Description| |--|--------|--------| |{EVENT.ACK.STATUS}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands|*Acknowledgment status of the event (Yes/No)*.| |{EVENT.AGE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Discovery notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands|*Age of the event that triggered an action*, with precision down to a second.<br>Useful in escalated messages.<br>For example: 9m 13s.| |{EVENT.DATE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Discovery notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands|*Date of the event that triggered an action in yyyy.mm.dd format.*<br>For example: 2025.04.14.| |{EVENT.DURATION}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Internal notifications<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands|*Duration of the event (time difference between problem and recovery events)*, with precision down to a second.<br>Useful in problem recovery messages.| |{EVENT.ID}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Discovery notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications<br>→ Trigger URLs<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text|*Numeric ID of the event that triggered an action.*| |{EVENT.NAME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Internal notifications<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text|*Name of the problem event that triggered an action.*| |{EVENT.NSEVERITY}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text|*Numeric value of the event severity.* Possible values: 0 - Not classified, 1 - Information, 2 - Warning, 3 - Average, 4 - High, 5 - Disaster.| |{EVENT.OBJECT}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Discovery notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands|*Numeric value of the event object.* Possible values: 0 - Trigger, 1 - Discovered host, 2 - Discovered service, 3 - Autoregistration, 4 - Item, 5 - Low-level discovery rule.| |{EVENT.OPDATA}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands|*Operational data of the underlying trigger of a problem.*| |{EVENT.RECOVERY.DATE}|→ Problem [recovery notifications](/manual/config/notifications/action/recovery_operations) and commands<br>→ Problem update notifications and commands (if recovery took place)<br>→ Service recovery notifications and commands<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) (if recovery took place) commands|*Date of the recovery event in yyyy.mm.dd format.*| |{EVENT.RECOVERY.ID}|→ Problem [recovery notifications](/manual/config/notifications/action/recovery_operations) and commands<br>→ Problem update notifications and commands (if recovery took place)<br>→ Service recovery notifications and commands<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) (if recovery took place) commands|*Numeric ID of the recovery event.*| |{EVENT.RECOVERY.NAME}|→ Problem [recovery notifications](/manual/config/notifications/action/recovery_operations) and commands<br>→ Problem update notifications and commands (if recovery took place)<br>→ Service recovery notifications and commands<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) (if recovery took place) commands|*Name of the recovery event.*| |{EVENT.RECOVERY.STATUS}|→ Problem [recovery notifications](/manual/config/notifications/action/recovery_operations) and commands<br>→ Problem update notifications and commands (if recovery took place)<br>→ Service recovery notifications and commands<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) (if recovery took place) commands|*Verbal value of the recovery event.*| |{EVENT.RECOVERY.TAGS}|→ Problem [recovery notifications](/manual/config/notifications/action/recovery_operations) and commands<br>→ Problem update notifications and commands (if recovery took place)<br>→ Service recovery notifications and commands<br>→ Internal notifications<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) (if recovery took place) commands|*A comma separated list of recovery event tags.* Expanded to an empty string if no tags exist.| |{EVENT.RECOVERY.TAGSJSON}|→ Problem [recovery notifications](/manual/config/notifications/action/recovery_operations) and commands<br>→ Problem update notifications and commands (if recovery took place)<br>→ Service recovery notifications and commands<br>→ Internal notifications<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) (if recovery took place) commands|*A JSON array containing event tag [objects](/manual/api/reference/event/object#event-tag).* Expanded to an empty array if no tags exist.| |{EVENT.RECOVERY.TIME}|→ Problem [recovery notifications](/manual/config/notifications/action/recovery_operations) and commands<br>→ Problem update notifications and commands (if recovery took place)<br>→ Service recovery notifications and commands<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) (if recovery took place) commands|*Time of the recovery event in hh:mm:ss format.*| |{EVENT.RECOVERY.VALUE}|→ Problem [recovery notifications](/manual/config/notifications/action/recovery_operations) and commands<br>→ Problem update notifications and commands (if recovery took place)<br>→ Service recovery notifications and commands<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) (if recovery took place) commands|*Numeric value of the recovery event.*| |{EVENT.SEVERITY}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text|*Name of the event severity.*| |{EVENT.SOURCE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Discovery notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands|*Numeric value of the event source.* Possible values: 0 - Trigger, 1 - Discovery, 2 - Autoregistration, 3 - Internal, 4 - Service.| |{EVENT.STATUS}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Internal notifications<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text|*Verbal value of the event that triggered an action.*| |{EVENT.TAGS}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Internal notifications<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands|*A comma separated list of event tags.* Expanded to an empty string if no tags exist.| |{EVENT.TAGSJSON}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Internal notifications<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands|*A JSON array containing event tag [objects](/manual/api/reference/event/object#event-tag).* Expanded to an empty array if no tags exist.| |{EVENT.TAGS.\<tag name>}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Internal notifications<br>→ Webhook media type URL names and URLs<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands|*Event tag value referenced by the tag name.*<br>A tag name containing non-alphanumeric characters (including non-English multibyte-UTF characters) should be double quoted. Quotes and backslashes inside a quoted tag name must be escaped with a backslash.| |{EVENT.TIME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Discovery notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands|*Time of the event that triggered an action in hh:mm:ss format.*<br>For example: 12:57:53.| |{EVENT.UPDATE.ACTION}|→ Problem update notifications and commands|*Human-readable name of the action(s)* performed during [problem update](/manual/acknowledgment#updating-problems).<br>Resolves to the following values: *acknowledged*, *unacknowledged*, *commented*, *changed severity from (original severity) to (updated severity)* and *closed* (depending on how many actions are performed in one update).| |{EVENT.UPDATE.DATE}|→ Problem update notifications and commands<br>→ Service update notifications and commands|*Date of event [update](/manual/config/notifications/action/update_operations) (acknowledgment, etc) in yyyy.mm.dd format.*<br>`{ACK.DATE}` is deprecated and may not resolve in supported locations.| |{EVENT.UPDATE.HISTORY}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands|*Log of problem updates (acknowledgments, etc).*<br>`{EVENT.ACK.HISTORY}` is deprecated and may not resolve in supported locations.| |{EVENT.UPDATE.MESSAGE}|→ Problem update notifications and commands|*Problem update message.*<br>`{ACK.MESSAGE}` is deprecated and may not resolve in supported locations.| |{EVENT.UPDATE.NSEVERITY}|→ Service update notifications and commands |*Numeric value of the new event severity set during problem update operation.* | |{EVENT.UPDATE.SEVERITY}|→ Service update notifications and commands |*Name of the new event severity set during problem update operation.* | |{EVENT.UPDATE.STATUS}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service update notifications and commands (since Zabbix 7.0.2)<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands|*Numeric value of the problem update status.* Possible values: 0 - Webhook was called because of problem/recovery event, 1 - Update operation.| |{EVENT.UPDATE.TIME}|→ Problem update notifications and commands<br>→ Service update notifications and commands|*Time of event [update](/manual/config/notifications/action/update_operations) (acknowledgment, etc) in hh:mm:ss format.*<br>`{ACK.TIME}` is deprecated and may not resolve in supported locations.| |{EVENT.VALUE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Internal notifications<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text|*Numeric value of the event that triggered an action (1 for problem, 0 for recovering).*| ### Notikumi |Macro|Supported in|Description| |--|--------|--------| |{EVENT.ACK.STATUS}|→ Uz trigeri balstīti paziņojumi un komandas<br>→ Problēmas atjaunināšanas paziņojumi un komandas<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas|*Notikuma apstiprinājuma statuss (Jā/Nē)*.| |{EVENT.AGE}|→ Uz trigeri balstīti paziņojumi un komandas<br>→ Problēmas atjaunināšanas paziņojumi un komandas<br>→ Uz pakalpojumu balstīti paziņojumi un komandas<br>→ Pakalpojuma atjaunināšanas paziņojumi un komandas<br>→ Pakalpojuma atjaunošanas paziņojumi un komandas<br>→ Atklāšanas paziņojumi un komandas<br>→ Autoreģistrācijas paziņojumi un komandas<br>→ Iekšējie paziņojumi<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas|*Notikuma, kas izraisīja darbību, vecums*, ar precizitāti līdz sekundei.<br>Noder eskalētos ziņojumos.<br>Piemēram: 9m 13s.| |{EVENT.DATE}|→ Uz trigeri balstīti paziņojumi un komandas<br>→ Problēmas atjaunināšanas paziņojumi un komandas<br>→ Uz pakalpojumu balstīti paziņojumi un komandas<br>→ Pakalpojuma atjaunināšanas paziņojumi un komandas<br>→ Pakalpojuma atjaunošanas paziņojumi un komandas<br>→ Atklāšanas paziņojumi un komandas<br>→ Autoreģistrācijas paziņojumi un komandas<br>→ Iekšējie paziņojumi<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas|*Notikuma, kas izraisīja darbību, datums yyyy.mm.dd formātā.*<br>Piemēram: 2025.04.14.| |{EVENT.DURATION}|→ Uz trigeri balstīti paziņojumi un komandas<br>→ Problēmas atjaunināšanas paziņojumi un komandas<br>→ Uz pakalpojumu balstīti paziņojumi un komandas<br>→ Pakalpojuma atjaunināšanas paziņojumi un komandas<br>→ Pakalpojuma atjaunošanas paziņojumi un komandas<br>→ Iekšējie paziņojumi<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas|*Notikuma ilgums (laika starpība starp problēmas un atjaunošanas notikumiem)*, ar precizitāti līdz sekundei.<br>Noder problēmas atjaunošanas ziņojumos.| |{EVENT.ID}|→ Uz trigeri balstīti paziņojumi un komandas<br>→ Problēmas atjaunināšanas paziņojumi un komandas<br>→ Uz pakalpojumu balstīti paziņojumi un komandas<br>→ Pakalpojuma atjaunināšanas paziņojumi un komandas<br>→ Pakalpojuma atjaunošanas paziņojumi un komandas<br>→ Atklāšanas paziņojumi un komandas<br>→ Autoreģistrācijas paziņojumi un komandas<br>→ Iekšējie paziņojumi<br>→ Trigera URL<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts|*Notikuma, kas izraisīja darbību, skaitliskais ID.*| |{EVENT.NAME}|→ Uz trigeri balstīti paziņojumi un komandas<br>→ Problēmas atjaunināšanas paziņojumi un komandas<br>→ Uz pakalpojumu balstīti paziņojumi un komandas<br>→ Pakalpojuma atjaunināšanas paziņojumi un komandas<br>→ Pakalpojuma atjaunošanas paziņojumi un komandas<br>→ Iekšējie paziņojumi<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts|*Problēmas notikuma nosaukums, kas izraisīja darbību.*| |{EVENT.NSEVERITY}|→ Uz trigeri balstīti paziņojumi un komandas<br>→ Problēmas atjaunināšanas paziņojumi un komandas<br>→ Uz pakalpojumu balstīti paziņojumi un komandas<br>→ Pakalpojuma atjaunināšanas paziņojumi un komandas<br>→ Pakalpojuma atjaunošanas paziņojumi un komandas<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts|*Notikuma nopietnības skaitliskā vērtība.* Iespējamās vērtības: 0 - Nav klasificēts, 1 - Informācija, 2 - Brīdinājums, 3 - Vidējs, 4 - Augsts, 5 - Katastrofa.| |{EVENT.OBJECT}|→ Uz trigeri balstīti paziņojumi un komandas<br>→ Problēmas atjaunināšanas paziņojumi un komandas<br>→ Uz pakalpojumu balstīti paziņojumi un komandas<br>→ Pakalpojuma atjaunināšanas paziņojumi un komandas<br>→ Pakalpojuma atjaunošanas paziņojumi un komandas<br>→ Atklāšanas paziņojumi un komandas<br>→ Autoreģistrācijas paziņojumi un komandas<br>→ Iekšējie paziņojumi<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas|*Notikuma objekta skaitliskā vērtība.* Iespējamās vērtības: 0 - Trigeris, 1 - Atklāts hosts, 2 - Atklāts pakalpojums, 3 - Autoreģistrācija, 4 - Vienums, 5 - Zema līmeņa atklāšanas noteikums.| |{EVENT.OPDATA}|→ Uz trigeri balstīti paziņojumi un komandas<br>→ Problēmas atjaunināšanas paziņojumi un komandas<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas|*Pamatā esošā problēmas trigera operatīvie dati.*| |{EVENT.RECOVERY.DATE}|→ Problēmas [atjaunošanas paziņojumi](/manual/config/notifications/action/recovery_operations) un komandas<br>→ Problēmas atjaunināšanas paziņojumi un komandas (ja notikusi atjaunošana)<br>→ Pakalpojuma atjaunošanas paziņojumi un komandas<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) (ja notikusi atjaunošana) komandas|*Atjaunošanas notikuma datums yyyy.mm.dd formātā.*| |{EVENT.RECOVERY.ID}|→ Problēmas [atjaunošanas paziņojumi](/manual/config/notifications/action/recovery_operations) un komandas<br>→ Problēmas atjaunināšanas paziņojumi un komandas (ja notikusi atjaunošana)<br>→ Pakalpojuma atjaunošanas paziņojumi un komandas<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) (ja notikusi atjaunošana) komandas|*Atjaunošanas notikuma skaitliskais ID.*| |{EVENT.RECOVERY.NAME}|→ Problēmas [atjaunošanas paziņojumi](/manual/config/notifications/action/recovery_operations) un komandas<br>→ Problēmas atjaunināšanas paziņojumi un komandas (ja notikusi atjaunošana)<br>→ Pakalpojuma atjaunošanas paziņojumi un komandas<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) (ja notikusi atjaunošana) komandas|*Atjaunošanas notikuma nosaukums.*| |{EVENT.RECOVERY.STATUS}|→ Problēmas [atjaunošanas paziņojumi](/manual/config/notifications/action/recovery_operations) un komandas<br>→ Problēmas atjaunināšanas paziņojumi un komandas (ja notikusi atjaunošana)<br>→ Pakalpojuma atjaunošanas paziņojumi un komandas<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) (ja notikusi atjaunošana) komandas|*Atjaunošanas notikuma verbālā vērtība.*| |{EVENT.RECOVERY.TAGS}|→ Problēmas [atjaunošanas paziņojumi](/manual/config/notifications/action/recovery_operations) un komandas<br>→ Problēmas atjaunināšanas paziņojumi un komandas (ja notikusi atjaunošana)<br>→ Pakalpojuma atjaunošanas paziņojumi un komandas<br>→ Iekšējie paziņojumi<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) (ja notikusi atjaunošana) komandas|*Ar komatiem atdalīts atjaunošanas notikuma tagu saraksts.* Ja tagu nav, tiek izvērsts tukšā virknē.| |{EVENT.RECOVERY.TAGSJSON}|→ Problēmas [atjaunošanas paziņojumi](/manual/config/notifications/action/recovery_operations) un komandas<br>→ Problēmas atjaunināšanas paziņojumi un komandas (ja notikusi atjaunošana)<br>→ Pakalpojuma atjaunošanas paziņojumi un komandas<br>→ Iekšējie paziņojumi<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) (ja notikusi atjaunošana) komandas|*JSON masīvs, kas satur notikuma taga [objektus](/manual/api/reference/event/object#event-tag).* Ja tagu nav, tiek izvērsts tukšā masīvā.| |{EVENT.RECOVERY.TIME}|→ Problēmas [atjaunošanas paziņojumi](/manual/config/notifications/action/recovery_operations) un komandas<br>→ Problēmas atjaunināšanas paziņojumi un komandas (ja notikusi atjaunošana)<br>→ Pakalpojuma atjaunošanas paziņojumi un komandas<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) (ja notikusi atjaunošana) komandas|*Atjaunošanas notikuma laiks hh:mm:ss formātā.*| |{EVENT.RECOVERY.VALUE}|→ Problēmas [atjaunošanas paziņojumi](/manual/config/notifications/action/recovery_operations) un komandas<br>→ Problēmas atjaunināšanas paziņojumi un komandas (ja notikusi atjaunošana)<br>→ Pakalpojuma atjaunošanas paziņojumi un komandas<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) (ja notikusi atjaunošana) komandas|*Atjaunošanas notikuma skaitliskā vērtība.*| |{EVENT.SEVERITY}|→ Uz trigeri balstīti paziņojumi un komandas<br>→ Problēmas atjaunināšanas paziņojumi un komandas<br>→ Uz pakalpojumu balstīti paziņojumi un komandas<br>→ Pakalpojuma atjaunināšanas paziņojumi un komandas<br>→ Pakalpojuma atjaunošanas paziņojumi un komandas<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts|*Notikuma nopietnības nosaukums.*| |{EVENT.SOURCE}|→ Uz trigeri balstīti paziņojumi un komandas<br>→ Problēmas atjaunināšanas paziņojumi un komandas<br>→ Uz pakalpojumu balstīti paziņojumi un komandas<br>→ Pakalpojuma atjaunināšanas paziņojumi un komandas<br>→ Pakalpojuma atjaunošanas paziņojumi un komandas<br>→ Atklāšanas paziņojumi un komandas<br>→ Autoreģistrācijas paziņojumi un komandas<br>→ Iekšējie paziņojumi<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas|*Notikuma avota skaitliskā vērtība.* Iespējamās vērtības: 0 - Trigeris, 1 - Atklāšana, 2 - Autoreģistrācija, 3 - Iekšējais, 4 - Pakalpojums.| |{EVENT.STATUS}|→ Uz trigeri balstīti paziņojumi un komandas<br>→ Problēmas atjaunināšanas paziņojumi un komandas<br>→ Uz pakalpojumu balstīti paziņojumi un komandas<br>→ Pakalpojuma atjaunināšanas paziņojumi un komandas<br>→ Pakalpojuma atjaunošanas paziņojumi un komandas<br>→ Iekšējie paziņojumi<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts|*Notikuma, kas izraisīja darbību, verbālā vērtība.*| |{EVENT.TAGS}|→ Uz trigeri balstīti paziņojumi un komandas<br>→ Problēmas atjaunināšanas paziņojumi un komandas<br>→ Uz pakalpojumu balstīti paziņojumi un komandas<br>→ Pakalpojuma atjaunināšanas paziņojumi un komandas<br>→ Pakalpojuma atjaunošanas paziņojumi un komandas<br>→ Iekšējie paziņojumi<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas|*Ar komatiem atdalīts notikuma tagu saraksts.* Ja tagu nav, tiek izvērsts tukšā virknē.| |{EVENT.TAGSJSON}|→ Uz trigeri balstīti paziņojumi un komandas<br>→ Problēmas atjaunināšanas paziņojumi un komandas<br>→ Uz pakalpojumu balstīti paziņojumi un komandas<br>→ Pakalpojuma atjaunināšanas paziņojumi un komandas<br>→ Pakalpojuma atjaunošanas paziņojumi un komandas<br>→ Iekšējie paziņojumi<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas|*JSON masīvs, kas satur notikuma taga [objektus](/manual/api/reference/event/object#event-tag).* Ja tagu nav, tiek izvērsts tukšā masīvā.| |{EVENT.TAGS.\<tag name>}|→ Uz trigeri balstīti paziņojumi un komandas<br>→ Problēmas atjaunināšanas paziņojumi un komandas<br>→ Uz pakalpojumu balstīti paziņojumi un komandas<br>→ Pakalpojuma atjaunināšanas paziņojumi un komandas<br>→ Pakalpojuma atjaunošanas paziņojumi un komandas<br>→ Iekšējie paziņojumi<br>→ Webhook multivides tipa URL nosaukumi un URL<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas|*Notikuma taga vērtība, kas norādīta pēc taga nosaukuma.*<br>Taga nosaukums, kas satur nealfanumeriskus simbolus (tostarp neangļu vairāku baitu UTF rakstzīmes), jāievieto dubultpēdiņās. Pēdiņas un slīpsvītras citētā taga nosaukumā ir jāekranē ar slīpsvītru.| |{EVENT.TIME}|→ Uz trigeri balstīti paziņojumi un komandas<br>→ Problēmas atjaunināšanas paziņojumi un komandas<br>→ Uz pakalpojumu balstīti paziņojumi un komandas<br>→ Pakalpojuma atjaunināšanas paziņojumi un komandas<br>→ Pakalpojuma atjaunošanas paziņojumi un komandas<br>→ Atklāšanas paziņojumi un komandas<br>→ Autoreģistrācijas paziņojumi un komandas<br>→ Iekšējie paziņojumi<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas|*Notikuma, kas izraisīja darbību, laiks hh:mm:ss formātā.*<br>Piemēram: 12:57:53.| |{EVENT.UPDATE.ACTION}|→ Problēmas atjaunināšanas paziņojumi un komandas|*Cilvēkam saprotams veiktās darbības(-u) nosaukums* [problēmas atjaunināšanas](/manual/acknowledgment#updating-problems) laikā.<br>Tiek atveidots kā viena no šādām vērtībām: *apstiprināts*, *neapstiprināts*, *pievienots komentārs*, *mainīta nopietnība no (sākotnējā nopietnība) uz (atjauninātā nopietnība)* un *aizvērts* (atkarībā no tā, cik darbību veiktas vienā atjauninājumā).| |{EVENT.UPDATE.DATE}|→ Problēmas atjaunināšanas paziņojumi un komandas<br>→ Pakalpojuma atjaunināšanas paziņojumi un komandas|*Notikuma [atjaunināšanas](/manual/config/notifications/action/update_operations) (apstiprināšana u. c.) datums yyyy.mm.dd formātā.*<br>`{ACK.DATE}` ir novecojis un atbalstītajās vietās var netikt atveidots.| |{EVENT.UPDATE.HISTORY}|→ Uz trigeri balstīti paziņojumi un komandas<br>→ Problēmas atjaunināšanas paziņojumi un komandas<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas|*Problēmas atjauninājumu žurnāls (apstiprināšana u. c.).*<br>`{EVENT.ACK.HISTORY}` ir novecojis un atbalstītajās vietās var netikt atveidots.| |{EVENT.UPDATE.MESSAGE}|→ Problēmas atjaunināšanas paziņojumi un komandas|*Problēmas atjaunināšanas ziņojums.*<br>`{ACK.MESSAGE}` ir novecojis un atbalstītajās vietās var netikt atveidots.| |{EVENT.UPDATE.NSEVERITY}|→ Pakalpojuma atjaunināšanas paziņojumi un komandas |*Jaunās notikuma nopietnības skaitliskā vērtība, kas iestatīta problēmas atjaunināšanas darbības laikā.* | |{EVENT.UPDATE.SEVERITY}|→ Pakalpojuma atjaunināšanas paziņojumi un komandas |*Jaunās notikuma nopietnības nosaukums, kas iestatīts problēmas atjaunināšanas darbības laikā.* | |{EVENT.UPDATE.STATUS}|→ Uz trigeri balstīti paziņojumi un komandas<br>→ Problēmas atjaunināšanas paziņojumi un komandas<br>→ Pakalpojuma atjaunināšanas paziņojumi un komandas (kopš Zabbix 7.0.2)<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas|*Problēmas atjaunināšanas statusa skaitliskā vērtība.* Iespējamās vērtības: 0 - webhook tika izsaukts problēmas/atjaunošanas notikuma dēļ, 1 - atjaunināšanas darbība.| |{EVENT.UPDATE.TIME}|→ Problēmas atjaunināšanas paziņojumi un komandas<br>→ Pakalpojuma atjaunināšanas paziņojumi un komandas|*Notikuma [atjaunināšanas](/manual/config/notifications/action/update_operations) (apstiprināšana u. c.) laiks hh:mm:ss formātā.*<br>`{ACK.TIME}` ir novecojis un atbalstītajās vietās var netikt atveidots.| |{EVENT.VALUE}|→ Uz trigeri balstīti paziņojumi un komandas<br>→ Problēmas atjaunināšanas paziņojumi un komandas<br>→ Uz pakalpojumu balstīti paziņojumi un komandas<br>→ Pakalpojuma atjaunināšanas paziņojumi un komandas<br>→ Pakalpojuma atjaunošanas paziņojumi un komandas<br>→ Iekšējie paziņojumi<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts|*Notikuma, kas izraisīja darbību, skaitliskā vērtība (1 problēmai, 0 atjaunošanai).*| #### Events Retrieve events generated by triggers, network discovery and other Zabbix systems for more flexible situation management or third-party tool integration. [Event API](/manual/api/reference/event) #### Notikumi Iegūstiet notikumus, ko ģenerējuši trigeri, tīkla atklāšana un citas Zabbix sistēmas, lai nodrošinātu elastīgāku situāciju pārvaldību vai integrāciju ar trešo pušu rīkiem. [Notikumu API](/manual/api/reference/event) ### Event tag The event tag object has the following properties. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |tag|string|Event tag name.| |value|string|Event tag value.| ### Notikuma tags Notikuma taga objektam ir šādas īpašības. |Īpašība|[Tips](/manual/api/reference_commentary#data-types)|Apraksts| |--|--|------| |tag|string|Notikuma taga nosaukums.| |value|string|Notikuma taga vērtība.| # Event This class is designed to work with events. Object references: - [Event](/manual/api/reference/event/object#event) - [Event tag](/manual/api/reference/event/object#event-tag) - [Media type URL](/manual/api/reference/event/object#media-type-url) Available methods: - [event.get](/manual/api/reference/event/get) - retrieve events - [event.acknowledge](/manual/api/reference/event/acknowledge) - acknowledge events # Notikums Šī klase ir paredzēta darbam ar notikumiem. Objektu atsauces: - [Notikums](/manual/api/reference/event/object#event) - [Notikuma tags](/manual/api/reference/event/object#event-tag) - [Mediju tipa URL](/manual/api/reference/event/object#media-type-url) Pieejamās metodes: - [event.get](/manual/api/reference/event/get) - izgūt notikumus - [event.acknowledge](/manual/api/reference/event/acknowledge) - apstiprināt notikumus #### event [ZBXNEXT-6974](https://support.zabbix.com/browse/ZBXNEXT-6974) `event.get`: Added new parameters `selectAcknowledges`, `selectAlerts`, `trigger_severities`, and `groupBy`.<br> [ZBXNEXT-6974](https://support.zabbix.com/browse/ZBXNEXT-6974) `event.get`: Deprecated parameters `select_acknowledges` and `select_alerts`.<br> [ZBXNEXT-2299](https://support.zabbix.com/browse/ZBXNEXT-2299), [ZBX-23240](https://support.zabbix.com/browse/ZBX-23240) `event.get`: Added new parameters `action` and `action_userids`. #### notikums [ZBXNEXT-6974](https://support.zabbix.com/browse/ZBXNEXT-6974) `event.get`: Pievienoti jauni parametri `selectAcknowledges`, `selectAlerts`, `trigger_severities` un `groupBy`.<br> [ZBXNEXT-6974](https://support.zabbix.com/browse/ZBXNEXT-6974) `event.get`: Novecojuši parametri `select_acknowledges` un `select_alerts`.<br> [ZBXNEXT-2299](https://support.zabbix.com/browse/ZBXNEXT-2299), [ZBX-23240](https://support.zabbix.com/browse/ZBX-23240) `event.get`: Pievienoti jauni parametri `action` un `action_userids`. #### event [ZBXNEXT-6974](https://support.zabbix.com/browse/ZBXNEXT-6974) `event.get`: Added strict validation of the method parameters. #### notikums [ZBXNEXT-6974](https://support.zabbix.com/browse/ZBXNEXT-6974) `event.get`: Pievienota stingra metodes parametru validācija. ### Example ### Piemērs #### Example #### Piemērs ##### Example 10 CPU activity at any time with exception. Use of function time() and **not** operator: ```default min(/zabbix/system.cpu.load[all,avg1],5m)>2 and not (dayofweek()=7 and time()>230000) and not (dayofweek()=1 and time()<010000) ``` The trigger may change its state to problem at any time, except for 2 hours on a week change (Sunday, 23:00 - Monday, 01:00). ##### Piemērs 10 CPU aktivitāte jebkurā laikā ar izņēmumu. Funkcijas time() un **not** operatora lietošana: ```default min(/zabbix/system.cpu.load[all,avg1],5m)>2 and not (dayofweek()=7 and time()>230000) and not (dayofweek()=1 and time()<010000) ``` Trigeris var jebkurā laikā mainīt savu stāvokli uz problēmu, izņemot 2 stundas nedēļas maiņas laikā (svētdiena, 23:00 - pirmdiena, 01:00). ##### Example 11 Check if client local time is in sync with Zabbix server time. Use of function fuzzytime(): ```default fuzzytime(/MySQL_DB/system.localtime,10s)=0 ``` The trigger will change to the problem state in case when local time on server MySQL\_DB and Zabbix server differs by more than 10 seconds. Note that 'system.localtime' must be configured as a [passive check](/manual/appendix/items/activepassive#passive-checks) for Zabbix agent; on Zabbix agent 2 it may be configured as an active check. ##### Piemērs 11 Pārbaudiet, vai klienta lokālais laiks ir sinhronizēts ar Zabbix servera laiku. Funkcijas fuzzytime() izmantošana: ```default fuzzytime(/MySQL_DB/system.localtime,10s)=0 ``` Trigeris pāries problēmas stāvoklī gadījumā, ja lokālais laiks serverī MySQL\_DB un Zabbix serverī atšķiras par vairāk nekā 10 sekundēm. Ņemiet vērā, ka 'system.localtime' Zabbix aģentam ir jākonfigurē kā [pasīvā pārbaude](/manual/appendix/items/activepassive#passive-checks); Zabbix agent 2 to var konfigurēt kā aktīvu pārbaudi. ##### Example 12 Comparing average load today with average load of the same time yesterday (using time shift as `now-1d`). ```default avg(/server/system.cpu.load,1h)/avg(/server/system.cpu.load,1h:now-1d)>2 ``` The trigger will fire if the average load of the last hour tops the average load of the same hour yesterday more than two times. ##### Piemērs 12 Salīdzinot šodienas vidējo slodzi ar vakardienas tā paša laika vidējo slodzi (izmantojot laika nobīdi kā `now-1d`). ```default avg(/server/system.cpu.load,1h)/avg(/server/system.cpu.load,1h:now-1d)>2 ``` Trigeris nostrādās, ja pēdējās stundas vidējā slodze vairāk nekā divas reizes pārsniegs tās pašas stundas vidējo slodzi vakar. ##### Example 13 Using the value of another item to get a trigger threshold: ```default last(/Template PfSense/hrStorageFree[{#SNMPVALUE}])<last(/Template PfSense/hrStorageSize[{#SNMPVALUE}])*0.1 ``` The trigger will fire if the free storage drops below 10 percent. ##### Piemērs 13 Cita vienuma vērtības izmantošana, lai iegūtu trigera slieksni: ```default last(/Template PfSense/hrStorageFree[{#SNMPVALUE}])<last(/Template PfSense/hrStorageSize[{#SNMPVALUE}])*0.1 ``` Trigeris nostrādās, ja brīvās krātuves apjoms samazināsies zem 10 procentiem. ##### Example 14 Using [evaluation result](#operators) to get the number of triggers over a threshold: ```default (last(/server1/system.cpu.load[all,avg1])>5) + (last(/server2/system.cpu.load[all,avg1])>5) + (last(/server3/system.cpu.load[all,avg1])>5)>=2 ``` The trigger will fire if at least two of the triggers in the expression are in a problem state. ##### Piemērs 14 Izmantojot [izvērtēšanas rezultātu](#operators), lai iegūtu trigeru skaitu virs sliekšņa: ```default (last(/server1/system.cpu.load[all,avg1])>5) + (last(/server2/system.cpu.load[all,avg1])>5) + (last(/server3/system.cpu.load[all,avg1])>5)>=2 ``` Trigeris aktivizēsies, ja vismaz divi no izteiksmē iekļautajiem trigeriem būs problēmas stāvoklī. ##### Example 15 Comparing string values of two items - operands here are functions that return strings. Problem: create an alert if Ubuntu version is different on different hosts ```default last(/NY Zabbix server/vfs.file.contents[/etc/os-release])<>last(/LA Zabbix server/vfs.file.contents[/etc/os-release]) ``` ##### Piemērs 15 Divu vienumu virkņu vērtību salīdzināšana - operandi šeit ir funkcijas, kas atgriež virknes. Problēma: izveidot brīdinājumu, ja Ubuntu versija atšķiras dažādos hosts ```default last(/NY Zabbix server/vfs.file.contents[/etc/os-release])<>last(/LA Zabbix server/vfs.file.contents[/etc/os-release]) ``` ##### Example 16 Comparing two string values - operands are: - a function that returns a string - a combination of macros and strings Problem: detect changes in the DNS query The item key is: ```default net.dns.record[192.0.2.1,{$WEBSITE_NAME},{$DNS_RESOURCE_RECORD_TYPE},2,1] ``` with macros defined as ```default {$WEBSITE_NAME} = example.com {$DNS_RESOURCE_RECORD_TYPE} = MX ``` and normally returns: ```default example.com MX 0 mail.example.com ``` So our trigger expression to detect if the DNS query result deviated from the expected result is: ```default last(/Zabbix server/net.dns.record[192.0.2.1,{$WEBSITE_NAME},{$DNS_RESOURCE_RECORD_TYPE},2,1])<>"{$WEBSITE_NAME} {$DNS_RESOURCE_RECORD_TYPE} 0 mail.{$WEBSITE_NAME}" ``` Notice the quotes around the second operand. ##### Piemērs 16 Salīdzinot divas virknes vērtības - operandi ir: - funkcija, kas atgriež virkni - makro un virkņu kombinācija Problēma: noteikt izmaiņas DNS vaicājumā Vienuma atslēga ir: ```default net.dns.record[192.0.2.1,{$WEBSITE_NAME},{$DNS_RESOURCE_RECORD_TYPE},2,1] ``` ar definētiem makro ```default {$WEBSITE_NAME} = example.com {$DNS_RESOURCE_RECORD_TYPE} = MX ``` un parasti atgriež: ```default example.com MX 0 mail.example.com ``` Tātad mūsu trigeris izteiksme, lai noteiktu, vai DNS vaicājuma rezultāts ir novirzījies no sagaidāmā rezultāta, ir: ```default last(/Zabbix server/net.dns.record[192.0.2.1,{$WEBSITE_NAME},{$DNS_RESOURCE_RECORD_TYPE},2,1])<>"{$WEBSITE_NAME} {$DNS_RESOURCE_RECORD_TYPE} 0 mail.{$WEBSITE_NAME}" ``` Pievērsiet uzmanību pēdiņām ap otro operandu. ##### Example 17 Comparing two string values - operands are: - a function that returns a string - a string constant with special characters \\ and " Problem: detect if the `/tmp/hello` file content is equal to: ```default \" //hello ?\" ``` Option 1. Write the string directly: ```default last(/Zabbix server/vfs.file.contents[/tmp/hello])="\\\" //hello ?\\\"" ``` Notice how \\ and " characters are escaped when the string gets compared directly. Option 2. Use a macro ```default {$HELLO_MACRO} = \" //hello ?\" ``` in the expression: ```default last(/Zabbix server/vfs.file.contents[/tmp/hello])={$HELLO_MACRO} ``` ##### Piemērs 17 Salīdzinot divas virknes vērtības - operandi ir: - funkcija, kas atgriež virkni - virknes konstante ar īpašām rakstzīmēm \\ un " Problēma: noteikt, vai faila `/tmp/hello` saturs ir vienāds ar: ```default \" //hello ?\" ``` 1. variants. Ierakstiet virkni tieši: ```default last(/Zabbix server/vfs.file.contents[/tmp/hello])="\\\" //hello ?\\\"" ``` Ņemiet vērā, kā rakstzīmes \\ un " tiek ekrānētas, kad virkne tiek salīdzināta tieši. 2. variants. Izmantojiet makro ```default {$HELLO_MACRO} = \" //hello ?\" ``` izteiksmē: ```default last(/Zabbix server/vfs.file.contents[/tmp/hello])={$HELLO_MACRO} ``` ##### Example 18 Comparing long-term periods. Problem: Load of Exchange server increased by more than 10% last month ```default trendavg(/Exchange/system.cpu.load,1M:now/M)>1.1*trendavg(/Exchange/system.cpu.load,1M:now/M-1M) ``` You may also use the [Event name](/manual/config/triggers/trigger#configuration) field in trigger configuration to build a meaningful alert message, for example to receive something like `"Load of Exchange server increased by 24% in July (0.69) comparing to June (0.56)"` the event name must be defined as: ```default Load of {HOST.HOST} server increased by {{?100*trendavg(//system.cpu.load,1M:now/M)/trendavg(//system.cpu.load,1M:now/M-1M)}.fmtnum(0)}% in {{TIME}.fmttime(%B,-1M)} ({{?trendavg(//system.cpu.load,1M:now/M)}.fmtnum(2)}) comparing to {{TIME}.fmttime(%B,-2M)} ({{?trendavg(//system.cpu.load,1M:now/M-1M)}.fmtnum(2)}) ``` It is also useful to allow manual closing in trigger configuration for this kind of problem. ##### Piemērs 18 Ilgtermiņa periodu salīdzināšana. Problēma: Exchange servera slodze pagājušajā mēnesī palielinājās par vairāk nekā 10% ```default trendavg(/Exchange/system.cpu.load,1M:now/M)>1.1*trendavg(/Exchange/system.cpu.load,1M:now/M-1M) ``` Varat arī izmantot lauku [Notikuma nosaukums](/manual/config/triggers/trigger#configuration) trigeru konfigurācijā, lai izveidotu jēgpilnu brīdinājuma ziņojumu, piemēram, lai saņemtu kaut ko līdzīgu `"Exchange servera slodze jūlijā palielinājās par 24% (0.69), salīdzinot ar jūniju (0.56)"` notikuma nosaukumam jābūt definētam šādi: ```default Load of {HOST.HOST} server increased by {{?100*trendavg(//system.cpu.load,1M:now/M)/trendavg(//system.cpu.load,1M:now/M-1M)}.fmtnum(0)}% in {{TIME}.fmttime(%B,-1M)} ({{?trendavg(//system.cpu.load,1M:now/M)}.fmtnum(2)}) comparing to {{TIME}.fmttime(%B,-2M)} ({{?trendavg(//system.cpu.load,1M:now/M-1M)}.fmtnum(2)}) ``` Šāda veida problēmai trigeru konfigurācijā ir arī lietderīgi atļaut manuālu aizvēršanu. ##### Example 1 Calculating percentage of free disk space on '/'. Use of function **last**: 100*last(//vfs.fs.size[/,free])/last(//vfs.fs.size[/,total]) Zabbix will take the latest values for free and total disk spaces and calculate percentage according to the given formula. ##### Piemērs 1 Brīvās diska vietas procentuālā daudzuma aprēķins uz '/'. Funkcijas **last** izmantošana: 100*last(//vfs.fs.size[/,free])/last(//vfs.fs.size[/,total]) Zabbix izmantos jaunākās brīvās un kopējās diska vietas vērtības un aprēķinās procentuālo daudzumu atbilstoši dotajai formulai. ##### Example 1: Convert a number (scientific notation to integer) Convert the number "2.62128e+07" from scientific notation to an integer. ```javascript return (Number(value)) ``` Value returned by the function: 26212800. ##### Piemērs 1: Pārveidot skaitli (zinātniskā pieraksta formu uz veselu skaitli) Pārveidojiet skaitli "2.62128e+07" no zinātniskā pieraksta formas uz veselu skaitli. ```javascript return (Number(value)) ``` Funkcijas atgrieztā vērtība: 26212800. ##### Example 1: Discovering MBeans This rule will return 3 objects: the top row of the column: MBean1, MBean2, MBean3. For more information about objects please refer to [supported macros](/manual/discovery/low_level_discovery/examples/jmx#supported-macros) table, *Discovery of MBeans* section. Discovery rule configuration collecting MBeans (without the attributes) looks like the following:  The key used here: jmx.discovery[beans,"*:type=GarbageCollector,name=*"] All the garbage collectors without attributes will be discovered. As Garbage collectors have the same attribute set, we can use desired attributes in item prototypes the following way:  The keys used here: jmx[{#JMXOBJ},CollectionCount] jmx[{#JMXOBJ},CollectionTime] jmx[{#JMXOBJ},Valid] LLD discovery rule will result in something close to this (items are discovered for two Garbage collectors): {width="600"} ##### Piemērs 1: MBean atklāšana Šis noteikums atgriezīs 3 objektus: kolonnas augšējo rindu: MBean1, MBean2, MBean3. Plašāku informāciju par objektiem skatiet [atbalstīto makrosu](/manual/discovery/low_level_discovery/examples/jmx#supported-macros) tabulā, sadaļā *MBean atklāšana*. Atklāšanas noteikuma konfigurācija MBean vākšanai (bez atribūtiem) izskatās šādi:  Šeit izmantotā atslēga: jmx.discovery[beans,"*:type=GarbageCollector,name=*"] Tiks atklāti visi atkritumu savācēji bez atribūtiem. Tā kā atkritumu savācējiem ir viens un tas pats atribūtu kopums, mēs varam izmantot vajadzīgos atribūtus vienumu prototipos šādi:  Šeit izmantotās atslēgas: jmx[{#JMXOBJ},CollectionCount] jmx[{#JMXOBJ},CollectionTime] jmx[{#JMXOBJ},Valid] LLD atklāšanas noteikuma rezultāts būs aptuveni šāds (vienumi tiek atklāti diviem atkritumu savācējiem): {width="600"} #### Example 1 General example: |Parameter|Description| |--|--------| |**OID**|1.2.3.45.6.7.8.0 (or .1.2.3.45.6.7.8.0)| |**Key**|<Unique string to be used as reference to triggers><br>For example, "my\_param".| Note that OID can be given in either numeric or string form. However, in some cases, string OID must be converted to numeric representation. Utility snmpget may be used for this purpose: ```bash snmpget -On localhost public enterprises.ucdavis.memory.memTotalSwap.0 ``` #### Piemērs 1 Vispārīgs piemērs: |Parametrs|Apraksts| |--|--------| |**OID**|1.2.3.45.6.7.8.0 (vai .1.2.3.45.6.7.8.0)| |**Atslēga**|<Unikāla virkne, kas tiks izmantota kā atsauce uz trigeriem><br>Piemēram, "my\_param".| Ņemiet vērā, ka OID var norādīt gan skaitliskā, gan virknes formā. Tomēr dažos gadījumos virknes OID ir jāpārveido skaitliskā attēlojumā. Šim nolūkam var izmantot utilītu snmpget: ```bash snmpget -On localhost public enterprises.ucdavis.memory.memTotalSwap.0 ``` #### Example 1. In Zabbix, add a user macro {$PASSWORD} of type *Vault secret* and with the value `AppID=zabbix_server&Query=Safe=passwordSafe;Object=zabbix:Content`  2. Zabbix will send the following API request to the vault: ```bash curl \ --header "Content-Type: application/json" \ --cert cert.pem \ --key key.pem \ https://127.0.0.1:1858/AIMWebService/api/Accounts?AppID=zabbix_server&Query=Safe=passwordSafe;Object=zabbix_server_database ``` 3. The vault response will contain the key "Content": ```json { "Content": <password>, "UserName": <username>, "Address": <address>, "Database" :<Database>, "PasswordChangeInProcess":<PasswordChangeInProcess> } ``` 4. As a result, Zabbix will resolve the macro {$PASSWORD} to the value - <password> #### Piemērs 1. Zabbix pievienojiet lietotāja makrosu {$PASSWORD} ar tipu *Vault secret* un vērtību `AppID=zabbix_server&Query=Safe=passwordSafe;Object=zabbix:Content`  2. Zabbix nosūtīs uz glabātuvi šādu API pieprasījumu: ```bash curl \ --header "Content-Type: application/json" \ --cert cert.pem \ --key key.pem \ https://127.0.0.1:1858/AIMWebService/api/Accounts?AppID=zabbix_server&Query=Safe=passwordSafe;Object=zabbix_server_database ``` 3. Glabātuves atbilde saturēs atslēgu "Content": ```json { "Content": <password>, "UserName": <username>, "Address": <address>, "Database" :<Database>, "PasswordChangeInProcess":<PasswordChangeInProcess> } ``` 4. Rezultātā Zabbix atrisinās makrosu {$PASSWORD} uz vērtību - <password> **Example** 1. In Zabbix, add a user macro {$PASSWORD} of type "Vault secret" and with the value `macros:password`  2. Run the following CLI commands to create required secret in the vault: ```bash # Enable "secret/" mount point if not already enabled; note that "kv-v2" must be used. vault secrets enable -path=secret/ kv-v2 # Put new secret with key "password" under mount point "secret/" and path "zabbix/macros". vault kv put -mount=secret zabbix/macros password=<password> # Test that secret is successfully added. vault kv get secret/zabbix/macros # Finally test with Curl; note that "data" need to be manually added after mount point and "/v1" before the mount point, also see --capath parameter. curl --header "X-Vault-Token: <VaultToken>" https://127.0.0.1:8200/v1/secret/data/zabbix/macros ``` 3. As a result, Zabbix will resolve the macro {$PASSWORD} to the value: <password> **Piemērs** 1. Zabbix pievienojiet lietotāja makrosu {$PASSWORD} ar tipu "Vault secret" un vērtību `macros:password`  2. Palaidiet šādas CLI komandas, lai izveidotu nepieciešamo noslēpumu glabātuvē: ```bash # Iespējojiet "secret/" montēšanas punktu, ja tas vēl nav iespējots; ņemiet vērā, ka jāizmanto "kv-v2". vault secrets enable -path=secret/ kv-v2 # Ievietojiet jaunu noslēpumu ar atslēgu "password" zem montēšanas punkta "secret/" un ceļa "zabbix/macros". vault kv put -mount=secret zabbix/macros password=<password> # Pārbaudiet, vai noslēpums ir veiksmīgi pievienots. vault kv get secret/zabbix/macros # Visbeidzot pārbaudiet ar Curl; ņemiet vērā, ka "data" manuāli jāpievieno aiz montēšanas punkta un "/v1" pirms montēšanas punkta, skatiet arī parametru --capath. curl --header "X-Vault-Token: <VaultToken>" https://127.0.0.1:8200/v1/secret/data/zabbix/macros ``` 3. Rezultātā Zabbix atrisinās makrosu {$PASSWORD} uz vērtību: <password> ##### Example 1. In *zabbix_server.conf*, specify the following parameters: ```ini Vault=CyberArk VaultURL=https://127.0.0.1:1858 VaultDBPath=AppID=zabbix_server&Query=Safe=passwordSafe;Object=zabbix_server_database VaultTLSCertFile=cert.pem VaultTLSKeyFile=key.pem VaultPrefix=/AIMWebService/api/Accounts? ``` 2. Zabbix will send the following API request to the vault: ```bash curl \ --header "Content-Type: application/json" \ --cert cert.pem \ --key key.pem \ https://127.0.0.1:1858/AIMWebService/api/Accounts?AppID=zabbix_server&Query=Safe=passwordSafe;Object=zabbix_server_database ``` 3. The vault response will contain the keys "Content" and "UserName": ```json { "Content": <password>, "UserName": <username>, "Address": <address>, "Database": <Database>, "PasswordChangeInProcess":<PasswordChangeInProcess> } ``` 4. As a result, Zabbix will use the following credentials for database authentication: - Username: <username> - Password: <password> ##### Piemērs 1. Failā *zabbix_server.conf* norādiet šādus parametrus: ```ini Vault=CyberArk VaultURL=https://127.0.0.1:1858 VaultDBPath=AppID=zabbix_server&Query=Safe=passwordSafe;Object=zabbix_server_database VaultTLSCertFile=cert.pem VaultTLSKeyFile=key.pem VaultPrefix=/AIMWebService/api/Accounts? ``` 2. Zabbix nosūtīs uz glabātuvi šādu API pieprasījumu: ```bash curl \ --header "Content-Type: application/json" \ --cert cert.pem \ --key key.pem \ https://127.0.0.1:1858/AIMWebService/api/Accounts?AppID=zabbix_server&Query=Safe=passwordSafe;Object=zabbix_server_database ``` 3. Glabātuves atbilde saturēs atslēgas "Content" un "UserName": ```json { "Content": <password>, "UserName": <username>, "Address": <address>, "Database": <Database>, "PasswordChangeInProcess":<PasswordChangeInProcess> } ``` 4. Rezultātā Zabbix datubāzes autentifikācijai izmantos šādus akreditācijas datus: - Lietotājvārds: <username> - Parole: <password> **Example** 1. In *zabbix_server.conf*, specify the following parameters: ```ini Vault=HashiCorp VaultToken=hvs.CAESIIG_PILmULFYOsEyWHxkZ2mF2a8VPKNLE8eHqd4autYGGh4KHGh2cy5aeTY0NFNSaUp3ZnpWbDF1RUNjUkNTZEg VaultURL=https://127.0.0.1:8200 VaultDBPath=database VaultPrefix=/v1/secret/data/zabbix/ ``` 2. Run the following CLI commands to create the required secret in the vault: ```bash # Enable "secret/" mount point if not already enabled; note that "kv-v2" must be used. vault secrets enable -path=secret/ kv-v2 # Put new secrets with keys username and password under mount point "secret/" and path "zabbix/database". vault kv put -mount=secret zabbix/database username=zabbix password=<password> # Test that secret is successfully added. vault kv get secret/zabbix/database # Finally test with Curl; note that "data" need to be manually added after mount point and "/v1" before the mount point, also see --capath parameter. curl --header "X-Vault-Token: <VaultToken>" https://127.0.0.1:8200/v1/secret/data/zabbix/database ``` 3. As a result, Zabbix server will retrieve the following credentials for database authentication: - Username: zabbix - Password: <password> **Piemērs** 1. Failā *zabbix_server.conf* norādiet šādus parametrus: ```ini Vault=HashiCorp VaultToken=hvs.CAESIIG_PILmULFYOsEyWHxkZ2mF2a8VPKNLE8eHqd4autYGGh4KHGh2cy5aeTY0NFNSaUp3ZnpWbDF1RUNjUkNTZEg VaultURL=https://127.0.0.1:8200 VaultDBPath=database VaultPrefix=/v1/secret/data/zabbix/ ``` 2. Izpildiet šādas CLI komandas, lai glabātuvē izveidotu nepieciešamo noslēpumu: ```bash # Iespējojiet "secret/" montēšanas punktu, ja tas vēl nav iespējots; ņemiet vērā, ka jāizmanto "kv-v2". vault secrets enable -path=secret/ kv-v2 # Pievienojiet jaunus noslēpumus ar atslēgām username un password zem montēšanas punkta "secret/" un ceļa "zabbix/database". vault kv put -mount=secret zabbix/database username=zabbix password=<password> # Pārbaudiet, vai noslēpums ir veiksmīgi pievienots. vault kv get secret/zabbix/database # Visbeidzot pārbaudiet ar Curl; ņemiet vērā, ka "data" manuāli jāpievieno pēc montēšanas punkta un "/v1" pirms montēšanas punkta; skatiet arī parametru --capath. curl --header "X-Vault-Token: <VaultToken>" https://127.0.0.1:8200/v1/secret/data/zabbix/database ``` 3. Rezultātā Zabbix serveris iegūs šādus akreditācijas datus datubāzes autentifikācijai: - Lietotājvārds: zabbix - Parole: <password> ##### Example 1 Message subject: Problem: {TRIGGER.NAME} When you receive the message, the message subject will be replaced by something like: Problem: Processor load is too high on Zabbix server ##### Piemērs 1 Ziņojuma temats: Problem: {TRIGGER.NAME} Kad saņemsiet ziņojumu, ziņojuma temats tiks aizstāts ar, piemēram: Problem: Processor load is too high on Zabbix server ##### Example 1 Monitoring of two instances "MySQL1" and "MySQL2". Configuration parameters: ```bash Plugins.Mysql.Sessions.MySQL1.Uri=tcp://127.0.0.1:3306 Plugins.Mysql.Sessions.MySQL1.User=mysql1_user Plugins.Mysql.Sessions.MySQL1.Password=unique_password Plugins.Mysql.Sessions.MySQL2.Uri=tcp://192.0.2.1:3306 Plugins.Mysql.Sessions.MySQL2.User=mysql2_user Plugins.Mysql.Sessions.MySQL2.Password=different_password ``` As a result of this configuration, each session name may be used as a connString in an [item key](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2), e.g., `mysql.ping[MySQL1]` or `mysql.ping[MySQL2]`. ##### Piemērs 1 Divu instanču "MySQL1" un "MySQL2" uzraudzība. Konfigurācijas parametri: ```bash Plugins.Mysql.Sessions.MySQL1.Uri=tcp://127.0.0.1:3306 Plugins.Mysql.Sessions.MySQL1.User=mysql1_user Plugins.Mysql.Sessions.MySQL1.Password=unique_password Plugins.Mysql.Sessions.MySQL2.Uri=tcp://192.0.2.1:3306 Plugins.Mysql.Sessions.MySQL2.User=mysql2_user Plugins.Mysql.Sessions.MySQL2.Password=different_password ``` Šīs konfigurācijas rezultātā katru sesijas nosaukumu var izmantot kā connString [vienuma atslēgā](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2), piemēram, `mysql.ping[MySQL1]` vai `mysql.ping[MySQL2]`. **Example 1** Restart of Windows on certain condition. In order to automatically restart Windows upon a problem detected by Zabbix, define the following script: |Script parameter|Value| |--|--------| |*Scope*|'Action operation'| |*Type*|'Script'| |*Command*|c:\\windows\\system32\\shutdown.exe -r -f| **Piemērs 1** Windows restartēšana noteiktā nosacījumā. Lai automātiski restartētu Windows, kad Zabbix ir konstatējis problēmu, definējiet šādu skriptu: |Skripta parametrs|Vērtība| |--|--------| |*Darbības joma*|'Darbības operācija'| |*Tips*|'Skripts'| |*Komanda*|c:\\windows\\system32\\shutdown.exe -r -f| ##### Example 1 Sending a repeated notification once every 30 minutes (5 times in total) to a "MySQL Administrators" group. To configure: - In *Operations* tab, set the *Default operation step duration* to "30m" (30 minutes). - Set the escalation *Steps* to be from "1" to "5". - Select the "MySQL Administrators" group as the recipients of the message. {width="600"} Notifications will be sent at 0:00, 0:30, 1:00, 1:30, 2:00 hours after the problem starts (unless, of course, the problem is resolved sooner). If the problem is resolved and a recovery message is configured, it will be sent to those who received at least one problem message within this escalation scenario. ::: noteclassic If the trigger that generated an active escalation is disabled, Zabbix sends an informative message about it to all those that have already received notifications. ::: ##### Piemērs 1 Atkārtota paziņojuma sūtīšana reizi 30 minūtēs (kopā 5 reizes) grupai "MySQL Administrators". Lai to konfigurētu: - Cilnē *Operations* iestatiet *Default operation step duration* uz "30m" (30 minūtes). - Iestatiet eskalācijas *Steps* no "1" līdz "5". - Atlasiet grupu "MySQL Administrators" kā ziņojuma saņēmējus. {width="600"} Paziņojumi tiks nosūtīti pēc 0:00, 0:30, 1:00, 1:30 un 2:00 stundām kopš problēmas sākuma (ja vien, protams, problēma netiek atrisināta agrāk). Ja problēma tiek atrisināta un ir konfigurēts atkopšanas ziņojums, tas tiks nosūtīts tiem, kuri šajā eskalācijas scenārijā saņēma vismaz vienu problēmas ziņojumu. ::: noteclassic Ja trigeris, kas izveidoja aktīvu eskalāciju, tiek atspējots, Zabbix nosūta informatīvu ziņojumu visiem tiem, kuri jau ir saņēmuši paziņojumus. ::: ##### Example 1 Send simple GET requests to retrieve data from services such as Elasticsearch: - Create a GET item with URL: `localhost:9200/?pretty` - Notice the response: ```json { "name" : "YQ2VAY-", "cluster_name" : "elasticsearch", "cluster_uuid" : "kH4CYqh5QfqgeTsjh2F9zg", "version" : { "number" : "6.1.3", "build_hash" : "af51318", "build_date" : "2018-01-26T18:22:55.523Z", "build_snapshot" : false, "lucene_version" : "7.1.0", "minimum_wire_compatibility_version" : "5.6.0", "minimum_index_compatibility_version" : "5.0.0" }, "tagline" : "You know, for search" } ``` - Now extract the version number using a JSONPath preprocessing step: `$.version.number` ##### Piemērs 1 Nosūtiet vienkāršus GET pieprasījumus, lai izgūtu datus no tādiem pakalpojumiem kā Elasticsearch: - Izveidojiet GET vienumu ar URL: `localhost:9200/?pretty` - Pievērsiet uzmanību atbildei: ```json { "name" : "YQ2VAY-", "cluster_name" : "elasticsearch", "cluster_uuid" : "kH4CYqh5QfqgeTsjh2F9zg", "version" : { "number" : "6.1.3", "build_hash" : "af51318", "build_date" : "2018-01-26T18:22:55.523Z", "build_snapshot" : false, "lucene_version" : "7.1.0", "minimum_wire_compatibility_version" : "5.6.0", "minimum_index_compatibility_version" : "5.0.0" }, "tagline" : "You know, for search" } ``` - Tagad izvelciet versijas numuru, izmantojot JSONPath priekšapstrādes soli: `$.version.number` ##### Example 1 Something very simple: UserParameter=ping[*],echo $1 We may define unlimited number of items for monitoring all having format ping\[something\]. - ping\[0\] - will always return '0' - ping\[aaa\] - will always return 'aaa' ##### Piemērs 1 Kaut kas ļoti vienkāršs: UserParameter=ping[*],echo $1 Mēs varam definēt neierobežotu skaitu vienumu uzraudzībai, kuriem visiem ir formāts ping\[kaut kas\]. - ping\[0\] - vienmēr atgriezīs '0' - ping\[aaa\] - vienmēr atgriezīs 'aaa' ##### Example 1 Temperature in server room is too high. Problem expression: ```default last(/server/temp)>20 ``` Recovery expression: ```default last(/server/temp)<=15 ``` ##### Piemērs 1 Temperatūra servera telpā ir pārāk augsta. Problēmas izteiksme: ```default last(/server/temp)>20 ``` Atjaunošanās izteiksme: ```default last(/server/temp)<=15 ``` ##### Example 1 The processor load is too high on Zabbix server. ```default last(/Zabbix server/system.cpu.load[all,avg1])>5 ``` By using the function 'last()', we are referencing the most recent value. `/Zabbix server/system.cpu.load[all,avg1]` gives a short name of the monitored parameter. It specifies that the host is 'Zabbix server' and the key being monitored is 'system.cpu.load\[all,avg1\]'. Finally, `>5` means that the trigger is in the PROBLEM state whenever the most recent processor load measurement from Zabbix server is greater than 5. ##### Piemērs 1 Procesora slodze ir pārāk augsta Zabbix serverī. ```default last(/Zabbix server/system.cpu.load[all,avg1])>5 ``` Izmantojot funkciju 'last()', mēs atsaucamies uz jaunāko vērtību. `/Zabbix server/system.cpu.load[all,avg1]` norāda uz uzraudzītā parametra īso nosaukumu. Tā nosaka, ka hosts ir 'Zabbix server' un uzraudzītais atslēgas nosaukums ir 'system.cpu.load\[all,avg1\]'. Visbeidzot, `>5` nozīmē, ka trigeris ir PROBLEM stāvoklī ikreiz, kad jaunākais procesora slodzes mērījums no Zabbix serveris ir lielāks par 5. ##### Example 1 To create a "Web scenario failed" trigger, you can define a trigger expression: last(/host/web.test.fail[Scenario])<>0 Make sure to replace 'Scenario' with the real name of your scenario. ##### Piemērs 1 Lai izveidotu "Tīmekļa scenārijs neizdevās" trigeri, varat definēt trigera izteiksmi: last(/host/web.test.fail[Scenario])<>0 Pārliecinieties, ka aizstājat 'Scenario' ar sava scenārija īsto nosaukumu. ##### Example 1 Total disk space of host group 'MySQL Servers'. ```default sum(last_foreach(/*/vfs.fs.size[/,total]?[group="MySQL Servers"])) ``` ##### Piemērs 1 Kopējā diska vieta hostu grupai 'MySQL Servers'. ```default sum(last_foreach(/*/vfs.fs.size[/,total]?[group="MySQL Servers"])) ``` ##### Example 1 Use of host-level macro in the "Status of SSH daemon" item key: `net.tcp.service[ssh,,{$SSH_PORT}]` This item can be assigned to multiple hosts, providing that the value of **{$SSH\_PORT}** is defined on those hosts. ##### Piemērs 1 Hosta līmeņa makrosa izmantošana vienuma atslēgā "SSH dēmona statuss": `net.tcp.service[ssh,,{$SSH_PORT}]` Šo vienumu var piešķirt vairākiem hostiem, ja šajos hostos ir definēta **{$SSH\_PORT}** vērtība. ##### Example 1 Use of the following expression in low-level discovery to discover databases except a database with a specific name: ```default ^TESTDATABASE$ ```  Chosen *Expression type*: "Result is FALSE". Doesn't match name, containing string "*TESTDATABASE*". ##### Piemērs 1 Tālāk norādītās izteiksmes izmantošana zemā līmeņa atklāšanā, lai atklātu datubāzes, izņemot datubāzi ar noteiktu nosaukumu: ```default ^TESTDATABASE$ ```  Izvēlētais *izteiksmes tips*: "Rezultāts ir FALSE". Neatbilst nosaukumam, kas satur virkni "*TESTDATABASE*". ##### Example 2 Calculating a 10-minute average of the number of values processed by Zabbix. Use of function **avg**: avg(/Zabbix Server/zabbix[wcache,values],10m) Note that extensive use of calculated items with long time periods may affect performance of Zabbix server. ##### Piemērs 2 10 minūšu vidējās vērtības aprēķināšana par Zabbix apstrādāto vērtību skaitu. Funkcijas **avg** izmantošana: avg(/Zabbix Server/zabbix[wcache,values],10m) Ņemiet vērā, ka plaša aprēķināto vienumu izmantošana ar gariem laika periodiem var ietekmēt Zabbix servera veiktspēju. ##### Example 2: Convert a number (binary to decimal) Convert the binary number "11010010" to a decimal number. ```javascript return(parseInt(value,2)) ``` Value returned by the function: 210. ##### Piemērs 2: Pārveidot skaitli (no binārās uz decimālo sistēmu) Pārveidojiet bināro skaitli "11010010" par decimālo skaitli. ```javascript return(parseInt(value,2)) ``` Funkcijas atgrieztā vērtība: 210. ##### Example 2: Discovering MBean attributes This rule will return 9 objects with the following fields: MBean1Attribute1, MBean2Attribute1, MBean3Attribute1,MBean1Attribute2,MBean2Attribute2, MBean3Attribute2, MBean1Attribute3, MBean2Attribute3, MBean3Attribute3. For more information about objects please refer to [supported macros](/manual/discovery/low_level_discovery/examples/jmx#supported-macros) table, *Discovery of MBean attributes* section. Discovery rule configuration collecting MBean attributes looks like the following:  The key used here: jmx.discovery[attributes,"*:type=GarbageCollector,name=*"] All the garbage collectors with a single item attribute will be discovered.  In this particular case an item will be created from prototype for every MBean attribute. The main drawback of this configuration is that trigger creation from trigger prototypes is impossible as there is only one item prototype for all attributes. So this setup can be used for data collection, but is not recommended for automatic monitoring. ##### Piemērs 2: MBean atribūtu atklāšana Šis noteikums atgriezīs 9 objektus ar šādiem laukiem: MBean1Attribute1, MBean2Attribute1, MBean3Attribute1,MBean1Attribute2,MBean2Attribute2, MBean3Attribute2, MBean1Attribute3, MBean2Attribute3, MBean3Attribute3. Lai iegūtu vairāk informācijas par objektiem, skatiet [atbalstīto makrosu](/manual/discovery/low_level_discovery/examples/jmx#supported-macros) tabulu sadaļā *MBean atribūtu atklāšana*. MBean atribūtu apkopojošā atklāšanas noteikuma konfigurācija izskatās šādi:  Šeit izmantotā atslēga: jmx.discovery[attributes,"*:type=GarbageCollector,name=*"] Tiks atklāti visi atkritumu savācēji ar viena vienuma atribūtu.  Šajā konkrētajā gadījumā no prototipa tiks izveidots vienums katram MBean atribūtam. Šīs konfigurācijas galvenais trūkums ir tas, ka trigeru izveide no trigeru prototipiem nav iespējama, jo visiem atribūtiem ir tikai viens vienuma prototips. Tāpēc šo iestatījumu var izmantot datu apkopošanai, taču tas nav ieteicams automātiskai uzraudzībai. ##### Example 2 Free disk space is too low. Problem expression: it is less than 10GB for last 5 minutes ```default max(/server/vfs.fs.size[/,free],5m)<10G ``` Recovery expression: it is more than 40GB for last 10 minutes ```default min(/server/vfs.fs.size[/,free],10m)>40G ``` ##### Piemērs 2 Brīvās diska vietas ir pārāk maz. Problēmas izteiksme: tā ir mazāka par 10 GB pēdējo 5 minūšu laikā ```default max(/server/vfs.fs.size[/,free],5m)<10G ``` Atjaunošanās izteiksme: tā ir lielāka par 40 GB pēdējo 10 minūšu laikā ```default min(/server/vfs.fs.size[/,free],10m)>40G ``` ##### Example 2 Let's add more sense! UserParameter=mysql.ping[*],mysqladmin -u$1 -p$2 ping | grep -c alive This parameter can be used for monitoring availability of MySQL database. We can pass user name and password: mysql.ping[zabbix,our_password] ##### Piemērs 2 Pievienosim vairāk jēgas! UserParameter=mysql.ping[*],mysqladmin -u$1 -p$2 ping | grep -c alive Šo parametru var izmantot MySQL datubāzes pieejamības uzraudzībai. Mēs varam nodot lietotājvārdu un paroli: mysql.ping[zabbix,our_password] ##### Example 2 Message: Processor load is: {?last(/zabbix.zabbix.com/system.cpu.load[,avg1])} When you receive the message, the message will be replaced by something like: Processor load is: 1.45 ##### Piemērs 2 Ziņojums: Procesora slodze ir: {?last(/zabbix.zabbix.com/system.cpu.load[,avg1])} Kad saņemsiet ziņojumu, tas tiks aizstāts ar kaut ko līdzīgu šim: Procesora slodze ir: 1.45 #### Example 2 Monitoring of uptime: |Parameter|Description| |--|--------| |**OID**|MIB::sysUpTime.0| |**Key**|router.uptime| |**Value type**|Float| |**Units**|uptime| |**Preprocessing step: Custom multiplier**|0.01| #### Piemērs 2 Darbspējas laika uzraudzība: |Parametrs|Apraksts| |--|--------| |**OID**|MIB::sysUpTime.0| |**Atslēga**|router.uptime| |**Vērtības tips**|Peldošā komata skaitlis| |**Mērvienības**|darbspējas laiks| |**Pirmsapstrādes solis: Pielāgots reizinātājs**|0.01| ##### Example 2 Providing some of the parameters in the item key. Configuration parameters: ```bash Plugins.PostgreSQL.Sessions.Session1.Uri=tcp://192.0.2.234:5432 Plugins.PostgreSQL.Sessions.Session1.User=old_username Plugins.PostgreSQL.Sessions.Session1.Password=session_password ``` [Item key](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2): `pgsql.ping[session1,new_username,,postgres]` As a result of this configuration, the agent will connect to PostgreSQL using the following parameters: - URI from session parameter: `192.0.2.234:5432` - Username from the item key: `new_username` - Password from session parameter (since it is omitted in the item key): `session_password` - Database name from the item key: `postgres` ##### Piemērs 2 Dažu parametru norādīšana vienuma atslēgā. Konfigurācijas parametri: ```bash Plugins.PostgreSQL.Sessions.Session1.Uri=tcp://192.0.2.234:5432 Plugins.PostgreSQL.Sessions.Session1.User=old_username Plugins.PostgreSQL.Sessions.Session1.Password=session_password ``` [Vienuma atslēga](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2): `pgsql.ping[session1,new_username,,postgres]` Šīs konfigurācijas rezultātā aģents izveidos savienojumu ar PostgreSQL, izmantojot šādus parametrus: - URI no sesijas parametra: `192.0.2.234:5432` - Lietotājvārds no vienuma atslēgas: `new_username` - Parole no sesijas parametra (jo tā vienuma atslēgā ir izlaista): `session_password` - Datubāzes nosaukums no vienuma atslēgas: `postgres` **Example 2** Restart the host by using IPMI control. |Script parameter|Value| |--|--------| |*Scope*|'Action operation'| |*Type*|'IPMI'| |*Command*|reset| **Piemērs 2** Pārstartējiet hostu, izmantojot IPMI vadību. |Skripta parametrs|Vērtība| |--|--------| |*Tvērums*|'Darbības operācija'| |*Tips*|'IPMI'| |*Komanda*|reset| ##### Example 2 Sending a delayed notification about a long-standing problem. To configure: - In *Operations* tab, set the *Default operation step duration* to "10h" (10 hours). - Set the escalation *Steps* to be from "2" to "2". {width="600"} A notification will only be sent at Step 2 of the escalation scenario, or 10 hours after the problem starts. You can customize the message text to something like "The problem is more than 10 hours old". ##### Piemērs 2 Aizkavēta paziņojuma nosūtīšana par ilgstošu problēmu. Lai to konfigurētu: - Cilnē *Operations* iestatiet *Default operation step duration* uz "10h" (10 stundas). - Iestatiet eskalācijas *Steps* no "2" līdz "2". {width="600"} Paziņojums tiks nosūtīts tikai eskalācijas scenārija 2. solī, jeb 10 stundas pēc problēmas sākuma. Varat pielāgot ziņojuma tekstu, piemēram: "Problēma ilgst jau vairāk nekā 10 stundas". ##### Example 2 Send simple POST requests to retrieve data from services such as Elasticsearch: - Create a POST item with URL: `http://localhost:9200/str/values/_search?scroll=10s` - Configure the following POST body to obtain the processor load (1 min average per core) ```json { "query": { "bool": { "must": [{ "match": { "itemid": 28275 } }], "filter": [{ "range": { "clock": { "gt": 1517565836, "lte": 1517566137 } } }] } } } ``` - Received: ```json { "_scroll_id": "DnF1ZXJ5VGhlbkZldGNoBQAAAAAAAAAkFllRMlZBWS1UU1pxTmdEeGVwQjRBTFEAAAAAAAAAJRZZUTJWQVktVFNacU5nRHhlcEI0QUxRAAAAAAAAACYWWVEyVkFZLVRTWnFOZ0R4ZXBCNEFMUQAAAAAAAAAnFllRMlZBWS1UU1pxTmdEeGVwQjRBTFEAAAAAAAAAKBZZUTJWQVktVFNacU5nRHhlcEI0QUxR", "took": 18, "timed_out": false, "_shards": { "total": 5, "successful": 5, "skipped": 0, "failed": 0 }, "hits": { "total": 1, "max_score": 1.0, "hits": [{ "_index": "dbl", "_type": "values", "_id": "dqX9VWEBV6sEKSMyk6sw", "_score": 1.0, "_source": { "itemid": 28275, "value": "0.138750", "clock": 1517566136, "ns": 25388713, "ttl": 604800 } }] } } ``` - Now use a JSONPath preprocessing step to get the item value: `$.hits.hits[0]._source.value` ##### Piemērs 2 Nosūtiet vienkāršus POST pieprasījumus, lai izgūtu datus no tādiem pakalpojumiem kā Elasticsearch: - Izveidojiet POST vienumu ar URL: `http://localhost:9200/str/values/_search?scroll=10s` - Konfigurējiet šādu POST body, lai iegūtu procesora noslodzi (1 minūtes vidējais rādītājs uz kodolu) ```json { "query": { "bool": { "must": [{ "match": { "itemid": 28275 } }], "filter": [{ "range": { "clock": { "gt": 1517565836, "lte": 1517566137 } } }] } } } ``` - Saņemts: ```json { "_scroll_id": "DnF1ZXJ5VGhlbkZldGNoBQAAAAAAAAAkFllRMlZBWS1UU1pxTmdEeGVwQjRBTFEAAAAAAAAAJRZZUTJWQVktVFNacU5nRHhlcEI0QUxRAAAAAAAAACYWWVEyVkFZLVRTWnFOZ0R4ZXBCNEFMUQAAAAAAAAAnFllRMlZBWS1UU1pxTmdEeGVwQjRBTFEAAAAAAAAAKBZZUTJWQVktVFNacU5nRHhlcEI0QUxR", "took": 18, "timed_out": false, "_shards": { "total": 5, "successful": 5, "skipped": 0, "failed": 0 }, "hits": { "total": 1, "max_score": 1.0, "hits": [{ "_index": "dbl", "_type": "values", "_id": "dqX9VWEBV6sEKSMyk6sw", "_score": 1.0, "_source": { "itemid": 28275, "value": "0.138750", "clock": 1517566136, "ns": 25388713, "ttl": 604800 } }] } } ``` - Tagad izmantojiet JSONPath priekšapstrādes soli, lai iegūtu vienuma vērtību: `$.hits.hits[0]._source.value` ##### Example 2 Sum of latest values of all items matching net.if.in\[\*\] on the host. ```default sum(last_foreach(/host/net.if.in[*])) ``` ##### Piemērs 2 Visu vienumu, kas atbilst net.if.in\[\*\], jaunāko vērtību summa hostā. ```default sum(last_foreach(/host/net.if.in[*])) ``` ##### Example 2 To create a "Web scenario failed" trigger with a useful problem description in the trigger name, you can define a trigger with name: Web scenario "Scenario" failed: {ITEM.VALUE} and trigger expression: length(last(/host/web.test.error[Scenario]))>0 and last(/host/web.test.fail[Scenario])>0 Make sure to replace 'Scenario' with the real name of your scenario. ##### Piemērs 2 Lai izveidotu trigeri "Web scenario failed" ar noderīgu problēmas aprakstu trigera nosaukumā, varat definēt trigeri ar nosaukumu: Web scenario "Scenario" failed: {ITEM.VALUE} un trigera izteiksmi: length(last(/host/web.test.error[Scenario]))>0 and last(/host/web.test.fail[Scenario])>0 Noteikti aizstājiet 'Scenario' ar jūsu scenārija īsto nosaukumu. ##### Example 2 Use of host-level macro in the "CPU load is too high" trigger: `last(/ca_001/system.cpu.load[,avg1])>{$MAX_CPULOAD}` Such a trigger would be created on the template, not edited in individual hosts. ::: notetip If you want to use the amount of values as the function parameter (for example, **max(/host/key,\#3)**), include hash mark in the macro definition like this: SOME\_PERIOD => \#3 ::: ##### Piemērs 2 Hosta līmeņa makrosa izmantošana trigerī "CPU load is too high": `last(/ca_001/system.cpu.load[,avg1])>{$MAX_CPULOAD}` Šāds trigeris tiktu izveidots veidnē, nevis rediģēts atsevišķos hostos. ::: notetip Ja vēlaties izmantot vērtību skaitu kā funkcijas parametru (piemēram, **max(/host/key,\#3)**), iekļaujiet restītes zīmi makrosa definīcijā šādi: SOME\_PERIOD => \#3 ::: ##### Example 2 www.example.com is overloaded. ```default last(/www.example.com/system.cpu.load[all,avg1])>5 or min(/www.example.com/system.cpu.load[all,avg1],10m)>2 ``` The expression is true when either the current processor load is more than 5 or the processor load was more than 2 during last 10 minutes. ##### Piemērs 2 www.example.com ir pārslogots. ```default last(/www.example.com/system.cpu.load[all,avg1])>5 or min(/www.example.com/system.cpu.load[all,avg1],10m)>2 ``` Izteiksme ir patiesa, ja pašreizējā procesora slodze ir lielāka par 5 vai ja procesora slodze pēdējo 10 minūšu laikā bija lielāka par 2. ##### Example 3 Average processor load of host group 'MySQL Servers'. ```default avg(last_foreach(/*/system.cpu.load[,avg1]?[group="MySQL Servers"])) ``` ##### Piemērs 3 Hosts grupas "MySQL Servers" vidējā procesora noslodze. ```default avg(last_foreach(/*/system.cpu.load[,avg1]?[group="MySQL Servers"])) ``` ##### Example 3 Calculating total bandwidth on eth0. Sum of two functions: last(//net.if.in[eth0,bytes])+last(//net.if.out[eth0,bytes]) ##### Piemērs 3 Kopējā joslas platuma aprēķināšana uz eth0. Divu funkciju summa: last(//net.if.in[eth0,bytes])+last(//net.if.out[eth0,bytes]) ##### Example 3 Checking if Zabbix API is alive, using [apiinfo.version](/manual/api/reference/apiinfo/version). - Item configuration: {width="600"} Note the use of the POST method with JSON data, setting request headers and asking to return headers only: - Item value preprocessing with regular expression to get HTTP code:  - Checking the result in *Latest data*: {width="600"} ##### Piemērs 3 Pārbauda, vai Zabbix API ir aktīvs, izmantojot [apiinfo.version](/manual/api/reference/apiinfo/version). - Vienuma konfigurācija: {width="600"} Ņemiet vērā POST metodes izmantošanu ar JSON datiem, iestatot pieprasījuma galvenes un pieprasot atgriezt tikai galvenes: - Vienuma vērtības pirmapstrāde ar regulāro izteiksmi, lai iegūtu HTTP kodu:  - Rezultāta pārbaude sadaļā *Latest data*: {width="600"} ##### Example 3 Collecting a metric using default configuration parameters. Configuration parameters: ```bash Plugins.PostgreSQL.Default.Uri=tcp://192.0.2.234:5432 Plugins.PostgreSQL.Default.User=zabbix Plugins.PostgreSQL.Default.Password=password ``` [Item key](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2): `pgsql.ping[,,,postgres]` As a result of this configuration, the agent will connect to PostgreSQL using the parameters: - Default URI: `192.0.2.234:5432` - Default username: `zabbix` - Default password: `password` - Database name from the item key: `postgres` ##### Piemērs 3 Metrikas apkopošana, izmantojot noklusējuma konfigurācijas parametrus. Konfigurācijas parametri: ```bash Plugins.PostgreSQL.Default.Uri=tcp://192.0.2.234:5432 Plugins.PostgreSQL.Default.User=zabbix Plugins.PostgreSQL.Default.Password=password ``` [Vienuma atslēga](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2): `pgsql.ping[,,,postgres]` Šīs konfigurācijas rezultātā aģents izveidos savienojumu ar PostgreSQL, izmantojot šādus parametrus: - Noklusējuma URI: `192.0.2.234:5432` - Noklusējuma lietotājvārds: `zabbix` - Noklusējuma parole: `password` - Datubāzes nosaukums no vienuma atslēgas: `postgres` ##### Example 3 Escalating the problem to the Boss. In the first example above we configured periodical sending of messages to MySQL administrators. In this case, the administrators will get four messages before the problem will be escalated to the Database manager. Note that the manager will get a message only in case the problem is not acknowledged yet, supposedly no one is working on it. {width="600"} Details of Operation 2: {width="600"} Note the use of {ESC.HISTORY} macro in the customized message. The macro will contain information about all previously executed steps on this escalation, such as notifications sent and commands executed. ##### Piemērs 3 Problēmas eskalēšana vadītājam. Pirmajā iepriekš minētajā piemērā mēs konfigurējām periodisku ziņojumu sūtīšanu MySQL administratoriem. Šajā gadījumā administratori saņems četrus ziņojumus, pirms problēma tiks eskalēta datubāzes pārvaldniekam. Ņemiet vērā, ka pārvaldnieks saņems ziņojumu tikai tad, ja problēma vēl nebūs apstiprināta, t. i., visticamāk, neviens ar to vēl nestrādā. {width="600"} 2. darbības informācija: {width="600"} Ņemiet vērā pielāgotajā ziņojumā izmantoto makrosu {ESC.HISTORY}. Šis makross saturēs informāciju par visām iepriekš izpildītajām šīs eskalācijas darbībām, piemēram, nosūtītajiem paziņojumiem un izpildītajām komandām. ##### Example 3 /etc/passwd has been changed. ```default last(/www.example.com/vfs.file.cksum[/etc/passwd],#1)<>last(/www.example.com/vfs.file.cksum[/etc/passwd],#2) ``` The expression is true when the previous value of /etc/passwd checksum differs from the most recent one. Similar expressions could be useful to monitor changes in important files, such as /etc/passwd, /etc/inetd.conf, /kernel, etc. ##### Piemērs 3 /etc/passwd ir mainīts. ```default last(/www.example.com/vfs.file.cksum[/etc/passwd],#1)<>last(/www.example.com/vfs.file.cksum[/etc/passwd],#2) ``` Izteiksme ir patiesa, ja iepriekšējā /etc/passwd kontrolsummas vērtība atšķiras no jaunākās. Līdzīgas izteiksmes var būt noderīgas, lai uzraudzītu izmaiņas svarīgos failos, piemēram, /etc/passwd, /etc/inetd.conf, /kernel u.c. ##### Example 3 How many lines matching a regular expression in a file? UserParameter=wc[*],grep -c "$2" $1 This parameter can be used to calculate number of lines in a file. wc[/etc/passwd,root] wc[/etc/services,zabbix] ##### Piemērs 3 Cik rindu failā atbilst regulārai izteiksmei? UserParameter=wc[*],grep -c "$2" $1 Šo parametru var izmantot, lai aprēķinātu rindu skaitu failā. wc[/etc/passwd,root] wc[/etc/services,zabbix] ##### Example 3 Message: Latest value: {?last(/{HOST.HOST}/{ITEM.KEY})} MAX for 15 minutes: {?max(/{HOST.HOST}/{ITEM.KEY},15m)} MIN for 15 minutes: {?min(/{HOST.HOST}/{ITEM.KEY},15m)} When you receive the message, the message will be replaced by something like: Latest value: 1.45 MAX for 15 minutes: 2.33 MIN for 15 minutes: 1.01 ##### Piemērs 3 Ziņojums: Jaunākā vērtība: {?last(/{HOST.HOST}/{ITEM.KEY})} MAX 15 minūtēm: {?max(/{HOST.HOST}/{ITEM.KEY},15m)} MIN 15 minūtēm: {?min(/{HOST.HOST}/{ITEM.KEY},15m)} Kad saņemsiet ziņojumu, tas tiks aizstāts ar kaut ko līdzīgu: Jaunākā vērtība: 1.45 MAX 15 minūtēm: 2.33 MIN 15 minūtēm: 1.01 **Example 3** Power off the host by using IPMI control. |Script parameter|Value| |--|--------| |*Scope*|'Action operation'| |*Type*|'IPMI'| |*Command*|power off| **Piemērs 3** Izslēdziet hostu, izmantojot IPMI vadību. |Skripta parametrs|Vērtība| |--|--------| |*Tvērums*|'Darbības operācija'| |*Tips*|'IPMI'| |*Komanda*|power off| ##### Example 3: Round a number Round the number "18.2345" to 2 digits. ```javascript return(Math.round(value* 100) / 100) ``` Value returned by the function: 18.23. ##### Piemērs 3: Noapaļot skaitli Noapaļojiet skaitli "18.2345" līdz 2 cipariem aiz komata. ```javascript return(Math.round(value* 100) / 100) ``` Funkcijas atgrieztā vērtība: 18.23. ##### Example 3 To create a "Web application is slow" trigger, you can define a trigger expression: last(/host/web.test.in[Scenario,,bps])<10000 Make sure to replace 'Scenario' with the real name of your scenario. ##### Piemērs 3 Lai izveidotu trigeri "Tīmekļa lietojumprogramma ir lēna", varat definēt trigera izteiksmi: last(/host/web.test.in[Scenario,,bps])<10000 Pārliecinieties, ka aizstājat 'Scenario' ar sava scenārija īsto nosaukumu. ##### Example 3 Use of two macros in the "CPU load is too high" trigger: `min(/ca_001/system.cpu.load[,avg1],{$CPULOAD_PERIOD})>{$MAX_CPULOAD}` Note that a macro can be used as a parameter of trigger function, in this example function **min()**. ##### Piemērs 3 Divu makrosu izmantošana trigerī "CPU load is too high": `min(/ca_001/system.cpu.load[,avg1],{$CPULOAD_PERIOD})>{$MAX_CPULOAD}` Ņemiet vērā, ka makrosu var izmantot kā trigera funkcijas parametru, šajā piemērā funkcijā **min()**. ##### Example 4 5-minute average of the number of queries per second for host group 'MySQL Servers'. ```default avg(avg_foreach(/*/mysql.qps?[group="MySQL Servers"],5m)) ``` ##### Piemērs 4 5 minūšu vidējais vaicājumu skaits sekundē hosts grupai 'MySQL Servers'. ```default avg(avg_foreach(/*/mysql.qps?[group="MySQL Servers"],5m)) ``` ##### Example 4 A more complex scenario. After multiple messages to MySQL administrators and escalation to the manager, Zabbix will try to restart the MySQL database. It will happen if the problem exists for 2:30 hours and it hasn't been acknowledged. If the problem still exists, after another 30 minutes Zabbix will send a message to all guest users. If this does not help, after another hour Zabbix will reboot server with the MySQL database (second remote command) using IPMI commands. {width="600"} ##### Piemērs 4 Sarežģītāks scenārijs. Pēc vairākiem ziņojumiem MySQL administratoriem un eskalācijas vadītājam, Zabbix mēģinās restartēt MySQL datu bāzi. Tas notiks, ja problēma pastāvēs 2:30 stundas un tā nebūs apstiprināta. Ja problēma joprojām pastāvēs, pēc vēl 30 minūtēm Zabbix nosūtīs ziņojumu visiem vieslietotājiem. Ja tas nepalīdzēs, pēc vēl vienas stundas Zabbix pārstartēs serveri ar MySQL datu bāzi (otrā attālā komanda), izmantojot IPMI komandas. {width="600"} ##### Example 4 Calculating percentage of incoming traffic. More complex expression: 100*last(//net.if.in[eth0,bytes])/(last(//net.if.in[eth0,bytes])+last(//net.if.out[eth0,bytes])) See also: [Examples of aggregate calculations](/manual/config/items/itemtypes/calculated/aggregate#usage-examples) ##### Piemērs 4 Ienākošā trafika procentuālā daudzuma aprēķināšana. Sarežģītāka izteiksme: 100*last(//net.if.in[eth0,bytes])/(last(//net.if.in[eth0,bytes])+last(//net.if.out[eth0,bytes])) Skatiet arī: [Apkopoto aprēķinu piemēri](/manual/config/items/itemtypes/calculated/aggregate#usage-examples) ##### Example 4: Count letters in a string Count the number of letters in the string "Zabbix". ```javascript return (value.length) ``` Value returned by the function: 6. ##### Piemērs 4: Saskaitīt burtus virknē Saskaitiet burtu skaitu virknē "Zabbix". ```javascript return (value.length) ``` Funkcijas atgrieztā vērtība: 6. ##### Example 4 Message: http://<server_ip_or_name>/zabbix/tr_events.php?triggerid={TRIGGER.ID}&eventid={EVENT.ID} When you receive the message, it will contain a link to the *Event details* page, which provides information about the event, its trigger, and a list of latest events generated by the same trigger. ##### Piemērs 4 Ziņojums: http://<server_ip_or_name>/zabbix/tr_events.php?triggerid={TRIGGER.ID}&eventid={EVENT.ID} Kad saņemsiet ziņojumu, tas saturēs saiti uz *Notikuma informācijas* lapu, kurā ir sniegta informācija par notikumu, tā trigeri un to jaunāko notikumu sarakstu, kurus ģenerējis tas pats trigeris. ##### Example 4 Retrieving weather information by connecting to the Openweathermap public service. - Configure a master item for bulk data collection in a single JSON: {width="600"} Note the usage of macros in query fields. Refer to the [Openweathermap API](https://openweathermap.org/current) for how to fill them. Sample JSON returned in response to HTTP agent: ```json { "body": { "coord": { "lon": 40.01, "lat": 56.11 }, "weather": [{ "id": 801, "main": "Clouds", "description": "few clouds", "icon": "02n" }], "base": "stations", "main": { "temp": 15.14, "pressure": 1012.6, "humidity": 66, "temp_min": 15.14, "temp_max": 15.14, "sea_level": 1030.91, "grnd_level": 1012.6 }, "wind": { "speed": 1.86, "deg": 246.001 }, "clouds": { "all": 20 }, "dt": 1526509427, "sys": { "message": 0.0035, "country": "RU", "sunrise": 1526432608, "sunset": 1526491828 }, "id": 487837, "name": "Stavrovo", "cod": 200 } } ``` The next task is to configure dependent items that extract data from the JSON. - Configure a sample dependent item for humidity:  Other weather metrics such as 'Temperature' are added in the same manner. - Sample dependent item value preprocessing with JSONPath:  - Check the result of weather data in *Latest data*: {width="600"} ##### Piemērs 4 Laikapstākļu informācijas iegūšana, pieslēdzoties Openweathermap publiskajam servisam. - Konfigurējiet galveno vienumu masveida datu apkopošanai vienā JSON: {width="600"} Ņemiet vērā makro izmantošanu vaicājuma laukos. Skatiet [Openweathermap API](https://openweathermap.org/current), lai uzzinātu, kā tos aizpildīt. Parauga JSON, kas atgriezts HTTP aģenta atbildē: ```json { "body": { "coord": { "lon": 40.01, "lat": 56.11 }, "weather": [{ "id": 801, "main": "Clouds", "description": "few clouds", "icon": "02n" }], "base": "stations", "main": { "temp": 15.14, "pressure": 1012.6, "humidity": 66, "temp_min": 15.14, "temp_max": 15.14, "sea_level": 1030.91, "grnd_level": 1012.6 }, "wind": { "speed": 1.86, "deg": 246.001 }, "clouds": { "all": 20 }, "dt": 1526509427, "sys": { "message": 0.0035, "country": "RU", "sunrise": 1526432608, "sunset": 1526491828 }, "id": 487837, "name": "Stavrovo", "cod": 200 } } ``` Nākamais uzdevums ir konfigurēt atkarīgos vienumus, kas izgūst datus no JSON. - Konfigurējiet parauga atkarīgo vienumu mitrumam:  Citi laikapstākļu rādītāji, piemēram, "Temperature", tiek pievienoti tādā pašā veidā. - Parauga atkarīgā vienuma vērtības pirmapstrāde ar JSONPath:  - Pārbaudiet laikapstākļu datu rezultātu sadaļā *Latest data*: {width="600"} ##### Example 4 Someone is downloading a large file from the Internet. Use of function min: ```default min(/www.example.com/net.if.in[eth0,bytes],5m)>100K ``` The expression is true when number of received bytes on eth0 is more than 100 KB within last 5 minutes. ##### Piemērs 4 Kāds lejupielādē lielu failu no interneta. Funkcijas min izmantošana: ```default min(/www.example.com/net.if.in[eth0,bytes],5m)>100K ``` Izteiksme ir patiesa, ja saņemto baitu skaits uz eth0 pēdējo 5 minūšu laikā ir lielāks par 100 KB. ##### Example 4 Synchronize the agent unavailability condition with the item update interval: - define {$INTERVAL} macro and use it in the item update interval; - use {$INTERVAL} as parameter of the agent unavailability trigger: `nodata(/ca_001/agent.ping,{$INTERVAL})=1` ##### Piemērs 4 Sinhronizējiet aģents nepieejamības nosacījumu ar vienums atjaunināšanas intervālu: - definējiet {$INTERVAL} makrosu un izmantojiet to vienums atjaunināšanas intervālā; - izmantojiet {$INTERVAL} kā aģents nepieejamības trigeris parametru: `nodata(/ca_001/agent.ping,{$INTERVAL})=1` ##### Example 5 An escalation with several operations that have overlapping step ranges and custom intervals. The default operation step duration is 30 minutes. {width="600"} Notifications will be sent as follows: - To MySQL administrators at 0:00, 0:30, 1:00, and 1:30 after the problem starts. - To Database manager at 2:00 and 2:10 (the shorter custom step duration of 10 minutes defined in the subsequent operation overrides the longer step duration of 1 hour configured here, as outlined in [Operation details](/manual/config/notifications/action/operation#operation-details) for *Step duration* when steps overlap). - To Zabbix administrators at 2:00, 2:10, and 2:20 after the problem starts (the custom step duration of 10 minutes is applied). - To guest users at 4:00 after the problem starts (the default step duration of 30 minutes takes effect between steps 8 and 11). ##### Piemērs 5 Eskalācija ar vairākām operācijām, kurām pārklājas soļu diapazoni un ir pielāgoti intervāli. Noklusējuma operācijas soļa ilgums ir 30 minūtes. {width="600"} Paziņojumi tiks nosūtīti šādi: - MySQL administratoriem 0:00, 0:30, 1:00 un 1:30 pēc problēmas sākuma. - Database manager 2:00 un 2:10 (īsākais turpmākajā operācijā definētais pielāgotais soļa ilgums — 10 minūtes — aizstāj šeit konfigurēto garāko soļa ilgumu — 1 stundu, kā aprakstīts sadaļā [Operation details](/manual/config/notifications/action/operation#operation-details) parametram *Step duration*, ja soļi pārklājas). - Zabbix administratoriem 2:00, 2:10 un 2:20 pēc problēmas sākuma (tiek piemērots pielāgotais soļa ilgums — 10 minūtes). - vieslietotājiem 4:00 pēc problēmas sākuma (starp 8. un 11. soli stājas spēkā noklusējuma soļa ilgums — 30 minūtes). ##### Example 5 Average CPU load on all hosts in multiple host groups that have the specific tags. ```default avg(last_foreach(/*/system.cpu.load?[(group="Servers A" or group="Servers B" or group="Servers C") and (tag="Service:" or tag="Importance:High")])) ``` ##### Piemērs 5 Vidējā CPU noslodze visos hosts vairākās hostu grupās, kurām ir konkrēti tagi. ```default avg(last_foreach(/*/system.cpu.load?[(group="Servers A" or group="Servers B" or group="Servers C") and (tag="Service:" or tag="Importance:High")])) ``` ##### Example 5 Both nodes of clustered SMTP server are down. Note use of two different hosts in one expression: ```default last(/smtp1.example.com/net.tcp.service[smtp])=0 and last(/smtp2.example.com/net.tcp.service[smtp])=0 ``` The expression is true when both SMTP servers are down on both smtp1.example.com and smtp2.example.com. ##### Piemērs 5 Abi klasterizētā SMTP servera mezgli ir nedarbojas. Ņemiet vērā divu dažādu hosts izmantošanu vienā izteiksmē: ```default last(/smtp1.example.com/net.tcp.service[smtp])=0 and last(/smtp2.example.com/net.tcp.service[smtp])=0 ``` Izteiksme ir patiesa, ja abi SMTP serveri ir nedarbojas gan smtp1.example.com, gan smtp2.example.com. ##### Example 5 Centralize configuration of working hours: - create a global {$WORKING\_HOURS} macro equal to `1-5,09:00-18:00`; - use it in the *Working time* field in *Administration* → *General* → *GUI*; - use it in the *When active* field in *Users* → *Users*, *Media* tab of a user; - use it to set up more frequent item polling during working hours:  - use it in the *Time period* action condition; - adjust the working time in *Administration* → *Macros*, if needed. ##### Piemērs 5 Centralizējiet darba laika konfigurāciju: - izveidojiet globālu {$WORKING\_HOURS} makro ar vērtību `1-5,09:00-18:00`; - izmantojiet to laukā *Working time* sadaļā *Administration* → *General* → *GUI*; - izmantojiet to laukā *When active* sadaļā *Users* → *Users*, lietotāja cilnē *Media*; - izmantojiet to, lai iestatītu biežāku vienumu aptaujāšanu darba laikā:  - izmantojiet to darbības nosacījumā *Time period*; - ja nepieciešams, pielāgojiet darba laiku sadaļā *Administration* → *Macros*. ##### Example 5 Connecting to Nginx status page and getting its metrics in bulk. - Configure Nginx following the [official guide](https://nginx.ru/en/docs/http/ngx_http_stub_status_module.html). - Configure a master item for bulk data collection: {width="600"} Sample Nginx stub status output: Active connections: 1 Active connections: server accepts handled requests 52 52 52 Reading: 0 Writing: 1 Waiting: 0 The next task is to configure dependent items that extract data. - Configure a sample dependent item for requests per second:  - Sample dependent item value preprocessing with regular expression `server accepts handled requests\s+([0-9]+) ([0-9]+) ([0-9]+)`: {width="600"} - Check the complete result from stub module in *Latest data*: {width="600"} ##### Piemērs 5 Savienošana ar Nginx statusa lapu un tās metrikas iegūšana masveidā. - Konfigurējiet Nginx, ievērojot [oficiālo rokasgrāmatu](https://nginx.ru/en/docs/http/ngx_http_stub_status_module.html). - Konfigurējiet galveno vienumu masveida datu vākšanai: {width="600"} Nginx stub statusa izvades paraugs: Aktīvie savienojumi: 1 Aktīvie savienojumi: server accepts handled requests 52 52 52 Lasīšana: 0 Rakstīšana: 1 Gaida: 0 Nākamais uzdevums ir konfigurēt atkarīgos vienumus, kas izgūst datus. - Konfigurējiet atkarīgā vienuma paraugu pieprasījumiem sekundē:  - Atkarīgā vienuma vērtības priekšapstrādes paraugs ar regulāro izteiksmi `server accepts handled requests\s+([0-9]+) ([0-9]+) ([0-9]+)`: {width="600"} - Pārbaudiet pilno rezultātu no stub moduļa sadaļā *Jaunākie dati*: {width="600"} ##### Example 5: Get time remaining Get the remaining time (in seconds) until the expiration date of a certificate (Feb 12 12:33:56 2022 GMT). ```javascript var split = value.split(' '), MONTHS_LIST = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'], month_index = ('0' + (MONTHS_LIST.indexOf(split[0]) + 1)).slice(-2), ISOdate = split[3] + '-' + month_index + '-' + split[1] + 'T' + split[2], now = Date.now(); return parseInt((Date.parse(ISOdate) - now) / 1000); ``` Value returned by the function: 44380233. ##### Piemērs 5: Iegūt atlikušo laiku Iegūstiet atlikušo laiku (sekundēs) līdz sertifikāta derīguma termiņa beigām (Feb 12 12:33:56 2022 GMT). ```javascript var split = value.split(' '), MONTHS_LIST = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'], month_index = ('0' + (MONTHS_LIST.indexOf(split[0]) + 1)).slice(-2), ISOdate = split[3] + '-' + month_index + '-' + split[1] + 'T' + split[2], now = Date.now(); return parseInt((Date.parse(ISOdate) - now) / 1000); ``` Funkcijas atgrieztā vērtība: 44380233. ##### Example 5 Informing about values from several hosts in a trigger expression. Message: Problem name: {TRIGGER.NAME} Trigger expression: {TRIGGER.EXPRESSION} 1. Item value on {HOST.NAME1}: {ITEM.VALUE1} ({ITEM.NAME1}) 2. Item value on {HOST.NAME2}: {ITEM.VALUE2} ({ITEM.NAME2}) When you receive the message, the message will be replaced by something like: Problem name: Processor load is too high on a local host Trigger expression: last(/Myhost/system.cpu.load[percpu,avg1])>5 or last(/Myotherhost/system.cpu.load[percpu,avg1])>5 1. Item value on Myhost: 0.83 (Processor load (1 min average per core)) 2. Item value on Myotherhost: 5.125 (Processor load (1 min average per core)) ##### Piemērs 5 Informēšana par vērtībām no vairākiem hostiem trigera izteiksmē. Ziņojums: Problēmas nosaukums: {TRIGGER.NAME} Trigera izteiksme: {TRIGGER.EXPRESSION} 1. Vienuma vērtība uz {HOST.NAME1}: {ITEM.VALUE1} ({ITEM.NAME1}) 2. Vienuma vērtība uz {HOST.NAME2}: {ITEM.VALUE2} ({ITEM.NAME2}) Kad saņemsiet ziņojumu, tas tiks aizstāts ar apmēram šādu tekstu: Problēmas nosaukums: Procesora slodze lokālajā hostā ir pārāk augsta Trigera izteiksme: last(/Myhost/system.cpu.load[percpu,avg1])>5 or last(/Myotherhost/system.cpu.load[percpu,avg1])>5 1. Vienuma vērtība uz Myhost: 0.83 (Procesora slodze (1 min vidējā uz kodolu)) 2. Vienuma vērtība uz Myotherhost: 5.125 (Procesora slodze (1 min vidējā uz kodolu)) ##### Example 6 Calculation used on the latest item value sums of a whole host group. ```default sum(last_foreach(/*/net.if.out[eth0,bytes]?[group="video"])) / sum(last_foreach(/*/nginx_stat.sh[active]?[group="video"])) ``` ##### Piemērs 6 Aprēķins, kas izmantots jaunākās vienuma vērtības summām visai hostu grupai. ```default sum(last_foreach(/*/net.if.out[eth0,bytes]?[group="video"])) / sum(last_foreach(/*/nginx_stat.sh[active]?[group="video"])) ``` ##### Example 6 Receiving details of both the problem event and recovery event in a [recovery](/manual/config/notifications/action/recovery_operations) message: Message: Problem: Event ID: {EVENT.ID} Event value: {EVENT.VALUE} Event status: {EVENT.STATUS} Event time: {EVENT.TIME} Event date: {EVENT.DATE} Event age: {EVENT.AGE} Event acknowledgment: {EVENT.ACK.STATUS} Event update history: {EVENT.UPDATE.HISTORY} Recovery: Event ID: {EVENT.RECOVERY.ID} Event value: {EVENT.RECOVERY.VALUE} Event status: {EVENT.RECOVERY.STATUS} Event time: {EVENT.RECOVERY.TIME} Event date: {EVENT.RECOVERY.DATE} Operational data: {EVENT.OPDATA} When you receive the message, the macros will be replaced by something like: Problem: Event ID: 21874 Event value: 1 Event status: PROBLEM Event time: 13:04:30 Event date: 2018.01.02 Event age: 5m 0s Event acknowledgment: Yes Event update history: 2018.01.02 13:05:51 "John Smith (Admin)" Actions: acknowledged. Recovery: Event ID: 21896 Event value: 0 Event status: OK Event time: 13:10:07 Event date: 2018.01.02 Operational data: Current value is 0.83 ##### Piemērs 6 Saņemt detalizētu informāciju gan par problēmas notikumu, gan atkopšanas notikumu [atkopšanas](/manual/config/notifications/action/recovery_operations) ziņojumā: Ziņojums: Problēma: Notikuma ID: {EVENT.ID} Notikuma vērtība: {EVENT.VALUE} Notikuma statuss: {EVENT.STATUS} Notikuma laiks: {EVENT.TIME} Notikuma datums: {EVENT.DATE} Notikuma vecums: {EVENT.AGE} Notikuma apstiprinājums: {EVENT.ACK.STATUS} Notikuma atjauninājumu vēsture: {EVENT.UPDATE.HISTORY} Atkopšana: Notikuma ID: {EVENT.RECOVERY.ID} Notikuma vērtība: {EVENT.RECOVERY.VALUE} Notikuma statuss: {EVENT.RECOVERY.STATUS} Notikuma laiks: {EVENT.RECOVERY.TIME} Notikuma datums: {EVENT.RECOVERY.DATE} Operatīvie dati: {EVENT.OPDATA} Kad saņemsiet ziņojumu, makrosi tiks aizstāti ar kaut ko līdzīgu šim: Problēma: Notikuma ID: 21874 Notikuma vērtība: 1 Notikuma statuss: PROBLEM Notikuma laiks: 13:04:30 Notikuma datums: 2018.01.02 Notikuma vecums: 5m 0s Notikuma apstiprinājums: Jā Notikuma atjauninājumu vēsture: 2018.01.02 13:05:51 "John Smith (Admin)" Darbības: apstiprināts. Atkopšana: Notikuma ID: 21896 Notikuma vērtība: 0 Notikuma statuss: OK Notikuma laiks: 13:10:07 Notikuma datums: 2018.01.02 Operatīvie dati: Pašreizējā vērtība ir 0.83 ##### Example 6: Remove JSON properties Modify the JSON data structure by removing any properties with the key `"data_size"` or `"index_size"`. ```javascript var obj=JSON.parse(value); for (i = 0; i < Object.keys(obj).length; i++) { delete obj[i]["data_size"]; delete obj[i]["index_size"]; } return JSON.stringify(obj) ``` Value accepted by the function: ```json [ { "table_name":"history", "data_size":"326.05", "index_size":"174.34" }, { "table_name":"history_log", "data_size":"6.02", "index_size":"3.45" } ] ``` Value returned by the function: ```json [ { "table_name":"history" }, { "table_name":"history_log" } ] ``` ##### Piemērs 6: Noņemt JSON rekvizītus Modificējiet JSON datu struktūru, noņemot visus rekvizītus ar atslēgu `"data_size"` vai `"index_size"`. ```javascript var obj=JSON.parse(value); for (i = 0; i < Object.keys(obj).length; i++) { delete obj[i]["data_size"]; delete obj[i]["index_size"]; } return JSON.stringify(obj) ``` Funkcijas pieņemtā vērtība: ```json [ { "table_name":"history", "data_size":"326.05", "index_size":"174.34" }, { "table_name":"history_log", "data_size":"6.02", "index_size":"3.45" } ] ``` Funkcijas atgrieztā vērtība: ```json [ { "table_name":"history" }, { "table_name":"history_log" } ] ``` ##### Example 6 Use host prototype macro to configure items for discovered hosts: - on a host prototype define user macro {$SNMPVALUE} with {\#SNMPVALUE} [low-level discovery](/manual/config/macros/lld_macros) macro as a value:  - assign *Generic SNMPv2* template to the host prototype; - use {$SNMPVALUE} in the *SNMP OID* field of *Generic SNMPv2* template items. ##### Piemērs 6 Izmantojiet hosta prototipa makrosu, lai konfigurētu vienumus atklātajiem hostiem: - hosta prototipā definējiet lietotāja makrosu {$SNMPVALUE} ar {\#SNMPVALUE} [zemā līmeņa atklāšanas](/manual/config/macros/lld_macros) makrosu kā vērtību:  - piešķiriet hosta prototipam veidni *Generic SNMPv2*; - izmantojiet {$SNMPVALUE} veidnes *Generic SNMPv2* vienumu laukā *SNMP OID*. ##### Example 6 Zabbix agent needs to be upgraded. Use of function find(): ```default find(/example.example.com/agent.version,,"like","beta8")=1 ``` The expression is true if Zabbix agent has version beta8. ##### Piemērs 6 Zabbix aģents ir jāatjaunina. Funkcijas find() izmantošana: ```default find(/example.example.com/agent.version,,"like","beta8")=1 ``` Izteiksme ir patiesa, ja Zabbix aģenta versija ir beta8. ##### Example 7: Convert Apache status to JSON Convert the value received from a [web.page.get](/manual/config/items/itemtypes/zabbix_agent#web.page.get) Zabbix agent item (e.g., web.page.get[http://127.0.0.1:80/server-status?auto]) to a JSON object. ```javascript // Convert Apache status to JSON // Split the value into substrings and put these substrings into an array var lines = value.split('\n'); // Create an empty object "output" var output = {}; // Create an object "workers" with predefined properties var workers = { '_': 0, 'S': 0, 'R': 0, 'W': 0, 'K': 0, 'D': 0, 'C': 0, 'L': 0, 'G': 0, 'I': 0, '.': 0 }; // Add the substrings from the "lines" array to the "output" object as properties (key-value pairs) for (var i = 0; i < lines.length; i++) { var line = lines[i].match(/([A-z0-9 ]+): (.*)/); if (line !== null) { output[line[1]] = isNaN(line[2]) ? line[2] : Number(line[2]); } } // Multiversion metrics output.ServerUptimeSeconds = output.ServerUptimeSeconds || output.Uptime; output.ServerVersion = output.ServerVersion || output.Server; // Parse "Scoreboard" property to get the worker count if (typeof output.Scoreboard === 'string') { for (var i = 0; i < output.Scoreboard.length; i++) { var char = output.Scoreboard[i]; workers[char]++; } } // Add worker data to the "output" object output.Workers = { waiting: workers['_'], starting: workers['S'], reading: workers['R'], sending: workers['W'], keepalive: workers['K'], dnslookup: workers['D'], closing: workers['C'], logging: workers['L'], finishing: workers['G'], cleanup: workers['I'], slot: workers['.'] }; // Return JSON string return JSON.stringify(output); ``` Value accepted by the function: ```default HTTP/1.1 200 OK Date: Mon, 27 Mar 2023 11:08:39 GMT Server: Apache/2.4.52 (Ubuntu) Vary: Accept-Encoding Content-Encoding: gzip Content-Length: 405 Content-Type: text/plain; charset=ISO-8859-1 127.0.0.1 ServerVersion: Apache/2.4.52 (Ubuntu) ServerMPM: prefork Server Built: 2023-03-08T17:32:01 CurrentTime: Monday, 27-Mar-2023 14:08:39 EEST RestartTime: Monday, 27-Mar-2023 12:19:59 EEST ParentServerConfigGeneration: 1 ParentServerMPMGeneration: 0 ServerUptimeSeconds: 6520 ServerUptime: 1 hour 48 minutes 40 seconds Load1: 0.56 Load5: 0.33 Load15: 0.28 Total Accesses: 2476 Total kBytes: 8370 Total Duration: 52718 CPUUser: 8.16 CPUSystem: 3.44 CPUChildrenUser: 0 CPUChildrenSystem: 0 CPULoad: .177914 Uptime: 6520 ReqPerSec: .379755 BytesPerSec: 3461.58 BytesPerReq: 3461.58 DurationPerReq: 21.2916 BusyWorkers: 2 IdleWorkers: 6 Scoreboard: ____KW__.............................................................................................................................................. ``` Value returned by the function: ```json { "Date": "Mon, 27 Mar 2023 11:08:39 GMT", "Server": "Apache/2.4.52 (Ubuntu)", "Vary": "Accept-Encoding", "Encoding": "gzip", "Length": 405, "Type": "text/plain; charset=ISO-8859-1", "ServerVersion": "Apache/2.4.52 (Ubuntu)", "ServerMPM": "prefork", "Server Built": "2023-03-08T17:32:01", "CurrentTime": "Monday, 27-Mar-2023 14:08:39 EEST", "RestartTime": "Monday, 27-Mar-2023 12:19:59 EEST", "ParentServerConfigGeneration": 1, "ParentServerMPMGeneration": 0, "ServerUptimeSeconds": 6520, "ServerUptime": "1 hour 48 minutes 40 seconds", "Load1": 0.56, "Load5": 0.33, "Load15": 0.28, "Total Accesses": 2476, "Total kBytes": 8370, "Total Duration": 52718, "CPUUser": 8.16, "CPUSystem": 3.44, "CPUChildrenUser": 0, "CPUChildrenSystem": 0, "CPULoad": 0.177914, "Uptime": 6520, "ReqPerSec": 0.379755, "BytesPerSec": 1314.55, "BytesPerReq": 3461.58, "DurationPerReq": 21.2916, "BusyWorkers": 2, "IdleWorkers": 6, "Scoreboard": "____KW__..............................................................................................................................................", "Workers": { "waiting": 6, "starting": 0, "reading": 0, "sending": 1, "keepalive": 1, "dnslookup": 0, "closing": 0, "logging": 0, "finishing": 0, "cleanup": 0, "slot": 142 } } ``` ##### Piemērs 7: Apache statusa pārveidošana par JSON Pārveidojiet vērtību, kas saņemta no Zabbix aģenta vienuma [web.page.get](/manual/config/items/itemtypes/zabbix_agent#web.page.get) (piemēram, web.page.get[http://127.0.0.1:80/server-status?auto]), par JSON objektu. ```javascript // Convert Apache status to JSON // Split the value into substrings and put these substrings into an array var lines = value.split('\n'); // Create an empty object "output" var output = {}; // Create an object "workers" with predefined properties var workers = { '_': 0, 'S': 0, 'R': 0, 'W': 0, 'K': 0, 'D': 0, 'C': 0, 'L': 0, 'G': 0, 'I': 0, '.': 0 }; // Add the substrings from the "lines" array to the "output" object as properties (key-value pairs) for (var i = 0; i < lines.length; i++) { var line = lines[i].match(/([A-z0-9 ]+): (.*)/); if (line !== null) { output[line[1]] = isNaN(line[2]) ? line[2] : Number(line[2]); } } // Multiversion metrics output.ServerUptimeSeconds = output.ServerUptimeSeconds || output.Uptime; output.ServerVersion = output.ServerVersion || output.Server; // Parse "Scoreboard" property to get the worker count if (typeof output.Scoreboard === 'string') { for (var i = 0; i < output.Scoreboard.length; i++) { var char = output.Scoreboard[i]; workers[char]++; } } // Add worker data to the "output" object output.Workers = { waiting: workers['_'], starting: workers['S'], reading: workers['R'], sending: workers['W'], keepalive: workers['K'], dnslookup: workers['D'], closing: workers['C'], logging: workers['L'], finishing: workers['G'], cleanup: workers['I'], slot: workers['.'] }; // Return JSON string return JSON.stringify(output); ``` Funkcijas pieņemtā vērtība: ```default HTTP/1.1 200 OK Date: Mon, 27 Mar 2023 11:08:39 GMT Server: Apache/2.4.52 (Ubuntu) Vary: Accept-Encoding Content-Encoding: gzip Content-Length: 405 Content-Type: text/plain; charset=ISO-8859-1 127.0.0.1 ServerVersion: Apache/2.4.52 (Ubuntu) ServerMPM: prefork Server Built: 2023-03-08T17:32:01 CurrentTime: Monday, 27-Mar-2023 14:08:39 EEST RestartTime: Monday, 27-Mar-2023 12:19:59 EEST ParentServerConfigGeneration: 1 ParentServerMPMGeneration: 0 ServerUptimeSeconds: 6520 ServerUptime: 1 hour 48 minutes 40 seconds Load1: 0.56 Load5: 0.33 Load15: 0.28 Total Accesses: 2476 Total kBytes: 8370 Total Duration: 52718 CPUUser: 8.16 CPUSystem: 3.44 CPUChildrenUser: 0 CPUChildrenSystem: 0 CPULoad: .177914 Uptime: 6520 ReqPerSec: .379755 BytesPerSec: 3461.58 BytesPerReq: 3461.58 DurationPerReq: 21.2916 BusyWorkers: 2 IdleWorkers: 6 Scoreboard: ____KW__.............................................................................................................................................. ``` Funkcijas atgrieztā vērtība: ```json { "Date": "Mon, 27 Mar 2023 11:08:39 GMT", "Server": "Apache/2.4.52 (Ubuntu)", "Vary": "Accept-Encoding", "Encoding": "gzip", "Length": 405, "Type": "text/plain; charset=ISO-8859-1", "ServerVersion": "Apache/2.4.52 (Ubuntu)", "ServerMPM": "prefork", "Server Built": "2023-03-08T17:32:01", "CurrentTime": "Monday, 27-Mar-2023 14:08:39 EEST", "RestartTime": "Monday, 27-Mar-2023 12:19:59 EEST", "ParentServerConfigGeneration": 1, "ParentServerMPMGeneration": 0, "ServerUptimeSeconds": 6520, "ServerUptime": "1 hour 48 minutes 40 seconds", "Load1": 0.56, "Load5": 0.33, "Load15": 0.28, "Total Accesses": 2476, "Total kBytes": 8370, "Total Duration": 52718, "CPUUser": 8.16, "CPUSystem": 3.44, "CPUChildrenUser": 0, "CPUChildrenSystem": 0, "CPULoad": 0.177914, "Uptime": 6520, "ReqPerSec": 0.379755, "BytesPerSec": 1314.55, "BytesPerReq": 3461.58, "DurationPerReq": 21.2916, "BusyWorkers": 2, "IdleWorkers": 6, "Scoreboard": "____KW__..............................................................................................................................................", "Workers": { "waiting": 6, "starting": 0, "reading": 0, "sending": 1, "keepalive": 1, "dnslookup": 0, "closing": 0, "logging": 0, "finishing": 0, "cleanup": 0, "slot": 142 } } ``` ##### Example 7 Server is unreachable. ```default count(/example.example.com/icmpping,30m,,"0")>5 ``` The expression is true if host "example.example.com" is unreachable more than 5 times in the last 30 minutes. ##### Piemērs 7 Serveris nav sasniedzams. ```default count(/example.example.com/icmpping,30m,,"0")>5 ``` Izteiksme ir patiesa, ja hosts "example.example.com" pēdējo 30 minūšu laikā nav sasniedzams vairāk nekā 5 reizes. ##### Example 7 The total number of unsupported items in host group 'Zabbix servers'. ```default sum(last_foreach(/*/zabbix[host,,items_unsupported]?[group="Zabbix servers"])) ``` ##### Example 8 Sum of the latest numeric results of DNS checks across all hosts. The shown item form is `net.dns[192.0.2.1,example.com,A]` as an example of one possible key. ```default sum(last_foreach(/*/net.dns[*,*,*])) ``` Note that wildcards must match the number of parameters in the key (here [`net.dns`](/manual/config/items/itemtypes/zabbix_agent#net.dns) has three parameters: ip, name, type). ##### Piemērs 7 Neatbalstīto vienumu kopējais skaits hostu grupā 'Zabbix servers'. ```default sum(last_foreach(/*/zabbix[host,,items_unsupported]?[group="Zabbix servers"])) ``` ##### Piemērs 8 DNS pārbaužu jaunāko skaitlisko rezultātu summa visos hostos. Parādītā vienuma forma ir `net.dns[192.0.2.1,example.com,A]` kā viena iespējamā atslēgas piemērs. ```default sum(last_foreach(/*/net.dns[*,*,*])) ``` Ņemiet vērā, ka aizstājējzīmēm ir jāsakrīt ar parametru skaitu atslēgā (šeit [`net.dns`](/manual/config/items/itemtypes/zabbix_agent#net.dns) ir trīs parametri: ip, name, type). ##### Example 8 No heartbeats within last 3 minutes. Use of function nodata(): ```default nodata(/example.example.com/tick,3m)=1 ``` To make use of this trigger, 'tick' must be defined as a Zabbix [trapper](/manual/config/items/itemtypes/trapper) item. The host should periodically send data for this item using zabbix\_sender. If no data is received within 180 seconds, the trigger value becomes PROBLEM. *Note* that 'nodata' can be used for any item type. ##### Piemērs 8 Nav sirdspukstu pēdējo 3 minūšu laikā. Funkcijas nodata() izmantošana: ```default nodata(/example.example.com/tick,3m)=1 ``` Lai izmantotu šo trigeri, 'tick' ir jādefinē kā Zabbix [trapper](/manual/config/items/itemtypes/trapper) vienums. Hostam periodiski jānosūta dati šim vienumam, izmantojot zabbix\_sender. Ja 180 sekunžu laikā netiek saņemti dati, trigera vērtība kļūst PROBLEM. *Piezīme* — 'nodata' var izmantot jebkura veida vienumam. ##### Example 9 CPU activity at night time. Use of function time(): ```default min(/Zabbix server/system.cpu.load[all,avg1],5m)>2 and time()<060000 ``` The trigger may change its state to problem only at night time (00:00 - 06:00). ##### Piemērs 9 CPU aktivitāte nakts laikā. Funkcijas time() izmantošana: ```default min(/Zabbix server/system.cpu.load[all,avg1],5m)>2 and time()<060000 ``` Trigeris var mainīt savu stāvokli uz problēmu tikai nakts laikā (00:00 - 06:00). ##### Example configuration for Apache # .. ProxyPass "/" http://host/zabbix/ ProxyPassReverse "/" http://host/zabbix/ ProxyPassReverseCookiePath /zabbix / ProxyPassReverseCookieDomain host zabbix.example.com # .. ##### Apache konfigurācijas piemērs # .. ProxyPass "/" http://host/zabbix/ ProxyPassReverse "/" http://host/zabbix/ ProxyPassReverseCookiePath /zabbix / ProxyPassReverseCookieDomain host zabbix.example.com # .. ##### Example configuration for nginx # .. location / { # .. proxy_cookie_path /zabbix /; proxy_pass http://192.168.0.94/zabbix/; # .. ##### Nginx konfigurācijas piemērs # .. location / { # .. proxy_cookie_path /zabbix /; proxy_pass http://192.168.0.94/zabbix/; # .. #### Example Getting memory usage of *apache* process. If using this OID syntax: ```default HOST-RESOURCES-MIB::hrSWRunPerfMem["index","HOST-RESOURCES-MIB::hrSWRunPath", "/usr/sbin/apache2"] ``` the index number will be looked up here: ```default ... HOST-RESOURCES-MIB::hrSWRunPath.5376 = STRING: "/sbin/getty" HOST-RESOURCES-MIB::hrSWRunPath.5377 = STRING: "/sbin/getty" HOST-RESOURCES-MIB::hrSWRunPath.5388 = STRING: "/usr/sbin/apache2" HOST-RESOURCES-MIB::hrSWRunPath.5389 = STRING: "/sbin/sshd" ... ``` Now we have the index, 5388. The index will be appended to the data OID in order to receive the value we are interested in: ```default HOST-RESOURCES-MIB::hrSWRunPerfMem.5388 = INTEGER: 31468 KBytes ``` #### Piemērs *apache* procesa atmiņas lietojuma iegūšana. Ja tiek izmantota šī OID sintakse: ```default HOST-RESOURCES-MIB::hrSWRunPerfMem["index","HOST-RESOURCES-MIB::hrSWRunPath", "/usr/sbin/apache2"] ``` tad indeksa numurs tiks uzmeklēts šeit: ```default ... HOST-RESOURCES-MIB::hrSWRunPath.5376 = STRING: "/sbin/getty" HOST-RESOURCES-MIB::hrSWRunPath.5377 = STRING: "/sbin/getty" HOST-RESOURCES-MIB::hrSWRunPath.5388 = STRING: "/usr/sbin/apache2" HOST-RESOURCES-MIB::hrSWRunPath.5389 = STRING: "/sbin/sshd" ... ``` Tagad mums ir indekss — 5388. Indekss tiks pievienots datu OID, lai saņemtu mūs interesējošo vērtību: ```default HOST-RESOURCES-MIB::hrSWRunPerfMem.5388 = INTEGER: 31468 KBytes ``` ##### Example of several dependencies For example, the Host is behind the Router2 and the Router2 is behind the Router1. ```default Zabbix - Router1 - Router2 - Host ``` If the Router1 is down, then obviously the Host and the Router2 are also unreachable, yet receiving three notifications about the Host, the Router1 and the Router2 all being down is excessive. So in this case we define two dependencies: ```default the 'Host is down' trigger depends on the 'Router2 is down' trigger the 'Router2 is down' trigger depends on the 'Router1 is down' trigger ``` Before changing the status of the 'Host is down' trigger, Zabbix will check for the corresponding trigger dependencies. If such are found and one of those triggers is in the 'Problem' state, then the trigger status will not be changed, the actions will not be executed and no notifications will be sent. Zabbix performs this check recursively. If the Router1 or the Router2 is unreachable, the Host trigger won't be updated. ##### Vairāku atkarību piemērs Piemēram, hosts atrodas aiz Router2, bet Router2 atrodas aiz Router1. ```default Zabbix - Router1 - Router2 - Host ``` Ja Router1 nedarbojas, tad acīmredzami arī hosts un Router2 nav sasniedzami, taču trīs paziņojumu saņemšana par to, ka hosts, Router1 un Router2 visi nedarbojas, ir pārmērīga. Tāpēc šajā gadījumā mēs definējam divas atkarības: ```default trigeris 'Host is down' ir atkarīgs no trigera 'Router2 is down' trigeris 'Router2 is down' ir atkarīgs no trigera 'Router1 is down' ``` Pirms mainīt trigera 'Host is down' statusu, Zabbix pārbaudīs atbilstošās trigera atkarības. Ja tādas tiek atrastas un viens no šiem trigeriem ir stāvoklī 'Problem', trigera statuss netiks mainīts, darbības netiks izpildītas un paziņojumi netiks nosūtīti. Zabbix veic šo pārbaudi rekursīvi. Ja Router1 vai Router2 nav sasniedzams, Host trigeris netiks atjaunināts. Example of using runtime control to reload the server configuration cache: ```bash zabbix_server -c /usr/local/etc/zabbix_server.conf -R config_cache_reload ``` Examples of using runtime control to reload the proxy configuration: ```bash # Reload configuration of all proxies: zabbix_server -R proxy_config_cache_reload # Reload configuration of Proxy1 and Proxy2: zabbix_server -R proxy_config_cache_reload=Proxy1,Proxy2 ``` Examples of using runtime control to gather diagnostic information: ```bash # Gather all available diagnostic information in the server log file: zabbix_server -R diaginfo # Gather history cache statistics in the server log file: zabbix_server -R diaginfo=historycache ``` Example of using runtime control to reload the SNMP cache: ```bash zabbix_server -R snmp_cache_reload ``` ::: noteimportant When an SNMPv3 interface is updated via the Zabbix UI, Zabbix will automatically reload the new SNMPv3 credentials for that interface in most cases; use `-R snmp_cache_reload` only if polling still fails after credential changes (for example, due to engineBoots/engineID inconsistencies or non-RFC devices), or when you need to force a global SNMP cache clear for troubleshooting. ::: Example of using runtime control to trigger execution of housekeeper: ```bash zabbix_server -c /usr/local/etc/zabbix_server.conf -R housekeeper_execute ``` Examples of using runtime control to change log level: ```bash # Increase log level of all processes: zabbix_server -c /usr/local/etc/zabbix_server.conf -R log_level_increase # Increase log level of second poller process: zabbix_server -c /usr/local/etc/zabbix_server.conf -R log_level_increase=poller,2 # Increase log level of process with PID 1234: zabbix_server -c /usr/local/etc/zabbix_server.conf -R log_level_increase=1234 # Decrease log level of all http poller processes: zabbix_server -c /usr/local/etc/zabbix_server.conf -R log_level_decrease="http poller" ``` Example of setting the HA failover delay to the minimum of 10 seconds: ```bash zabbix_server -R ha_set_failover_delay=10s ``` Piemērs, kā izmantot izpildlaika vadību, lai pārlādētu servera konfigurācijas kešatmiņu: ```bash zabbix_server -c /usr/local/etc/zabbix_server.conf -R config_cache_reload ``` Izpildlaika vadības izmantošanas piemēri, lai pārlādētu starpniekservera konfigurāciju: ```bash # Pārlādēt visu starpniekserveru konfigurāciju: zabbix_server -R proxy_config_cache_reload # Pārlādēt Proxy1 un Proxy2 konfigurāciju: zabbix_server -R proxy_config_cache_reload=Proxy1,Proxy2 ``` Izpildlaika vadības izmantošanas piemēri diagnostikas informācijas iegūšanai: ```bash # Iegūt visu pieejamo diagnostikas informāciju servera žurnāla failā: zabbix_server -R diaginfo # Iegūt vēstures kešatmiņas statistiku servera žurnāla failā: zabbix_server -R diaginfo=historycache ``` Piemērs, kā izmantot izpildlaika vadību, lai pārlādētu SNMP kešatmiņu: ```bash zabbix_server -R snmp_cache_reload ``` ::: noteimportant Kad SNMPv3 interfeiss tiek atjaunināts, izmantojot Zabbix lietotāja saskarni, vairumā gadījumu Zabbix automātiski pārlādēs šī interfeisa jaunos SNMPv3 akreditācijas datus; izmantojiet `-R snmp_cache_reload` tikai tad, ja aptauja joprojām neizdodas pēc akreditācijas datu maiņas (piemēram, engineBoots/engineID neatbilstību vai ierīču, kas neatbilst RFC, dēļ), vai arī tad, ja problēmu novēršanai nepieciešams piespiedu kārtā notīrīt visu SNMP kešatmiņu. ::: Piemērs, kā izmantot izpildlaika vadību, lai aktivizētu housekeeper izpildi: ```bash zabbix_server -c /usr/local/etc/zabbix_server.conf -R housekeeper_execute ``` Izpildlaika vadības izmantošanas piemēri žurnāla līmeņa maiņai: ```bash # Palielināt visu procesu žurnāla līmeni: zabbix_server -c /usr/local/etc/zabbix_server.conf -R log_level_increase # Palielināt otrā poller procesa žurnāla līmeni: zabbix_server -c /usr/local/etc/zabbix_server.conf -R log_level_increase=poller,2 # Palielināt procesa ar PID 1234 žurnāla līmeni: zabbix_server -c /usr/local/etc/zabbix_server.conf -R log_level_increase=1234 # Samazināt visu http poller procesu žurnāla līmeni: zabbix_server -c /usr/local/etc/zabbix_server.conf -R log_level_decrease="http poller" ``` Piemērs HA atteices pārslēgšanas aizkaves iestatīšanai uz minimālo 10 sekundes: ```bash zabbix_server -R ha_set_failover_delay=10s ``` *Example:* Problem *Web camera 3 is down* has tags `type:video-surveillance`, `floor:1` and `name:webcam-3` and status *Warning* The service **Web camera 3** has the only problem tag specified: `name:webcam-3`  Service status will change from *OK* to *Warning* when this problem is detected. If the service **Web camera 3** had problem tags `name:webcam-3` and `floor:2`, its status would not be changed, when the problem is detected, because the conditions are only partially met. *Piemērs:* Problēmai *Web camera 3 is down* ir birkas `type:video-surveillance`, `floor:1` un `name:webcam-3`, un statuss *Warning* Pakalpojumam **Web camera 3** ir norādīta tikai viena problēmas birka: `name:webcam-3`  Kad šī problēma tiks konstatēta, pakalpojuma statuss mainīsies no *OK* uz *Warning*. Ja pakalpojumam **Web camera 3** būtu problēmas birkas `name:webcam-3` un `floor:2`, tā statuss nemainītos, kad problēma tiktu konstatēta, jo nosacījumi ir izpildīti tikai daļēji. ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri ### Examples ### Piemēri #### Examples #### Piemēri #### Examples #### Piemēri #### Examples #### Piemēri #### Examples #### Piemēri #### Examples #### Piemēri #### Examples and dealing with errors To get a warning when you are about to run out of free disk space on your host, you may use a trigger expression like this: timeleft(/host/vfs.fs.size[/,free],1h,0)}<1h However, error code -1 may come into play and put your trigger in a problem state. Generally it's good because you get a warning that your predictions don't work correctly and you should look at them more thoroughly to find out why. But sometimes it's bad because -1 can simply mean that there was no data about the host free disk space obtained in the last hour. If you are getting too many false positive alerts, consider using more complicated trigger expression ^[5](#footnotes)^: timeleft(/host/vfs.fs.size[/,free],1h,0)<1h and timeleft(/host/vfs.fs.size[/,free],1h,0)<>-1 The situation is a bit more difficult with **forecast**. First of all, -1 may or may not put the trigger in a problem state depending on whether you have expression like `forecast(/host/item,(...))<...` or like `forecast(/host/item,(...))>...` Furthermore, -1 may be a valid forecast if it's normal for the item value to be negative. But probability of this situation in the real world situation is negligible (see [how](/manual/config/triggers/expression) the operator **=** works). So add `... or forecast(/host/item,(...))=-1` or `... and forecast(/host/item,(...))<>-1` if you want or don't want to treat -1 as a problem respectively. #### Footnotes ^**1**^ For example, a simple trigger like `timeleft(/host/item,1h,X) < 1h` may go into problem state when the item value approaches X and then suddenly recover once value X is reached. If the problem is item value being below X, use: `last(/host/item) < X or timeleft(/host/item,1h,X) < 1h` If the problem is item value being above X use: `last(/host/item) > X or timeleft(/host/item,1h,X) < 1h` ^**2**^ Polynomial degree can be from 1 to 6, *polynomial1* is equivalent to *linear*. However, use higher degree polynomials [with caution](https://en.wikipedia.org/wiki/Runge's_phenomenon). If the evaluation period contains less points than needed to determine polynomial coefficients, polynomial degree will be lowered (e.g., *polynomial5* is requested, but there are only 4 points, therefore *polynomial3* will be fitted). ^**3**^ For example, fitting *exponential* or *power* functions involves calculating log() of item values. If data contains zeros or negative numbers, you will get an error since log() is defined for positive values only. ^**4**^ For *linear*, *exponential*, *logarithmic* and *power* fits all necessary calculations can be written explicitly. For *polynomial* only *value* can be calculated without any additional steps. Calculating *avg* involves computing polynomial antiderivative (analytically). Computing *max*, *min* and *delta* involves computing polynomial derivative (analytically) and finding its roots (numerically). Solving f(t) = 0 involves finding polynomial roots (numerically). ^**5**^ But in this case -1 can cause your trigger to recover from the problem state. To be fully protected use: `timeleft(/host/vfs.fs.size[/,free],1h,0)<1h and ({TRIGGER.VALUE}=0 and timeleft(/host/vfs.fs.size[/,free],1h,0)<>-1 or {TRIGGER.VALUE}=1)` #### Piemēri un darbs ar kļūdām Lai saņemtu brīdinājumu, kad jūsu hostā drīz beigsies brīvā diska vieta, varat izmantot trigeri ar šādu izteiksmi: timeleft(/host/vfs.fs.size[/,free],1h,0)}<1h Tomēr var tikt ņemts vērā kļūdas kods -1, un tas var novest jūsu trigeri uz problēmas stāvokli. Kopumā tas ir labi, jo jūs saņemat brīdinājumu, ka jūsu prognozes nedarbojas pareizi un tās vajadzētu rūpīgāk pārskatīt, lai noskaidrotu iemeslu. Taču dažkārt tas ir slikti, jo -1 var vienkārši nozīmēt, ka pēdējās stundas laikā nav iegūti dati par hosta brīvo diska vietu. Ja saņemat pārāk daudz kļūdainu pozitīvu brīdinājumu, apsveriet iespēju izmantot sarežģītāku trigeru izteiksmi ^[5](#footnotes)^: timeleft(/host/vfs.fs.size[/,free],1h,0)<1h and timeleft(/host/vfs.fs.size[/,free],1h,0)<>-1 Situācija ar **forecast** ir nedaudz sarežģītāka. Pirmkārt, -1 var vai nu var arī nevar novest trigeri uz problēmas stāvokli atkarībā no tā, vai jums ir izteiksme `forecast(/host/item,(...))<...` vai `forecast(/host/item,(...))>...` Turklāt -1 var būt derīga prognoze, ja ir normāli, ka vienuma vērtība ir negatīva. Taču šādas situācijas varbūtība reālajā pasaulē ir niecīga (skatiet [kā](/manual/config/triggers/expression) darbojas operators **=**). Tāpēc pievienojiet `... or forecast(/host/item,(...))=-1` vai `... and forecast(/host/item,(...))<>-1`, ja attiecīgi vēlaties vai nevēlaties uzskatīt -1 par problēmu. #### Piezīmes ^**1**^ Piemēram, vienkāršs trigeris, piemēram `timeleft(/host/item,1h,X) < 1h`, var nonākt problēmas stāvoklī, kad vienuma vērtība tuvojas X un pēc tam pēkšņi atjaunoties, tiklīdz X tiek sasniegta. Ja problēma ir tāda, ka vienuma vērtība ir zem X, izmantojiet: `last(/host/item) < X or timeleft(/host/item,1h,X) < 1h` Ja problēma ir tāda, ka vienuma vērtība ir virs X, izmantojiet: `last(/host/item) > X or timeleft(/host/item,1h,X) < 1h` ^**2**^ Polinoma pakāpe var būt no 1 līdz 6, *polynomial1* ir ekvivalents *linear*. Tomēr augstākas pakāpes polinomus izmantojiet [piesardzīgi](https://en.wikipedia.org/wiki/Runge's_phenomenon). Ja novērtēšanas periodā ir mazāk punktu, nekā nepieciešams polinoma koeficientu noteikšanai, polinoma pakāpe tiks samazināta (piemēram, tiek pieprasīts *polynomial5*, bet ir tikai 4 punkti, tāpēc tiks pielāgots *polynomial3*). ^**3**^ Piemēram, *exponential* vai *power* funkciju pielāgošana ietver log() aprēķināšanu no vienumu vērtībām. Ja datos ir nulles vai negatīvi skaitļi, tiks saņemta kļūda, jo log() ir definēts tikai pozitīvām vērtībām. ^**4**^ *linear*, *exponential*, *logarithmic* un *power* pielāgojumiem visus nepieciešamos aprēķinus var uzrakstīt tieši. Savukārt *polynomial* gadījumā bez papildu soļiem var aprēķināt tikai *value*. *avg* aprēķināšana ietver polinoma primitīvās funkcijas aprēķināšanu (analītiski). *max*, *min* un *delta* aprēķināšana ietver polinoma atvasinājuma aprēķināšanu (analītiski) un tā sakņu atrašanu (skaitliski). Atrisinot f(t) = 0, tiek meklētas polinoma saknes (skaitliski). ^**5**^ Taču šajā gadījumā -1 var izraisīt to, ka jūsu trigeris atjaunojas no problēmas stāvokļa. Lai būtu pilnībā aizsargāti, izmantojiet: `timeleft(/host/vfs.fs.size[/,free],1h,0)<1h and ({TRIGGER.VALUE}=0 and timeleft(/host/vfs.fs.size[/,free],1h,0)<>-1 or {TRIGGER.VALUE}=1)` #### Examples Examples here illustrate how you can use macros in messages. #### Piemēri Šeit sniegtie piemēri ilustrē, kā varat izmantot makrosus ziņojumos. #### Examples Examples of [global scripts](/manual/web_interface/frontend_sections/alerts/scripts#configuring-a-global-script) that may be used as remote commands in action operations. #### Piemēri Piemēri [globālajiem skriptiem](/manual/web_interface/frontend_sections/alerts/scripts#configuring-a-global-script), kurus var izmantot kā attālinātās komandas darbību operācijās. #### Examples For an example of how to set up Zabbix for monitoring websites using the *Website by Browser* template, see [Monitor websites with browser items](/manual/quickstart/monitor_browser). #### Piemēri Lai redzētu piemēru, kā iestatīt Zabbix vietņu uzraudzībai, izmantojot *Website by Browser* veidni, skatiet [Monitor websites with browser items](/manual/quickstart/monitor_browser). #### Examples |From|To|Selected period| |--|--|------| |`now/d`|`now/d`|00:00 - 23:59 today| |`now/d`|`now/d+1d`|00:00 today - 23:59 tomorrow| |`now/w`|`now/w`|Monday 00:00:00 - Sunday 23:59:59 this week| |`now-1y/w`|`now-1y/w`|The week of Monday 00:00:00 - Sunday 23:59:59 one year ago| ::: noteimportant Using "now/M+1M" for the *To* parameter may add 31 days, which can result in the date shifting by 1-3 days depending on the number of days in the month. For example, if used in January, the result may be 02 March instead of the expected 28 February. To avoid this issue, use "now/M-3d+1M/M", which adjusts for month length accurately. Similarly, if configuring *From* to go backward, use "now/M+3d-1M/M". ::: #### Piemēri |No|Uz|Atlasītais periods| |--|--|------| |`now/d`|`now/d`|Šodien 00:00 - 23:59| |`now/d`|`now/d+1d`|Šodien 00:00 - rīt 23:59| |`now/w`|`now/w`|Šī nedēļa: pirmdiena 00:00:00 - svētdiena 23:59:59| |`now-1y/w`|`now-1y/w`|Nedēļa: pirmdiena 00:00:00 - svētdiena 23:59:59 pirms gada| ::: noteimportant Izmantojot "now/M+1M" parametram *Uz*, var tikt pievienotas 31 diena, kā rezultātā datums var nobīdīties par 1-3 dienām atkarībā no dienu skaita mēnesī. Piemēram, ja to izmanto janvārī, rezultāts var būt 02. marts, nevis gaidītais 28. februāris. Lai izvairītos no šīs problēmas, izmantojiet "now/M-3d+1M/M", kas precīzi pielāgojas mēneša garumam. Līdzīgi, ja konfigurējat *No* atpakaļejošā virzienā, izmantojiet "now/M+3d-1M/M". ::: #### Examples Here are some code snippets showing how to add Zabbix protocol header to the data you want to send in order to obtain the packet you should send to Zabbix so that it is interpreted correctly. These code snippets assume that the data is not larger than 1GB, thus the large packet format is not used. ##### Python ```python packet = b"ZBXD\1" + struct.pack("<II", len(data), 0) + data ``` or ```python def zbx_create_header(plain_data_size, compressed_data_size=None): protocol = b"ZBXD" flags = 0x01 if compressed_data_size is None: datalen = plain_data_size reserved = 0 else: flags |= 0x02 datalen = compressed_data_size reserved = plain_data_size return protocol + struct.pack("<BII", flags, datalen, reserved) packet = zbx_create_header(len(data)) + data ``` ##### Perl ```perl my $packet = "ZBXD\1" . pack("(II)<", length($data), 0) . $data; ``` or ```perl sub zbx_create_header($;$) { my $plain_data_size = shift; my $compressed_data_size = shift; my $protocol = "ZBXD"; my $flags = 0x01; my $datalen; my $reserved; if (!defined($compressed_data_size)) { $datalen = $plain_data_size; $reserved = 0; } else { $flags |= 0x02; $datalen = $compressed_data_size; $reserved = $plain_data_size; } return $protocol . chr($flags) . pack("(II)<", $datalen, $reserved); } my $packet = zbx_create_header(length($data)) . $data; ``` ##### PHP ```php $packet = "ZBXD\1" . pack("VV", strlen($data), 0) . $data; ``` or ```php function zbx_create_header($plain_data_size, $compressed_data_size = null) { $protocol = "ZBXD"; $flags = 0x01; if (is_null($compressed_data_size)) { $datalen = $plain_data_size; $reserved = 0; } else { $flags |= 0x02; $datalen = $compressed_data_size; $reserved = $plain_data_size; } return $protocol . chr($flags) . pack("VV", $datalen, $reserved); } $packet = zbx_create_header(strlen($data)) . $data; ``` ##### Bash ```bash datalen=$(printf "%08x" ${#data}) datalen="\\x${datalen:6:2}\\x${datalen:4:2}\\x${datalen:2:2}\\x${datalen:0:2}" printf "ZBXD\1${datalen}\0\0\0\0%s" "$data" ``` #### Piemēri Šeit ir daži koda fragmenti, kas parāda, kā pievienot Zabbix protokola galveni datiem, kurus vēlaties nosūtīt, lai iegūtu paketi, kas jānosūta uz Zabbix, lai tā tiktu pareizi interpretēta. Šie koda fragmenti pieņem, ka dati nav lielāki par 1GB, tādēļ lielo pakešu formāts netiek izmantots. ##### Python ```python packet = b"ZBXD\1" + struct.pack("<II", len(data), 0) + data ``` vai ```python def zbx_create_header(plain_data_size, compressed_data_size=None): protocol = b"ZBXD" flags = 0x01 if compressed_data_size is None: datalen = plain_data_size reserved = 0 else: flags |= 0x02 datalen = compressed_data_size reserved = plain_data_size return protocol + struct.pack("<BII", flags, datalen, reserved) packet = zbx_create_header(len(data)) + data ``` ##### Perl ```perl my $packet = "ZBXD\1" . pack("(II)<", length($data), 0) . $data; ``` vai ```perl sub zbx_create_header($;$) { my $plain_data_size = shift; my $compressed_data_size = shift; my $protocol = "ZBXD"; my $flags = 0x01; my $datalen; my $reserved; if (!defined($compressed_data_size)) { $datalen = $plain_data_size; $reserved = 0; } else { $flags |= 0x02; $datalen = $compressed_data_size; $reserved = $plain_data_size; } return $protocol . chr($flags) . pack("(II)<", $datalen, $reserved); } my $packet = zbx_create_header(length($data)) . $data; ``` ##### PHP ```php $packet = "ZBXD\1" . pack("VV", strlen($data), 0) . $data; ``` vai ```php function zbx_create_header($plain_data_size, $compressed_data_size = null) { $protocol = "ZBXD"; $flags = 0x01; if (is_null($compressed_data_size)) { $datalen = $plain_data_size; $reserved = 0; } else { $flags |= 0x02; $datalen = $compressed_data_size; $reserved = $plain_data_size; } return $protocol . chr($flags) . pack("VV", $datalen, $reserved); } $packet = zbx_create_header(strlen($data)) . $data; ``` ##### Bash ```bash datalen=$(printf "%08x" ${#data}) datalen="\\x${datalen:6:2}\\x${datalen:4:2}\\x${datalen:2:2}\\x${datalen:0:2}" printf "ZBXD\1${datalen}\0\0\0\0%s" "$data" ``` ##### Examples Let's review two more practical examples of an LLD rule creation with the use of MBean. To understand the difference between an LLD rule collecting MBeans and an LLD rule collecting MBean attributes better please take a look at following table: | | | | |---|---|---| |**MBean1**|**MBean2**|**MBean3**| |MBean1Attribute1|MBean2Attribute1|MBean3Attribute1| |MBean1Attribute2|MBean2Attribute2|MBean3Attribute2| |MBean1Attribute3|MBean2Attribute3|MBean3Attribute3| ##### Piemēri Apskatīsim vēl divus praktiskus LLD kārtulas izveides piemērus, izmantojot MBean. Lai labāk saprastu atšķirību starp LLD kārtulu, kas apkopo MBeans, un LLD kārtulu, kas apkopo MBean atribūtus, lūdzu, aplūkojiet šo tabulu: | | | | |---|---|---| |**MBean1**|**MBean2**|**MBean3**| |MBean1Attribute1|MBean2Attribute1|MBean3Attribute1| |MBean1Attribute2|MBean2Attribute2|MBean3Attribute2| |MBean1Attribute3|MBean2Attribute3|MBean3Attribute3| ##### Examples Numeric (unsigned) value: {"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"item_tags":[{"tag":"foo","value":"test"}],"itemid":3,"name":"Agent availability","clock":1519304285,"ns":123456789,"value":1,"type":3} Numeric (float) value: {"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"item_tags":[{"tag":"foo","value":"test"}],"itemid":4,"name":"CPU Load","clock":1519304285,"ns":123456789,"value":0.1,"type":0} Character, text value: {"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"item_tags":[{"tag":"foo","value":"test"}],"itemid":2,"name":"Agent version","clock":1519304285,"ns":123456789,"value":"3.4.4","type":4} Log value: {"host":{"host":"Host A","name":"Host A visible"},"groups":["Group X","Group Y","Group Z"],"item_tags":[{"tag":"foo","value":"test"}],"itemid":1,"name":"Messages in log file","clock":1519304285,"ns":123456789,"timestamp":1519304285,"source":"","severity":0,"eventid":0,"value":"log file message","type":2} ##### Piemēri Skaitliska (bez zīmes) vērtība: {"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"item_tags":[{"tag":"foo","value":"test"}],"itemid":3,"name":"Aģenta pieejamība","clock":1519304285,"ns":123456789,"value":1,"type":3} Skaitliska (peldošā komata) vērtība: {"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"item_tags":[{"tag":"foo","value":"test"}],"itemid":4,"name":"CPU slodze","clock":1519304285,"ns":123456789,"value":0.1,"type":0} Rakstzīmju, teksta vērtība: {"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"item_tags":[{"tag":"foo","value":"test"}],"itemid":2,"name":"Aģenta versija","clock":1519304285,"ns":123456789,"value":"3.4.4","type":4} Žurnāla vērtība: {"host":{"host":"Host A","name":"Host A visible"},"groups":["Group X","Group Y","Group Z"],"item_tags":[{"tag":"foo","value":"test"}],"itemid":1,"name":"Ziņojumi žurnālfailā","clock":1519304285,"ns":123456789,"timestamp":1519304285,"source":"","severity":0,"eventid":0,"value":"žurnālfaila ziņojums","type":2} ##### Examples Numeric (unsigned) value: {"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"item_tags":[{"tag":"foo","value":"test"}],"itemid":3,"name":"Agent availability","clock":1519311600,"count":60,"min":1,"avg":1,"max":1,"type":3} Numeric (float) value: {"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"item_tags":[{"tag":"foo","value":"test"}],"itemid":4,"name":"CPU Load","clock":1519311600,"count":60,"min":0.01,"avg":0.15,"max":1.5,"type":0} ##### Piemēri Skaitliska (bez zīmes) vērtība: {"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"item_tags":[{"tag":"foo","value":"test"}],"itemid":3,"name":"Agent availability","clock":1519311600,"count":60,"min":1,"avg":1,"max":1,"type":3} Skaitliska (peldošā komata) vērtība: {"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"item_tags":[{"tag":"foo","value":"test"}],"itemid":4,"name":"CPU Load","clock":1519311600,"count":60,"min":0.01,"avg":0.15,"max":1.5,"type":0} ##### Examples of correct/incorrect syntax Expressions (including function calls) cannot be used as history, trend, or foreach [function](/manual/appendix/functions) parameters. However, those functions themselves can be used in other (non-historical) function parameters. |Expression|Example| |-|---------| |Valid|`avg(last(/host/key1),last(/host/key2)*10,last(/host/key1)*100)`<br>`max(avg(avg_foreach(/*/system.cpu.load?[group="Servers A"],5m)),avg(avg_foreach(/*/system.cpu.load?[group="Servers B"],5m)),avg(avg_foreach(/*/system.cpu.load?[group="Servers C"],5m)))`| |Invalid|`sum(/host/key,10+2)`<br>`sum(/host/key, avg(10,2))`<br>`sum(/host/key,last(/host/key2))`| Note that in an expression like: ```default sum(sum_foreach(//resptime[*],5m))/sum(count_foreach(//resptime[*],5m)) ``` it cannot be guaranteed that both parts of the equation will always have the same set of values. While one part of the expression is evaluated, a new value for the requested period may arrive and then the other part of the expression will have a different set of values. ##### Pareizas/nepareizas sintakses piemēri Izteiksmes (tostarp funkciju izsaukumi) nevar izmantot kā vēstures, trendu vai foreach [funkcijas](/manual/appendix/functions) parametrus. Tomēr pašas šīs funkcijas var izmantot citos (ne vēsturiskos) funkciju parametros. |Izteiksme|Piemērs| |-|---------| |Derīgs|`avg(last(/host/key1),last(/host/key2)*10,last(/host/key1)*100)`<br>`max(avg(avg_foreach(/*/system.cpu.load?[group="Servers A"],5m)),avg(avg_foreach(/*/system.cpu.load?[group="Servers B"],5m)),avg(avg_foreach(/*/system.cpu.load?[group="Servers C"],5m)))`| |Nederīgs|`sum(/host/key,10+2)`<br>`sum(/host/key, avg(10,2))`<br>`sum(/host/key,last(/host/key2))`| Ņemiet vērā, ka tādā izteiksmē kā: ```default sum(sum_foreach(//resptime[*],5m))/sum(count_foreach(//resptime[*],5m)) ``` nav iespējams garantēt, ka abām vienādojuma daļām vienmēr būs vienāds vērtību kopums. Kamēr tiek aprēķināta viena izteiksmes daļa, var pienākt jauna vērtība pieprasītajam periodam, un tad otrai izteiksmes daļai būs atšķirīgs vērtību kopums. #### Examples of hardware configuration The table provides examples of hardware configuration, assuming a **Linux/BSD/Unix** platform. These are size and hardware configuration examples to start with. Each Zabbix installation is unique. Make sure to benchmark the performance of your Zabbix system in a staging or development environment, so that you can fully understand your requirements before deploying the Zabbix installation to its production environment. |Installation size|Monitored metrics^**1**^|CPU/vCPU cores|Memory<br>(GiB)|Database|Amazon EC2^**2**^| |-|-|-|-|--|--| |Small|1 000|2|8|MySQL Server,<br>Percona Server,<br>MariaDB Server,<br>PostgreSQL|m6i.large/m6g.large| |Medium|10 000|4|16|MySQL Server,<br>Percona Server,<br>MariaDB Server,<br>PostgreSQL|m6i.xlarge/m6g.xlarge| |Large|100 000|16|64|MySQL Server,<br>Percona Server,<br>MariaDB Server,<br>PostgreSQL,<br>Oracle|m6i.4xlarge/m6g.4xlarge| |Very large|1 000 000|32|96|MySQL Server,<br>Percona Server,<br>MariaDB Server,<br>PostgreSQL,<br>Oracle|m6i.8xlarge/m6g.8xlarge| ^**1**^ 1 metric = 1 item + 1 trigger + 1 graph<br> ^**2**^ Example with Amazon general purpose EC2 instances, using ARM64 or x86_64 architecture, a proper instance type like Compute/Memory/Storage optimised should be selected during Zabbix installation evaluation and testing before installing in its production environment. ::: noteclassic Actual configuration depends on the number of active items and refresh rates very much (see [database size](#database-size) section of this page for details). It is highly recommended to run the database on a separate server for large installations. ::: #### Aparatūras konfigurācijas piemēri Tabulā ir sniegti aparatūras konfigurācijas piemēri, pieņemot **Linux/BSD/Unix** platformu. Šie ir izmēra un aparatūras konfigurācijas piemēri, ar ko sākt. Katra Zabbix instalācija ir unikāla. Pārliecinieties, ka veicat sava Zabbix sistēmas veiktspējas testēšanu sagatavošanas vai izstrādes vidē, lai pirms Zabbix instalācijas izvietošanas ražošanas vidē pilnībā izprastu savas prasības. |Instalācijas izmērs|Uzraudzītie metriķi^**1**^|CPU/vCPU kodoli|Atmiņa<br>(GiB)|Datubāze|Amazon EC2^**2**^| |-|-|-|-|-|-| |Mazs|1 000|2|8|MySQL Server,<br>Percona Server,<br>MariaDB Server,<br>PostgreSQL|m6i.large/m6g.large| |Vidējs|10 000|4|16|MySQL Server,<br>Percona Server,<br>MariaDB Server,<br>PostgreSQL|m6i.xlarge/m6g.xlarge| |Liels|100 000|16|64|MySQL Server,<br>Percona Server,<br>MariaDB Server,<br>PostgreSQL,<br>Oracle|m6i.4xlarge/m6g.4xlarge| |Ļoti liels|1 000 000|32|96|MySQL Server,<br>Percona Server,<br>MariaDB Server,<br>PostgreSQL,<br>Oracle|m6i.8xlarge/m6g.8xlarge| ^**1**^ 1 metriķis = 1 vienums + 1 trigeris + 1 grafiks<br> ^**2**^ Piemērs ar Amazon vispārējas nozīmes EC2 instancēm, izmantojot ARM64 vai x86_64 arhitektūru; Zabbix instalācijas izvērtēšanas un testēšanas laikā pirms instalēšanas ražošanas vidē jāizvēlas atbilstošs instances tips, piemēram, Compute/Memory/Storage optimizēts. ::: noteclassic Faktiskā konfigurācija ļoti lielā mērā ir atkarīga no aktīvo vienumu skaita un atsvaidzināšanas biežuma (sīkāku informāciju skatiet šīs lapas sadaļā [datubāzes izmērs](#database-size)). Lielām instalācijām ir ļoti ieteicams datubāzi izvietot atsevišķā serverī. ::: ##### Examples of simple user parameters A simple command: UserParameter=ping,echo 1 The agent will always return '1' for an item with 'ping' key. A more complex example: UserParameter=mysql.ping,mysqladmin -uroot ping | grep -c alive The agent will return '1', if MySQL server is alive, '0' - otherwise. ##### Vienkāršu lietotāja parametru piemēri Vienkārša komanda: UserParameter=ping,echo 1 Aģents vienmēr atgriezīs '1' vienumam ar atslēgu 'ping'. Sarežģītāks piemērs: UserParameter=mysql.ping,mysqladmin -uroot ping | grep -c alive Aģents atgriezīs '1', ja MySQL serveris darbojas, pretējā gadījumā — '0'. #### Examples of triggers #### Trigeru piemēri ##### Examples Problem: {"clock":1519304285,"ns":123456789,"value":1,"name":"Either Zabbix agent is unreachable on Host B or pollers are too busy on Zabbix Server","severity":3,"eventid":42, "hosts":[{"host":"Host B", "name":"Host B visible"},{"host":"Zabbix Server","name":"Zabbix Server visible"}],"groups":["Group X","Group Y","Group Z","Zabbix servers"],"tags":[{"tag":"availability","value":""},{"tag":"data center","value":"Riga"}]} Recovery: {"clock":1519304345,"ns":987654321,"value":0,"eventid":43,"p_eventid":42} Problem (multiple problem event generation): {"clock":1519304286,"ns":123456789,"value":1,"eventid":43,"name":"Either Zabbix agent is unreachable on Host B or pollers are too busy on Zabbix Server","severity":3,"hosts":[{"host":"Host B", "name":"Host B visible"},{"host":"Zabbix Server","name":"Zabbix Server visible"}],"groups":["Group X","Group Y","Group Z","Zabbix servers"],"tags":[{"tag":"availability","value":""},{"tag":"data center","value":"Riga"}]} {"clock":1519304286,"ns":123456789,"value":1,"eventid":43,"name":"Either Zabbix agent is unreachable on Host B or pollers are too busy on Zabbix Server","severity":3,"hosts":[{"host":"Host B", "name":"Host B visible"},{"host":"Zabbix Server","name":"Zabbix Server visible"}],"groups":["Group X","Group Y","Group Z","Zabbix servers"],"tags":[{"tag":"availability","value":""},{"tag":"data center","value":"Riga"}]} Recovery: {"clock":1519304346,"ns":987654321,"value":0,"eventid":44,"p_eventid":43} {"clock":1519304346,"ns":987654321,"value":0,"eventid":44,"p_eventid":42} ##### Piemēri Problēma: {"clock":1519304285,"ns":123456789,"value":1,"name":"Vai nu Zabbix aģents nav sasniedzams hostā Host B, vai arī aptaujātāji ir pārāk noslogoti uz Zabbix servera","severity":3,"eventid":42, "hosts":[{"host":"Host B", "name":"Host B visible"},{"host":"Zabbix Server","name":"Zabbix Server visible"}],"groups":["Group X","Group Y","Group Z","Zabbix servers"],"tags":[{"tag":"availability","value":""},{"tag":"data center","value":"Riga"}]} Atjaunošana: {"clock":1519304345,"ns":987654321,"value":0,"eventid":43,"p_eventid":42} Problēma (vairāku problēmas notikumu ģenerēšana): {"clock":1519304286,"ns":123456789,"value":1,"eventid":43,"name":"Vai nu Zabbix aģents nav sasniedzams hostā Host B, vai arī aptaujātāji ir pārāk noslogoti uz Zabbix servera","severity":3,"hosts":[{"host":"Host B", "name":"Host B visible"},{"host":"Zabbix Server","name":"Zabbix Server visible"}],"groups":["Group X","Group Y","Group Z","Zabbix servers"],"tags":[{"tag":"availability","value":""},{"tag":"data center","value":"Riga"}]} {"clock":1519304286,"ns":123456789,"value":1,"eventid":43,"name":"Vai nu Zabbix aģents nav sasniedzams hostā Host B, vai arī aptaujātāji ir pārāk noslogoti uz Zabbix servera","severity":3,"hosts":[{"host":"Host B", "name":"Host B visible"},{"host":"Zabbix Server","name":"Zabbix Server visible"}],"groups":["Group X","Group Y","Group Z","Zabbix servers"],"tags":[{"tag":"availability","value":""},{"tag":"data center","value":"Riga"}]} Atjaunošana: {"clock":1519304346,"ns":987654321,"value":0,"eventid":44,"p_eventid":43} {"clock":1519304346,"ns":987654321,"value":0,"eventid":44,"p_eventid":42} ### Examples [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "authentication.get", "params": { "output": "extend" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "authentication_type": "0", "http_auth_enabled": "0", "http_login_form": "0", "http_strip_domains": "", "http_case_sensitive": "1", "ldap_auth_enabled": "0", "ldap_case_sensitive": "1", "ldap_userdirectoryid": "0", "saml_auth_enabled": "0", "saml_case_sensitive": "0", "passwd_min_length": "8", "passwd_check_rules": "15", "jit_provision_interval": "1h", "saml_jit_status": "0", "ldap_jit_status": "0", "disabled_usrgrpid": "9", "mfa_status": "0", "mfaid": "0" }, "id": 1 } ``` ### Piemēri [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "authentication.get", "params": { "output": "extend" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "authentication_type": "0", "http_auth_enabled": "0", "http_login_form": "0", "http_strip_domains": "", "http_case_sensitive": "1", "ldap_auth_enabled": "0", "ldap_case_sensitive": "1", "ldap_userdirectoryid": "0", "saml_auth_enabled": "0", "saml_case_sensitive": "0", "passwd_min_length": "8", "passwd_check_rules": "15", "jit_provision_interval": "1h", "saml_jit_status": "0", "ldap_jit_status": "0", "disabled_usrgrpid": "9", "mfa_status": "0", "mfaid": "0" }, "id": 1 } ``` ### Examples [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "authentication.update", "params": { "http_auth_enabled": 1, "http_case_sensitive": 0, "http_login_form": 1 }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ "http_auth_enabled", "http_case_sensitive", "http_login_form" ], "id": 1 } ``` ### Piemēri [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "authentication.update", "params": { "http_auth_enabled": 1, "http_case_sensitive": 0, "http_login_form": 1 }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": [ "http_auth_enabled", "http_case_sensitive", "http_login_form" ], "id": 1 } ``` ### Examples [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "autoregistration.get", "params": { "output": "extend" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "tls_accept": "3" }, "id": 1 } ``` ### Piemēri [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "autoregistration.get", "params": { "output": "extend" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "tls_accept": "3" }, "id": 1 } ``` ### Examples [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "autoregistration.update", "params": { "tls_accept": "3", "tls_psk_identity": "PSK 001", "tls_psk": "11111595725ac58dd977beef14b97461a7c1045b9a1c923453302c5473193478" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": true, "id": 1 } ``` ### Piemēri [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "autoregistration.update", "params": { "tls_accept": "3", "tls_psk_identity": "PSK 001", "tls_psk": "11111595725ac58dd977beef14b97461a7c1045b9a1c923453302c5473193478" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": true, "id": 1 } ``` ### Examples [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "housekeeping.get", "params": { "output": "extend" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hk_events_mode": "1", "hk_events_trigger": "365d", "hk_events_service": "1d", "hk_events_internal": "1d", "hk_events_discovery": "1d", "hk_events_autoreg": "1d", "hk_services_mode": "1", "hk_services": "365d", "hk_audit_mode": "1", "hk_audit": "31d", "hk_sessions_mode": "1", "hk_sessions": "365d", "hk_history_mode": "1", "hk_history_global": "0", "hk_history": "31d", "hk_trends_mode": "1", "hk_trends_global": "0", "hk_trends": "365d", "db_extension": "", "compression_status": "0", "compress_older": "7d" }, "id": 1 } ``` ### Piemēri [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "housekeeping.get", "params": { "output": "extend" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "hk_events_mode": "1", "hk_events_trigger": "365d", "hk_events_service": "1d", "hk_events_internal": "1d", "hk_events_discovery": "1d", "hk_events_autoreg": "1d", "hk_services_mode": "1", "hk_services": "365d", "hk_audit_mode": "1", "hk_audit": "31d", "hk_sessions_mode": "1", "hk_sessions": "365d", "hk_history_mode": "1", "hk_history_global": "0", "hk_history": "31d", "hk_trends_mode": "1", "hk_trends_global": "0", "hk_trends": "365d", "db_extension": "", "compression_status": "0", "compress_older": "7d" }, "id": 1 } ``` ### Examples [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "housekeeping.update", "params": { "hk_events_mode": "1", "hk_events_trigger": "200d", "hk_events_internal": "2d", "hk_events_discovery": "2d" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ "hk_events_mode", "hk_events_trigger", "hk_events_internal", "hk_events_discovery" ], "id": 1 } ``` ### Piemēri [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "housekeeping.update", "params": { "hk_events_mode": "1", "hk_events_trigger": "200d", "hk_events_internal": "2d", "hk_events_discovery": "2d" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": [ "hk_events_mode", "hk_events_trigger", "hk_events_internal", "hk_events_discovery" ], "id": 1 } ``` ### Examples [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "settings.get", "params": { "output": "extend" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "default_theme": "blue-theme", "search_limit": "1000", "max_in_table": "50", "server_check_interval": "10", "work_period": "1-5,09:00-18:00", "show_technical_errors": "0", "history_period": "24h", "period_default": "1h", "max_period": "2y", "severity_color_0": "97AAB3", "severity_color_1": "7499FF", "severity_color_2": "FFC859", "severity_color_3": "FFA059", "severity_color_4": "E97659", "severity_color_5": "E45959", "severity_name_0": "Not classified", "severity_name_1": "Information", "severity_name_2": "Warning", "severity_name_3": "Average", "severity_name_4": "High", "severity_name_5": "Disaster", "custom_color": "0", "ok_period": "5m", "blink_period": "2m", "problem_unack_color": "CC0000", "problem_ack_color": "CC0000", "ok_unack_color": "009900", "ok_ack_color": "009900", "problem_unack_style": "1", "problem_ack_style": "1", "ok_unack_style": "1", "ok_ack_style": "1", "discovery_groupid": "5", "default_inventory_mode": "-1", "alert_usrgrpid": "7", "snmptrap_logging": "1", "default_lang": "en_US", "default_timezone": "system", "login_attempts": "5", "login_block": "30s", "validate_uri_schemes": "1", "uri_valid_schemes": "http,https,ftp,file,mailto,tel,ssh", "x_frame_options": "SAMEORIGIN", "iframe_sandboxing_enabled": "1", "iframe_sandboxing_exceptions": "", "max_overview_table_size": "50", "connect_timeout": "3s", "socket_timeout": "3s", "media_type_test_timeout": "65s", "script_timeout": "60s", "item_test_timeout": "60s", "url": "", "report_test_timeout": "60s", "auditlog_enabled": "1", "auditlog_mode": "1", "ha_failover_delay": "1m", "geomaps_tile_provider": "OpenStreetMap.Mapnik", "geomaps_tile_url": "", "geomaps_max_zoom": "0", "geomaps_attribution": "", "vault_provider": "0", "timeout_zabbix_agent": "3s", "timeout_simple_check": "3s", "timeout_snmp_agent": "3s", "timeout_external_check": "3s", "timeout_db_monitor": "3s", "timeout_http_agent": "3s", "timeout_ssh_agent": "3s", "timeout_telnet_agent": "3s", "timeout_script": "3s" }, "id": 1 } ``` ### Piemēri [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "settings.get", "params": { "output": "extend" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "default_theme": "blue-theme", "search_limit": "1000", "max_in_table": "50", "server_check_interval": "10", "work_period": "1-5,09:00-18:00", "show_technical_errors": "0", "history_period": "24h", "period_default": "1h", "max_period": "2y", "severity_color_0": "97AAB3", "severity_color_1": "7499FF", "severity_color_2": "FFC859", "severity_color_3": "FFA059", "severity_color_4": "E97659", "severity_color_5": "E45959", "severity_name_0": "Not classified", "severity_name_1": "Information", "severity_name_2": "Warning", "severity_name_3": "Average", "severity_name_4": "High", "severity_name_5": "Disaster", "custom_color": "0", "ok_period": "5m", "blink_period": "2m", "problem_unack_color": "CC0000", "problem_ack_color": "CC0000", "ok_unack_color": "009900", "ok_ack_color": "009900", "problem_unack_style": "1", "problem_ack_style": "1", "ok_unack_style": "1", "ok_ack_style": "1", "discovery_groupid": "5", "default_inventory_mode": "-1", "alert_usrgrpid": "7", "snmptrap_logging": "1", "default_lang": "en_US", "default_timezone": "system", "login_attempts": "5", "login_block": "30s", "validate_uri_schemes": "1", "uri_valid_schemes": "http,https,ftp,file,mailto,tel,ssh", "x_frame_options": "SAMEORIGIN", "iframe_sandboxing_enabled": "1", "iframe_sandboxing_exceptions": "", "max_overview_table_size": "50", "connect_timeout": "3s", "socket_timeout": "3s", "media_type_test_timeout": "65s", "script_timeout": "60s", "item_test_timeout": "60s", "url": "", "report_test_timeout": "60s", "auditlog_enabled": "1", "auditlog_mode": "1", "ha_failover_delay": "1m", "geomaps_tile_provider": "OpenStreetMap.Mapnik", "geomaps_tile_url": "", "geomaps_max_zoom": "0", "geomaps_attribution": "", "vault_provider": "0", "timeout_zabbix_agent": "3s", "timeout_simple_check": "3s", "timeout_snmp_agent": "3s", "timeout_external_check": "3s", "timeout_db_monitor": "3s", "timeout_http_agent": "3s", "timeout_ssh_agent": "3s", "timeout_telnet_agent": "3s", "timeout_script": "3s" }, "id": 1 } ``` ### Examples [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "settings.update", "params": { "login_attempts": "1", "login_block": "1m" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ "login_attempts", "login_block" ], "id": 1 } ``` ### Piemēri [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "settings.update", "params": { "login_attempts": "1", "login_block": "1m" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": [ "login_attempts", "login_block" ], "id": 1 } ``` ##### Examples The following example installs Zabbix agent with custom configuration. It also enables TLS support [using pre-shared keys](/manual/encryption/using_pre_shared_keys). ```bash mkdir "C:\Program Files\Zabbix Agent" 2>nul msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-7.0.0-windows-amd64-openssl.msi" /qn+^ SERVER=192.0.2.1^ INSTALLFOLDER="C:\Program Files\Zabbix Agent"^ HOSTNAME=LAPTOP-IKP7S51S^ TLSACCEPT=psk^ TLSCONNECT=psk^ TLSPSKIDENTITY="PSK 001"^ TLSPSKFILE="C:\Program Files\Zabbix Agent\psk.key"^ TLSPSKVALUE=1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952^ ENABLEPATH=1^ ALLOWDENYKEY="AllowKey=system.run[type C:\Windows\System32\drivers\etc\hosts];DenyKey=system.run[*]" ``` The next example installs a newer version of Zabbix agent and uses a **template configuration file** (`CONF="C:\agent-template.conf"`). During installation, this file will become the agent configuration file. To inherit parameters from the old configuration file, use parameter placeholders (e.g., `[AllowDenyKey]`). ```bash msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-7.0.1-windows-amd64-openssl.msi" /qn+ CONF="C:\agent-template.conf" # agent-template.conf example: LogFile=[LogFile] [AllowDenyKey] Server=192.0.2.8 Hostname=DESKTOP-X9F4A2B [Include] [TLSConnect] [TLSAccept] [TLSPSKIdentity] [TLSPSKFile] ``` Alternatively, you can use a **custom configuration file** (`NONMSICONFNAME="C:\agent-custom.conf"`). During installation, any valid agent configuration parameters present in this file (limited to those listed in the table above) will be written in the newly created agent configuration file. To keep existing agent configuration, define parameters to be preserved. ```bash msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-7.0.1-windows-amd64-openssl.msi" /qn+ NONMSICONFNAME="C:\agent-custom.conf" # agent-custom.conf example: Server=192.0.2.8 Hostname=DESKTOP-X9F4A2B ``` ##### Piemēri Šis piemērs instalē Zabbix aģents ar pielāgotu konfigurāciju. Tas arī iespējo TLS atbalstu [izmantojot iepriekš koplietotas atslēgas](/manual/encryption/using_pre_shared_keys). ```bash mkdir "C:\Program Files\Zabbix Agent" 2>nul msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-7.0.0-windows-amd64-openssl.msi" /qn+^ SERVER=192.0.2.1^ INSTALLFOLDER="C:\Program Files\Zabbix Agent"^ HOSTNAME=LAPTOP-IKP7S51S^ TLSACCEPT=psk^ TLSCONNECT=psk^ TLSPSKIDENTITY="PSK 001"^ TLSPSKFILE="C:\Program Files\Zabbix Agent\psk.key"^ TLSPSKVALUE=1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952^ ENABLEPATH=1^ ALLOWDENYKEY="AllowKey=system.run[type C:\Windows\System32\drivers\etc\hosts];DenyKey=system.run[*]" ``` Nākamais piemērs instalē jaunāku Zabbix aģents versiju un izmanto **veidnes konfigurācijas failu** (`CONF="C:\agent-template.conf"`). Instalēšanas laikā šis fails kļūs par aģents konfigurācijas failu. Lai mantotu parametrus no vecā konfigurācijas faila, izmantojiet parametru vietturus (piem., `[AllowDenyKey]`). ```bash msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-7.0.1-windows-amd64-openssl.msi" /qn+ CONF="C:\agent-template.conf" # agent-template.conf example: LogFile=[LogFile] [AllowDenyKey] Server=192.0.2.8 Hostname=DESKTOP-X9F4A2B [Include] [TLSConnect] [TLSAccept] [TLSPSKIdentity] [TLSPSKFile] ``` Alternatīvi varat izmantot **pielāgotu konfigurācijas failu** (`NONMSICONFNAME="C:\agent-custom.conf"`). Instalēšanas laikā visi derīgie aģents konfigurācijas parametri, kas atrodas šajā failā (ierobežoti līdz tiem, kas uzskaitīti tabulā iepriekš), tiks ierakstīti jaunizveidotajā aģents konfigurācijas failā. Lai saglabātu esošo aģents konfigurāciju, definējiet saglabājamos parametrus. ```bash msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-7.0.1-windows-amd64-openssl.msi" /qn+ NONMSICONFNAME="C:\agent-custom.conf" # agent-custom.conf example: Server=192.0.2.8 Hostname=DESKTOP-X9F4A2B ``` ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *Action log* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### Piemēri Tālāk sniegto piemēru mērķis ir tikai aprakstīt paneļa logrīka lauku objektu konfigurāciju logrīkam *Darbību žurnāls*. Plašāku informāciju par paneļa konfigurēšanu skatiet [`dashboard.create`](/manual/api/reference/dashboard/create). ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *Clock* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### Piemēri Tālāk sniegto piemēru mērķis ir tikai aprakstīt paneļa logrīka lauku objektu konfigurāciju *Pulksteņa* logrīkam. Plašāku informāciju par paneļa konfigurēšanu skatiet [`dashboard.create`](/manual/api/reference/dashboard/create). ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *Data overview* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### Piemēri Tālāk minētie piemēri ir paredzēti tikai, lai aprakstītu informācijas paneļa logrīka lauku objektu konfigurāciju logrīkam *Data overview*. Plašāku informāciju par informācijas paneļa konfigurēšanu skatiet [`dashboard.create`](/manual/api/reference/dashboard/create). ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *Discovery status* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### Piemēri Tālāk sniegto piemēru mērķis ir tikai aprakstīt paneļa logrīka lauku objektu konfigurāciju logrīkam *Atklāšanas statuss*. Papildinformāciju par paneļa konfigurēšanu skatiet [`dashboard.create`](/manual/api/reference/dashboard/create). ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *Favorite graphs* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### Piemēri Tālāk sniegto piemēru mērķis ir tikai aprakstīt paneļa logrīka lauku objektu konfigurāciju logrīkam *Iecienītākie grafiki*. Plašāku informāciju par paneļa konfigurēšanu skatiet [`dashboard.create`](/manual/api/reference/dashboard/create). ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *Favorite maps* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### Piemēri Tālāk sniegto piemēru mērķis ir tikai aprakstīt paneļa logrīka lauku objektu konfigurāciju logrīkam *Iecienītās kartes*. Plašāku informāciju par paneļa konfigurēšanu skatiet [`dashboard.create`](/manual/api/reference/dashboard/create). ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *Gauge* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### Piemēri Tālāk sniegto piemēru mērķis ir tikai aprakstīt paneļa logrīka lauku objektu konfigurāciju *Mērinstrumenta* logrīkam. Plašāku informāciju par paneļa konfigurēšanu skatiet [`dashboard.create`](/manual/api/reference/dashboard/create). ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *Geomap* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### Piemēri Tālāk sniegto piemēru mērķis ir tikai aprakstīt paneļa logrīka lauku objektu konfigurāciju *Geomap* logrīkam. Plašāku informāciju par paneļa konfigurēšanu skatiet [`dashboard.create`](/manual/api/reference/dashboard/create). ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *Graph (classic)* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### Piemēri Tālāk sniegto piemēru mērķis ir tikai aprakstīt paneļa logrīka lauku objektu konfigurāciju logrīkam *Graph (classic)*. Plašāku informāciju par paneļa konfigurēšanu skatiet [`dashboard.create`](/manual/api/reference/dashboard/create). ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *Graph prototype* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### Piemēri Tālāk sniegto piemēru mērķis ir tikai aprakstīt paneļa logrīka lauku objektu konfigurāciju logrīkam *Graph prototype*. Plašāku informāciju par paneļa konfigurēšanu skatiet [`dashboard.create`](/manual/api/reference/dashboard/create). ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *Graph* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### Piemēri Tālāk sniegto piemēru mērķis ir tikai aprakstīt paneļa logrīka lauku objektu konfigurāciju *Graph* logrīkam. Plašāku informāciju par paneļa konfigurēšanu skatiet [`dashboard.create`](/manual/api/reference/dashboard/create). ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *Honeycomb* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### Piemēri Tālāk sniegto piemēru mērķis ir tikai aprakstīt paneļa logrīka lauku objektu konfigurāciju *Honeycomb* logrīkam. Plašāku informāciju par paneļa konfigurēšanu skatiet [`dashboard.create`](/manual/api/reference/dashboard/create). ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *Host availability* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### Piemēri Tālāk sniegto piemēru mērķis ir tikai aprakstīt paneļa logrīka lauku objektu konfigurāciju logrīkam *Host availability*. Plašāku informāciju par paneļa konfigurēšanu skatiet [`dashboard.create`](/manual/api/reference/dashboard/create). ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *Host navigator* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### Piemēri Tālāk sniegto piemēru mērķis ir tikai aprakstīt paneļa logrīka lauku objektu konfigurāciju *Host navigator* logrīkam. Plašāku informāciju par paneļa konfigurēšanu skatiet [`dashboard.create`](/manual/api/reference/dashboard/create). ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *Item history* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### Piemēri Tālāk sniegto piemēru mērķis ir tikai aprakstīt paneļa logrīka lauku objektu konfigurāciju logrīkam *Vienuma vēsture*. Plašāku informāciju par paneļa konfigurēšanu skatiet [`dashboard.create`](/manual/api/reference/dashboard/create). ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *Item navigator* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### Piemēri Tālāk sniegto piemēru mērķis ir tikai aprakstīt paneļa logrīka lauku objektu konfigurāciju *Vienumu navigatora* logrīkam. Plašāku informāciju par paneļa konfigurēšanu skatiet [`dashboard.create`](/manual/api/reference/dashboard/create). ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *Item value* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### Piemēri Tālāk sniegto piemēru mērķis ir tikai aprakstīt paneļa logrīka lauku objektu konfigurāciju logrīkam *Vienuma vērtība*. Plašāku informāciju par paneļa konfigurēšanu skatiet [`dashboard.create`](/manual/api/reference/dashboard/create). ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *Map navigation tree* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### Piemēri Tālāk sniegto piemēru mērķis ir tikai aprakstīt paneļa logrīka lauku objektu konfigurāciju logrīkam *Kartes navigācijas koks*. Plašāku informāciju par paneļa konfigurēšanu skatiet [`dashboard.create`](/manual/api/reference/dashboard/create). ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *Map* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### Piemēri Tālāk sniegto piemēru mērķis ir aprakstīt tikai paneļa logrīka lauku objektu konfigurāciju *Kartes* logrīkam. Plašāku informāciju par paneļa konfigurēšanu skatiet [`dashboard.create`](/manual/api/reference/dashboard/create). ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *Pie chart* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### Piemēri Tālāk sniegto piemēru mērķis ir tikai aprakstīt paneļa logrīka lauku objektu konfigurāciju *Pie chart* logrīkam. Plašāku informāciju par paneļa konfigurēšanu skatiet [`dashboard.create`](/manual/api/reference/dashboard/create). ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *Problem hosts* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### Piemēri Tālāk sniegto piemēru mērķis ir tikai aprakstīt paneļa logrīka lauku objektu konfigurāciju logrīkam *Problēmu hosti*. Plašāku informāciju par paneļa konfigurēšanu skatiet [`dashboard.create`](/manual/api/reference/dashboard/create). ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *Problems by severity* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### Piemēri Tālāk sniegto piemēru mērķis ir tikai aprakstīt paneļa logrīka lauku objektu konfigurāciju logrīkam *Problēmas pēc smaguma pakāpes*. Plašāku informāciju par paneļa konfigurēšanu skatiet [`dashboard.create`](/manual/api/reference/dashboard/create). ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *Problems* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### Piemēri Tālāk sniegto piemēru mērķis ir tikai aprakstīt paneļa logrīka lauku objektu konfigurāciju logrīkam *Problēmas*. Plašāku informāciju par paneļa konfigurēšanu skatiet [`dashboard.create`](/manual/api/reference/dashboard/create). ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *SLA report* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### Piemēri Tālāk sniegto piemēru mērķis ir aprakstīt tikai paneļa logrīka lauku objektu konfigurāciju *SLA report* logrīkam. Plašāku informāciju par paneļa konfigurēšanu skatiet [`dashboard.create`](/manual/api/reference/dashboard/create). ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *System information* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### Piemēri Tālāk sniegto piemēru mērķis ir tikai aprakstīt paneļa logrīka lauku objektu konfigurāciju logrīkam *Sistēmas informācija*. Plašāku informāciju par paneļa konfigurēšanu skatiet [`dashboard.create`](/manual/api/reference/dashboard/create). ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *Top hosts* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### Piemēri Tālāk sniegto piemēru mērķis ir tikai aprakstīt paneļa logrīka lauku objektu konfigurāciju logrīkam *Top hosts*. Plašāku informāciju par paneļa konfigurēšanu skatiet [`dashboard.create`](/manual/api/reference/dashboard/create). ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *Top triggers* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### Piemēri Tālāk sniegto piemēru mērķis ir tikai aprakstīt paneļa logrīka lauku objektu konfigurāciju logrīkam *Top trigeri*. Plašāku informāciju par paneļa konfigurēšanu skatiet [`dashboard.create`](/manual/api/reference/dashboard/create). ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *Trigger overview* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### Piemēri Tālāk sniegto piemēru mērķis ir tikai aprakstīt paneļa logrīka lauku objektu konfigurāciju logrīkam *Trigeru pārskats*. Plašāku informāciju par paneļa konfigurēšanu skatiet [`dashboard.create`](/manual/api/reference/dashboard/create). ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *URL* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### Piemēri Tālāk sniegto piemēru mērķis ir tikai aprakstīt paneļa logrīka lauku objektu konfigurāciju *URL* logrīkam. Plašāku informāciju par paneļa konfigurēšanu skatiet [`dashboard.create`](/manual/api/reference/dashboard/create). ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *Web monitoring* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### Piemēri Tālāk sniegto piemēru mērķis ir tikai aprakstīt paneļa logrīka lauku objektu konfigurāciju logrīkam *Tīmekļa uzraudzība*. Plašāku informāciju par paneļa konfigurēšanu skatiet [`dashboard.create`](/manual/api/reference/dashboard/create). ### Examples The following examples illustrate how you can use JavaScript preprocessing. Each example contains a brief description, a function body for JavaScript preprocessing parameters, and the preprocessing step result - value returned by the function. ### Piemēri Tālāk sniegtie piemēri ilustrē, kā var izmantot JavaScript priekšapstrādi. Katrs piemērs satur īsu aprakstu, funkcijas pamattekstu JavaScript priekšapstrādes parametriem un priekšapstrādes soļa rezultātu — funkcijas atgriezto vērtību. #### Examples The following examples show common configuration patterns for `AllowKey` and `DenyKey`. #### Piemēri Tālāk sniegtie piemēri parāda bieži izmantotus `AllowKey` un `DenyKey` konfigurācijas modeļus. #### Examples The following examples show common Zabbix API tasks using the zabbix\_utils library. Additional examples are available in the `examples` directory of the [zabbix_utils](https://github.com/zabbix/python-zabbix-utils) GitHub repository. #### Piemēri Tālāk sniegtie piemēri parāda biežāk sastopamos Zabbix API uzdevumus, izmantojot `zabbix_utils` bibliotēku. Papildu piemēri ir pieejami GitHub repozitorija [zabbix_utils](https://github.com/zabbix/python-zabbix-utils) `examples` direktorijā. # Examples This section provides files of sample modules and widgets, which you can use as a base for your custom modules. To use a module: 1. Download the ZIP archive. 2. Unpack the content into a separate directory inside the *modules* directory of your Zabbix frontend installation (for example, *zabbix/ui/modules*). 3. Register the module in Zabbix frontend. # Piemēri Šajā sadaļā ir pieejami paraugmoduļu un logrīku faili, kurus varat izmantot kā pamatu saviem pielāgotajiem moduļiem. Lai izmantotu moduli: 1. Lejupielādējiet ZIP arhīvu. 2. Izpakojiet saturu atsevišķā direktorijā savas Zabbix lietotāja saskarne instalācijas *modules* direktorijā (piemēram, *zabbix/ui/modules*). 3. Reģistrējiet moduli Zabbix lietotāja saskarnē. #### Example Stop repetitive problem events from the same network port.  This global correlation rule will correlate problems if *host* and *port* tag values exist on the trigger and they are the same in the original event and the new one. The operation will close new problem events on the same network port, keeping only the original problem open. #### Piemērs Apturiet atkārtotus problēmu notikumus no tā paša tīkla porta.  Šis globālais korelācijas noteikums korelēs problēmas, ja trigerim pastāv *host* un *port* birku vērtības un tās ir vienādas sākotnējā un jaunajā notikumā. Darbība aizvērs jaunus problēmu notikumus tajā pašā tīkla portā, atstājot atvērtu tikai sākotnējo problēmu. #### Examples **User macro with context** Regular expression: `\.+\"[a-z]+`<br> User macro with context: `{$MACRO:regex:"\.+\\"[a-z]+"}` Notice: - backslashes are [not escaped](/manual/config/macros/user_macros_context#important-notes); - quotation marks are escaped. **Macro function inside item key parameter** Regular expression: `.+:(\d+)$`<br> Item key: `net.tcp.service[tcp,,"{{$ENDPOINT}.regsub(\".+:(\d+)$\",\1)}"]` Notice: - regular expression inside the `regsub` macro function is double-quoted (because of contains closing parenthesis); - quotation marks around the regular expression are escaped (because the whole third item parameter is double-quoted); - third item key parameter is double-quoted because it contains a comma. **LLD macro function** Regular expression: `\.+\"([a-z]+)`<br> LLD macro: `{{#MACRO}.iregsub("\.+\\"([a-z]+)", \1)}` Notice: - backslashes are not escaped; - quotation marks are escaped. **LLD macro function inside user macro context** Regular expression: `\.+\"([a-z]+)`<br> LLD macro: `{{#MACRO}.iregsub("\.+\\"([a-z]+)", \1)}`<br> User macro with context: `{$MACRO:"{{#MACRO}.iregsub(\"\.+\\\"[a-z]+\", \1)}"}` Notice: - backslash escaping for LLD does not change; - upon inserting the LLD macro into user macro context, we need to put it into string: 1. Quotation marks are added around the macro expression; 2. Quotation marks get escaped; in total, 3 new backslashes are introduced. **String parameter of function (any)** `concat` is used as example. String content: `\.+\"[a-z]+`<br> Expression: `concat("abc", "\\.\\\"[a-z]+")` Notice: - String parameters require escaping both for backslashes and quotation marks. **LLD macro function inside string parameter of function** Regular expression: `\.+\"([a-z]+)`<br> LLD macro: `{{#MACRO}.iregsub("\.+\\"([a-z]+)", \1)}`<br> Expression: `concat("abc, "{{#MACRO}.iregsub(\"\\.+\\\\\"([a-z]+)\", \\1)}")` Notice: - String parameters require escaping both for backslashes and quotation marks; - Another layer of escaping is added, because the macro will be resolved only after string is unquoted; **User macro with context inside string parameter of function** Regular expression: `\.+\"[a-z]+`<br> User macro with context: `{$MACRO:regex:"\.+\\"[a-z]+"}`<br> Expression: `concat("abc, "{$MACRO:regex:\"\\.+\\\\\"[a-z]+\"}")` Notice: - Same as in the previous example an additional layer of escaping is needed; - Backslashes and quotation marks are escaped only for the top-level escaping (by virtue of it being a string parameter). **LLD macro function inside user macro context inside function** Regular expression: `\.+\"([a-z])+`<br> LLD macro: `{{#MACRO}.iregsub("\.+\\"([a-z]+)", \1)}`<br> User macro with context: `{$MACRO:"{{#MACRO}.iregsub(\"\.+\\\"([a-z]+)\", \1)}"}`<br> Expression: `concat("abc, "{$MACRO:\"{{#MACRO}.iregsub(\\\"\.+\\\\\\\"([a-z]+)\\\", \\1)}\"}")` Notice the three layers of escaping: 1. For LLD macro function, without escaping of backslashes; 2. For User macro with context, without escaping of backslashes; 3. For the string parameter of a function, with escaping of backslashes. **User macro with context just inside string** Regular expression: `\.+\"[a-z]+`<br> User macro with context: `{$MACRO:regex:"\.+\\"[a-z]+"}`<br> Inside string of some expression, for example: `func(arg1, arg2, arg3)="{$MACRO:regex:\"\\.+\\\\\"[a-z]+\"}"` Notice: - Strings also require backslash escaping; - Strings also require quotation mark escaping; - Again a case with 2 levels of escaping: 1. Escaping for user macro context without backslash escaping; 2. Escaping for it being a string with backslash escaping. #### Piemēri **Lietotāja makross ar kontekstu** Regulārā izteiksme: `\.+\"[a-z]+`<br> Lietotāja makross ar kontekstu: `{$MACRO:regex:"\.+\\"[a-z]+"}` Ņemiet vērā: - atpakaļvērstās slīpsvītras nav [atdalītas](/manual/config/macros/user_macros_context#important-notes); - pēdiņas ir atdalītas. **Makro funkcija vienuma atslēgas parametrā** Regulārā izteiksme: `.+:(\d+)$`<br> Vienuma atslēga: `net.tcp.service[tcp,,"{{$ENDPOINT}.regsub(\".+:(\d+)$\",\1)}"]` Ņemiet vērā: - regulārā izteiksme `regsub` makro funkcijā ir ievietota dubultpēdiņās (jo satur aizverošo iekavu); - pēdiņas ap regulāro izteiksmi ir atdalītas (jo viss trešais vienuma parametrs ir ievietots dubultpēdiņās); - trešais vienuma atslēgas parametrs ir ievietots dubultpēdiņās, jo tas satur komatu. **LLD makro funkcija** Regulārā izteiksme: `\.+\"([a-z]+)`<br> LLD makross: `{{#MACRO}.iregsub("\.+\\"([a-z]+)", \1)}` Ņemiet vērā: - atpakaļvērstās slīpsvītras nav atdalītas; - pēdiņas ir atdalītas. **LLD makro funkcija lietotāja makrosa kontekstā** Regulārā izteiksme: `\.+\"([a-z]+)`<br> LLD makross: `{{#MACRO}.iregsub("\.+\\"([a-z]+)", \1)}`<br> Lietotāja makross ar kontekstu: `{$MACRO:"{{#MACRO}.iregsub(\"\.+\\\"[a-z]+\", \1)}"}` Ņemiet vērā: - atpakaļvērsto slīpsvītru atdalīšana LLD gadījumā nemainās; - ievietojot LLD makrosu lietotāja makrosa kontekstā, tas jāievieto virknē: 1. ap makro izteiksmi tiek pievienotas pēdiņas; 2. pēdiņas tiek atdalītas; kopumā tiek ieviestas 3 jaunas atpakaļvērstās slīpsvītras. **Funkcijas virknes parametrs (jebkurš)** Kā piemērs izmantots `concat`. Virknes saturs: `\.+\"[a-z]+`<br> Izteiksme: `concat("abc", "\\.\\\"[a-z]+")` Ņemiet vērā: - virknes parametros jāatdala gan atpakaļvērstās slīpsvītras, gan pēdiņas. **LLD makro funkcija funkcijas virknes parametrā** Regulārā izteiksme: `\.+\"([a-z]+)`<br> LLD makross: `{{#MACRO}.iregsub("\.+\\"([a-z]+)", \1)}`<br> Izteiksme: `concat("abc, "{{#MACRO}.iregsub(\"\\.+\\\\\"([a-z]+)\", \\1)}")` Ņemiet vērā: - virknes parametros jāatdala gan atpakaļvērstās slīpsvītras, gan pēdiņas; - tiek pievienots vēl viens atdalīšanas slānis, jo makross tiks atrisināts tikai pēc tam, kad virkne būs noņemta no pēdiņām; **Lietotāja makross ar kontekstu funkcijas virknes parametrā** Regulārā izteiksme: `\.+\"[a-z]+`<br> Lietotāja makross ar kontekstu: `{$MACRO:regex:"\.+\\"[a-z]+"}`<br> Izteiksme: `concat("abc, "{$MACRO:regex:\"\\.+\\\\\"[a-z]+\"}")` Ņemiet vērā: - tāpat kā iepriekšējā piemērā ir nepieciešams papildu atdalīšanas slānis; - atpakaļvērstās slīpsvītras un pēdiņas tiek atdalītas tikai augstākā līmeņa atdalīšanai (jo tas ir virknes parametrs). **LLD makro funkcija lietotāja makrosa kontekstā funkcijā** Regulārā izteiksme: `\.+\"([a-z])+`<br> LLD makross: `{{#MACRO}.iregsub("\.+\\"([a-z]+)", \1)}`<br> Lietotāja makross ar kontekstu: `{$MACRO:"{{#MACRO}.iregsub(\"\.+\\\"([a-z]+)\", \1)}"}`<br> Izteiksme: `concat("abc, "{$MACRO:\"{{#MACRO}.iregsub(\\\"\.+\\\\\\\"([a-z]+)\\\", \\1)}\"}")` Ņemiet vērā trīs atdalīšanas slāņus: 1. LLD makro funkcijai bez atpakaļvērsto slīpsvītru atdalīšanas; 2. Lietotāja makrosam ar kontekstu bez atpakaļvērsto slīpsvītru atdalīšanas; 3. Funkcijas virknes parametram ar atpakaļvērsto slīpsvītru atdalīšanu. **Lietotāja makross ar kontekstu tieši virknē** Regulārā izteiksme: `\.+\"[a-z]+`<br> Lietotāja makross ar kontekstu: `{$MACRO:regex:"\.+\\"[a-z]+"}`<br> Kādas izteiksmes virknes iekšpusē, piemēram: `func(arg1, arg2, arg3)="{$MACRO:regex:\"\\.+\\\\\"[a-z]+\"}"` Ņemiet vērā: - virknēs arī jāatdala atpakaļvērstās slīpsvītras; - virknēs arī jāatdala pēdiņas; - atkal gadījums ar 2 atdalīšanas līmeņiem: 1. atdalīšana lietotāja makrosa kontekstam bez atpakaļvērsto slīpsvītru atdalīšanas; 2. atdalīšana tāpēc, ka tā ir virkne, ar atpakaļvērsto slīpsvītru atdalīšanu. #### Examples Working hours. Monday - Friday from 9:00 till 18:00: 1-5,09:00-18:00 Working hours plus weekend. Monday - Friday from 9:00 till 18:00 and Saturday, Sunday from 10:00 till 16:00: 1-5,09:00-18:00;6-7,10:00-16:00 #### Piemēri Darba laiks. No pirmdienas līdz piektdienai no 9:00 līdz 18:00: 1-5,09:00-18:00 Darba laiks, ieskaitot nedēļas nogali. No pirmdienas līdz piektdienai no 9:00 līdz 18:00 un sestdien, svētdien no 10:00 līdz 16:00: 1-5,09:00-18:00;6-7,10:00-16:00 # Examples You can use several empty examples, as well as existing loadable plugins provided by Zabbix, as a reference: - [Example plugin for Zabbix agent 2](https://git.zabbix.com/projects/AP/repos/example/browse) - [MSSQL plugin](https://git.zabbix.com/projects/AP/repos/mssql/browse) - [MongoDB plugin](https://git.zabbix.com/projects/AP/repos/mongodb/browse) - [PostgreSQL plugin](https://git.zabbix.com/projects/AP/repos/postgresql/browse) See the full list of [plugins](/manual/extensions/plugins#builtin-plugins) provided by Zabbix. # Piemēri Kā atsauci varat izmantot vairākus tukšus piemērus, kā arī Zabbix nodrošinātos ielādējamos spraudņus: - [Piemēra spraudnis Zabbix aģentam 2](https://git.zabbix.com/projects/AP/repos/example/browse) - [MSSQL spraudnis](https://git.zabbix.com/projects/AP/repos/mssql/browse) - [MongoDB spraudnis](https://git.zabbix.com/projects/AP/repos/mongodb/browse) - [PostgreSQL spraudnis](https://git.zabbix.com/projects/AP/repos/postgresql/browse) Skatiet pilnu Zabbix nodrošināto [spraudņu](/manual/extensions/plugins#builtin-plugins) sarakstu. ### Example The required JSON string format is best illustrated with an example. Suppose we are running an old Zabbix 1.8 agent (one that does not support [`vfs.fs.discovery`](/manual/config/items/itemtypes/zabbix_agent#vfs.fs.discovery)), but we still need to discover file systems. Here is a simple Perl script for Linux that discovers mounted file systems and outputs in JSON, which includes both file system name and type. One way to use it would be as a [`UserParameter`](/manual/appendix/config/zabbix_agentd#userparameter) with key `vfs.fs.discovery_perl`: ```perl #!/usr/bin/perl $first = 1; print "[\n"; for (`cat /proc/mounts`) { ($fsname, $fstype) = m/\S+ (\S+) (\S+)/; print "\t,\n" if not $first; $first = 0; print "\t{\n"; print "\t\t\"{#FSNAME}\":\"$fsname\",\n"; print "\t\t\"{#FSTYPE}\":\"$fstype\"\n"; print "\t}\n"; } print "]\n"; ``` ::: noteimportant Allowed symbols for LLD macro names are **0-9** , **A-Z** , **\_** , **.**. Lowercase letters are not supported in the names. ::: An example of its output (reformatted for clarity) is shown below. JSON for custom discovery checks has to follow the same format. ```javascript [ { "{#FSNAME}":"/", "{#FSTYPE}":"rootfs" }, { "{#FSNAME}":"/sys", "{#FSTYPE}":"sysfs" }, { "{#FSNAME}":"/proc", "{#FSTYPE}":"proc" }, { "{#FSNAME}":"/dev", "{#FSTYPE}":"devtmpfs" }, { "{#FSNAME}":"/dev/pts", "{#FSTYPE}":"devpts" }, { "{#FSNAME}":"/lib/init/rw", "{#FSTYPE}":"tmpfs" }, { "{#FSNAME}":"/dev/shm", "{#FSTYPE}":"tmpfs" }, { "{#FSNAME}":"/home", "{#FSTYPE}":"ext3" }, { "{#FSNAME}":"/tmp", "{#FSTYPE}":"ext3" }, { "{#FSNAME}":"/usr", "{#FSTYPE}":"ext3" }, { "{#FSNAME}":"/var", "{#FSTYPE}":"ext3" }, { "{#FSNAME}":"/sys/fs/fuse/connections", "{#FSTYPE}":"fusectl" } ] ``` In the previous example it is required that the keys match the LLD macro names used in prototypes, the alternative is to extract LLD macro values using JSONPath `{#FSNAME}` → `$.fsname` and `{#FSTYPE}` → `$.fstype`, thus making such script possible: ```perl #!/usr/bin/perl $first = 1; print "[\n"; for (`cat /proc/mounts`) { ($fsname, $fstype) = m/\S+ (\S+) (\S+)/; print "\t,\n" if not $first; $first = 0; print "\t{\n"; print "\t\t\"fsname\":\"$fsname\",\n"; print "\t\t\"fstype\":\"$fstype\"\n"; print "\t}\n"; } print "]\n"; ``` An example of its output (reformatted for clarity) is shown below. JSON for custom discovery checks has to follow the same format. ```javascript [ { "fsname":"/", "fstype":"rootfs" }, { "fsname":"/sys", "fstype":"sysfs" }, { "fsname":"/proc", "fstype":"proc" }, { "fsname":"/dev", "fstype":"devtmpfs" }, { "fsname":"/dev/pts", "fstype":"devpts" }, { "fsname":"/lib/init/rw", "fstype":"tmpfs" }, { "fsname":"/dev/shm", "fstype":"tmpfs" }, { "fsname":"/home", "fstype":"ext3" }, { "fsname":"/tmp", "fstype":"ext3" }, { "fsname":"/usr", "fstype":"ext3" }, { "fsname":"/var", "fstype":"ext3" }, { "fsname":"/sys/fs/fuse/connections", "fstype":"fusectl" } ] ``` Then, in the discovery rule's "Filter" field, we could specify `{#FSTYPE}` as a macro and `rootfs|ext3` as a regular expression. ::: noteclassic You don't have to use macro names `FSNAME`/`FSTYPE` with custom LLD rules, you are free to use whatever names you like. In case JSONPath is used then LLD row will be an array element that can be an object, but it can be also another array or a value. ::: Note that, if using a user parameter, the return value is limited to 16 MB. For more details, see [data limits for LLD return values](/manual/discovery/low_level_discovery/notes#data-limits-for-return-values). ### Piemērs Nepieciešamais JSON virknes formāts vislabāk ir ilustrēts ar piemēru. Pieņemsim, ka mēs izmantojam vecu Zabbix 1.8 aģentu (tādu, kas neatbalsta [`vfs.fs.discovery`](/manual/config/items/itemtypes/zabbix_agent#vfs.fs.discovery)), bet mums joprojām ir jāatklāj failu sistēmas. Šeit ir vienkāršs Perl skripts Linux sistēmai, kas atklāj piemontētās failu sistēmas un izvada JSON formātā, iekļaujot gan failu sistēmas nosaukumu, gan tipu. Viens no veidiem, kā to izmantot, būtu kā [`UserParameter`](/manual/appendix/config/zabbix_agentd#userparameter) ar atslēgu `vfs.fs.discovery_perl`: ```perl #!/usr/bin/perl $first = 1; print "[\n"; for (`cat /proc/mounts`) { ($fsname, $fstype) = m/\S+ (\S+) (\S+)/; print "\t,\n" if not $first; $first = 0; print "\t{\n"; print "\t\t\"{#FSNAME}\":\"$fsname\",\n"; print "\t\t\"{#FSTYPE}\":\"$fstype\"\n"; print "\t}\n"; } print "]\n"; ``` ::: noteimportant Atļautie simboli LLD makro nosaukumos ir **0-9** , **A-Z** , **\_** , **.**. Nosaukumos nav atbalstīti mazie burti. ::: Tālāk ir parādīts tā izvades piemērs (pārformatēts skaidrības labad). JSON pielāgotām atklāšanas pārbaudēm ir jāatbilst tam pašam formātam. ```javascript [ { "{#FSNAME}":"/", "{#FSTYPE}":"rootfs" }, { "{#FSNAME}":"/sys", "{#FSTYPE}":"sysfs" }, { "{#FSNAME}":"/proc", "{#FSTYPE}":"proc" }, { "{#FSNAME}":"/dev", "{#FSTYPE}":"devtmpfs" }, { "{#FSNAME}":"/dev/pts", "{#FSTYPE}":"devpts" }, { "{#FSNAME}":"/lib/init/rw", "{#FSTYPE}":"tmpfs" }, { "{#FSNAME}":"/dev/shm", "{#FSTYPE}":"tmpfs" }, { "{#FSNAME}":"/home", "{#FSTYPE}":"ext3" }, { "{#FSNAME}":"/tmp", "{#FSTYPE}":"ext3" }, { "{#FSNAME}":"/usr", "{#FSTYPE}":"ext3" }, { "{#FSNAME}":"/var", "{#FSTYPE}":"ext3" }, { "{#FSNAME}":"/sys/fs/fuse/connections", "{#FSTYPE}":"fusectl" } ] ``` Iepriekšējā piemērā ir nepieciešams, lai atslēgas atbilstu LLD makro nosaukumiem, kas izmantoti prototipos; alternatīva ir iegūt LLD makro vērtības, izmantojot JSONPath `{#FSNAME}` → `$.fsname` un `{#FSTYPE}` → `$.fstype`, tādējādi padarot iespējamu šādu skriptu: ```perl #!/usr/bin/perl $first = 1; print "[\n"; for (`cat /proc/mounts`) { ($fsname, $fstype) = m/\S+ (\S+) (\S+)/; print "\t,\n" if not $first; $first = 0; print "\t{\n"; print "\t\t\"fsname\":\"$fsname\",\n"; print "\t\t\"fstype\":\"$fstype\"\n"; print "\t}\n"; } print "]\n"; ``` Tālāk ir parādīts tā izvades piemērs (pārformatēts skaidrības labad). JSON pielāgotām atklāšanas pārbaudēm ir jāatbilst tam pašam formātam. ```javascript [ { "fsname":"/", "fstype":"rootfs" }, { "fsname":"/sys", "fstype":"sysfs" }, { "fsname":"/proc", "fstype":"proc" }, { "fsname":"/dev", "fstype":"devtmpfs" }, { "fsname":"/dev/pts", "fstype":"devpts" }, { "fsname":"/lib/init/rw", "fstype":"tmpfs" }, { "fsname":"/dev/shm", "fstype":"tmpfs" }, { "fsname":"/home", "fstype":"ext3" }, { "fsname":"/tmp", "fstype":"ext3" }, { "fsname":"/usr", "fstype":"ext3" }, { "fsname":"/var", "fstype":"ext3" }, { "fsname":"/sys/fs/fuse/connections", "fstype":"fusectl" } ] ``` Tad atklāšanas noteikuma laukā "Filter" mēs varētu norādīt `{#FSTYPE}` kā makro un `rootfs|ext3` kā regulāro izteiksmi. ::: noteclassic Pielāgotajos LLD noteikumos jums nav obligāti jāizmanto makro nosaukumi `FSNAME`/`FSTYPE`; varat izmantot jebkurus nosaukumus, kas jums patīk. Ja tiek izmantots JSONPath, tad LLD rinda būs masīva elements, kas var būt objekts, bet tas var būt arī cits masīvs vai vērtība. ::: Ņemiet vērā, ka, izmantojot lietotāja parametru, atgrieztās vērtības apjoms ir ierobežots līdz 16 MB. Plašāku informāciju skatiet sadaļā [datu limiti LLD atgrieztajām vērtībām](/manual/discovery/low_level_discovery/notes#data-limits-for-return-values). ##### Example with an inline regex modifier Use of the following regular expression including an inline modifier (?i) to match the characters "error": ```default (?i)error ```  Chosen *Expression type*: "Result is TRUE". Characters "error" are matched. ##### Piemērs ar iekļautu regulārās izteiksmes modifikatoru Tālāk norādītās regulārās izteiksmes izmantošana, iekļaujot iekļautu modifikatoru (?i), lai atbilstu rakstzīmēm "error": ```default (?i)error ```  Izvēlētais *Expression type*: "Result is TRUE". Rakstzīmes "error" tiek atrastas. ### Example workflow The following section walks you through several usage examples in greater detail. ### Piemēra darbplūsma Nākamā sadaļa detalizētāk iepazīstina ar vairākiem lietošanas piemēriem. #### Exceeded character limit for function parameters after upgrade Proper escaping of backslashes has been added in history function string parameters in Zabbix 7.0. As additional backslashes are added during upgrade from pre-7.0 Zabbix versions, this leads to longer parameters which may result in broken trigger functions if the parameter length exceeds the maximum data size of 255 characters. To illustrate what problems can arise during database upgrade, what are their impact, how to recognize and fix them, let's take an example setup with 3 items and 2 triggers. #### Pārsniegts funkciju parametru rakstzīmju ierobežojums pēc jaunināšanas Zabbix 7.0 vēstures funkciju virkņu parametros ir pievienota korekta atpakaļvērsto slīpsvītru ekrānēšana. Tā kā jaunināšanas laikā no Zabbix versijām pirms 7.0 tiek pievienotas papildu atpakaļvērstās slīpsvītras, parametri kļūst garāki, un tas var izraisīt bojātas trigeru funkcijas, ja parametra garums pārsniedz maksimālo datu izmēru — 255 rakstzīmes. Lai parādītu, kādas problēmas var rasties datubāzes jaunināšanas laikā, kāda ir to ietekme, kā tās atpazīt un novērst, aplūkosim piemēra konfigurāciju ar 3 vienumiem un 2 trigeriem. ##### Exceeding file descriptor limit In case of large number of concurrent checks, it is possible to exhaust the file descriptor limit for the [discovery manager](/manual/concepts/server#server-process-types-and-threads). The number of file descriptors required for detection equates to the number of discovery workers * 1000. By default, there are 5 [discovery workers](/manual/appendix/config/zabbix_server#startdiscoverers), while the soft limit of the system is approximately 1024. If this limit is approached, Zabbix will reduce the default number of concurrent checks per type for each worker and write a warning to the log file. But, if the user has set a higher value for *Maximum concurrent checks per type* than the value calculated by Zabbix, Zabbix will use the user-defined value for one worker. ##### Faila deskriptoru limita pārsniegšana Ja vienlaicīgo pārbaužu skaits ir liels, var tikt izsmelts faila deskriptoru limits [atklāšanas pārvaldniekam](/manual/concepts/server#server-process-types-and-threads). Atklāšanai nepieciešamo faila deskriptoru skaits ir vienāds ar atklāšanas darbinieku skaitu * 1000. Pēc noklusējuma ir 5 [atklāšanas darbinieki](/manual/appendix/config/zabbix_server#startdiscoverers), savukārt sistēmas mīkstais limits ir aptuveni 1024. Ja šis limits tiek sasniegts, Zabbix samazinās noklusējuma vienlaicīgo pārbaužu skaitu katram tipam katram darbiniekam un ierakstīs brīdinājumu žurnāla failā. Tomēr, ja lietotājs ir iestatījis lielāku vērtību parametram *Maksimālais vienlaicīgo pārbaužu skaits katram tipam* nekā Zabbix aprēķinātā vērtība, Zabbix izmantos lietotāja definēto vērtību vienam darbiniekam. #### 'Execute now' request object The 'Execute now' task request object has the following properties. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |itemid|ID|ID of item and low-level discovery rules.<br><br>Since Zabbix 7.0.19, *Admin* and *User* type users may 'Execute now' items on hosts for which they have *read-write* [permission](/manual/api/reference/usergroup/object#permission), or *read* permission and `invoke_execute_now` [action](/manual/api/reference/role/object#action) enabled for their role. The same applies to *Admin* type users for low-level discovery (LLD) rules.| #### 'Execute now' pieprasījuma objekts 'Execute now' uzdevuma pieprasījuma objektam ir šādas īpašības. |Īpašība|[Tips](/manual/api/reference_commentary#data-types)|Apraksts| |--|--|------| |itemid|ID|Vienuma un zemā līmeņa atklāšanas noteikumu ID.<br><br>Kopš Zabbix 7.0.19, *Admin* un *User* tipa lietotāji var veikt 'Execute now' vienumiem hosts, kuriem viņiem ir *read-write* [atļauja](/manual/api/reference/usergroup/object#permission), vai *read* atļauja un viņu lomai ir iespējota `invoke_execute_now` [darbība](/manual/api/reference/role/object#action). Tas pats attiecas uz *Admin* tipa lietotājiem zemā līmeņa atklāšanas (LLD) noteikumiem.| #### Execution steps :::noteclassic By default, all scripts in Zabbix are executed using the *sh* shell, and it is not possible to modify the default shell. To utilize a different shell, you can employ a workaround: create a script file and invoke that script during command execution. ::: The command/script is executed similarly on both Unix and Windows platforms: 1. Zabbix (the parent process) creates a pipe for communication 2. Zabbix sets the pipe as the output for the to-be-created child process 3. Zabbix creates the child process (runs the command/script) 4. A new process group (in Unix) or a job (in Windows) is created for the child process 5. Zabbix reads from the pipe until timeout occurs or no one is writing to the other end (ALL handles/file descriptors have been closed). Note that the child process can create more processes and exit before they exit or close the handle/file descriptor. 6. If the timeout has not been reached, Zabbix waits until the initial child process exits or timeout occurs 7. If the initial child process exited and the timeout has not been reached, Zabbix checks exit code of the initial child process and compares it to 0 (non-zero value is considered as execution failure, only for custom alert scripts, remote commands and user scripts executed on Zabbix server and Zabbix proxy) 8. At this point it is assumed that everything is done and the whole process tree (i.e. the process group or the job) is terminated ::: noteimportant Zabbix assumes that a command/script has done processing when the initial child process has exited AND no other process is still keeping the output handle/file descriptor open. When processing is done, ALL created processes are terminated. ::: All double quotes and backslashes in the command are escaped with backslashes and the command is enclosed in double quotes. #### Izpildes soļi :::noteclassic Pēc noklusējuma visi skripti Zabbix tiek izpildīti, izmantojot *sh* čaulu, un noklusējuma čaulu nav iespējams mainīt. Lai izmantotu citu čaulu, var izmantot apiešanas risinājumu: izveidot skripta failu un komandas izpildes laikā izsaukt šo skriptu. ::: Komanda/skripts tiek izpildīts līdzīgi gan Unix, gan Windows platformās: 1. Zabbix (vecākprocess) izveido kanālu saziņai 2. Zabbix iestata šo kanālu kā izvadi izveidojamajam bērnprocesam 3. Zabbix izveido bērnprocesu (palaiž komandu/skriptu) 4. Bērnprocesam tiek izveidota jauna procesu grupa (Unix) vai uzdevums (Windows) 5. Zabbix lasa no kanāla, līdz iestājas noildze vai arī neviens vairs neraksta otrā galā (visi turi/failu deskriptori ir aizvērti). Ņemiet vērā, ka bērnprocess var izveidot papildu procesus un beigt darbu pirms tie beidz darbu vai aizver turi/failu deskriptoru. 6. Ja noildze vēl nav sasniegta, Zabbix gaida, līdz sākotnējais bērnprocess beidz darbu vai iestājas noildze 7. Ja sākotnējais bērnprocess ir beidzis darbu un noildze vēl nav sasniegta, Zabbix pārbauda sākotnējā bērnprocesa izejas kodu un salīdzina to ar 0 (vērtība, kas nav nulle, tiek uzskatīta par izpildes kļūmi, tikai pielāgotajiem brīdinājumu skriptiem, attālinātajām komandām un lietotāju skriptiem, kas izpildīti uz Zabbix serveris un Zabbix starpniekserveris) 8. Šajā brīdī tiek pieņemts, ka viss ir pabeigts un viss procesu koks (t.i., procesu grupa vai uzdevums) tiek pārtraukts ::: noteimportant Zabbix pieņem, ka komanda/skripts ir pabeidzis apstrādi, kad sākotnējais bērnprocess ir beidzis darbu UN neviens cits process vairs netur atvērtu izvades turi/failu deskriptoru. Kad apstrāde ir pabeigta, visi izveidotie procesi tiek pārtraukti. ::: Visas dubultpēdiņas un atpakaļvērstās slīpsvītras komandā tiek ekrānētas ar atpakaļvērstajām slīpsvītrām, un komanda tiek ietverta dubultpēdiņās. #### Exit code checking Exit code are checked with the following conditions: - Only for custom alert scripts, remote commands and user scripts executed on Zabbix server and Zabbix proxy. - Any exit code that is different from 0 is considered as execution failure. - Contents of standard error and standard output for failed executions are collected and available in frontend (where execution result is displayed). - Additional log entry may be created for remote commands executed on Zabbix agent/proxy by enabling the LogRemoteCommands parameter on [agent](/manual/appendix/config/zabbix_agentd#logremotecommands)/[proxy](/manual/appendix/config/zabbix_proxy#logremotecommands). Possible frontend messages and log entries for failed commands/scripts: - Contents of standard error and standard output for failed executions (if any). - "Process exited with code: N." (for empty output, and exit code not equal to 0). - "Process killed by signal: N." (for process terminated by a signal, on Linux only). - "Process terminated unexpectedly." (for process terminated for unknown reasons). #### Izietas koda pārbaude Izietas kods tiek pārbaudīts, izmantojot šādus nosacījumus: - Tikai pielāgotiem brīdinājumu skriptiem, attāliem komandām un lietotāja skriptiem, kas tiek izpildīti Zabbix serverī un Zabbix starpniekserverī. - Jebkurš izietas kods, kas nav 0, tiek uzskatīts par izpildes kļūmi. - Neveiksmīgu izpildes gadījumu standarta kļūdu un standarta izvades saturs tiek savākts un ir pieejams lietotāja saskarnē (kur tiek parādīts izpildes rezultāts). - Papildu žurnāla ieraksts var tikt izveidots attālām komandām, kas izpildītas Zabbix aģentā/starpniekserverī, iespējojot parametru LogRemoteCommands [agent](/manual/appendix/config/zabbix_agentd#logremotecommands)/[proxy](/manual/appendix/config/zabbix_proxy#logremotecommands). Iespējamie lietotāja saskarnes ziņojumi un žurnāla ieraksti neveiksmīgām komandām/skriptiem: - Neveiksmīgu izpildes gadījumu standarta kļūdu un standarta izvades saturs (ja tāds ir). - "Process exited with code: N." (ja izvade ir tukša un izietas kods nav 0). - "Process killed by signal: N." (ja process tika pārtraukts ar signālu, tikai Linux). - "Process terminated unexpectedly." (ja process tika pārtraukts nezināmu iemeslu dēļ). #### Exit codes Zabbix agent 2 can also be compiled with older OpenSSL versions (1.0.1, 1.0.2). In this case Zabbix provides mutexes for locking in OpenSSL. If a mutex lock or unlock fails then an error message is printed to the standard error stream (STDERR) and Agent 2 exits with return code `2` or `3`, respectively. #### Iziešanas kodi Zabbix aģentu 2 var arī kompilēt ar vecākām OpenSSL versijām (1.0.1, 1.0.2). Šajā gadījumā Zabbix nodrošina mutexus bloķēšanai OpenSSL. Ja mutex bloķēšana vai atbloķēšana neizdodas, kļūdas ziņojums tiek izdrukāts standarta kļūdu plūsmā (STDERR), un Agent 2 iziet ar atgriešanas kodu `2` vai `3` attiecīgi. #### Exit code Zabbix agent returns `0` in case of successful exit and `1` in case of failure. #### Iziešanas kods Zabbix aģents atgriež `0` veiksmīgas iziešanas gadījumā un `1` kļūmes gadījumā. #### Expanded command-line parameters for agent MSI installer packages Zabbix agent MSI installer packages (for both Zabbix agent and Zabbix agent 2) now support the following parameters when performing an [installation from the command line](/manual/installation/install_from_packages/win_msi#installation-from-command-line): - `HOSTNAMEITEM` - specifies the Zabbix agent item used to obtain the host name - `UNSAFEUSERPARAMETERS` - allows all characters (e.g., \ ' " ` * ?) to be passed in arguments to user-defined parameters - `STARTAGENTS` - specifies the number of pre-forked `zabbix_agentd` instances that process passive checks - `DONOTSTART` - prevents the MSI installer from starting the Zabbix agent service - `SOURCEIP` - specifies the source IP address for outgoing connections to the Zabbix server/proxy, or for connections made when executing certain items (e.g., `web.page.get`, `net.tcp.port`) #### Paplašinātie komandrindas parametri aģenta MSI instalētāja pakotnēm Zabbix aģenta MSI instalētāja pakotnes (gan Zabbix agent, gan Zabbix agent 2) tagad atbalsta šādus parametrus, veicot [instalēšanu no komandrindas](/manual/installation/install_from_packages/win_msi#installation-from-command-line): - `HOSTNAMEITEM` - norāda Zabbix aģenta vienumu, ko izmanto hosta nosaukuma iegūšanai - `UNSAFEUSERPARAMETERS` - ļauj visus simbolus (piem., \ ' " ` * ?) nodot argumentos lietotāja definētiem parametriem - `STARTAGENTS` - norāda iepriekš palaisto `zabbix_agentd` instanču skaitu, kas apstrādā pasīvos pārbaudes - `DONOTSTART` - neļauj MSI instalētājam palaist Zabbix aģenta pakalpojumu - `SOURCEIP` - norāda izejošo savienojumu avota IP adresi uz Zabbix serveri/starpniekserveri vai savienojumiem, kas tiek izveidoti, izpildot noteiktus vienumus (piem., `web.page.get`, `net.tcp.port`) #### Expanded widget availability on template dashboards Previously, on a [template dashboard](/manual/config/templates/template#adding-dashboards), you could create only the following widgets: *Clock*, *Graph (classic)*, *Graph prototype*, *Item value*, *Plain text*, *URL*. Now template dashboards support the creation of all widgets. #### Paplašināta logrīku pieejamība veidņu informācijas paneļos Iepriekš [veidnes informācijas panelī](/manual/config/templates/template#adding-dashboards) varēja izveidot tikai šādus logrīkus: *Clock*, *Graph (classic)*, *Graph prototype*, *Item value*, *Plain text*, *URL*. Tagad veidņu informācijas paneļi atbalsta visu logrīku izveidi. #### Expired signing key for RHEL packages When upgrading Zabbix on [Red Hat Enterprise Linux](/manual/installation/upgrade/packages/rhel#update-repository-configuration-package) or its derivatives, you may encounter an expired signing key issue for packages on [Zabbix repository](https://repo.zabbix.com/zabbix/7.0/). When a signing key expires, attempts to verify package signatures will result in an error indicating that the certificate or key is no longer valid. For example: ```bash error: Verifying a signature using certificate D9AA84C2B617479C6E4FCF4D19F2475308EFA7DD (Zabbix LLC (Jul 2022) <packager@zabbix.com>): 1. Certificate 19F2475308EFA7DD invalid: certificate is not alive because: The primary key is not live because: Expired on 2024-07-04T11:41:23Z 2. Key 19F2475308EFA7DD invalid: key is not alive because: The primary key is not live because: Expired on 2024-07-04T11:41:23Z ``` To resolve such issues, manually reinstall the latest `zabbix-release` package for your specific variant of RHEL (replace the link below with the correct one from [Zabbix repository](https://repo.zabbix.com/zabbix/7.0/)). For example, on **RHEL 9**, run: ```bash rpm -Uvh https://repo.zabbix.com/zabbix/7.0/rhel/9/x86_64/zabbix-release-latest.el9.noarch.rpm ``` Then, update the repository information: ```bash dnf update ``` For more information, see [ZBX-24761](https://support.zabbix.com/browse/ZBX-24761). #### Beidzies RHEL pakotņu parakstīšanas atslēgas derīguma termiņš Veicot Zabbix jaunināšanu uz [Red Hat Enterprise Linux](/manual/installation/upgrade/packages/rhel#update-repository-configuration-package) vai tā atvasinājumiem, var rasties problēma ar beigušos parakstīšanas atslēgu pakotnēm [Zabbix repozitorijā](https://repo.zabbix.com/zabbix/7.0/). Kad parakstīšanas atslēgas derīguma termiņš beidzas, mēģinājumi pārbaudīt pakotņu parakstus radīs kļūdu, kas norāda, ka sertifikāts vai atslēga vairs nav derīga. Piemēram: ```bash error: Verifying a signature using certificate D9AA84C2B617479C6E4FCF4D19F2475308EFA7DD (Zabbix LLC (Jul 2022) <packager@zabbix.com>): 1. Certificate 19F2475308EFA7DD invalid: certificate is not alive because: The primary key is not live because: Expired on 2024-07-04T11:41:23Z 2. Key 19F2475308EFA7DD invalid: key is not alive because: The primary key is not live because: Expired on 2024-07-04T11:41:23Z ``` Lai novērstu šādas problēmas, manuāli pārinstalējiet jaunāko `zabbix-release` pakotni savai konkrētajai RHEL versijai (aizstājiet tālāk norādīto saiti ar pareizo no [Zabbix repozitorija](https://repo.zabbix.com/zabbix/7.0/)). Piemēram, uz **RHEL 9** izpildiet: ```bash rpm -Uvh https://repo.zabbix.com/zabbix/7.0/rhel/9/x86_64/zabbix-release-latest.el9.noarch.rpm ``` Pēc tam atjauniniet repozitorija informāciju: ```bash dnf update ``` Papildinformāciju skatiet [ZBX-24761](https://support.zabbix.com/browse/ZBX-24761). ##### expm1(value) {#expm1} The Euler's number at a power of a value minus 1. Parameter: - **value** - the value to check For example, Euler's number at a power of a value '2' minus 1 will be '6.38905609893065'. Example: expm1(last(/host/key)) ##### expm1(value) {#expm1} Eilera skaitlis pakāpē ar vērtību mīnus 1. Parametrs: - **value** - pārbaudāmā vērtība Piemēram, Eilera skaitlis pakāpē ar vērtību '2' mīnus 1 būs '6.38905609893065'. Piemērs: expm1(last(/host/key)) #### Export and import Export and import Zabbix configuration data for configuration backups, migration or large-scale configuration updates. [Configuration API](/manual/api/reference/configuration) #### Eksportēšana un importēšana Eksportējiet un importējiet Zabbix konfigurācijas datus konfigurācijas dublējumkopijām, migrācijai vai liela mēroga konfigurācijas atjauninājumiem. [Konfigurācijas API](/manual/api/reference/configuration) ##### ExportDir The directory for [real-time export](/manual/config/export/files) of events, history and trends in newline-delimited JSON format. If set, enables the real-time export. ##### ExportDir Direktorija [reāllaika eksportam](/manual/config/export/files) notikumiem, vēsturei un tendencēm newline-delimited JSON formātā. Ja ir iestatīta, tā iespējo reāllaika eksportu. #### Exported elements |Element|Type|Description| |------|---|---------| |uuid|string|Unique identifier for this host group. | |name|string|Group name.| #### Eksportētie elementi |Elements|Tips|Apraksts| |------|---|---------| |uuid|string|Unikāls identifikators šai hostu grupai. | |name|string|Grupas nosaukums.| #### Exported elements |Element|Type|Description| |------|---|---------| |uuid|string|Unique identifier for this template group. | |name|string|Group name.| #### Eksportētie elementi |Element|Type|Description| |------|---|---------| |uuid|string|Unikāls identifikators šai veidņu grupai. | |name|string|Grupas nosaukums.| ### Exported elements Exported elements are explained in the table below. |Element|<|Type|Description| |-|---|---|-----------------------| |images|<| |Root element for images.| |<|name|string|Unique image name.| |^|imagetype|integer|Image type.<br>Possible values:<br>1 - Image;<br>2 - Background.| |^|encodedImage|string|Base64 encoded image.| |maps|<| |Root element for [maps](#maps).| ### Eksportētie elementi Eksportētie elementi ir izskaidroti zemāk esošajā tabulā. |Element|<|Type|Description| |-|---|---|-----------------------| |images|<| |Saknes elements attēliem.| |<|name|string|Unikāls attēla nosaukums.| |^|imagetype|integer|Attēla tips.<br>Iespējamās vērtības:<br>1 - Attēls;<br>2 - Fons.| |^|encodedImage|string|Base64 kodēts attēls.| |maps|<| |Saknes elements [kartēm](#maps).| #### Exported elements Exported elements are explained in the table below. |Element|<|Type|Description| |-|---|---|-----------------------| |name|<|string|(required) Media type name.| |type|<|string|(required) Transport used by the media type.<br>Possible values:^[1](#footnotes)^ EMAIL (0), SMS (1), SCRIPT (2), WEBHOOK (4).| |status|<|string|Whether the media type is enabled.<br>Possible values:^[1](#footnotes)^ ENABLED (0, default), DISABLED (1)| |max\_sessions|<|integer|The maximum number of alerts that can be processed in parallel.<br>Possible values for SMS:^[1](#footnotes)^ 1 (default).<br>Possible values for other media types:^[1](#footnotes)^ 0-100 (where 0 - unlimited).| |attempts|<|integer|The maximum number of attempts to send an alert.<br>Possible values:^[1](#footnotes)^ 1-10 (default: 3).| |attempt\_interval|<|string|The interval (using seconds or [time suffix](/manual/appendix/suffixes#time-suffixes)) between retry attempts.<br>Possible values:^[1](#footnotes)^ 0-60s (default: 10s).| |description|<|string|Media type description.| |message\_templates|<| |Root element for media type message templates.| |<|event\_source|string|(required) Event source.<br>Possible values:^[1](#footnotes)^ TRIGGERS (0), DISCOVERY (1), AUTOREGISTRATION (2), INTERNAL (3), SERVICE (4).| |^|operation\_mode|string|Operation mode.<br>Possible values:^[1](#footnotes)^ PROBLEM (0), RECOVERY (1), UPDATE (2).| |^|subject|string|Message subject.| |^|message|string|Message body.| ::: noteclassic See also: [Media type object](/manual/api/reference/mediatype/object) (refer to the relevant property with a matching name). ::: #### Eksportētie elementi Eksportētie elementi ir izskaidroti zemāk esošajā tabulā. |Elements|<|Tips|Apraksts| |-|---|---|-----------------------| |name|<|string|(obligāti) Mediju tipa nosaukums.| |type|<|string|(obligāti) Pārsūtīšanas veids, ko izmanto mediju tips.<br>Iespējamās vērtības:^[1](#footnotes)^ EMAIL (0), SMS (1), SCRIPT (2), WEBHOOK (4).| |status|<|string|Vai mediju tips ir iespējots.<br>Iespējamās vērtības:^[1](#footnotes)^ ENABLED (0, pēc noklusējuma), DISABLED (1)| |max\_sessions|<|integer|Maksimālais brīdinājumu skaits, ko var apstrādāt paralēli.<br>Iespējamās vērtības SMS gadījumā:^[1](#footnotes)^ 1 (pēc noklusējuma).<br>Iespējamās vērtības citiem mediju tipiem:^[1](#footnotes)^ 0-100 (kur 0 — neierobežoti).| |attempts|<|integer|Maksimālais mēģinājumu skaits brīdinājuma nosūtīšanai.<br>Iespējamās vērtības:^[1](#footnotes)^ 1-10 (pēc noklusējuma: 3).| |attempt\_interval|<|string|Intervāls (izmantojot sekundes vai [laika sufiksu](/manual/appendix/suffixes#time-suffixes)) starp atkārtotiem mēģinājumiem.<br>Iespējamās vērtības:^[1](#footnotes)^ 0-60s (pēc noklusējuma: 10s).| |description|<|string|Mediju tipa apraksts.| |message\_templates|<| |Saknes elements mediju tipa ziņojumu veidnēm.| |<|event\_source|string|(obligāti) Notikuma avots.<br>Iespējamās vērtības:^[1](#footnotes)^ TRIGGERS (0), DISCOVERY (1), AUTOREGISTRATION (2), INTERNAL (3), SERVICE (4).| |^|operation\_mode|string|Darbības režīms.<br>Iespējamās vērtības:^[1](#footnotes)^ PROBLEM (0), RECOVERY (1), UPDATE (2).| |^|subject|string|Ziņojuma tēma.| |^|message|string|Ziņojuma teksts.| ::: noteclassic Skatiet arī: [Media type object](/manual/api/reference/mediatype/object) (skatiet atbilstošo īpašību ar tādu pašu nosaukumu). ::: ## Exported elements Exported elements are explained in the tables below. |Element|<|Type|Description| |-|---|---|-----------------------| |template_groups|<| |(required) Root element for template groups.| |<|uuid|string|(required) Unique identifier for this template group.| |^|name|string|(required) Template group name.| |host_groups|<| |(required) Root element for host groups that are used by host prototypes.| |<|uuid|string|(required) Unique identifier for this host group.| |^|name|string|(required) Host group name.| |templates|<| |Root element for [templates](#templates).| ## Eksportētie elementi Eksportētie elementi ir izskaidroti tālāk esošajās tabulās. |Elements|<|Tips|Apraksts| |-|---|---|-----------------------| |template_groups|<| |(obligāts) Saknes elements veidņu grupām.| |<|uuid|string|(obligāts) Unikāls identifikators šai veidņu grupai.| |^|name|string|(obligāts) Veidņu grupas nosaukums.| |host_groups|<| |(obligāts) Saknes elements host grupām, ko izmanto host prototipi.| |<|uuid|string|(obligāts) Unikāls identifikators šai host grupai.| |^|name|string|(obligāts) Host grupas nosaukums.| |templates|<| |Saknes elements [veidnēm](#templates).| ## Exported elements Exported elements are explained in the tables below. |Element|<|Type|Description| |-|---|---|-----------------------| |version|<|string|(required) Zabbix version.| |host_groups|<| |(required) Root element for host groups.| |<|uuid|string|(required) Unique identifier for this host group.| |^|name|string|(required) Host group name.| |hosts|<| |Root element for [hosts](#hosts).| ## Eksportētie elementi Eksportētie elementi ir skaidroti tālāk esošajās tabulās. |Elements|<|Tips|Apraksts| |-|---|---|-----------------------| |version|<|string|(obligāts) Zabbix versija.| |host_groups|<| |(obligāts) Saknes elements hostu grupām.| |<|uuid|string|(obligāts) Unikāls šīs hostu grupas identifikators.| |^|name|string|(obligāts) Hostu grupas nosaukums.| |hosts|<| |Saknes elements [hosts](#hosts).| ##### ExportFileSize The maximum size per export file in bytes. Used for rotation if `ExportDir` is set. Default: `1G`<br> Range: 1M-1G ##### ExportFileSize Maksimālais izmērs vienam eksporta failam baitos. Tiek izmantots rotācijai, ja ir iestatīts `ExportDir`. Noklusējums: `1G`<br> Diapazons: 1M-1G ##### Export format Data can be exported using the Zabbix web frontend or [Zabbix API](/manual/api/reference/configuration). Supported export formats are YAML, XML and JSON. ##### Eksporta formāts Datus var eksportēt, izmantojot Zabbix lietotāja saskarni vai [Zabbix API](/manual/api/reference/configuration). Atbalstītie eksporta formāti ir YAML, XML un JSON. #### Export format Export format in YAML: ```yaml zabbix_export: version: '7.0' host_groups: - uuid: f2481361f99448eea617b7b1d4765566 name: 'Discovered hosts' - uuid: 6f6799aa69e844b4b3918f779f2abf08 name: 'Zabbix servers' hosts: - host: 'Zabbix server 1' name: 'Main Zabbix server' monitored_by: 'SERVER' templates: - name: 'Linux by Zabbix agent' - name: 'Zabbix server health' groups: - name: 'Discovered hosts' - name: 'Zabbix servers' interfaces: - ip: 192.168.1.1 interface_ref: if1 items: - name: 'Zabbix trap' type: TRAP key: trap delay: '0' history: 1w preprocessing: - type: MULTIPLIER parameters: - '8' tags: - tag: component value: 'raw' triggers: - expression: 'last(/Zabbix server 1/trap)=0' name: 'Last value is zero' priority: WARNING tags: - tag: scope value: 'availability' tags: - tag: service value: zabbix-server macros: - macro: '{$HOST.MACRO}' value: '123' - macro: '{$PASSWORD1}' type: SECRET_TEXT inventory: type: 'Zabbix server' name: yyyyyy-HP-Pro-3010-Small-Form-Factor-PC os: 'Linux yyyyyy-HP-Pro-3010-Small-Form-Factor-PC 4.4.0-165-generic #193-Ubuntu SMP Tue Sep 17 17:42:52 UTC 2019 x86_64' inventory_mode: AUTOMATIC graphs: - name: 'CPU utilization server' show_work_period: 'NO' show_triggers: 'NO' graph_items: - drawtype: FILLED_REGION color: FF5555 item: host: 'Zabbix server 1' key: 'system.cpu.util[,steal]' - sortorder: '1' drawtype: FILLED_REGION color: 55FF55 item: host: 'Zabbix server 1' key: 'system.cpu.util[,softirq]' - sortorder: '2' drawtype: FILLED_REGION color: '009999' item: host: 'Zabbix server 1' key: 'system.cpu.util[,interrupt]' - sortorder: '3' drawtype: FILLED_REGION color: '990099' item: host: 'Zabbix server 1' key: 'system.cpu.util[,nice]' - sortorder: '4' drawtype: FILLED_REGION color: '999900' item: host: 'Zabbix server 1' key: 'system.cpu.util[,iowait]' - sortorder: '5' drawtype: FILLED_REGION color: '990000' item: host: 'Zabbix server 1' key: 'system.cpu.util[,system]' - sortorder: '6' drawtype: FILLED_REGION color: '000099' calc_fnc: MIN item: host: 'Zabbix server 1' key: 'system.cpu.util[,user]' - sortorder: '7' drawtype: FILLED_REGION color: '009900' item: host: 'Zabbix server 1' key: 'system.cpu.util[,idle]' ``` #### Eksporta formāts Eksporta formāts YAML: ```yaml zabbix_export: version: '7.0' host_groups: - uuid: f2481361f99448eea617b7b1d4765566 name: 'Discovered hosts' - uuid: 6f6799aa69e844b4b3918f779f2abf08 name: 'Zabbix servers' hosts: - host: 'Zabbix server 1' name: 'Main Zabbix server' monitored_by: 'SERVER' templates: - name: 'Linux by Zabbix aģents' - name: 'Zabbix server health' groups: - name: 'Discovered hosts' - name: 'Zabbix servers' interfaces: - ip: 192.168.1.1 interface_ref: if1 items: - name: 'Zabbix trap' type: TRAP key: trap delay: '0' history: 1w preprocessing: - type: MULTIPLIER parameters: - '8' tags: - tag: component value: 'raw' triggers: - expression: 'last(/Zabbix server 1/trap)=0' name: 'Pēdējā vērtība ir nulle' priority: WARNING tags: - tag: scope value: 'availability' tags: - tag: service value: zabbix-server macros: - macro: '{$HOST.MACRO}' value: '123' - macro: '{$PASSWORD1}' type: SECRET_TEXT inventory: type: 'Zabbix server' name: yyyyyy-HP-Pro-3010-Small-Form-Factor-PC os: 'Linux yyyyyy-HP-Pro-3010-Small-Form-Factor-PC 4.4.0-165-generic #193-Ubuntu SMP Tue Sep 17 17:42:52 UTC 2019 x86_64' inventory_mode: AUTOMATIC graphs: - name: 'CPU utilization server' show_work_period: 'NO' show_triggers: 'NO' graph_items: - drawtype: FILLED_REGION color: FF5555 item: host: 'Zabbix server 1' key: 'system.cpu.util[,steal]' - sortorder: '1' drawtype: FILLED_REGION color: 55FF55 item: host: 'Zabbix server 1' key: 'system.cpu.util[,softirq]' - sortorder: '2' drawtype: FILLED_REGION color: '009999' item: host: 'Zabbix server 1' key: 'system.cpu.util[,interrupt]' - sortorder: '3' drawtype: FILLED_REGION color: '990099' item: host: 'Zabbix server 1' key: 'system.cpu.util[,nice]' - sortorder: '4' drawtype: FILLED_REGION color: '999900' item: host: 'Zabbix server 1' key: 'system.cpu.util[,iowait]' - sortorder: '5' drawtype: FILLED_REGION color: '990000' item: host: 'Zabbix server 1' key: 'system.cpu.util[,system]' - sortorder: '6' drawtype: FILLED_REGION color: '000099' calc_fnc: MIN item: host: 'Zabbix server 1' key: 'system.cpu.util[,user]' - sortorder: '7' drawtype: FILLED_REGION color: '009900' item: host: 'Zabbix server 1' key: 'system.cpu.util[,idle]' ``` #### Export format Export format in YAML: ```yaml zabbix_export: version: '7.0' template_groups: - uuid: a571c0d144b14fd4a87a9d9b2aa9fcd6 name: Templates/Applications host_groups: - uuid: a571c0d144b14fd4a87a9d9b2aa9fcd6 name: Applications templates: - uuid: 56079badd056419383cc26e6a4fcc7e0 template: VMware name: VMware description: | You can discuss this template or leave feedback on our forum https://www.zabbix.com/forum/zabbix-suggestions-and-feedback/ Template tooling version used: 0.41 groups: - name: Templates/Applications items: - uuid: 5ce209f4d94f460488a74a92a52d92b1 name: 'VMware: Event log' type: SIMPLE key: 'vmware.eventlog[{$VMWARE.URL},skip]' history: 7d trends: '0' value_type: LOG username: '{$VMWARE.USERNAME}' password: '{$VMWARE.PASSWORD}' description: 'Collect VMware event log.' tags: - tag: component value: log - uuid: ee2edadb8ce943ef81d25dbbba8667a4 name: 'VMware: Full name' type: SIMPLE key: 'vmware.fullname[{$VMWARE.URL}]' delay: 1h history: 7d trends: '0' value_type: CHAR username: '{$VMWARE.USERNAME}' password: '{$VMWARE.PASSWORD}' description: 'VMware service full name.' preprocessing: - type: DISCARD_UNCHANGED_HEARTBEAT parameters: - 1d tags: - tag: component value: system - uuid: a0ec9145f2234fbea79a28c57ebdb44d name: 'VMware: Version' type: SIMPLE key: 'vmware.version[{$VMWARE.URL}]' delay: 1h history: 7d trends: '0' value_type: CHAR username: '{$VMWARE.USERNAME}' password: '{$VMWARE.PASSWORD}' description: 'VMware service version.' preprocessing: - type: DISCARD_UNCHANGED_HEARTBEAT parameters: - 1d tags: - tag: component value: system discovery_rules: - uuid: 16ffc933cce74cf28a6edf306aa99782 name: 'Discover VMware clusters' type: SIMPLE key: 'vmware.cluster.discovery[{$VMWARE.URL}]' delay: 1h username: '{$VMWARE.USERNAME}' password: '{$VMWARE.PASSWORD}' description: 'Discovery of clusters' item_prototypes: - uuid: 46111f91dd564a459dbc1d396e2e6c76 name: 'VMware: Status of "{#CLUSTER.NAME}" cluster' type: SIMPLE key: 'vmware.cluster.status[{$VMWARE.URL},{#CLUSTER.NAME}]' history: 7d username: '{$VMWARE.USERNAME}' password: '{$VMWARE.PASSWORD}' description: 'VMware cluster status.' valuemap: name: 'VMware status' tags: - tag: cluster value: '{#CLUSTER.NAME}' - tag: component value: cluster - uuid: 8fb6a45cbe074b0cb6df53758e2c6623 name: 'Discover VMware datastores' type: SIMPLE key: 'vmware.datastore.discovery[{$VMWARE.URL}]' delay: 1h username: '{$VMWARE.USERNAME}' password: '{$VMWARE.PASSWORD}' item_prototypes: - uuid: 4b61838ba4c34e709b25081ae5b059b5 name: 'VMware: Average read latency of the datastore {#DATASTORE}' type: SIMPLE key: 'vmware.datastore.read[{$VMWARE.URL},{#DATASTORE},latency]' history: 7d username: '{$VMWARE.USERNAME}' password: '{$VMWARE.PASSWORD}' description: 'Amount of time for a read operation from the datastore (milliseconds).' tags: - tag: component value: datastore - tag: datastore value: '{#DATASTORE}' - uuid: 5355c401dc244bc588ccd18767577c93 name: 'VMware: Free space on datastore {#DATASTORE} (percentage)' type: SIMPLE key: 'vmware.datastore.size[{$VMWARE.URL},{#DATASTORE},pfree]' delay: 5m history: 7d value_type: FLOAT units: '%' username: '{$VMWARE.USERNAME}' password: '{$VMWARE.PASSWORD}' description: 'VMware datastore space in percentage from total.' tags: - tag: component value: datastore - tag: datastore value: '{#DATASTORE}' - uuid: 84f13c4fde2d4a17baaf0c8c1eb4f2c0 name: 'VMware: Total size of datastore {#DATASTORE}' type: SIMPLE key: 'vmware.datastore.size[{$VMWARE.URL},{#DATASTORE}]' delay: 5m history: 7d units: B username: '{$VMWARE.USERNAME}' password: '{$VMWARE.PASSWORD}' description: 'VMware datastore space in bytes.' tags: - tag: component value: datastore - tag: datastore value: '{#DATASTORE}' - uuid: 540cd0fbc56c4b8ea19f2ff5839ce00d name: 'VMware: Average write latency of the datastore {#DATASTORE}' type: SIMPLE key: 'vmware.datastore.write[{$VMWARE.URL},{#DATASTORE},latency]' history: 7d username: '{$VMWARE.USERNAME}' password: '{$VMWARE.PASSWORD}' description: 'Amount of time for a write operation to the datastore (milliseconds).' tags: - tag: component value: datastore - tag: datastore value: '{#DATASTORE}' - uuid: a5bc075e89f248e7b411d8f960897a08 name: 'Discover VMware hypervisors' type: SIMPLE key: 'vmware.hv.discovery[{$VMWARE.URL}]' delay: 1h username: '{$VMWARE.USERNAME}' password: '{$VMWARE.PASSWORD}' description: 'Discovery of hypervisors.' host_prototypes: - uuid: 051a1469d4d045cbbf818fcc843a352e host: '{#HV.UUID}' name: '{#HV.NAME}' group_links: - group: name: Applications group_prototypes: - name: '{#CLUSTER.NAME}' - name: '{#DATACENTER.NAME}' templates: - name: 'VMware Hypervisor' macros: - macro: '{$VMWARE.HV.UUID}' value: '{#HV.UUID}' description: 'UUID of hypervisor.' custom_interfaces: 'YES' interfaces: - ip: '{#HV.IP}' - uuid: 9fd559f4e88c4677a1b874634dd686f5 name: 'Discover VMware VMs' type: SIMPLE key: 'vmware.vm.discovery[{$VMWARE.URL}]' delay: 1h username: '{$VMWARE.USERNAME}' password: '{$VMWARE.PASSWORD}' description: 'Discovery of guest virtual machines.' host_prototypes: - uuid: 23b9ae9d6f33414880db1cb107115810 host: '{#VM.UUID}' name: '{#VM.NAME}' group_links: - group: name: Applications group_prototypes: - name: '{#CLUSTER.NAME} (vm)' - name: '{#DATACENTER.NAME}/{#VM.FOLDER} (vm)' - name: '{#HV.NAME}' templates: - name: 'VMware Guest' macros: - macro: '{$VMWARE.VM.UUID}' value: '{#VM.UUID}' description: 'UUID of guest virtual machine.' custom_interfaces: 'YES' interfaces: - ip: '{#VM.IP}' tags: - tag: class value: software - tag: target value: vmware macros: - macro: '{$VMWARE.PASSWORD}' description: 'VMware service {$USERNAME} user password' - macro: '{$VMWARE.URL}' description: 'VMware service (vCenter or ESX hypervisor) SDK URL (https://servername/sdk)' - macro: '{$VMWARE.USERNAME}' description: 'VMware service user name' valuemaps: - uuid: 3c59c22905054d42ac4ee8b72fe5f270 name: 'VMware status' mappings: - value: '0' newvalue: gray - value: '1' newvalue: green - value: '2' newvalue: yellow - value: '3' newvalue: red ``` #### Eksporta formāts Eksporta formāts YAML: ```yaml zabbix_export: version: '7.0' template_groups: - uuid: a571c0d144b14fd4a87a9d9b2aa9fcd6 name: Templates/Applications host_groups: - uuid: a571c0d144b14fd4a87a9d9b2aa9fcd6 name: Applications templates: - uuid: 56079badd056419383cc26e6a4fcc7e0 template: VMware name: VMware description: | Jūs varat apspriest šo veidni vai atstāt atsauksmes mūsu forumā https://www.zabbix.com/forum/zabbix-suggestions-and-feedback/ Izmantotā veidnes rīku versija: 0.41 groups: - name: Templates/Applications items: - uuid: 5ce209f4d94f460488a74a92a52d92b1 name: 'VMware: Notikumu žurnāls' type: SIMPLE key: 'vmware.eventlog[{$VMWARE.URL},skip]' history: 7d trends: '0' value_type: LOG username: '{$VMWARE.USERNAME}' password: '{$VMWARE.PASSWORD}' description: 'Savākt VMware notikumu žurnālu.' tags: - tag: component value: log - uuid: ee2edadb8ce943ef81d25dbbba8667a4 name: 'VMware: Pilns nosaukums' type: SIMPLE key: 'vmware.fullname[{$VMWARE.URL}]' delay: 1h history: 7d trends: '0' value_type: CHAR username: '{$VMWARE.USERNAME}' password: '{$VMWARE.PASSWORD}' description: 'VMware pakalpojuma pilns nosaukums.' preprocessing: - type: DISCARD_UNCHANGED_HEARTBEAT parameters: - 1d tags: - tag: component value: system - uuid: a0ec9145f2234fbea79a28c57ebdb44d name: 'VMware: Versija' type: SIMPLE key: 'vmware.version[{$VMWARE.URL}]' delay: 1h history: 7d trends: '0' value_type: CHAR username: '{$VMWARE.USERNAME}' password: '{$VMWARE.PASSWORD}' description: 'VMware pakalpojuma versija.' preprocessing: - type: DISCARD_UNCHANGED_HEARTBEAT parameters: - 1d tags: - tag: component value: system discovery_rules: - uuid: 16ffc933cce74cf28a6edf306aa99782 name: 'Atklāt VMware klasterus' type: SIMPLE key: 'vmware.cluster.discovery[{$VMWARE.URL}]' delay: 1h username: '{$VMWARE.USERNAME}' password: '{$VMWARE.PASSWORD}' description: 'Klasteru atklāšana' item_prototypes: - uuid: 46111f91dd564a459dbc1d396e2e6c76 name: 'VMware: Klastera "{#CLUSTER.NAME}" statuss' type: SIMPLE key: 'vmware.cluster.status[{$VMWARE.URL},{#CLUSTER.NAME}]' history: 7d username: '{$VMWARE.USERNAME}' password: '{$VMWARE.PASSWORD}' description: 'VMware klastera statuss.' valuemap: name: 'VMware status' tags: - tag: cluster value: '{#CLUSTER.NAME}' - tag: component value: cluster - uuid: 8fb6a45cbe074b0cb6df53758e2c6623 name: 'Atklāt VMware datu krātuves' type: SIMPLE key: 'vmware.datastore.discovery[{$VMWARE.URL}]' delay: 1h username: '{$VMWARE.USERNAME}' password: '{$VMWARE.PASSWORD}' item_prototypes: - uuid: 4b61838ba4c34e709b25081ae5b059b5 name: 'VMware: Datu krātuves {#DATASTORE} vidējā lasīšanas latentā aizture' type: SIMPLE key: 'vmware.datastore.read[{$VMWARE.URL},{#DATASTORE},latency]' history: 7d username: '{$VMWARE.USERNAME}' password: '{$VMWARE.PASSWORD}' description: 'Laiks, kas nepieciešams lasīšanas operācijai no datu krātuves (milisekundēs).' tags: - tag: component value: datastore - tag: datastore value: '{#DATASTORE}' - uuid: 5355c401dc244bc588ccd18767577c93 name: 'VMware: Brīvā vieta datu krātuvē {#DATASTORE} (procentos)' type: SIMPLE key: 'vmware.datastore.size[{$VMWARE.URL},{#DATASTORE},pfree]' delay: 5m history: 7d value_type: FLOAT units: '%' username: '{$VMWARE.USERNAME}' password: '{$VMWARE.PASSWORD}' description: 'VMware datu krātuves vieta procentos no kopējā apjoma.' tags: - tag: component value: datastore - tag: datastore value: '{#DATASTORE}' - uuid: 84f13c4fde2d4a17baaf0c8c1eb4f2c0 name: 'VMware: Datu krātuves {#DATASTORE} kopējais izmērs' type: SIMPLE key: 'vmware.datastore.size[{$VMWARE.URL},{#DATASTORE}]' delay: 5m history: 7d units: B username: '{$VMWARE.USERNAME}' password: '{$VMWARE.PASSWORD}' description: 'VMware datu krātuves vieta baitos.' tags: - tag: component value: datastore - tag: datastore value: '{#DATASTORE}' - uuid: 540cd0fbc56c4b8ea19f2ff5839ce00d name: 'VMware: Datu krātuves {#DATASTORE} vidējā rakstīšanas latentā aizture' type: SIMPLE key: 'vmware.datastore.write[{$VMWARE.URL},{#DATASTORE},latency]' history: 7d username: '{$VMWARE.USERNAME}' password: '{$VMWARE.PASSWORD}' description: 'Laiks, kas nepieciešams rakstīšanas operācijai uz datu krātuvi (milisekundēs).' tags: - tag: component value: datastore - tag: datastore value: '{#DATASTORE}' - uuid: a5bc075e89f248e7b411d8f960897a08 name: 'Atklāt VMware hipervizorus' type: SIMPLE key: 'vmware.hv.discovery[{$VMWARE.URL}]' delay: 1h username: '{$VMWARE.USERNAME}' password: '{$VMWARE.PASSWORD}' description: 'Hipervizoru atklāšana.' host_prototypes: - uuid: 051a1469d4d045cbbf818fcc843a352e host: '{#HV.UUID}' name: '{#HV.NAME}' group_links: - group: name: Applications group_prototypes: - name: '{#CLUSTER.NAME}' - name: '{#DATACENTER.NAME}' templates: - name: 'VMware Hypervisor' macros: - macro: '{$VMWARE.HV.UUID}' value: '{#HV.UUID}' description: 'Hipervizora UUID.' custom_interfaces: 'YES' interfaces: - ip: '{#HV.IP}' - uuid: 9fd559f4e88c4677a1b874634dd686f5 name: 'Atklāt VMware VM' type: SIMPLE key: 'vmware.vm.discovery[{$VMWARE.URL}]' delay: 1h username: '{$VMWARE.USERNAME}' password: '{$VMWARE.PASSWORD}' description: 'Viesu virtuālo mašīnu atklāšana.' host_prototypes: - uuid: 23b9ae9d6f33414880db1cb107115810 host: '{#VM.UUID}' name: '{#VM.NAME}' group_links: - group: name: Applications group_prototypes: - name: '{#CLUSTER.NAME} (vm)' - name: '{#DATACENTER.NAME}/{#VM.FOLDER} (vm)' - name: '{#HV.NAME}' templates: - name: 'VMware Guest' macros: - macro: '{$VMWARE.VM.UUID}' value: '{#VM.UUID}' description: 'Viesu virtuālās mašīnas UUID.' custom_interfaces: 'YES' interfaces: - ip: '{#VM.IP}' tags: - tag: class value: software - tag: target value: vmware macros: - macro: '{$VMWARE.PASSWORD}' description: 'VMware pakalpojuma lietotāja {$USERNAME} parole' - macro: '{$VMWARE.URL}' description: 'VMware pakalpojuma (vCenter vai ESX hipervizora) SDK URL (https://servername/sdk)' - macro: '{$VMWARE.USERNAME}' description: 'VMware pakalpojuma lietotājvārds' valuemaps: - uuid: 3c59c22905054d42ac4ee8b72fe5f270 name: 'VMware status' mappings: - value: '0' newvalue: gray - value: '1' newvalue: green - value: '2' newvalue: yellow - value: '3' newvalue: red ``` #### Export format Export to YAML: ```yaml zabbix_export: version: '7.0' images: - name: Zabbix_server_3D_(128) imagetype: '1' encodedImage: iVBOR...5CYII= maps: - name: 'Local network' width: '680' height: '200' label_type: '0' label_location: '0' highlight: '1' expandproblem: '1' markelements: '1' show_unack: '0' severity_min: '0' show_suppressed: '0' grid_size: '50' grid_show: '1' grid_align: '1' label_format: '0' label_type_host: '2' label_type_hostgroup: '2' label_type_trigger: '2' label_type_map: '2' label_type_image: '2' label_string_host: '' label_string_hostgroup: '' label_string_trigger: '' label_string_map: '' label_string_image: '' expand_macros: '1' background: { } iconmap: { } urls: { } selements: - elementtype: '0' elements: - host: 'Zabbix server' label: | {HOST.NAME} {HOST.CONN} label_location: '0' x: '111' 'y': '61' elementsubtype: '0' areatype: '0' width: '200' height: '200' viewtype: '0' use_iconmap: '0' selementid: '1' icon_off: name: Zabbix_server_3D_(128) icon_on: { } icon_disabled: { } icon_maintenance: { } urls: { } evaltype: '0' shapes: - type: '0' x: '0' 'y': '0' width: '680' height: '15' text: '{MAP.NAME}' font: '9' font_size: '11' font_color: '000000' text_halign: '0' text_valign: '0' border_type: '0' border_width: '0' border_color: '000000' background_color: '' zindex: '0' lines: { } links: { } ``` #### Eksporta formāts Eksportēt uz YAML: ```yaml zabbix_export: version: '7.0' images: - name: Zabbix_server_3D_(128) imagetype: '1' encodedImage: iVBOR...5CYII= maps: - name: 'Local network' width: '680' height: '200' label_type: '0' label_location: '0' highlight: '1' expandproblem: '1' markelements: '1' show_unack: '0' severity_min: '0' show_suppressed: '0' grid_size: '50' grid_show: '1' grid_align: '1' label_format: '0' label_type_host: '2' label_type_hostgroup: '2' label_type_trigger: '2' label_type_map: '2' label_type_image: '2' label_string_host: '' label_string_hostgroup: '' label_string_trigger: '' label_string_map: '' label_string_image: '' expand_macros: '1' background: { } iconmap: { } urls: { } selements: - elementtype: '0' elements: - host: 'Zabbix server' label: | {HOST.NAME} {HOST.CONN} label_location: '0' x: '111' 'y': '61' elementsubtype: '0' areatype: '0' width: '200' height: '200' viewtype: '0' use_iconmap: '0' selementid: '1' icon_off: name: Zabbix_server_3D_(128) icon_on: { } icon_disabled: { } icon_maintenance: { } urls: { } evaltype: '0' shapes: - type: '0' x: '0' 'y': '0' width: '680' height: '15' text: '{MAP.NAME}' font: '9' font_size: '11' font_color: '000000' text_halign: '0' text_valign: '0' border_type: '0' border_width: '0' border_color: '000000' background_color: '' zindex: '0' lines: { } links: { } ``` #### Export format Export to YAML: ```yaml zabbix_export: version: '7.0' media_types: - name: Pushover type: WEBHOOK parameters: - name: endpoint value: 'https://api.pushover.net/1/messages.json' - name: eventid value: '{EVENT.ID}' - name: event_nseverity value: '{EVENT.NSEVERITY}' - name: event_source value: '{EVENT.SOURCE}' - name: event_value value: '{EVENT.VALUE}' - name: expire value: '1200' - name: message value: '{ALERT.MESSAGE}' - name: priority_average value: '0' - name: priority_default value: '0' - name: priority_disaster value: '0' - name: priority_high value: '0' - name: priority_information value: '0' - name: priority_not_classified value: '0' - name: priority_warning value: '0' - name: retry value: '60' - name: title value: '{ALERT.SUBJECT}' - name: token value: '<PUSHOVER TOKEN HERE>' - name: triggerid value: '{TRIGGER.ID}' - name: url value: '{$ZABBIX.URL}' - name: url_title value: Zabbix - name: user value: '{ALERT.SENDTO}' status: DISABLED max_sessions: '0' script: | try { var params = JSON.parse(value), request = new HttpRequest(), data, response, severities = [ {name: 'not_classified', color: '#97AAB3'}, {name: 'information', color: '#7499FF'}, {name: 'warning', color: '#FFC859'}, {name: 'average', color: '#FFA059'}, {name: 'high', color: '#E97659'}, {name: 'disaster', color: '#E45959'}, {name: 'resolved', color: '#009900'}, {name: 'default', color: '#000000'} ], priority; if (typeof params.HTTPProxy === 'string' && params.HTTPProxy.trim() !== '') { request.setProxy(params.HTTPProxy); } if ([0, 1, 2, 3].indexOf(parseInt(params.event_source)) === -1) { throw 'Incorrect "event_source" parameter given: "' + params.event_source + '".\nMust be 0-3.'; } if (params.event_value !== '0' && params.event_value !== '1' && (params.event_source === '0' || params.event_source === '3')) { throw 'Incorrect "event_value" parameter given: ' + params.event_value + '\nMust be 0 or 1.'; } if ([0, 1, 2, 3, 4, 5].indexOf(parseInt(params.event_nseverity)) === -1) { params.event_nseverity = '7'; } if (params.event_value === '0') { params.event_nseverity = '6'; } priority = params['priority_' + severities[params.event_nseverity].name] || params.priority_default; if (isNaN(priority) || priority < -2 || priority > 2) { throw '"priority" should be -2..2'; } if (params.event_source === '0' && isNaN(params.triggerid)) { throw 'field "triggerid" is not a number'; } if (isNaN(params.eventid)) { throw 'field "eventid" is not a number'; } if (typeof params.message !== 'string' || params.message.trim() === '') { throw 'field "message" cannot be empty'; } data = { token: params.token, user: params.user, title: params.title, message: params.message, url: (params.event_source === '0') ? params.url + '/tr_events.php?triggerid=' + params.triggerid + '&eventid=' + params.eventid : params.url, url_title: params.url_title, priority: priority }; if (priority == 2) { if (isNaN(params.retry) || params.retry < 30) { throw 'field "retry" should be a number with value of at least 30 if "priority" is set to 2'; } if (isNaN(params.expire) || params.expire > 10800) { throw 'field "expire" should be a number with value of at most 10800 if "priority" is set to 2'; } data.retry = params.retry; data.expire = params.expire; } data = JSON.stringify(data); Zabbix.log(4, '[ Pushover Webhook ] Sending request: ' + params.endpoint + '\n' + data); request.addHeader('Content-Type: application/json'); response = request.post(params.endpoint, data); Zabbix.log(4, '[ Pushover Webhook ] Received response with status code ' + request.getStatus() + '\n' + response); if (response !== null) { try { response = JSON.parse(response); } catch (error) { Zabbix.log(4, '[ Pushover Webhook ] Failed to parse response received from Pushover'); response = null; } } if (request.getStatus() != 200 || response === null || typeof response !== 'object' || response.status !== 1) { if (response !== null && typeof response === 'object' && typeof response.errors === 'object' && typeof response.errors[0] === 'string') { throw response.errors[0]; } else { throw 'Unknown error. Check debug log for more information.'; } } return 'OK'; } catch (error) { Zabbix.log(4, '[ Pushover Webhook ] Pushover notification failed: ' + error); throw 'Pushover notification failed: ' + error; } description: | Please refer to setup guide here: https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/pushover Set token parameter with to your Pushover application key. When assigning Pushover media to the Zabbix user - add user key into send to field. message_templates: - event_source: TRIGGERS operation_mode: PROBLEM subject: 'Problem: {EVENT.NAME}' message: | Problem started at {EVENT.TIME} on {EVENT.DATE} Problem name: {EVENT.NAME} Host: {HOST.NAME} Severity: {EVENT.SEVERITY} Operational data: {EVENT.OPDATA} Original problem ID: {EVENT.ID} {TRIGGER.URL} - event_source: TRIGGERS operation_mode: RECOVERY subject: 'Resolved in {EVENT.DURATION}: {EVENT.NAME}' message: | Problem has been resolved at {EVENT.RECOVERY.TIME} on {EVENT.RECOVERY.DATE} Problem name: {EVENT.NAME} Problem duration: {EVENT.DURATION} Host: {HOST.NAME} Severity: {EVENT.SEVERITY} Original problem ID: {EVENT.ID} {TRIGGER.URL} - event_source: TRIGGERS operation_mode: UPDATE subject: 'Updated problem in {EVENT.AGE}: {EVENT.NAME}' message: | {USER.FULLNAME} {EVENT.UPDATE.ACTION} problem at {EVENT.UPDATE.DATE} {EVENT.UPDATE.TIME}. {EVENT.UPDATE.MESSAGE} Current problem status is {EVENT.STATUS}, age is {EVENT.AGE}, acknowledged: {EVENT.ACK.STATUS}. - event_source: DISCOVERY operation_mode: PROBLEM subject: 'Discovery: {DISCOVERY.DEVICE.STATUS} {DISCOVERY.DEVICE.IPADDRESS}' message: | Discovery rule: {DISCOVERY.RULE.NAME} Device IP: {DISCOVERY.DEVICE.IPADDRESS} Device DNS: {DISCOVERY.DEVICE.DNS} Device status: {DISCOVERY.DEVICE.STATUS} Device uptime: {DISCOVERY.DEVICE.UPTIME} Device service name: {DISCOVERY.SERVICE.NAME} Device service port: {DISCOVERY.SERVICE.PORT} Device service status: {DISCOVERY.SERVICE.STATUS} Device service uptime: {DISCOVERY.SERVICE.UPTIME} - event_source: AUTOREGISTRATION operation_mode: PROBLEM subject: 'Autoregistration: {HOST.HOST}' message: | Host name: {HOST.HOST} Host IP: {HOST.IP} Agent port: {HOST.PORT} ``` #### Eksporta formāts Eksportēt uz YAML: ```yaml zabbix_export: version: '7.0' media_types: - name: Pushover type: WEBHOOK parameters: - name: endpoint value: 'https://api.pushover.net/1/messages.json' - name: eventid value: '{EVENT.ID}' - name: event_nseverity value: '{EVENT.NSEVERITY}' - name: event_source value: '{EVENT.SOURCE}' - name: event_value value: '{EVENT.VALUE}' - name: expire value: '1200' - name: message value: '{ALERT.MESSAGE}' - name: priority_average value: '0' - name: priority_default value: '0' - name: priority_disaster value: '0' - name: priority_high value: '0' - name: priority_information value: '0' - name: priority_not_classified value: '0' - name: priority_warning value: '0' - name: retry value: '60' - name: title value: '{ALERT.SUBJECT}' - name: token value: '<PUSHOVER TOKEN HERE>' - name: triggerid value: '{TRIGGER.ID}' - name: url value: '{$ZABBIX.URL}' - name: url_title value: Zabbix - name: user value: '{ALERT.SENDTO}' status: DISABLED max_sessions: '0' script: | try { var params = JSON.parse(value), request = new HttpRequest(), data, response, severities = [ {name: 'not_classified', color: '#97AAB3'}, {name: 'information', color: '#7499FF'}, {name: 'warning', color: '#FFC859'}, {name: 'average', color: '#FFA059'}, {name: 'high', color: '#E97659'}, {name: 'disaster', color: '#E45959'}, {name: 'resolved', color: '#009900'}, {name: 'default', color: '#000000'} ], priority; if (typeof params.HTTPProxy === 'string' && params.HTTPProxy.trim() !== '') { request.setProxy(params.HTTPProxy); } if ([0, 1, 2, 3].indexOf(parseInt(params.event_source)) === -1) { throw 'Nekorekts parametrs "event_source": "' + params.event_source + '".\nTam jābūt 0-3.'; } if (params.event_value !== '0' && params.event_value !== '1' && (params.event_source === '0' || params.event_source === '3')) { throw 'Nekorekts parametrs "event_value": ' + params.event_value + '\nTam jābūt 0 vai 1.'; } if ([0, 1, 2, 3, 4, 5].indexOf(parseInt(params.event_nseverity)) === -1) { params.event_nseverity = '7'; } if (params.event_value === '0') { params.event_nseverity = '6'; } priority = params['priority_' + severities[params.event_nseverity].name] || params.priority_default; if (isNaN(priority) || priority < -2 || priority > 2) { throw '"priority" jābūt diapazonā -2..2'; } if (params.event_source === '0' && isNaN(params.triggerid)) { throw 'lauks "triggerid" nav skaitlis'; } if (isNaN(params.eventid)) { throw 'lauks "eventid" nav skaitlis'; } if (typeof params.message !== 'string' || params.message.trim() === '') { throw 'lauks "message" nevar būt tukšs'; } data = { token: params.token, user: params.user, title: params.title, message: params.message, url: (params.event_source === '0') ? params.url + '/tr_events.php?triggerid=' + params.triggerid + '&eventid=' + params.eventid : params.url, url_title: params.url_title, priority: priority }; if (priority == 2) { if (isNaN(params.retry) || params.retry < 30) { throw 'lauks "retry" jābūt skaitlim ar vērtību vismaz 30, ja "priority" ir iestatīts uz 2'; } if (isNaN(params.expire) || params.expire > 10800) { throw 'lauks "expire" jābūt skaitlim ar vērtību ne vairāk kā 10800, ja "priority" ir iestatīts uz 2'; } data.retry = params.retry; data.expire = params.expire; } data = JSON.stringify(data); Zabbix.log(4, '[ Pushover Webhook ] Sūta pieprasījumu: ' + params.endpoint + '\n' + data); request.addHeader('Content-Type: application/json'); response = request.post(params.endpoint, data); Zabbix.log(4, '[ Pushover Webhook ] Saņemta atbilde ar statusa kodu ' + request.getStatus() + '\n' + response); if (response !== null) { try { response = JSON.parse(response); } catch (error) { Zabbix.log(4, '[ Pushover Webhook ] Neizdevās parsēt no Pushover saņemto atbildi'); response = null; } } if (request.getStatus() != 200 || response === null || typeof response !== 'object' || response.status !== 1) { if (response !== null && typeof response === 'object' && typeof response.errors === 'object' && typeof response.errors[0] === 'string') { throw response.errors[0]; } else { throw 'Nezināma kļūda. Lai iegūtu vairāk informācijas, pārbaudiet atkļūdošanas žurnālu.'; } } return 'OK'; } catch (error) { Zabbix.log(4, '[ Pushover Webhook ] Pushover paziņojuma nosūtīšana neizdevās: ' + error); throw 'Pushover paziņojuma nosūtīšana neizdevās: ' + error; } description: | Lūdzu, skatiet iestatīšanas rokasgrāmatu šeit: https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/pushover Iestatiet parametru token ar savu Pushover lietotnes atslēgu. Piešķirot Pushover mediju Zabbix lietotājam, laukā "send to" pievienojiet lietotāja atslēgu. message_templates: - event_source: TRIGGERS operation_mode: PROBLEM subject: 'Problēma: {EVENT.NAME}' message: | Problēma sākās {EVENT.TIME} {EVENT.DATE} Problēmas nosaukums: {EVENT.NAME} Hosts: {HOST.NAME} Smagums: {EVENT.SEVERITY} Operatīvie dati: {EVENT.OPDATA} Sākotnējās problēmas ID: {EVENT.ID} {TRIGGER.URL} - event_source: TRIGGERS operation_mode: RECOVERY subject: 'Atrisināts {EVENT.DURATION}: {EVENT.NAME}' message: | Problēma tika atrisināta {EVENT.RECOVERY.TIME} {EVENT.RECOVERY.DATE} Problēmas nosaukums: {EVENT.NAME} Problēmas ilgums: {EVENT.DURATION} Hosts: {HOST.NAME} Smagums: {EVENT.SEVERITY} Sākotnējās problēmas ID: {EVENT.ID} {TRIGGER.URL} - event_source: TRIGGERS operation_mode: UPDATE subject: 'Atjaunināta problēma {EVENT.AGE}: {EVENT.NAME}' message: | {USER.FULLNAME} {EVENT.UPDATE.ACTION} problēmu {EVENT.UPDATE.DATE} {EVENT.UPDATE.TIME}. {EVENT.UPDATE.MESSAGE} Pašreizējais problēmas statuss ir {EVENT.STATUS}, vecums ir {EVENT.AGE}, apstiprināts: {EVENT.ACK.STATUS}. - event_source: DISCOVERY operation_mode: PROBLEM subject: 'Atklāšana: {DISCOVERY.DEVICE.STATUS} {DISCOVERY.DEVICE.IPADDRESS}' message: | Atklāšanas noteikums: {DISCOVERY.RULE.NAME} Ierīces IP: {DISCOVERY.DEVICE.IPADDRESS} Ierīces DNS: {DISCOVERY.DEVICE.DNS} Ierīces statuss: {DISCOVERY.DEVICE.STATUS} Ierīces darbības laiks: {DISCOVERY.DEVICE.UPTIME} Ierīces pakalpojuma nosaukums: {DISCOVERY.SERVICE.NAME} Ierīces pakalpojuma ports: {DISCOVERY.SERVICE.PORT} Ierīces pakalpojuma statuss: {DISCOVERY.SERVICE.STATUS} Ierīces pakalpojuma darbības laiks: {DISCOVERY.SERVICE.UPTIME} - event_source: AUTOREGISTRATION operation_mode: PROBLEM subject: 'Automātiska reģistrācija: {HOST.HOST}' message: | Hosts nosaukums: {HOST.HOST} Hosts IP: {HOST.IP} Aģenta ports: {HOST.PORT} ``` #### Export format ```yaml host_groups: - uuid: 6f6799aa69e844b4b3918f779f2abf08 name: 'Zabbix servers' ``` #### Eksporta formāts ```yaml host_groups: - uuid: 6f6799aa69e844b4b3918f779f2abf08 name: 'Zabbix serveri' ``` #### Export format ```yaml template_groups: - uuid: 36bff6c29af64692839d077febfc7079 name: 'Network devices' ``` #### Eksporta formāts ```yaml template_groups: - uuid: 36bff6c29af64692839d077febfc7079 name: 'Tīkla ierīces' ``` #### Exporting a template Export the configuration of template "10571" as an XML string. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "configuration.export", "params": { "options": { "templates": [ "10571" ] }, "format": "xml" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<zabbix_export><version>7.0</version><template_groups><template_group><uuid>7df96b18c230490a9a0a9e2307226338</uuid><name>Templates</name></template_group></template_groups><templates><template><uuid>5aef0444a82a4d8cb7a95dc4c0c85330</uuid><template>New template</template><name>New template</name><groups><group><name>Templates</name></group></groups><items><item><uuid>7f1e6f1e48aa4a128e5b6a958a5d11c3</uuid><name>Zabbix agent ping</name><key>agent.ping</key></item><item><uuid>77ba228662be4570830aa3c503fcdc03</uuid><name>Apache server uptime</name><type>DEPENDENT</type><key>apache.server.uptime</key><delay>0</delay><trends>0</trends><value_type>TEXT</value_type><preprocessing><step><type>REGEX</type><parameters><parameter>&lt;dt&gt;Server uptime: (.*)&lt;\/dt&gt;</parameter><parameter>\\1</parameter></parameters></step></preprocessing><master_item><key>web.page.get[127.0.0.1/server-status]</key></master_item></item><item><uuid>6805d4c39a624a8bab2cc8ab63df1ab3</uuid><name>CPU load</name><key>system.cpu.load</key><value_type>FLOAT</value_type><triggers><trigger><uuid>ab4c2526c2bc42e48a633082255ebcb3</uuid><expression>avg(/New template/system.cpu.load,3m)&gt;2</expression><name>CPU load too high on {HOST.HOST} for 3 minutes</name><priority>WARNING</priority></trigger></triggers></item><item><uuid>590efe5731254f089265c76ff9320726</uuid><name>Apache server status</name><key>web.page.get[127.0.0.1/server-status]</key><trends>0</trends><value_type>TEXT</value_type></item></items><valuemaps><valuemap><uuid>8fd5814c45d44a00a15ac6eaae1f3946</uuid><name>Zabbix agent ping</name><mappings><mapping><value>1</value><newvalue>Available</newvalue></mapping><mapping><value>0</value><newvalue>Not available</newvalue></mapping></mappings></valuemap></valuemaps></template></templates></zabbix_export>\n", "id": 1 } ``` #### Veidnes eksportēšana Eksportējiet veidnes "10571" konfigurāciju kā XML virkni. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "configuration.export", "params": { "options": { "templates": [ "10571" ] }, "format": "xml" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<zabbix_export><version>7.0</version><template_groups><template_group><uuid>7df96b18c230490a9a0a9e2307226338</uuid><name>Templates</name></template_group></template_groups><templates><template><uuid>5aef0444a82a4d8cb7a95dc4c0c85330</uuid><template>New template</template><name>New template</name><groups><group><name>Templates</name></group></groups><items><item><uuid>7f1e6f1e48aa4a128e5b6a958a5d11c3</uuid><name>Zabbix agent ping</name><key>agent.ping</key></item><item><uuid>77ba228662be4570830aa3c503fcdc03</uuid><name>Apache server uptime</name><type>DEPENDENT</type><key>apache.server.uptime</key><delay>0</delay><trends>0</trends><value_type>TEXT</value_type><preprocessing><step><type>REGEX</type><parameters><parameter>&lt;dt&gt;Server uptime: (.*)&lt;\/dt&gt;</parameter><parameter>\\1</parameter></parameters></step></preprocessing><master_item><key>web.page.get[127.0.0.1/server-status]</key></master_item></item><item><uuid>6805d4c39a624a8bab2cc8ab63df1ab3</uuid><name>CPU load</name><key>system.cpu.load</key><value_type>FLOAT</value_type><triggers><trigger><uuid>ab4c2526c2bc42e48a633082255ebcb3</uuid><expression>avg(/New template/system.cpu.load,3m)&gt;2</expression><name>CPU slodze ir pārāk augsta uz {HOST.HOST} 3 minūtes</name><priority>WARNING</priority></trigger></triggers></item><item><uuid>590efe5731254f089265c76ff9320726</uuid><name>Apache server status</name><key>web.page.get[127.0.0.1/server-status]</key><trends>0</trends><value_type>TEXT</value_type></item></items><valuemaps><valuemap><uuid>8fd5814c45d44a00a15ac6eaae1f3946</uuid><name>Zabbix agent ping</name><mappings><mapping><value>1</value><newvalue>Available</newvalue></mapping><mapping><value>0</value><newvalue>Not available</newvalue></mapping></mappings></valuemap></valuemaps></template></templates></zabbix_export>\n", "id": 1 } ``` #### Exporting To export hosts, do the following: 1. Go to *Data collection* → *Hosts*. 2. Mark the checkboxes of the hosts to export. 3. Click *Export* below the list.  Depending on the selected format, hosts are exported to a local file with a default name: - `zabbix_export_hosts.yaml` - in YAML export (default option for export); - `zabbix_export_hosts.xml` - in XML export; - `zabbix_export_hosts.json` - in JSON export. #### Eksportēšana Lai eksportētu hostus, rīkojieties šādi: 1. Atveriet *Datu ievākšana* → *Hosti*. 2. Atzīmējiet eksportējamo hostu izvēles rūtiņas. 3. Zem saraksta noklikšķiniet uz *Eksportēt*.  Atkarībā no izvēlētā formāta hosti tiek eksportēti uz lokālu failu ar noklusējuma nosaukumu: - `zabbix_export_hosts.yaml` - YAML eksportā (noklusējuma eksporta opcija); - `zabbix_export_hosts.xml` - XML eksportā; - `zabbix_export_hosts.json` - JSON eksportā. #### Exporting To export media types, do the following: 1. Go to *Alerts* → *Media types*. 2. Mark the checkboxes of the media types to export. 3. Click *Export* below the list.  Depending on the selected format, media types are exported to a local file with a default name: - `zabbix_export_mediatypes.yaml` - in YAML export (default option for export); - `zabbix_export_mediatypes.xml` - in XML export; - `zabbix_export_mediatypes.json` - in JSON export. #### Eksportēšana Lai eksportētu paziņojumu nesēju tipus, rīkojieties šādi: 1. Atveriet *Brīdinājumi* → *Paziņojumu nesēju tipi*. 2. Atzīmējiet eksportējamo paziņojumu nesēju tipu izvēles rūtiņas. 3. Zem saraksta noklikšķiniet uz *Eksportēt*.  Atkarībā no izvēlētā formāta paziņojumu nesēju tipi tiek eksportēti uz lokālu failu ar noklusējuma nosaukumu: - `zabbix_export_mediatypes.yaml` - YAML eksportam (noklusējuma eksporta opcija); - `zabbix_export_mediatypes.xml` - XML eksportam; - `zabbix_export_mediatypes.json` - JSON eksportam. #### Exporting To export network maps, do the following: 1. Go to *Monitoring* → *Maps*. 2. Mark the checkboxes of the network maps to export. 3. Click *Export* below the list.  Depending on the selected format, maps are exported to a local file with a default name: - `zabbix_export_maps.yaml` - in YAML export (default option for export); - `zabbix_export_maps.xml` - in XML export; - `zabbix_export_maps.json` - in JSON export. #### Eksportēšana Lai eksportētu tīkla kartes, rīkojieties šādi: 1. Dodieties uz *Monitoring* → *Maps*. 2. Atzīmējiet eksportējamo tīkla karšu izvēles rūtiņas. 3. Zem saraksta noklikšķiniet uz *Export*.  Atkarībā no izvēlētā formāta kartes tiek eksportētas uz lokālu failu ar noklusējuma nosaukumu: - `zabbix_export_maps.yaml` — YAML eksportā (noklusējuma eksporta opcija); - `zabbix_export_maps.xml` — XML eksportā; - `zabbix_export_maps.json` — JSON eksportā. #### Exporting To export templates, do the following: 1. Go to *Data collection* → *Templates*. 2. Mark the checkboxes of the templates to export. 3. Click *Export* below the list.  Depending on the selected format, templates are exported to a local file with a default name: - `zabbix_export_templates.yaml` - in YAML export (default option for export); - `zabbix_export_templates.xml` - in XML export; - `zabbix_export_templates.json` - in JSON export. #### Eksportēšana Lai eksportētu veidnes, rīkojieties šādi: 1. Dodieties uz *Datu ievākšana* → *Veidnes*. 2. Atzīmējiet eksportējamo veidņu izvēles rūtiņas. 3. Zem saraksta noklikšķiniet uz *Eksportēt*.  Atkarībā no izvēlētā formāta veidnes tiek eksportētas uz lokālu failu ar noklusējuma nosaukumu: - `zabbix_export_templates.yaml` - YAML eksportā (noklusējuma eksporta opcija); - `zabbix_export_templates.xml` - XML eksportā; - `zabbix_export_templates.json` - JSON eksportā. ###### Export request A request to execute the Export function of the Exporter interface. | | | |---|---| |direction|agent → plugin| |response|no| Parameters specific to export requests: |Name|Type|Comments| |---------|--------|----------| |key|string|The plugin key.| |parameters|array of strings (optional)|The parameters for Export function.| *Example:* {"id":4,"type":6,"key":"test.key","parameters":["foo","bar"]} ###### Eksportēšanas pieprasījums Pieprasījums izpildīt Exporter saskarnes funkciju Export. | | | |---|---| |virziens|aģents → spraudnis| |atbilde|nē| Eksportēšanas pieprasījumiem specifiski parametri: |Nosaukums|Type|Komentāri| |---------|--------|----------| |key|string|Spraudņa atslēga.| |parameters|array of strings (optional)|Funkcijas Export parametri.| *Piemērs:* {"id":4,"type":6,"key":"test.key","parameters":["foo","bar"]} ###### Export response Response from the Export function of the Exporter interface. | | | |---|---| |direction|plugin → agent| |response|n/a| Parameters specific to export responses: |Name|Type|Comments| |---------|--------|----------| |value|string (optional) |Response value from the Export function. Absent, if error is returned.| |error|string (optional) |Error message if the Export function has not been executed successfully. Absent, if value is returned.| *Examples:* {"id":5,"type":7,"value":"response"} or {"id":5,"type":7,"error":"error message"} ###### Eksportēšanas atbilde Atbilde no Exporter interfeisa funkcijas Export. | | | |---|---| |virziens|spraudnis → aģents| |atbilde|nav piemērojams| Parametri, kas raksturīgi eksportēšanas atbildēm: |Nosaukums|Tips|Komentāri| |---------|--------|----------| |value|string (optional) |Atbildes vērtība no funkcijas Export. Nav norādīta, ja tiek atgriezta kļūda.| |error|string (optional) |Kļūdas ziņojums, ja funkcija Export nav izpildīta veiksmīgi. Nav norādīts, ja tiek atgriezta vērtība.| *Piemēri:* {"id":5,"type":7,"value":"response"} vai {"id":5,"type":7,"error":"error message"} ##### ExportType The list of comma-delimited entity types (events, history, trends) for [real-time export](/manual/config/export/files) (all types by default). Valid only if `ExportDir` is set.<br>*Note* that if `ExportType` is specified, but `ExportDir` is not, then this is a configuration error and the server will not start. Example for history and trends export: ```default ExportType=history,trends ``` Example for event export only: ```default ExportType=events ``` ##### ExportType Ar komatiem atdalītu entītiju tipu saraksts (events, history, trends) [reāllaika eksportam](/manual/config/export/files) (pēc noklusējuma visi tipi). Derīgs tikai tad, ja ir iestatīts `ExportDir`.<br>*Piezīme* ja ir norādīts `ExportType`, bet `ExportDir` nav norādīts, tā ir konfigurācijas kļūda un serveris netiks palaists. Piemērs history un trends eksportam: ```default ExportType=history,trends ``` Piemērs tikai event eksportam: ```default ExportType=events ``` #### Exposed metrics The stats items gather the statistics in bulk and return a JSON, which is the basis for dependent items to get their data from. The following [internal metrics](/manual/config/items/itemtypes/internal) are returned by either of the two items: - `zabbix[boottime]` - `zabbix[hosts]` - `zabbix[items]` - `zabbix[items_unsupported]` - `zabbix[preprocessing]` (server only) - `zabbix[preprocessing_queue]` (server only) - `zabbix[process,<type>,<mode>,<state>]` (only process type based statistics) - `zabbix[rcache,<cache>,<mode>]` - `zabbix[requiredperformance]` - `zabbix[triggers]` (server only) - `zabbix[uptime]` - `zabbix[vcache,buffer,<mode>]` (server only) - `zabbix[vcache,cache,<parameter>]` - `zabbix[version]` - `zabbix[vmware,buffer,<mode>]` - `zabbix[wcache,<cache>,<mode>]` ('trends' cache type server only) #### Pieejamie metriķi Statistikas vienumi apkopo statistiku vairumā un atgriež JSON, kas ir pamats atkarīgajiem vienumiem datu iegūšanai. Tālāk norādītie [iekšējie metriķi](/manual/config/items/itemtypes/internal) tiek atgriezti ar jebkuru no šiem diviem vienumiem: - `zabbix[boottime]` - `zabbix[hosts]` - `zabbix[items]` - `zabbix[items_unsupported]` - `zabbix[preprocessing]` (tikai serverim) - `zabbix[preprocessing_queue]` (tikai serverim) - `zabbix[process,<type>,<mode>,<state>]` (tikai uz procesa tipa balstīta statistika) - `zabbix[rcache,<cache>,<mode>]` - `zabbix[requiredperformance]` - `zabbix[triggers]` (tikai serverim) - `zabbix[uptime]` - `zabbix[vcache,buffer,<mode>]` (tikai serverim) - `zabbix[vcache,cache,<parameter>]` - `zabbix[version]` - `zabbix[vmware,buffer,<mode>]` - `zabbix[wcache,<cache>,<mode>]` (`trends` kešatmiņas tips tikai serverim) ### Expressions The expressions object has the following properties. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |expression|string|Regular expression.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |expression\_type|integer|Type of Regular expression.<br><br>Possible values:<br>0 - Character string included;<br>1 - Any character string included;<br>2 - Character string not included;<br>3 - Result is TRUE;<br>4 - Result is FALSE.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |exp\_delimiter|string|Expression delimiter.<br><br>Default value: `","`.<br><br>Possible values: `","` or `"."`, or `"/"`.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `expression_type` is set to "Any character string included"| |case\_sensitive|integer|Case sensitivity.<br><br>Default value: `0`.<br><br>Possible values:<br>0 - Case insensitive;<br>1 - Case sensitive.| ### Izteiksmes Izteiksmju objektam ir šādas īpašības. |Īpašība|[Tips](/manual/api/reference_commentary#data-types)|Apraksts| |--|--|------| |expression|string|Regulārā izteiksme.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāta*| |expression\_type|integer|Regulārās izteiksmes tips.<br><br>Iespējamās vērtības:<br>0 - Iekļauta rakstzīmju virkne;<br>1 - Iekļauta jebkura rakstzīmju virkne;<br>2 - Rakstzīmju virkne nav iekļauta;<br>3 - Rezultāts ir TRUE;<br>4 - Rezultāts ir FALSE.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāta*| |exp\_delimiter|string|Izteiksmes atdalītājs.<br><br>Noklusējuma vērtība: `","`.<br><br>Iespējamās vērtības: `","` vai `"."`, vai `"/"`.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *atbalstīta*, ja `expression_type` ir iestatīts uz "Iekļauta jebkura rakstzīmju virkne"| |case\_sensitive|integer|Reģistra jutība.<br><br>Noklusējuma vērtība: `0`.<br><br>Iespējamās vērtības:<br>0 - Reģistrnejutīga;<br>1 - Reģistrjutīga.| #### Expressions with unknown operands Generally an unknown operand (such as an unsupported item) in the expression will immediately render the trigger value to `Unknown`. However, in some cases unknown operands (unsupported items, function errors) are admitted into expression evaluation: - The `nodata()` function is evaluated regardless of whether the referenced item is supported or not. - Logical expressions with OR and AND can be evaluated to known values in two cases regardless of unknown operands: - **Case 1**: "`1 or some_function(unsupported_item1) or some_function(unsupported_item2) or ...`" can be evaluated to known result ('1' or "Problem"), - **Case 2**: "`0 and some_function(unsupported_item1) and some_function(unsupported_item2) and ...`" can be evaluated to known result ('0' or "OK").<br> Zabbix tries to evaluate such logical expressions by taking unsupported items as unknown operands. In the two cases above a known value will be produced ("Problem" or "OK", respectively); in **all other** cases the trigger will evaluate to `Unknown`. - If the function evaluation for a supported item results in error, the function value becomes `Unknown` and it takes part as unknown operand in further expression evaluation. Note that unknown operands may "disappear" only in logical expressions as described above. In arithmetic expressions unknown operands always lead to the result `Unknown` (except division by 0). ::: noteimportant An expression that results in `Unknown` does not change the trigger state ("Problem/OK"). So, if it was "Problem" (see Case 1), it stays in the same problem state even if the known part is resolved ('1' becomes '0'), because the expression is now evaluated to `Unknown` and that does not change the trigger state. ::: If a trigger expression with several unsupported items evaluates to `Unknown` the error message in the frontend refers to the last unsupported item evaluated. #### Izteiksmes ar nezināmiem operandiem Parasti nezināms operands (piemēram, neatbalstīts vienums) izteiksmē nekavējoties padarīs trigeris vērtību par `Unknown`. Tomēr dažos gadījumos nezināmi operandi (neatbalstīti vienumi, funkciju kļūdas) tiek pieļauti izteiksmes izvērtēšanā: - Funkcija `nodata()` tiek izvērtēta neatkarīgi no tā, vai atsauces vienums ir atbalstīts vai nav. - Loģiskās izteiksmes ar OR un AND var tikt izvērtētas līdz zināmām vērtībām divos gadījumos neatkarīgi no nezināmiem operandiem: - **1. gadījums**: "`1 or some_function(unsupported_item1) or some_function(unsupported_item2) or ...`" var tikt izvērtēta līdz zināmam rezultātam ('1' vai "Problem"), - **2. gadījums**: "`0 and some_function(unsupported_item1) and some_function(unsupported_item2) and ...`" var tikt izvērtēta līdz zināmam rezultātam ('0' vai "OK").<br> Zabbix mēģina izvērtēt šādas loģiskās izteiksmes, uzskatot neatbalstītos vienumus par nezināmiem operandiem. Abos iepriekš minētajos gadījumos tiks iegūta zināma vērtība ("Problem" vai "OK" attiecīgi); **visos citos** gadījumos trigeris tiks izvērtēts kā `Unknown`. - Ja funkcijas izvērtēšana atbalstītam vienumam beidzas ar kļūdu, funkcijas vērtība kļūst par `Unknown`, un tā turpmākajā izteiksmes izvērtēšanā piedalās kā nezināms operands. Ņemiet vērā, ka nezināmi operandi var "pazust" tikai loģiskajās izteiksmēs, kā aprakstīts iepriekš. Aritmētiskajās izteiksmēs nezināmi operandi vienmēr noved pie rezultāta `Unknown` (izņemot dalīšanu ar 0). ::: noteimportant Izteiksme, kuras rezultāts ir `Unknown`, nemaina trigeris stāvokli ("Problem/OK"). Tātad, ja tas bija "Problem" (skatiet 1. gadījumu), tas paliek tajā pašā problēmas stāvoklī pat tad, ja zināmā daļa tiek atrisināta ('1' kļūst par '0'), jo izteiksme tagad tiek izvērtēta kā `Unknown`, un tas nemaina trigeris stāvokli. ::: Ja trigeris izteiksme ar vairākiem neatbalstītiem vienumiem tiek izvērtēta kā `Unknown`, kļūdas ziņojums lietotāja saskarne attiecas uz pēdējo izvērtēto neatbalstīto vienumu. ##### exp(value) {#exp} The Euler's number at a power of a value. Parameter: - **value** - the value to check For example, Euler's number at a power of a value '2' will be '7.38905609893065'. Example: exp(last(/host/key)) ##### exp(value) {#exp} Eilera skaitlis vērtības pakāpē. Parametrs: - **value** - pārbaudāmā vērtība Piemēram, Eilera skaitlis vērtības '2' pakāpē būs '7.38905609893065'. Piemērs: exp(last(/host/key)) #### Extended logging The data collected by the *vmware collector* processes can be logged for detailed debugging using debug level 5. The debug level can be configured in the [server](/manual/appendix/config/zabbix_server#debuglevel) and [proxy](/manual/appendix/config/zabbix_proxy#debuglevel) configuration files or using the runtime control option `-R log_level_increase="vmware collector,N"`, where "N" is the process number. For example, to increase the debug level from 4 to 5 for all *vmware collector* processes, run the following command: zabbix_server -R log_level_increase="vmware collector" To increase the debug level from 4 to 5 for the second *vmware collector* process, run the following command: zabbix_server -R log_level_increase="vmware collector,2" When extended logging of VMware collector data is no longer required, it is recommended to decrease the debug level to default (3) by running the `-R log_level_decrease` command. #### Paplašināta reģistrēšana Datus, ko apkopo *vmware collector* procesi, var reģistrēt detalizētai atkļūdošanai, izmantojot 5. atkļūdošanas līmeni. Atkļūdošanas līmeni var konfigurēt [servera](/manual/appendix/config/zabbix_server#debuglevel) un [starpniekservera](/manual/appendix/config/zabbix_proxy#debuglevel) konfigurācijas failos vai izmantojot izpildlaika vadības opciju `-R log_level_increase="vmware collector,N"`, kur "N" ir procesa numurs. Piemēram, lai palielinātu atkļūdošanas līmeni no 4 līdz 5 visiem *vmware collector* procesiem, izpildiet šādu komandu: zabbix_server -R log_level_increase="vmware collector" Lai palielinātu atkļūdošanas līmeni no 4 līdz 5 otrajam *vmware collector* procesam, izpildiet šādu komandu: zabbix_server -R log_level_increase="vmware collector,2" Kad paplašināta VMware collector datu reģistrēšana vairs nav nepieciešama, ieteicams samazināt atkļūdošanas līmeni līdz noklusējuma vērtībai (3), izpildot komandu `-R log_level_decrease`. #### Extended monitoring Sometimes it is necessary to log received HTML page content. This is especially useful if some web scenario step fails. Debug level 5 (trace) serves that purpose. This level can be set in [server](/manual/appendix/config/zabbix_server#debuglevel) and [proxy](/manual/appendix/config/zabbix_proxy#debuglevel) configuration files or using a [runtime control](/manual/concepts/server#runtime-control) option (`-R log_level_increase="http poller,N"`, where N is the process number). The following examples demonstrate how extended monitoring can be started provided debug level 4 is already set: # Increase log level of all http pollers: zabbix_server -R log_level_increase="http poller" # Increase log level of second http poller: zabbix_server -R log_level_increase="http poller,2" If extended web monitoring is not required it can be stopped using the `-R log_level_decrease` option. #### Paplašināta uzraudzība Dažkārt ir nepieciešams reģistrēt saņemtās HTML lapas saturu. Tas ir īpaši noderīgi, ja kāds tīmekļa scenārija solis neizdodas. Šim nolūkam kalpo atkļūdošanas līmenis 5 (trace). Šo līmeni var iestatīt [serveris](/manual/appendix/config/zabbix_server#debuglevel) un [starpniekserveris](/manual/appendix/config/zabbix_proxy#debuglevel) konfigurācijas failos vai, izmantojot [izpildlaika vadības](/manual/concepts/server#runtime-control) opciju (`-R log_level_increase="http poller,N"`, kur N ir procesa numurs). Tālāk redzamie piemēri parāda, kā var sākt paplašinātu uzraudzību, ja jau ir iestatīts atkļūdošanas līmenis 4: # Palielināt visu http poller žurnāla līmeni: zabbix_server -R log_level_increase="http poller" # Palielināt otrā http poller žurnāla līmeni: zabbix_server -R log_level_increase="http poller,2" Ja paplašināta tīmekļa uzraudzība nav nepieciešama, to var apturēt, izmantojot `-R log_level_decrease` opciju. #### Extended sorting in Top hosts widget Now, besides sorting by *Item value*, it is also possible to set *Host name* or *Text* column as the order column in *Top hosts* widget. #### Paplašināta kārtošana widgetā Top hosts Tagad papildus kārtošanai pēc *vienuma vērtības* ir iespējams iestatīt arī *hosts nosaukuma* vai *teksta* kolonnu kā kārtošanas kolonnu widgetā *Top hosts*. #### Extended support of macro functions [Macro functions](/manual/config/macros/macro_functions) are now supported with all types of macros: - [Built-in macros](/manual/appendix/macros/supported_by_location) - [User macros](/manual/config/macros/user_macros) - [Low-level discovery macros](/manual/config/macros/lld_macros) - [Expression macros](/manual/config/macros/expression_macros) Macro functions can be used in all locations supporting the listed macros. This applies unless explicitly stated that only a macro is expected (for example, when configuring [host macros](/manual/config/hosts/host#configuration) or low-level discovery rule [filters](/manual/discovery/low_level_discovery#filter)). #### Paplašināts makro funkciju atbalsts [Makro funkcijas](/manual/config/macros/macro_functions) tagad tiek atbalstītas ar visiem makro veidiem: - [Iebūvētie makro](/manual/appendix/macros/supported_by_location) - [Lietotāja makro](/manual/config/macros/user_macros) - [Zema līmeņa atklāšanas makro](/manual/config/macros/lld_macros) - [Izteiksmes makro](/manual/config/macros/expression_macros) Makro funkcijas var izmantot visās vietās, kas atbalsta uzskaitītos makro. Tas attiecas, ja vien nav skaidri norādīts, ka tiek gaidīts tikai makro (piemēram, konfigurējot [host makro](/manual/config/hosts/host#configuration) vai zema līmeņa atklāšanas noteikuma [filtrus](/manual/discovery/low_level_discovery#filter)). #### External check result The return value of an external check is a standard output together with a standard error produced by the check. ::: noteimportant An item that returns text (character, log, or text type of information) will not become unsupported in case of a standard error output. ::: The return value is limited to 16MB (including trailing whitespace that is truncated); [database limits](/manual/config/items/item#text-data-limits) also apply. If the requested script is not found or Zabbix server/proxy has no permissions to execute it, the item will become unsupported and a corresponding error message will be displayed. In case of a timeout, the item will become unsupported, a corresponding error message will be displayed, and the process forked for the script will be terminated. #### Ārējās pārbaudes rezultāts Ārējās pārbaudes atgrieztā vērtība ir standarta izvade kopā ar standarta kļūdu, ko ģenerē pārbaude. ::: noteimportant Vienums, kas atgriež tekstu (rakstzīmju, žurnāla vai teksta tipa informāciju), nekļūs neatbalstīts standarta kļūdas izvades gadījumā. ::: Atgrieztā vērtība ir ierobežota līdz 16 MB (ieskaitot beigu atstarpes, kas tiek saīsinātas); tiek piemēroti arī [datubāzes ierobežojumi](/manual/config/items/item#text-data-limits). Ja pieprasītais skripts netiek atrasts vai Zabbix serverim/starpniekserverim nav atļauju to izpildīt, vienums kļūs neatbalstīts un tiks parādīts atbilstošs kļūdas ziņojums. Noildzes gadījumā vienums kļūs neatbalstīts, tiks parādīts atbilstošs kļūdas ziņojums, un skriptam izveidotais process tiks pārtraukts. ##### External checks An [external check](/manual/config/items/itemtypes/external) is an item for executing checks by running an executable, for example, a [shell script](/manual/appendix/command_execution) or a binary. External checks are executed by Zabbix server or proxy (when host is monitored by proxy), and do not require an agent running on the host being monitored. ##### Ārējās pārbaudes [Ārējā pārbaude](/manual/config/items/itemtypes/external) ir vienums, kas paredzēts pārbaužu izpildei, palaižot izpildāmu failu, piemēram, [čaulas skriptu](/manual/appendix/command_execution) vai bināro failu. Ārējās pārbaudes izpilda Zabbix serveris vai starpniekserveris (ja hosts tiek uzraudzīts ar starpniekserveri), un tām nav nepieciešams aģents, kas darbojas uz uzraugāmā hosta. ##### ExternalScripts The location of external scripts (depends on the `datadir` compile-time installation variable). Default: `/usr/local/share/zabbix/externalscripts` ##### Ārējie skripti Ārējo skriptu atrašanās vieta (atkarīga no `datadir` kompilēšanas laikā iestatītā instalācijas mainīgā). Noklusējums: `/usr/local/share/zabbix/externalscripts` ##### ExternalScripts The location of external scripts (depends on the `datadir` compile-time installation variable). Default: `/usr/local/share/zabbix/externalscripts` ##### Ārējie skripti Ārējo skriptu atrašanās vieta (atkarīga no kompilēšanas laikā iestatītā instalācijas mainīgā `datadir`). Noklusējums: `/usr/local/share/zabbix/externalscripts` #### Extracting matching part of regular expression Sometimes we may want to extract only the interesting value from a target file instead of returning the whole line when a regular expression match is found. Log items have the ability to extract desired values from matched lines. This is accomplished by the additional **output** parameter in `log` and `logrt` items. Using the 'output' parameter allows to indicate the "capturing group" of the match that we may be interested in. So, for example: ```default log[/path/to/the/file,"large result buffer allocation.*Entries: ([0-9]+)",,,,\1] ``` should allow returning the entry count as found in the content of: ```default Fr Feb 07 2014 11:07:36.6690 */ Thread Id 1400 (GLEWF) large result buffer allocation - /Length: 437136/Entries: 5948/Client Ver: >=10/RPC ID: 41726453/User: AUser/Form: CFG:ServiceLevelAgreement ``` Only the number will be returned because `\1` refers to the first and only capturing group: `([0-9]+)`. And, with the ability to extract and return a number, the value can be used to define triggers. #### Regulārās izteiksmes atbilstošās daļas izvilkšana Dažkārt mēs varam vēlēties no mērķa faila izvilkt tikai interesējošo vērtību, nevis atgriezt visu rindu, kad tiek atrasta regulārās izteiksmes atbilstība. Log vienumiem ir iespēja izvilkt vajadzīgās vērtības no atbilstošajām rindām. Tas tiek panākts, izmantojot papildu **output** parametru `log` un `logrt` vienumos. Izmantojot parametru 'output', var norādīt atbilstības "uztveršanas grupu", kas mūs var interesēt. Piemēram: ```default log[/path/to/the/file,"large result buffer allocation.*Entries: ([0-9]+)",,,,\1] ``` tam vajadzētu ļaut atgriezt ierakstu skaitu, kas atrodams šādā saturā: ```default Fr Feb 07 2014 11:07:36.6690 */ Thread Id 1400 (GLEWF) large result buffer allocation - /Length: 437136/Entries: 5948/Client Ver: >=10/RPC ID: 41726453/User: AUser/Form: CFG:ServiceLevelAgreement ``` Tiks atgriezts tikai skaitlis, jo `\1` attiecas uz pirmo un vienīgo uztveršanas grupu: `([0-9]+)`. Un, pateicoties iespējai izvilkt un atgriezt skaitli, šo vērtību var izmantot trigeru definēšanai. ##### Failover to old protocol To make sure that Zabbix server or proxy can work with agents from pre-7.0 versions, which have plaintext protocol, a failover to the old protocol is implemented. Passive checks are performed using the JSON protocol (7.0 and later) after restart or when the interface configuration is changed. If no valid JSON is received in response (agent sent "ZBX_NOTSUPPORTED"), Zabbix will cache the interface as old protocol and **retry** the check by sending only the item key. Note that every hour Zabbix server/proxy will again try working with the new protocol with all interfaces, falling back to the old protocol if required. ##### Pārslēgšanās uz veco protokolu Lai nodrošinātu, ka Zabbix serveris vai starpniekserveris var strādāt ar aģentiem no versijām pirms 7.0, kuri izmanto vienkāršteksta protokolu, ir ieviesta pārslēgšanās uz veco protokolu. Pasīvās pārbaudes pēc restartēšanas vai, kad tiek mainīta interfeisa konfigurācija, tiek veiktas, izmantojot JSON protokolu (7.0 un jaunākas versijas). Ja atbildē netiek saņemts derīgs JSON (aģents nosūtīja "ZBX_NOTSUPPORTED"), Zabbix kešos saglabās interfeisu kā vecā protokola interfeisu un **atkārtos** pārbaudi, nosūtot tikai vienuma atslēgu. Ņemiet vērā, ka katru stundu Zabbix serveris/starpniekserveris atkal mēģinās strādāt ar jauno protokolu ar visiem interfeisiem, vajadzības gadījumā atgriežoties pie vecā protokola. ### Failover to standby node Zabbix will fail over to another node automatically if the active node stops. There must be at least one node in standby status for the failover to happen. How fast will the failover be? All nodes update their last access time (and status, if it is changed) every 5 seconds. So: - If the active node shuts down and manages to report its status as "stopped", another node will take over within **5 seconds**. - If the active node shuts down/becomes unavailable without being able to update its status, standby nodes will wait for the **failover delay** + 5 seconds to take over. The failover delay is configurable, with the supported range between 10 seconds and 15 minutes (one minute by default). To change the failover delay, you may run: ``` zabbix_server -R ha_set_failover_delay=5m ``` ### Pārslēgšanās uz gaidstāves mezglu Zabbix automātiski pārslēgsies uz citu mezglu, ja aktīvais mezgls pārtrauks darbību. Lai pārslēgšanās notiktu, vismaz vienam mezglam jābūt gaidstāves statusā. Cik ātra būs pārslēgšanās? Visi mezgli ik pēc 5 sekundēm atjaunina savu pēdējās piekļuves laiku (un statusu, ja tas ir mainījies). Tātad: - Ja aktīvais mezgls tiek izslēgts un paspēj paziņot savu statusu kā "apturēts", cits mezgls pārņems vadību 5 sekunžu laikā. - Ja aktīvais mezgls tiek izslēgts/kļūst nepieejams, nespējot atjaunināt savu statusu, gaidstāves mezgli gaidīs **pārslēgšanās aizkavi** + 5 sekundes, lai pārņemtu vadību. Pārslēgšanās aizkave ir konfigurējama, atbalstītais diapazons ir no 10 sekundēm līdz 15 minūtēm (pēc noklusējuma viena minūte). Lai mainītu pārslēgšanās aizkavi, varat palaist: ``` zabbix_server -R ha_set_failover_delay=5m ``` #### Faster permission checks Permission checks have been made much faster by introducing several intermediary tables for checking non-privileged user permissions. These tables keep hashes (SHA-256) of user group sets and host group sets for each user/host respectively. Additionally, there is a permission table storing only the accessible combinations of users and hosts, specified by the hash IDs. This improvement makes the loading of permission-heavy frontend pages (i.e. hosts, problems) much faster. Note that hashes and permissions are not calculated for Super-admin users. #### Ātrākas atļauju pārbaudes Atļauju pārbaudes ir kļuvušas daudz ātrākas, ieviešot vairākas starptabulas nepriviliģētu lietotāju atļauju pārbaudei. Šīs tabulas katram lietotājam/hostam attiecīgi glabā lietotāju grupu kopu un hostu grupu kopu jaucējvērtības (SHA-256). Papildus tam ir atļauju tabula, kurā tiek glabātas tikai pieejamās lietotāju un hostu kombinācijas, kas norādītas ar jaucējvērtību ID. Šis uzlabojums padara atļaujām intensīvu lietotāja saskarne lapu ielādi (t. i., hosts, problēmas) daudz ātrāku. Ņemiet vērā, ka Super-admin lietotājiem jaucējvērtības un atļaujas netiek aprēķinātas. #### Faster reaction to host maintenance period update Previously maintenances were recalculated only every minute causing a possible latency of up to 60 seconds for starting or stopping a maintenance period. Now maintenances are still recalculated every minute or as soon as the configuration cache is reloaded if there are changes to the maintenance period. Every second the timer process checks if any maintenances must be started/stopped based on whether there are changes to the [maintenance periods](/manual/maintenance#maintenance-periods) after the configuration update. Thus the speed of starting/stopping maintenance periods depends on the configuration [update interval](/manual/appendix/config/zabbix_server#cacheupdatefrequency) (10 seconds by default). Note that maintenance period changes do not include *Active since/Active till* settings. Also, if a host/host group is added to an existing active maintenance period, the changes will only be activated by the timer process at the start of next minute. #### Ātrāka reakcija uz hosta uzturēšanas perioda atjauninājumu Iepriekš uzturēšanas periodi tika pārrēķināti tikai reizi minūtē, kas varēja radīt līdz pat 60 sekunžu aizkavi uzturēšanas perioda sākšanai vai apturēšanai. Tagad uzturēšanas periodi joprojām tiek pārrēķināti reizi minūtē vai uzreiz pēc konfigurācijas kešatmiņas pārlādes, ja ir izmaiņas uzturēšanas periodā. Katru sekundi taimera process pārbauda, vai kādi uzturēšanas periodi ir jāsāk/jāaptur, pamatojoties uz to, vai pēc konfigurācijas atjaunināšanas ir izmaiņas [uzturēšanas periodos](/manual/maintenance#maintenance-periods). Tādējādi uzturēšanas periodu sākšanas/apturēšanas ātrums ir atkarīgs no konfigurācijas [atjaunināšanas intervāla](/manual/appendix/config/zabbix_server#cacheupdatefrequency) (pēc noklusējuma 10 sekundes). Ņemiet vērā, ka uzturēšanas perioda izmaiņas neietver iestatījumus *Active since/Active till*. Tāpat, ja esošam aktīvam uzturēšanas periodam tiek pievienots hosts/hostu grupa, izmaiņas tiks aktivizētas tikai ar taimera procesu nākamās minūtes sākumā. #### Faster trigger action execution [Trigger action](/manual/config/notifications/action) operation, recovery operation and update operation execution on Zabbix server now occurs immediately (less than 100 milliseconds) after a trigger status change, whereas previously users could experience up to 4 seconds of latency. The reduction in latency is made possible by implementing interprocess communication (IPC) mechanisms between multiple [processes](/manual/concepts/server#server-process-types-and-threads) (escalator and its escalation‐dispatch module, escalator and alerter, preprocessing manager and history syncer). #### Ātrāka trigeris darbību izpilde [Trigeris darbība](/manual/config/notifications/action) operācijas, atjaunošanas operācijas un atjaunināšanas operācijas izpilde serveris tagad notiek nekavējoties (mazāk nekā 100 milisekundēs) pēc trigeris statusa maiņas, savukārt iepriekš lietotāji varēja saskarties ar aizkavi līdz pat 4 sekundēm. Aizkaves samazinājumu nodrošina starpprocesu komunikācijas (IPC) mehānismu ieviešana starp vairākiem [procesiem](/manual/concepts/server#server-process-types-and-threads) (escalator un tā escalation-dispatch moduli, escalator un alerter, preprocessing manager un history syncer). #### Feature differences #### Funkciju atšķirības ##### Field order and formatting Zabbix follows the recommendations of [RFC 4514](http://tools.ietf.org/html/rfc4514), which specifies a "reverse" order for these fields, starting with the lowest-level fields (`CN`), proceeding to the mid-level fields (`OU`, `O`), and concluding with the highest-level fields (`DC`). ```ini TLSServerCertIssuer=CN=Signing CA,OU=Development group,O=Zabbix SIA,DC=zabbix,DC=com TLSServerCertSubject=CN=Zabbix proxy,OU=Development group,O=Zabbix SIA,DC=zabbix,DC=com ``` In contrast, OpenSSL by default displays the `Issuer` and `Subject` strings in top-level to low-level order. In the following example, `Issuer` and `Subject` fields start with the top-level (`DC`) and end with the low-level (`CN`) field. The formatting with spaces and field separators also varies based on the options used, and thus will not match the format required by Zabbix. ```bash $ openssl x509 -noout -in /home/zabbix/zabbix_proxy.crt -issuer -subject issuer= /DC=com/DC=zabbix/O=Zabbix SIA/OU=Development group/CN=Signing CA subject= /DC=com/DC=zabbix/O=Zabbix SIA/OU=Development group/CN=Zabbix proxy $ openssl x509 -noout -text -in /home/zabbix/zabbix_proxy.crt Certificate: ... Issuer: DC=com, DC=zabbix, O=Zabbix SIA, OU=Development group, CN=Signing CA ... Subject: DC=com, DC=zabbix, O=Zabbix SIA, OU=Development group, CN=Zabbix proxy ``` To format *Issuer* and *Subject* strings correctly for Zabbix, invoke OpenSSL with the following options: ```bash $ openssl x509 -noout -issuer -subject \ -nameopt esc_2253,esc_ctrl,utf8,dump_nostr,dump_unknown,dump_der,sep_comma_plus,dn_rev,sname\ -in /home/zabbix/zabbix_proxy.crt ``` The output will then be in reverse order, comma-separated, and usable in Zabbix configuration files and frontend: ```bash issuer=CN=Signing CA,OU=Development group,O=Zabbix SIA,DC=zabbix,DC=com subject=CN=Zabbix proxy,OU=Development group,O=Zabbix SIA,DC=zabbix,DC=com ``` ##### Lauku secība un formatējums Zabbix ievēro [RFC 4514](http://tools.ietf.org/html/rfc4514) ieteikumus, kas nosaka šo lauku "apgriezto" secību, sākot ar zemākā līmeņa laukiem (`CN`), turpinot ar vidējā līmeņa laukiem (`OU`, `O`) un noslēdzot ar augstākā līmeņa laukiem (`DC`). ```ini TLSServerCertIssuer=CN=Signing CA,OU=Development group,O=Zabbix SIA,DC=zabbix,DC=com TLSServerCertSubject=CN=Zabbix proxy,OU=Development group,O=Zabbix SIA,DC=zabbix,DC=com ``` Savukārt OpenSSL pēc noklusējuma attēlo `Issuer` un `Subject` virknes no augstākā līmeņa uz zemāko līmeni. Tālākajā piemērā `Issuer` un `Subject` lauki sākas ar augstākā līmeņa (`DC`) un beidzas ar zemākā līmeņa (`CN`) lauku. Atstarpju un lauku atdalītāju formatējums arī atšķiras atkarībā no izmantotajām opcijām, tāpēc tas neatbildīs Zabbix prasītajam formātam. ```bash $ openssl x509 -noout -in /home/zabbix/zabbix_proxy.crt -issuer -subject issuer= /DC=com/DC=zabbix/O=Zabbix SIA/OU=Development group/CN=Signing CA subject= /DC=com/DC=zabbix/O=Zabbix SIA/OU=Development group/CN=Zabbix proxy $ openssl x509 -noout -text -in /home/zabbix/zabbix_proxy.crt Certificate: ... Issuer: DC=com, DC=zabbix, O=Zabbix SIA, OU=Development group, CN=Signing CA ... Subject: DC=com, DC=zabbix, O=Zabbix SIA, OU=Development group, CN=Zabbix proxy ``` Lai pareizi noformētu *Issuer* un *Subject* virknes Zabbix vajadzībām, izsauciet OpenSSL ar šādām opcijām: ```bash $ openssl x509 -noout -issuer -subject \ -nameopt esc_2253,esc_ctrl,utf8,dump_nostr,dump_unknown,dump_der,sep_comma_plus,dn_rev,sname\ -in /home/zabbix/zabbix_proxy.crt ``` Tad izvade būs apgrieztā secībā, atdalīta ar komatiem un izmantojama Zabbix konfigurācijas failos un lietotāja saskarne: ```bash issuer=CN=Signing CA,OU=Development group,O=Zabbix SIA,DC=zabbix,DC=com subject=CN=Zabbix proxy,OU=Development group,O=Zabbix SIA,DC=zabbix,DC=com ``` ##### File locations - Configuration files are located in **/etc/zabbix**. - Zabbix server, proxy and agent logfiles are located in **/var/log/zabbix**. - Zabbix frontend is located in **/usr/share/zabbix**. - Home directory for the user **zabbix** is **/var/lib/zabbix**. ##### Failu atrašanās vietas - Konfigurācijas faili atrodas **/etc/zabbix**. - Zabbix servera, starpniekservera un aģenta žurnālfaili atrodas **/var/log/zabbix**. - Zabbix lietotāja saskarne atrodas **/usr/share/zabbix**. - Lietotāja **zabbix** mājas direktorija ir **/var/lib/zabbix**. ## FILES */usr/local/etc/zabbix\_agent2.conf* Default location of Zabbix agent 2 configuration file (if not modified during compile time). [ ]{#lbAH} ## FAILI */usr/local/etc/zabbix\_agent2.conf* Zabbix aģenta 2 konfigurācijas faila noklusējuma atrašanās vieta (ja nav izmainīta kompilēšanas laikā). [ ]{#lbAH} ##### File system Because of the trap file implementation, Zabbix needs the file system to support inodes to differentiate files (the information is acquired by a `stat()` call). ##### Failu sistēma Trap faila implementācijas dēļ Zabbix failu sistēmai ir jāatbalsta inode, lai atšķirtu failus (informācija tiek iegūta ar `stat()` izsaukumu). #### Filter A filter can be used to generate real items, triggers, and graphs only for entities that match the criteria. The **Filters** tab contains discovery rule filter definitions allowing to filter discovery values: {width="600"} |Parameter|Description| |--|--------| |*Type of calculation*|The following options for calculating filters are available:<br>**And** - all filters must be passed;<br>**Or** - enough if one filter is passed;<br>**And/Or** - uses *And* with different macro names and *Or* with the same macro name;<br>**Custom expression** - offers the possibility to define a custom calculation of filters. The formula must include all filters in the list. Limited to 255 symbols.| |*Filters*|The following filter condition operators are available: *matches*, *does not match*, *exists*, *does not exist*.<br>*Matches* and *does not match* operators expect a [Perl Compatible Regular Expression](https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions) (PCRE).<br>You can enter a regular expression or reference a global [regular expression](/manual/regular_expressions) in the *Regular expression* field.<br><br>*Exists* and *does not exist* operators allow to filter entities based on the presence or absence of the specified LLD macro in the response.<br>Note that if a macro from the filter is missing in the response, the found entity will be ignored, unless a "does not exist" condition is specified for this macro.<br><br>A warning will be displayed, if the absence of a macro affects the expression result. For example, if `{#B}` is missing in:<br>`{#A}` matches 1 and `{#B}` matches 2 - will give a warning<br>`{#A}` matches 1 or `{#B}` matches 2 - no warning.| For example, if you are only interested in the C:, D:, and E: file systems, you can put `{#FSNAME}` into the *Macro* field and `^C|^D|^E` into the *Regular expression* field.<br> Filtering is also possible by file system types using the `{#FSTYPE}` macro (e.g. `^ext|^reiserfs`) and by drive types (supported only by Windows agent) using the `{#FSDRIVETYPE}` macro (e.g., `fixed`). In order to test a regular expression you can use `grep -E`, for example: ```` for f in ext2 nfs reiserfs smbfs; do echo $f | grep -E '^ext|^reiserfs' || echo "SKIP: $f"; done ```` ::: notewarning A mistake or a typo in the regular expression used in the LLD rule (for example, an incorrect "File systems for discovery" regular expression) may cause deletion of thousands of configuration elements, historical values, and events for many hosts. ::: ::: noteimportant Zabbix database in MySQL must be created as case-sensitive if file system names that differ only by case are to be discovered correctly. ::: #### Filtrs Filtru var izmantot, lai ģenerētu reālus vienumus, trigerus un grafikus tikai tiem objektiem, kas atbilst kritērijiem. Cilne **Filtri** satur atklāšanas noteikuma filtru definīcijas, kas ļauj filtrēt atklāšanas vērtības: {width="600"} |Parametrs|Apraksts| |--|--------| |*Aprēķina veids*|Filtru aprēķināšanai ir pieejamas šādas opcijas:<br>**And** - visiem filtriem jābūt izpildītiem;<br>**Or** - pietiek, ja ir izpildīts viens filtrs;<br>**And/Or** - izmanto *And* ar dažādiem makro nosaukumiem un *Or* ar vienu un to pašu makro nosaukumu;<br>**Pielāgota izteiksme** - piedāvā iespēju definēt pielāgotu filtru aprēķinu. Formulā jāiekļauj visi filtri sarakstā. Ierobežots līdz 255 simboliem.| |*Filtri*|Pieejami šādi filtra nosacījumu operatori: *matches*, *does not match*, *exists*, *does not exist*.<br>Operatori *matches* un *does not match* sagaida [Perl Compatible Regular Expression](https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions) (PCRE).<br>Laukā *Regular expression* var ievadīt regulāro izteiksmi vai norādīt globālu [regular expression](/manual/regular_expressions).<br><br>Operatori *exists* un *does not exist* ļauj filtrēt objektus, pamatojoties uz norādītā LLD makro esamību vai neesamību atbildē.<br>Ņemiet vērā, ka, ja atbildē trūkst makro no filtra, atrastais objekts tiks ignorēts, ja vien šim makro nav norādīts nosacījums "does not exist".<br><br>Tiks parādīts brīdinājums, ja makro neesamība ietekmē izteiksmes rezultātu. Piemēram, ja `{#B}` trūkst šādā izteiksmē:<br>`{#A}` matches 1 and `{#B}` matches 2 - tiks parādīts brīdinājums<br>`{#A}` matches 1 or `{#B}` matches 2 - brīdinājums netiks parādīts.| Piemēram, ja jūs interesē tikai C:, D: un E: failu sistēmas, laukā *Macro* varat ievietot `{#FSNAME}`, bet laukā *Regular expression* - `^C|^D|^E`.<br> Filtrēšana ir iespējama arī pēc failu sistēmu tipiem, izmantojot makro `{#FSTYPE}` (piem., `^ext|^reiserfs`), un pēc disku tipiem (atbalstīts tikai Windows aģents), izmantojot makro `{#FSDRIVETYPE}` (piem., `fixed`). Lai pārbaudītu regulāro izteiksmi, varat izmantot `grep -E`, piemēram: ```` for f in ext2 nfs reiserfs smbfs; do echo $f | grep -E '^ext|^reiserfs' || echo "SKIP: $f"; done ```` ::: notewarning Kļūda vai drukas kļūda regulārajā izteiksmē, kas izmantota LLD noteikumā (piemēram, nepareiza regulārā izteiksme "File systems for discovery"), var izraisīt tūkstošiem konfigurācijas elementu, vēsturisko vērtību un notikumu dzēšanu daudziem hosts. ::: ::: noteimportant Zabbix datubāze MySQL ir jāizveido ar reģistrjutību, ja failu sistēmu nosaukumi, kas atšķiras tikai pēc reģistra, ir jāatklāj pareizi. ::: #### Filter audit log by IP The IP option has been added to the [audit log](/manual/web_interface/frontend_sections/reports/audit_log) filter. You may now filter the audit log by the IP from which activity was initiated. Additionally, IPs in the list are now clickable. Clicking on the hyperlink will filter records by the respective IP. #### Filtrēt audita žurnālu pēc IP IP opcija ir pievienota [audita žurnāla](/manual/web_interface/frontend_sections/reports/audit_log) filtram. Tagad varat filtrēt audita žurnālu pēc IP, no kuras tika uzsākta darbība. Turklāt IP adreses sarakstā tagad ir klikšķināmas. Noklikšķinot uz hipersaites, ieraksti tiks filtrēti pēc attiecīgās IP adreses. ##### Filter buttons | | | |--|--------| ||Apply specified filtering criteria (without saving).| ||Reset current filter and return to saved parameters of the current tab. On the main tab, this will clear the filter.| ||Save current filter parameters in a new tab. Only available on the main tab.| ||Replace tab parameters with currently specified parameters. Not available on the main tab.| ##### Filtra pogas | | | |--|--------| ||Piemērot norādītos filtrēšanas kritērijus (nesaglabājot).| ||Atiestatīt pašreizējo filtru un atgriezties pie pašreizējās cilnes saglabātajiem parametriem. Galvenajā cilnē tas notīrīs filtru.| ||Saglabāt pašreizējos filtra parametrus jaunā cilnē. Pieejams tikai galvenajā cilnē.| ||Aizstāt cilnes parametrus ar pašlaik norādītajiem parametriem. Nav pieejams galvenajā cilnē.| #### Filter expression The filter expression is an arithmetical expression in infix notation. Supported operands: |Operand|Description| |---|-------| |`"<text>"`<br>`'<text>'`|Text constant.<br><br>Example:<br>`'value: \\'1\\''`<br>`"value: '1'"`| |`<number>`|Numeric constant supporting scientific notation.<br><br>Example: `123`| |`<jsonpath starting with $>`|Value referred to by the JSONPath from the input document root node; only definite paths are supported.<br><br>Example: `$.object.name`| |`<jsonpath starting with @>`|Value referred to by the JSONPath from the current object/element; only definite paths are supported.<br><br>Example: `@.name`| Supported operators: |Operator|Type|Description|Result| |-|---|---|---| |`-`|Binary|Subtraction|Number| |`+`|Binary|Addition|Number| |`/`|Binary|Division|Number| |`*`|Binary|Multiplication|Number| |`==`|Binary|Equality|Boolean (1/0)| |`!=`|Binary|Inequality|Boolean (1/0)| |`<`|Binary|Less than|Boolean (1/0)| |`<=`|Binary|Less than or equal to|Boolean (1/0)| |`>`|Binary|Greater than|Boolean (1/0)| |`>=`|Binary|Greater than or equal to|Boolean (1/0)| |`=~`|Binary|Matches regular expression|Boolean (1/0)| |`!`|Unary|Boolean NOT|Boolean (1/0)| |`||`|Binary|Boolean OR|Boolean (1/0)| |`&&`|Binary|Boolean AND|Boolean (1/0)| #### Filtra izteiksme Filtra izteiksme ir aritmētiska izteiksme infiksa pierakstā. Atbalstītie operandi: |Operands|Apraksts| |---|-------| |`"<text>"`<br>`'<text>'`|Teksta konstante.<br><br>Piemērs:<br>`'value: \\'1\\''`<br>`"value: '1'"`| |`<number>`|Skaitliska konstante ar zinātniskā pieraksta atbalstu.<br><br>Piemērs: `123`| |`<jsonpath starting with $>`|Vērtība, uz kuru norāda JSONPath no ievades dokumenta saknes mezgla; tiek atbalstīti tikai noteiktie ceļi.<br><br>Piemērs: `$.object.name`| |`<jsonpath starting with @>`|Vērtība, uz kuru norāda JSONPath no pašreizējā objekta/elementa; tiek atbalstīti tikai noteiktie ceļi.<br><br>Piemērs: `@.name`| Atbalstītie operatori: |Operators|Tips|Apraksts|Rezultāts| |-|---|---|---| |`-`|Binārs|Atņemšana|Skaitlis| |`+`|Binārs|Saskaitīšana|Skaitlis| |`/`|Binārs|Dalīšana|Skaitlis| |`*`|Binārs|Reizināšana|Skaitlis| |`==`|Binārs|Vienādība|Būla vērtība (1/0)| |`!=`|Binārs|Nevienādība|Būla vērtība (1/0)| |`<`|Binārs|Mazāks par|Būla vērtība (1/0)| |`<=`|Binārs|Mazāks par vai vienāds ar|Būla vērtība (1/0)| |`>`|Binārs|Lielāks par|Būla vērtība (1/0)| |`>=`|Binārs|Lielāks par vai vienāds ar|Būla vērtība (1/0)| |`=~`|Binārs|Atbilst regulārajai izteiksmei|Būla vērtība (1/0)| |`!`|Unārs|Būla NOT|Būla vērtība (1/0)| |`||`|Binārs|Būla OR|Būla vērtība (1/0)| |`&&`|Binārs|Būla AND|Būla vērtība (1/0)| ##### Filtering by host In the *By host* mode results can be filtered by a host or by the host group. Specifying a parent host group implicitly selects all nested host groups. ##### Filtrēšana pēc hosta Režīmā *Pēc hosta* rezultātus var filtrēt pēc hosta vai hostu grupas. Norādot vecāko hostu grupu, netieši tiek atlasītas visas ligzdotās hostu grupas. ##### Filtering by trigger template In the *By trigger template* mode results can be filtered by one or several parameters listed below. |Parameter|Description| |--|--------| |*Template group*|Filter hosts by triggers that are inherited from templates belonging to the selected template group.| |*Template*|Filter hosts by triggers that are inherited from the selected template, including nested templates.<br>If a nested template has its own triggers, those triggers will not be displayed.| |*Template trigger*|Filter hosts by the selected trigger. Other triggers of the filtered hosts will not be displayed.| |*Host group*|Filter hosts belonging to the selected host group.| ##### Filtrēšana pēc trigeru veidnes Režīmā *Pēc trigeru veidnes* rezultātus var filtrēt pēc viena vai vairākiem tālāk norādītajiem parametriem. |Parameter|Description| |--|--------| |*Template group*|Filtrēt hosts pēc trigeriem, kas ir mantoti no veidnēm, kuras pieder atlasītajai veidņu grupai.| |*Template*|Filtrēt hosts pēc trigeriem, kas ir mantoti no atlasītās veidnes, tostarp ligzdotajām veidnēm.<br>Ja ligzdotajai veidnei ir savi trigeri, šie trigeri netiks parādīti.| |*Template trigger*|Filtrēt hosts pēc atlasītā trigeris. Citi filtrēto hostu trigeri netiks parādīti.| |*Host group*|Filtrēt hosts, kas pieder atlasītajai hostu grupai.| ##### Filtering options You may limit the problem trigger information in SNMP gateway configuration: - by severity (by default `ProblemMinSeverity=-1`) - by hiding acknowledged problems (by default `ProblemHideAck=false`) You may limit the problem count per host group in SNMP gateway configuration: - by unknown state triggers (by default `CountUnknown=false`) - by triggers with acknowledged/unacknowledged/all problems (by default `CountAcknowledgeStatus=all`) ##### Filtrēšanas opcijas SNMP gateway konfigurācijā varat ierobežot problēmu trigeru informāciju: - pēc nopietnības (pēc noklusējuma `ProblemMinSeverity=-1`) - slēpjot apstiprinātās problēmas (pēc noklusējuma `ProblemHideAck=false`) SNMP gateway konfigurācijā varat ierobežot problēmu skaitu katrai hostu grupai: - pēc nezināma stāvokļa trigeriem (pēc noklusējuma `CountUnknown=false`) - pēc trigeriem ar apstiprinātām/neapstiprinātām/visām problēmām (pēc noklusējuma `CountAcknowledgeStatus=all`) #### Filtering VMware event log records This example uses the [Matches regular expression](/manual/config/items/preprocessing#matchesregexp) preprocessing step to filter unnecessary events from the VMware event log. 1\. On a working VMware Hypervisor host, check that the [vmware.eventlog](/manual/vm_monitoring/vmware_keys#vmware.eventlog) item is present and working properly. Note that the event log item could already be present on the hypervisor if a [VMware](/manual/config/templates_out_of_the_box/vmware) template has been linked during the host creation. 2\. On the VMware Hypervisor host, create a [dependent item](/manual/config/items/itemtypes/dependent_items) of *Log* type and set the event log item as its master item. 3\. In the *Preprocessing* tab of the dependent item, click *Add* to create a preprocessing step and select *Matches regular expression* from the drop-down. Then, specify one of the following patterns: - For filtering all log events: ```bash .* logged in .* ``` - For filtering lines containing usernames after "User": ```bash \bUser\s+\K\S+ ``` ::: noteimportant If the regular expression is not matched, then the dependent item becomes unsupported with a corresponding error message. To avoid this, mark the *Custom on fail* checkbox and select an option such as discarding the value or setting a custom one. Please note that [discarded](/manual/config/items/preprocessing#discardunchanged) values are not stored in the database; as a result, triggers are not evaluated and trend data is not generated. ::: Alternatively, you may use the [Regular expression](/manual/config/items/preprocessing#regexp) preprocessing step to extract matching groups and control output: - For extracting and outputting the entire log event containing "logged in", specify the following parameters: ```bash Pattern: .*logged in.* Output: \0 ``` - For extracting and outputting usernames following "User": ```bash Pattern: User (.*?)(?=\ ) Output: \1 ``` #### VMware notikumu žurnāla ierakstu filtrēšana Šajā piemērā tiek izmantots priekšapstrādes solis [Atbilst regulārajai izteiksmei](/manual/config/items/preprocessing#matchesregexp), lai no VMware notikumu žurnāla atfiltrētu nevajadzīgos notikumus. 1\. Darbojošā VMware Hypervisor hostā pārbaudiet, ka vienums [vmware.eventlog](/manual/vm_monitoring/vmware_keys#vmware.eventlog) ir pieejams un darbojas pareizi. Ņemiet vērā, ka notikumu žurnāla vienums hipervizorā jau var būt pieejams, ja hosta izveides laikā tika piesaistīta veidne [VMware](/manual/config/templates_out_of_the_box/vmware). 2\. VMware Hypervisor hostā izveidojiet [atkarīgo vienumu](/manual/config/items/itemtypes/dependent_items) ar tipu *Log* un iestatiet notikumu žurnāla vienumu kā tā galveno vienumu. 3\. Atkarīgā vienuma cilnē *Preprocessing* noklikšķiniet uz *Add*, lai izveidotu priekšapstrādes soli, un nolaižamajā sarakstā atlasiet *Matches regular expression*. Pēc tam norādiet vienu no šiem paraugiem: - Lai filtrētu visus žurnāla notikumus: ```bash .* logged in .* ``` - Lai filtrētu rindas, kurās pēc "User" ir lietotājvārdi: ```bash \bUser\s+\K\S+ ``` ::: noteimportant Ja regulārā izteiksme neatbilst, atkarīgais vienums kļūst neatbalstīts un tiek parādīts atbilstošs kļūdas ziņojums. Lai no tā izvairītos, atzīmējiet izvēles rūtiņu *Custom on fail* un atlasiet opciju, piemēram, vērtības atmešanu vai pielāgotas vērtības iestatīšanu. Ņemiet vērā, ka [atmestās](/manual/config/items/preprocessing#discardunchanged) vērtības datubāzē netiek saglabātas; tādēļ trigeri netiek novērtēti un tendenču dati netiek ģenerēti. ::: Alternatīvi varat izmantot priekšapstrādes soli [Regular expression](/manual/config/items/preprocessing#regexp), lai izvilktu atbilstošās grupas un kontrolētu izvadi: - Lai izvilktu un izvadītu visu žurnāla notikumu, kas satur "logged in", norādiet šādus parametrus: ```bash Pattern: .*logged in.* Output: \0 ``` - Lai izvilktu un izvadītu lietotājvārdus pēc "User": ```bash Pattern: User (.*?)(?=\ ) Output: \1 ``` #### Filter media type usage in actions The *Display actions* option has been added to the [media types](/manual/web_interface/frontend_sections/alerts/mediatypes#using-filter) filter. You may now use the filter to display actions in the *Used in actions* column based on the scope of their media type usage (defined by the *Send to media type* parameter in action [operation details](/manual/config/notifications/action/operation#operation-details)). Additionally, the action [operation details](/manual/config/notifications/action/operation#operation-details) parameter *Send only to* has been renamed to *Send to media type*, and its option *All* has been renamed to *All available*. #### Filtrēt mediju tipa izmantošanu darbībās Filtram [mediju tipi](/manual/web_interface/frontend_sections/alerts/mediatypes#using-filter) ir pievienota opcija *Rādīt darbības*. Tagad varat izmantot filtru, lai kolonnā *Izmantots darbībās* rādītu darbības atbilstoši to mediju tipa izmantošanas tvērumam (noteiktam ar parametru *Sūtīt uz mediju tipu* darbības [operācijas detaļās](/manual/config/notifications/action/operation#operation-details)). Turklāt darbības [operācijas detaļu](/manual/config/notifications/action/operation#operation-details) parametrs *Sūtīt tikai uz* ir pārdēvēts par *Sūtīt uz mediju tipu*, un tā opcija *Visi* ir pārdēvēta par *Visi pieejamie*. ##### find(/host/key,(sec|#num)<:time shift>,<operator>,<pattern>) {#find} Find a value match within the defined evaluation period.<br> Supported value types: *Float*, *Integer*, *String*, *Text*, *Log*.<br> Returns: 1 - found; 0 - otherwise. Parameters: - See [common parameters](#common-parameters)<br> - **sec** or **#num** (optional) - defaults to the latest value if not specified - **operator** (must be double-quoted) Supported `operators`:<br>*eq* - equal (default for integer, float)<br>*ne* - not equal<br>*gt* - greater<br>*ge* - greater or equal<br>*lt* - less<br>*le* - less or equal<br>*like* (default for string, text, log) - matches if contains the string given in `pattern` (case-sensitive)<br>*bitand* - bitwise AND<br>*regexp* - case-sensitive match of the regular expression given in `pattern`<br>*iregexp* - case-insensitive match of the regular expression given in `pattern`<br> - **pattern** - the required pattern (string arguments must be double-quoted); [Perl Compatible Regular Expression](https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions) (PCRE) regular expression if `operator` is *regexp*, *iregexp* Comments: - If more than one value is processed, '1' is returned if there is at least one matching value. - *like* is not supported as operator for integer values. - *like* and *bitand* are not supported as operators for float values. - For string, text, and log values only *eq*, *ne*, *like*, *regexp* and *iregexp* operators are supported. - With *regexp* or *iregexp* as operator, the fourth `pattern` parameter can be an ordinary or [global](/manual/regular_expressions#global-regular-expressions) (starting with '@') regular expression. In case of global regular expressions case sensitivity is inherited from the global regular expression settings. Examples: ```default find(/host/key,10m,"like","error") #find a value that contains 'error' within the last 10 minutes until now find(/host/agent.version,,"like","beta")=1 #Zabbix agent has beta version, must be upgraded find(/host/log[/var/log/nginx/access.log],,"regexp"," 500 ")=1 #internal web server error has been found ``` ##### find(/host/key,(sec|#num)<:time shift>,<operator>,<pattern>) {#find} Atrod vērtības atbilstību definētajā novērtēšanas periodā.<br> Atbalstītie vērtību tipi: *Float*, *Integer*, *String*, *Text*, *Log*.<br> Atgriež: 1 - atrasts; 0 - pretējā gadījumā. Parametri: - Skatiet [kopīgos parametrus](#common-parameters)<br> - **sec** vai **#num** (neobligāts) - pēc noklusējuma tiek izmantota jaunākā vērtība, ja nav norādīts - **operator** (jābūt dubultpēdiņās) Atbalstītie `operatori`:<br>*eq* - vienāds (noklusējums integer, float)<br>*ne* - nav vienāds<br>*gt* - lielāks<br>*ge* - lielāks vai vienāds<br>*lt* - mazāks<br>*le* - mazāks vai vienāds<br>*like* (noklusējums string, text, log) - atbilst, ja satur `pattern` norādīto virkni (reģistrjutīgs)<br>*bitand* - bitu UN<br>*regexp* - reģistrjutīga atbilstība `pattern` norādītajai regulārajai izteiksmei<br>*iregexp* - reģistrnejutīga atbilstība `pattern` norādītajai regulārajai izteiksmei<br> - **pattern** - nepieciešamais raksts (virknes argumentiem jābūt dubultpēdiņās); [Perl Compatible Regular Expression](https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions) (PCRE) regulārā izteiksme, ja `operator` ir *regexp*, *iregexp* Komentāri: - Ja tiek apstrādāta vairāk nekā viena vērtība, tiek atgriezts '1', ja ir vismaz viena atbilstoša vērtība. - *like* netiek atbalstīts kā operators integer vērtībām. - *like* un *bitand* netiek atbalstīti kā operatori float vērtībām. - String, text un log vērtībām tiek atbalstīti tikai operatori *eq*, *ne*, *like*, *regexp* un *iregexp*. - Ja kā operators tiek izmantots *regexp* vai *iregexp*, ceturtais `pattern` parametrs var būt parasta vai [globāla](/manual/regular_expressions#global-regular-expressions) (sākas ar '@') regulārā izteiksme. Globālo regulāro izteiksmju gadījumā reģistrjutība tiek pārmantota no globālās regulārās izteiksmes iestatījumiem. Piemēri: ```default find(/host/key,10m,"like","error") #atrod vērtību, kas satur 'error', pēdējo 10 minūšu laikā līdz šim brīdim find(/host/agent.version,,"like","beta")=1 #Zabbix aģents izmanto beta versiju, tas ir jāatjaunina find(/host/log[/var/log/nginx/access.log],,"regexp"," 500 ")=1 #ir atrasta iekšējā tīmekļa servera kļūda ``` #### Find HTTP agent item Find HTTP agent item with post body type XML for specific host ID. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "item.get", "params": { "hostids": "10255", "filter": { "type": 19, "post_type": 3 } }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "itemid": "28252", "type": "19", "snmp_oid": "", "hostid": "10255", "name": "template item", "key_": "ti", "delay": "30s", "history": "90d", "trends": "365d", "status": "0", "value_type": "3", "trapper_hosts": "", "units": "", "logtimefmt": "", "templateid": "0", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "flags": "0", "interfaceid": "0", "description": "", "inventory_link": "0", "evaltype": "0", "jmx_endpoint": "", "master_itemid": "0", "timeout": "", "url": "localhost", "query_fields": [ { "name": "mode", "value": "xml" } ], "posts": "<body>\r\n<![CDATA[{$MACRO}<foo></bar>]]>\r\n</body>", "status_codes": "200", "follow_redirects": "0", "post_type": "3", "http_proxy": "", "headers": [], "retrieve_mode": "1", "request_method": "3", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [], "lastclock": "0", "lastns": "0", "lastvalue": "", "prevvalue": "", "name_resolved": "template item" } ], "id": 1 } ``` #### Atrast HTTP aģenta vienumu Atrast HTTP aģenta vienumu ar POST pamatteksta tipu XML konkrētam host ID. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "item.get", "params": { "hostids": "10255", "filter": { "type": 19, "post_type": 3 } }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": [ { "itemid": "28252", "type": "19", "snmp_oid": "", "hostid": "10255", "name": "template item", "key_": "ti", "delay": "30s", "history": "90d", "trends": "365d", "status": "0", "value_type": "3", "trapper_hosts": "", "units": "", "logtimefmt": "", "templateid": "0", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "flags": "0", "interfaceid": "0", "description": "", "inventory_link": "0", "evaltype": "0", "jmx_endpoint": "", "master_itemid": "0", "timeout": "", "url": "localhost", "query_fields": [ { "name": "mode", "value": "xml" } ], "posts": "<body>\r\n<![CDATA[{$MACRO}<foo></bar>]]>\r\n</body>", "status_codes": "200", "follow_redirects": "0", "post_type": "3", "http_proxy": "", "headers": [], "retrieve_mode": "1", "request_method": "3", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [], "lastclock": "0", "lastns": "0", "lastvalue": "", "prevvalue": "", "name_resolved": "template item" } ], "id": 1 } ``` #### Find HTTP agent item prototype Find HTTP agent item prototype with request method HEAD for specific host ID. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "itemprototype.get", "params": { "hostids": "10254", "filter": { "type": 19, "request_method": 3 } }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "itemid": "28257", "type": "19", "snmp_oid": "", "hostid": "10254", "name": "discovered", "key_": "item[{#INAME}]", "delay": "{#IUPDATE}", "history": "90d", "trends": "30d", "status": "0", "value_type": "3", "trapper_hosts": "", "units": "", "logtimefmt": "", "templateid": "28255", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "flags": "2", "interfaceid": "2", "description": "", "evaltype": "0", "jmx_endpoint": "", "master_itemid": "0", "timeout": "", "url": "{#IURL}", "query_fields": [], "posts": "", "status_codes": "", "follow_redirects": "0", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "3", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "discover": "0", "uuid": "", "parameters": [] } ], "id": 1 } ``` #### Atrast HTTP aģenta vienuma prototipu Atrast HTTP aģenta vienuma prototipu ar pieprasījuma metodi HEAD konkrētam hosta ID. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "itemprototype.get", "params": { "hostids": "10254", "filter": { "type": 19, "request_method": 3 } }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": [ { "itemid": "28257", "type": "19", "snmp_oid": "", "hostid": "10254", "name": "discovered", "key_": "item[{#INAME}]", "delay": "{#IUPDATE}", "history": "90d", "trends": "30d", "status": "0", "value_type": "3", "trapper_hosts": "", "units": "", "logtimefmt": "", "templateid": "28255", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "flags": "2", "interfaceid": "2", "description": "", "evaltype": "0", "jmx_endpoint": "", "master_itemid": "0", "timeout": "", "url": "{#IURL}", "query_fields": [], "posts": "", "status_codes": "", "follow_redirects": "0", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "3", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "discover": "0", "uuid": "", "parameters": [] } ], "id": 1 } ``` #### Finding dependent item Find one Dependent item for specific item ID. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "item.get", "params": { "output": "extend", "filter": { "type": 18, "master_itemid": "25545" }, "limit": "1" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "itemid": "25547", "type": "18", "snmp_oid": "", "hostid": "10116", "name": "Seconds", "key_": "apache.status.uptime.seconds", "delay": "0", "history": "90d", "trends": "365d", "status": "0", "value_type": "3", "trapper_hosts": "", "units": "", "logtimefmt": "", "templateid": "0", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "interfaceid": "0", "description": "", "evaltype": "0", "master_itemid": "25545", "jmx_endpoint": "", "timeout": "", "url": "", "query_fields": [], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "0", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "discover": "0", "uuid": "", "parameters": [] } ], "id": 1 } ``` #### Atkarīgā vienuma atrašana Atrod vienu atkarīgo vienumu konkrētam vienuma ID. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "item.get", "params": { "output": "extend", "filter": { "type": 18, "master_itemid": "25545" }, "limit": "1" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": [ { "itemid": "25547", "type": "18", "snmp_oid": "", "hostid": "10116", "name": "Seconds", "key_": "apache.status.uptime.seconds", "delay": "0", "history": "90d", "trends": "365d", "status": "0", "value_type": "3", "trapper_hosts": "", "units": "", "logtimefmt": "", "templateid": "0", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "interfaceid": "0", "description": "", "evaltype": "0", "master_itemid": "25545", "jmx_endpoint": "", "timeout": "", "url": "", "query_fields": [], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "0", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "discover": "0", "uuid": "", "parameters": [] } ], "id": 1 } ``` #### Finding dependent items by key Retrieve all dependent items from host with ID "10116" that have the word "apache" in the key. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "item.get", "params": { "output": "extend", "hostids": "10116", "search": { "key_": "apache" }, "filter": { "type": 18 } }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "itemid": "25550", "type": "18", "snmp_oid": "", "hostid": "10116", "name": "Days", "key_": "apache.status.uptime.days", "delay": "0", "history": "90d", "trends": "365d", "status": "0", "value_type": "3", "trapper_hosts": "", "units": "", "logtimefmt": "", "templateid": "0", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "flags": "0", "interfaceid": "0", "description": "", "inventory_link": "0", "evaltype": "0", "jmx_endpoint": "", "master_itemid": "25545", "timeout": "", "url": "", "query_fields": [], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "0", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [], "lastclock": "0", "lastns": "0", "lastvalue": "0", "prevvalue": "0", "name_resolved": "Days" }, { "itemid": "25555", "type": "18", "snmp_oid": "", "hostid": "10116", "name": "Hours", "key_": "apache.status.uptime.hours", "delay": "0", "history": "90d", "trends": "365d", "status": "0", "value_type": "3", "trapper_hosts": "", "units": "", "logtimefmt": "", "templateid": "0", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "flags": "0", "interfaceid": "0", "description": "", "inventory_link": "0", "evaltype": "0", "jmx_endpoint": "", "master_itemid": "25545", "timeout": "", "url": "", "query_fields": [], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "0", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [], "lastclock": "0", "lastns": "0", "lastvalue": "0", "prevvalue": "0", "name_resolved": "Hours" } ], "id": 1 } ``` #### Atkarīgo vienumu atrašana pēc atslēgas Iegūstiet visus atkarīgos vienumus no hosta ar ID "10116", kuru atslēgā ir vārds "apache". [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "item.get", "params": { "output": "extend", "hostids": "10116", "search": { "key_": "apache" }, "filter": { "type": 18 } }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": [ { "itemid": "25550", "type": "18", "snmp_oid": "", "hostid": "10116", "name": "Days", "key_": "apache.status.uptime.days", "delay": "0", "history": "90d", "trends": "365d", "status": "0", "value_type": "3", "trapper_hosts": "", "units": "", "logtimefmt": "", "templateid": "0", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "flags": "0", "interfaceid": "0", "description": "", "inventory_link": "0", "evaltype": "0", "jmx_endpoint": "", "master_itemid": "25545", "timeout": "", "url": "", "query_fields": [], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "0", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [], "lastclock": "0", "lastns": "0", "lastvalue": "0", "prevvalue": "0", "name_resolved": "Days" }, { "itemid": "25555", "type": "18", "snmp_oid": "", "hostid": "10116", "name": "Hours", "key_": "apache.status.uptime.hours", "delay": "0", "history": "90d", "trends": "365d", "status": "0", "value_type": "3", "trapper_hosts": "", "units": "", "logtimefmt": "", "templateid": "0", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "flags": "0", "interfaceid": "0", "description": "", "inventory_link": "0", "evaltype": "0", "jmx_endpoint": "", "master_itemid": "25545", "timeout": "", "url": "", "query_fields": [], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "0", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [], "lastclock": "0", "lastns": "0", "lastvalue": "0", "prevvalue": "0", "name_resolved": "Hours" } ], "id": 1 } ``` #### Finding items by key Retrieve all items used in triggers for specific host ID that have word "system.cpu" in the item key and sort results by name. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "item.get", "params": { "output": "extend", "hostids": "10084", "with_triggers": true, "search": { "key_": "system.cpu" }, "sortfield": "name" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "itemid": "42269", "type": "18", "snmp_oid": "", "hostid": "10084", "name": "CPU utilization", "key_": "system.cpu.util", "delay": "0", "history": "7d", "trends": "365d", "status": "0", "value_type": "0", "trapper_hosts": "", "units": "%", "logtimefmt": "", "templateid": "42267", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "flags": "0", "interfaceid": "0", "description": "CPU utilization in %.", "inventory_link": "0", "evaltype": "0", "jmx_endpoint": "", "master_itemid": "42264", "timeout": "", "url": "", "query_fields": [], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "0", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [], "lastclock": "0", "lastns": "0", "lastvalue": "0", "prevvalue": "0", "name_resolved": "CPU utilization" }, { "itemid": "42259", "type": "0", "snmp_oid": "", "hostid": "10084", "name": "Load average (15m avg)", "key_": "system.cpu.load[all,avg15]", "delay": "1m", "history": "7d", "trends": "365d", "status": "0", "value_type": "0", "trapper_hosts": "", "units": "", "logtimefmt": "", "templateid": "42219", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "flags": "0", "interfaceid": "1", "description": "", "inventory_link": "0", "evaltype": "0", "jmx_endpoint": "", "master_itemid": "0", "timeout": "", "url": "", "query_fields": [], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "0", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [], "lastclock": "0", "lastns": "0", "lastvalue": "0", "prevvalue": "0", "name_resolved": "Load average (15m avg)" }, { "itemid": "42249", "type": "0", "snmp_oid": "", "hostid": "10084", "name": "Load average (1m avg)", "key_": "system.cpu.load[all,avg1]", "delay": "1m", "history": "7d", "trends": "365d", "status": "0", "value_type": "0", "trapper_hosts": "", "units": "", "logtimefmt": "", "templateid": "42209", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "flags": "0", "interfaceid": "1", "description": "", "inventory_link": "0", "evaltype": "0", "jmx_endpoint": "", "master_itemid": "0", "timeout": "", "url": "", "query_fields": [], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "0", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [], "lastclock": "0", "lastns": "0", "lastvalue": "0", "prevvalue": "0", "name_resolved": "Load average (1m avg)" }, { "itemid": "42257", "type": "0", "snmp_oid": "", "hostid": "10084", "name": "Load average (5m avg)", "key_": "system.cpu.load[all,avg5]", "delay": "1m", "history": "7d", "trends": "365d", "status": "0", "value_type": "0", "trapper_hosts": "", "units": "", "logtimefmt": "", "templateid": "42217", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "flags": "0", "interfaceid": "1", "description": "", "inventory_link": "0", "evaltype": "0", "jmx_endpoint": "", "master_itemid": "0", "timeout": "", "url": "", "query_fields": [], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "0", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [], "lastclock": "0", "lastns": "0", "lastvalue": "0", "prevvalue": "0", "name_resolved": "Load average (5m avg)" }, { "itemid": "42260", "type": "0", "snmp_oid": "", "hostid": "10084", "name": "Number of CPUs", "key_": "system.cpu.num", "delay": "1m", "history": "7d", "trends": "365d", "status": "0", "value_type": "3", "trapper_hosts": "", "units": "", "logtimefmt": "", "templateid": "42220", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "flags": "0", "interfaceid": "1", "description": "", "inventory_link": "0", "evaltype": "0", "jmx_endpoint": "", "master_itemid": "0", "timeout": "", "url": "", "query_fields": [], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "0", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [], "lastclock": "0", "lastns": "0", "lastvalue": "0", "prevvalue": "0", "name_resolved": "Number of CPUs" } ], "id": 1 } ``` #### Vienumu atrašana pēc atslēgas Iegūstiet visus vienumus, kas tiek izmantoti trigeros konkrētam host ID un kuru vienuma atslēgā ir vārds "system.cpu", un kārtojiet rezultātus pēc nosaukuma. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "item.get", "params": { "output": "extend", "hostids": "10084", "with_triggers": true, "search": { "key_": "system.cpu" }, "sortfield": "name" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": [ { "itemid": "42269", "type": "18", "snmp_oid": "", "hostid": "10084", "name": "CPU utilization", "key_": "system.cpu.util", "delay": "0", "history": "7d", "trends": "365d", "status": "0", "value_type": "0", "trapper_hosts": "", "units": "%", "logtimefmt": "", "templateid": "42267", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "flags": "0", "interfaceid": "0", "description": "CPU utilization in %.", "inventory_link": "0", "evaltype": "0", "jmx_endpoint": "", "master_itemid": "42264", "timeout": "", "url": "", "query_fields": [], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "0", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [], "lastclock": "0", "lastns": "0", "lastvalue": "0", "prevvalue": "0", "name_resolved": "CPU utilization" }, { "itemid": "42259", "type": "0", "snmp_oid": "", "hostid": "10084", "name": "Load average (15m avg)", "key_": "system.cpu.load[all,avg15]", "delay": "1m", "history": "7d", "trends": "365d", "status": "0", "value_type": "0", "trapper_hosts": "", "units": "", "logtimefmt": "", "templateid": "42219", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "flags": "0", "interfaceid": "1", "description": "", "inventory_link": "0", "evaltype": "0", "jmx_endpoint": "", "master_itemid": "0", "timeout": "", "url": "", "query_fields": [], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "0", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [], "lastclock": "0", "lastns": "0", "lastvalue": "0", "prevvalue": "0", "name_resolved": "Load average (15m avg)" }, { "itemid": "42249", "type": "0", "snmp_oid": "", "hostid": "10084", "name": "Load average (1m avg)", "key_": "system.cpu.load[all,avg1]", "delay": "1m", "history": "7d", "trends": "365d", "status": "0", "value_type": "0", "trapper_hosts": "", "units": "", "logtimefmt": "", "templateid": "42209", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "flags": "0", "interfaceid": "1", "description": "", "inventory_link": "0", "evaltype": "0", "jmx_endpoint": "", "master_itemid": "0", "timeout": "", "url": "", "query_fields": [], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "0", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [], "lastclock": "0", "lastns": "0", "lastvalue": "0", "prevvalue": "0", "name_resolved": "Load average (1m avg)" }, { "itemid": "42257", "type": "0", "snmp_oid": "", "hostid": "10084", "name": "Load average (5m avg)", "key_": "system.cpu.load[all,avg5]", "delay": "1m", "history": "7d", "trends": "365d", "status": "0", "value_type": "0", "trapper_hosts": "", "units": "", "logtimefmt": "", "templateid": "42217", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "flags": "0", "interfaceid": "1", "description": "", "inventory_link": "0", "evaltype": "0", "jmx_endpoint": "", "master_itemid": "0", "timeout": "", "url": "", "query_fields": [], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "0", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [], "lastclock": "0", "lastns": "0", "lastvalue": "0", "prevvalue": "0", "name_resolved": "Load average (5m avg)" }, { "itemid": "42260", "type": "0", "snmp_oid": "", "hostid": "10084", "name": "Number of CPUs", "key_": "system.cpu.num", "delay": "1m", "history": "7d", "trends": "365d", "status": "0", "value_type": "3", "trapper_hosts": "", "units": "", "logtimefmt": "", "templateid": "42220", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "flags": "0", "interfaceid": "1", "description": "", "inventory_link": "0", "evaltype": "0", "jmx_endpoint": "", "master_itemid": "0", "timeout": "", "url": "", "query_fields": [], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "0", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [], "lastclock": "0", "lastns": "0", "lastvalue": "0", "prevvalue": "0", "name_resolved": "Number of CPUs" } ], "id": 1 } ``` #### Finding MFA methods by name Retrieve all MFA methods with "Zabbix" in their name. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "mfa.get", "params": { "output": "extend", "search": { "name": "Zabbix" } }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "mfaid": "1", "type": "1", "name": "Zabbix TOTP 1", "hash_function": "1", "code_length": "6", "api_hostname": "", "clientid": "" }, { "mfaid": "2", "type": "1", "name": "Zabbix TOTP 2", "hash_function": "3", "code_length": "8", "api_hostname": "", "clientid": "" } ], "id": 1 } ``` #### MFA metožu atrašana pēc nosaukuma Iegūstiet visas MFA metodes, kuru nosaukumā ir "Zabbix". [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "mfa.get", "params": { "output": "extend", "search": { "name": "Zabbix" } }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": [ { "mfaid": "1", "type": "1", "name": "Zabbix TOTP 1", "hash_function": "1", "code_length": "6", "api_hostname": "", "clientid": "" }, { "mfaid": "2", "type": "1", "name": "Zabbix TOTP 2", "hash_function": "3", "code_length": "8", "api_hostname": "", "clientid": "" } ], "id": 1 } ``` ##### Find links The following script: 1. Initializes a browser session. 2. Defines a function for removing duplicate elements from an array (see step 5). 3. Navigates to a page (specified as parameters, see below). 4. Finds links on the page. 5. Removes duplicate links to ensure they are unique. 6. Extracts only the links that start with "http". 7. Formats the extracted links to a specific structure. 8. Handles errors by capturing error messages and a screenshot. 9. Returns the collected results as a JSON string. The script also uses parameters from the [item configuration form](#configuration): - scheme - {$WEBSITE.SCHEME} - domain - {$WEBSITE.DOMAIN} - path - {$WEBSITE.PATH} In the *Script* field, enter: ```javascript var browser, result; browser = new Browser(Browser.chromeOptions()); try { var params = JSON.parse(value); // Parse the JSON string containing parameters passed from Zabbix. function uniq(a) { return a.sort().filter(function (item, pos, ary) { return !pos || item != ary[pos - 1]; }); } browser.navigate(params.scheme + '://' + params.domain + params.path); var el = browser.findElements("link text", ""); var links = []; for (var n = 0; n < el.length; n++) { links.push(el[n].getAttribute('href')); } links = uniq(links); result = []; for (i = 0; i < links.length; i++) { if (links[i].match(/^http.*/)) { var row = {}; row["{#URL}"] = links[i]; result.push(row); } } } catch (err) { if (!(err instanceof BrowserError)) { browser.setError(err.message); } result = browser.getResult(); result.error.screenshot = browser.getScreenshot(); } finally { return JSON.stringify(result); } ``` ##### Saišu atrašana Šis skripts: 1. Inicializē pārlūkprogrammas sesiju. 2. Definē funkciju dublikātu elementu noņemšanai no masīva (skatiet 5. soli). 3. Pāriet uz lapu (norādītu kā parametrus, skatiet tālāk). 4. Atrod saites lapā. 5. Noņem dublētās saites, lai nodrošinātu, ka tās ir unikālas. 6. Izvelk tikai tās saites, kas sākas ar "http". 7. Formatē iegūtās saites noteiktā struktūrā. 8. Apstrādā kļūdas, saglabājot kļūdu ziņojumus un ekrānuzņēmumu. 9. Atgriež savāktos rezultātus kā JSON virkni. Skripts izmanto arī parametrus no [vienuma konfigurācijas formas](#configuration): - scheme - {$WEBSITE.SCHEME} - domain - {$WEBSITE.DOMAIN} - path - {$WEBSITE.PATH} Laukā *Script* ievadiet: ```javascript var browser, result; browser = new Browser(Browser.chromeOptions()); try { var params = JSON.parse(value); // Parse the JSON string containing parameters passed from Zabbix. function uniq(a) { return a.sort().filter(function (item, pos, ary) { return !pos || item != ary[pos - 1]; }); } browser.navigate(params.scheme + '://' + params.domain + params.path); var el = browser.findElements("link text", ""); var links = []; for (var n = 0; n < el.length; n++) { links.push(el[n].getAttribute('href')); } links = uniq(links); result = []; for (i = 0; i < links.length; i++) { if (links[i].match(/^http.*/)) { var row = {}; row["{#URL}"] = links[i]; result.push(row); } } } catch (err) { if (!(err instanceof BrowserError)) { browser.setError(err.message); } result = browser.getResult(); result.error.screenshot = browser.getScreenshot(); } finally { return JSON.stringify(result); } ``` #### Firewall By default, only the ports listed in the [configuration changes](#firewall_configuration) above are open. To open additional ports, modify "*/etc/sysconfig/iptables*" file and reload firewall rules: systemctl reload iptables #### Ugunsmūris Pēc noklusējuma ir atvērti tikai iepriekš [konfigurācijas izmaiņās](#firewall_configuration) norādītie porti. Lai atvērtu papildu portus, modificējiet failu "*/etc/sysconfig/iptables*" un pārlādējiet ugunsmūra noteikumus: systemctl reload iptables ##### Firewall configuration The appliance uses iptables firewall with predefined rules: - Opened SSH port (22 TCP); - Opened Zabbix agent (10050 TCP) and Zabbix trapper (10051 TCP) ports; - Opened HTTP (80 TCP) and HTTPS (443 TCP) ports; - Opened SNMP trap port (162 UDP); - Opened outgoing connections to NTP port (123 UDP); - ICMP packets limited to 5 packets per second; - All other incoming connections are dropped. ##### Ugunsmūra konfigurācija Ierīce izmanto iptables ugunsmūri ar iepriekš definētiem noteikumiem: - Atvērts SSH ports (22 TCP); - Atvērti Zabbix aģents (10050 TCP) un Zabbix trapper (10051 TCP) porti; - Atvērti HTTP (80 TCP) un HTTPS (443 TCP) porti; - Atvērts SNMP trap port (162 UDP); - Atļauti izejošie savienojumi uz NTP portu (123 UDP); - ICMP paketes ierobežotas līdz 5 paketēm sekundē; - Visi pārējie ienākošie savienojumi tiek noraidīti. ##### first(/host/key,sec<:time shift>) {#first} The first (the oldest) value within the defined evaluation period.<br> Supported value types: *Float*, *Integer*, *String*, *Text*, *Log*. Parameters: - See [common parameters](#common-parameters) See also [last()](#last). Example: ```default first(/host/key,1h) #retrieve the oldest value within the last hour until now ``` ##### first(/host/key,sec<:time shift>) {#first} Pirmā (vecākā) vērtība definētajā novērtēšanas periodā.<br> Atbalstītie vērtību tipi: *Float*, *Integer*, *String*, *Text*, *Log*. Parametri: - Skatiet [kopīgos parametrus](#common-parameters) Skatiet arī [last()](#last). Piemērs: ```default first(/host/key,1h) #retrieve the oldest value within the last hour until now ``` ##### Fit functions Default `fit` is the *linear* function. But if your monitored system is more complicated you have more options to choose from. |`fit`|x = f(t)| |-----|--------| |*linear*|x = a + b\*t| |*polynomialN*^[2](#footnotes)^|x = a~0~ + a~1~\*t + a~2~\*t^2^ + ... + a~n~\*t^n^| |*exponential*|x = a\*exp(b\*t)| |*logarithmic*|x = a + b\*log(t)| |*power*|x = a\*t^b^| ##### Pielāgošanas funkcijas Noklusējuma `fit` ir *lineārā* funkcija. Taču, ja jūsu uzraudzītā sistēma ir sarežģītāka, jums ir pieejamas citas izvēles iespējas. |`fit`|x = f(t)| |-----|--------| |*lineārā*|x = a + b\*t| |*polinomiālāN*^[2](#footnotes)^|x = a~0~ + a~1~\*t + a~2~\*t^2^ + ... + a~n~\*t^n^| |*eksponenciālā*|x = a\*exp(b\*t)| |*logaritmiskā*|x = a + b\*log(t)| |*pakāpes*|x = a\*t^b^| #### Flexible intervals Flexible intervals allow to redefine the default update interval for specific time periods. A flexible interval is defined with *Interval* and *Period* where: - *Interval* - the update interval for the specified time period. [Time suffixes](/manual/appendix/suffixes) are supported, e.g., 30s, 1m, 2h, 1d. - *Period* - the time period when the flexible interval is active (see the [time periods](/manual/appendix/time_period) for detailed description of the *Period* format) If multiple flexible intervals overlap, the smallest *Interval* value is used for the overlapping period. Note that if the smallest value of overlapping flexible intervals is '0', no polling will take place. Outside the flexible intervals the default update interval is used. Note that if the flexible interval equals the length of the period, the item will be checked exactly once. If the flexible interval is greater than the period, the item might be checked once or it might not be checked at all (thus such configuration is not advisable). If the flexible interval is less than the period, the item will be checked at least once. If the flexible interval is set to '0', the item is not polled during the flexible interval period and resumes polling according to the default *Update interval* once the period is over. Examples: |Interval|Period|Description| |--|--|------| |10|1-5,09:00-18:00|Item will be checked every 10 seconds during working hours.| |0|1-7,00:00-7:00|Item will not be checked during the night.| |0|7-7,00:00-24:00|Item will not be checked on Sundays.| |60|1-7,12:00-12:01|Item will be checked at 12:00 every day. Note that this was used as a workaround for scheduled checks and it is recommended to use scheduling intervals for such checks.| #### Elastīgie intervāli Elastīgie intervāli ļauj pārrakstīt noklusējuma atjaunināšanas intervālu konkrētiem laika periodiem. Elastīgais intervāls tiek definēts ar *Interval* un *Period*, kur: - *Interval* - atjaunināšanas intervāls norādītajam laika periodam. [Taimstampa sufiksi](/manual/appendix/suffixes) tiek atbalstīti, piemēram, 30s, 1m, 2h, 1d. - *Period* - laika periods, kad elastīgais intervāls ir aktīvs (skatiet [laika periodus](/manual/appendix/time_period) detalizētam *Period* formāta aprakstam) Ja vairāki elastīgie intervāli pārklājas, pārklāšanās periodam tiek izmantota mazākā *Interval* vērtība. Ņemiet vērā, ka, ja pārklājošos elastīgo intervālu mazākā vērtība ir '0', aptauja netiks veikta. Ārpus elastīgajiem intervāliem tiek izmantots noklusējuma atjaunināšanas intervāls. Ņemiet vērā, ka, ja elastīgais intervāls ir vienāds ar perioda garumu, vienums tiks pārbaudīts tieši vienu reizi. Ja elastīgais intervāls ir lielāks par periodu, vienums var tikt pārbaudīts vienu reizi vai arī netikt pārbaudīts vispār (tāpēc šāda konfigurācija nav ieteicama). Ja elastīgais intervāls ir mazāks par periodu, vienums tiks pārbaudīts vismaz vienu reizi. Ja elastīgais intervāls ir iestatīts uz '0', vienums netiek aptaujāts elastīgā intervāla periodā un pēc perioda beigām atsāk aptauju atbilstoši noklusējuma *Update interval*. Piemēri: |Interval|Period|Description| |--|--|------| |10|1-5,09:00-18:00|Vienums tiks pārbaudīts ik pēc 10 sekundēm darba laikā.| |0|1-7,00:00-7:00|Vienums netiks pārbaudīts nakts laikā.| |0|7-7,00:00-24:00|Vienums netiks pārbaudīts svētdienās.| |60|1-7,12:00-12:01|Vienums tiks pārbaudīts katru dienu plkst. 12:00. Ņemiet vērā, ka tas tika izmantots kā risinājums plānotajām pārbaudēm, un šādām pārbaudēm ieteicams izmantot plānošanas intervālus.| #### Flexible/scheduling interval support in active checks Flexible/scheduling intervals are now supported in active checks by both Zabbix agent and Zabbix agent 2 (previously only Zabbix agent 2). #### Elastīga/plānošanas intervālu atbalsts aktīvajās pārbaudēs Elastīgie/plānošanas intervāli tagad tiek atbalstīti aktīvajās pārbaudēs gan Zabbix aģentā, gan Zabbix aģentā 2 (iepriekš tikai Zabbix aģentā 2). ##### Flexible timeout support Flexible item timeouts are supported for these item types: - [Zabbix agent](/manual/config/items/itemtypes/zabbix_agent) (both passive and active checks) - [SNMP agent](/manual/config/items/itemtypes/snmp) (except legacy SNMP checks^**1**^) - [Simple check](/manual/config/items/itemtypes/simple_checks) (except `icmpping*` and VMware items^**2**^) - [SSH agent](/manual/config/items/itemtypes/ssh_checks) - [Telnet agent](/manual/config/items/itemtypes/telnet_checks) - [External check](/manual/config/items/itemtypes/external) - [Database monitor](/manual/config/items/itemtypes/odbc_checks) - [Script](/manual/config/items/itemtypes/script) - [HTTP agent](/manual/config/items/itemtypes/http) - [Browser](/manual/config/items/itemtypes/browser) ^**1**^ For legacy SNMP checks (single OID polling), timeout settings from the [server](/manual/appendix/config/zabbix_server#timeout) or [proxy](/manual/appendix/config/zabbix_proxy#timeout) apply.<br> ^**2**^ For `icmpping*` items, the timeout value is specified directly in the item key. VMware monitoring items use their own VMwareTimeout parameter from [server](/manual/appendix/config/zabbix_server#vmwaretimeout) or [proxy](/manual/appendix/config/zabbix_proxy#vmwaretimeout) configuration. ##### Elastīga noildzes atbalsts Elastīgas vienuma noildzes tiek atbalstītas šādiem vienumu tipiem: - [Zabbix aģents](/manual/config/items/itemtypes/zabbix_agent) (gan pasīvajām, gan aktīvajām pārbaudēm) - [SNMP aģents](/manual/config/items/itemtypes/snmp) (izņemot mantotās SNMP pārbaudes^**1**^) - [Vienkārša pārbaude](/manual/config/items/itemtypes/simple_checks) (izņemot `icmpping*` un VMware vienumus^**2**^) - [SSH aģents](/manual/config/items/itemtypes/ssh_checks) - [Telnet aģents](/manual/config/items/itemtypes/telnet_checks) - [Ārējā pārbaude](/manual/config/items/itemtypes/external) - [Datubāzes monitors](/manual/config/items/itemtypes/odbc_checks) - [Skripts](/manual/config/items/itemtypes/script) - [HTTP aģents](/manual/config/items/itemtypes/http) - [Pārlūks](/manual/config/items/itemtypes/browser) ^**1**^ Mantotajām SNMP pārbaudēm (viena OID aptauja) tiek piemēroti noildzes iestatījumi no [serveris](/manual/appendix/config/zabbix_server#timeout) vai [starpniekserveris](/manual/appendix/config/zabbix_proxy#timeout).<br> ^**2**^ `icmpping*` vienumiem noildzes vērtība tiek norādīta tieši vienuma atslēgā. VMware uzraudzības vienumi izmanto savu VMwareTimeout parametru no [serveris](/manual/appendix/config/zabbix_server#vmwaretimeout) vai [starpniekserveris](/manual/appendix/config/zabbix_proxy#vmwaretimeout) konfigurācijas. #### Flexible user parameters Flexible user parameters accept parameters with the key. This way a flexible user parameter can be the basis for creating several items. Flexible user parameters have the following syntax: UserParameter=key[*],command |Parameter|Description| |--|--------| |**Key**|Unique item key. The \[\*\] defines that this key accepts parameters within the brackets.<br>Parameters are given when configuring the item.| |**Command**|Command to be executed to evaluate value of the key.<br>*For flexible user parameters only*:<br>You may use positional references $1…$9 in the command to refer to the respective parameter in the item key.<br>Zabbix parses the parameters enclosed in \[ \] of the item key and substitutes $1,...,$9 in the command accordingly.<br>$0 will be substituted by the original command (prior to expansion of $0,...,$9) to be run.<br>Positional references are interpreted regardless of whether they are enclosed between double (") or single (') quotes.<br>To use positional references unaltered, specify a double dollar sign - for example, awk '{print $$2}'. In this case `$$2` will actually turn into `$2` when executing the command.| ::: noteimportant Positional references with the $ sign are searched for and replaced by Zabbix agent only for flexible user parameters. For simple user parameters, such reference processing is skipped and, therefore, any $ sign quoting is not necessary. ::: ::: noteimportant Certain characters are not allowed in user parameters by default. For the complete list of characters, see [UnsafeUserParameters](/manual/appendix/config/zabbix_agentd#unsafeuserparameters). ::: #### Elastīgie lietotāja parametri Elastīgie lietotāja parametri pieņem parametrus ar atslēgu. Tādējādi elastīgs lietotāja parametrs var kalpot par pamatu vairāku vienumu izveidei. Elastīgo lietotāja parametru sintakse ir šāda: UserParameter=key[*],command |Parameter|Description| |--|--------| |**Key**|Unikāla vienuma atslēga. \[\*\] nosaka, ka šī atslēga pieņem parametrus iekavās.<br>Parametri tiek norādīti, konfigurējot vienumu.| |**Command**|Komanda, kas jāizpilda, lai noteiktu atslēgas vērtību.<br>*Tikai elastīgiem lietotāja parametriem*:<br>Komandā var izmantot pozicionālās atsauces $1…$9, lai norādītu uz attiecīgo parametru vienuma atslēgā.<br>Zabbix parsē vienuma atslēgas \[ \] ietvertos parametrus un attiecīgi aizstāj komandā $1,...,$9.<br>$0 tiks aizstāts ar sākotnējo komandu (pirms $0,...,$9 paplašināšanas), kas jāizpilda.<br>Pozicionālās atsauces tiek interpretētas neatkarīgi no tā, vai tās ir ietvertas dubultpēdiņās (") vai vienpēdiņās (').<br>Lai izmantotu pozicionālās atsauces nemainītā veidā, norādiet dubultu dolāra zīmi - piemēram, awk '{print $$2}'. Šajā gadījumā `$$2` izpildes laikā faktiski kļūs par `$2`.| ::: noteimportant Pozicionālās atsauces ar $ zīmi tiek meklētas un aizstātas tikai ar Zabbix aģents elastīgajiem lietotāja parametriem. Vienkāršiem lietotāja parametriem šāda atsauču apstrāde tiek izlaista un tāpēc $ zīmes citēšana nav nepieciešama. ::: ::: noteimportant Pēc noklusējuma noteiktas rakstzīmes lietotāja parametros nav atļautas. Pilnu rakstzīmju sarakstu skatiet [UnsafeUserParameters](/manual/appendix/config/zabbix_agentd#unsafeuserparameters). ::: #### Flipping frontend locales It has been observed that frontend locales may flip without apparent logic, i. e. some pages (or parts of pages) are displayed in one language while other pages (or parts of pages) in a different language. Typically the problem may appear when there are several users, some of whom use one locale, while others use another. A known workaround to this is to disable multithreading in PHP and Apache. The problem is related to how setting the locale works [in PHP](https://www.php.net/manual/en/function.setlocale): locale information is maintained per process, not per thread. So in a multi-thread environment, when there are several projects run by same Apache process, it is possible that the locale gets changed in another thread and that changes how data can be processed in the Zabbix thread. For more information, please see related problem reports: - [ZBX-10911](https://support.zabbix.com/browse/ZBX-10911) (Problem with flipping frontend locales) - [ZBX-16297](https://support.zabbix.com/browse/ZBX-16297) (Problem with number processing in graphs using the `bcdiv` function of BC Math functions) #### Lietotāja saskarnes lokalizāciju pārslēgšanās Ir novērots, ka lietotāja saskarnes lokalizācijas var pārslēgties bez acīmredzamas loģikas, t. i., dažas lapas (vai lapu daļas) tiek attēlotas vienā valodā, kamēr citas lapas (vai lapu daļas) — citā valodā. Parasti problēma var parādīties, ja ir vairāki lietotāji, no kuriem daži izmanto vienu lokalizāciju, bet citi — citu. Zināms pagaidu risinājums ir atspējot daudzpavedienu darbību PHP un Apache. Problēma ir saistīta ar to, kā lokalizācijas iestatīšana darbojas [in PHP](https://www.php.net/manual/en/function.setlocale): lokalizācijas informācija tiek uzturēta katram procesam, nevis katram pavedienam. Tāpēc daudzpavedienu vidē, ja vienā un tajā pašā Apache procesā darbojas vairāki projekti, ir iespējams, ka lokalizācija tiek mainīta citā pavedienā, un tas ietekmē to, kā dati tiek apstrādāti Zabbix pavedienā. Plašāku informāciju skatiet saistītajos problēmu ziņojumos: - [ZBX-10911](https://support.zabbix.com/browse/ZBX-10911) (Problēma ar lietotāja saskarnes lokalizāciju pārslēgšanos) - [ZBX-16297](https://support.zabbix.com/browse/ZBX-16297) (Problēma ar skaitļu apstrādi grafikos, izmantojot BC Math funkciju `bcdiv`) ### Float history The float history object has the following properties. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |clock|timestamp|Time when that value was received.| |itemid|ID|ID of the related item.| |ns|integer|Nanoseconds when the value was received.| |value|float|Received value.| ### Peldošā komata vēsture Peldošā komata vēstures objektam ir šādas īpašības. |Īpašība|[Tips](/manual/api/reference_commentary#data-types)|Apraksts| |--|--|------| |clock|timestamp|Laiks, kad šī vērtība tika saņemta.| |itemid|ID|Saistītā vienuma ID.| |ns|integer|Nanosekundes, kad vērtība tika saņemta.| |value|float|Saņemtā vērtība.| #### Floating point values trimmed for integer items Now, if a floating point value is received for an unsigned integer item, the value will be trimmed from the decimal part and saved as an integer. Previously a floating point value would make an integer item unsupported. #### Peldošā komata vērtības tiek saīsinātas veselu skaitļu vienumiem Tagad, ja unsigned integer vienumam tiek saņemta peldošā komata vērtība, vērtība tiks saīsināta, noņemot decimāldaļu, un saglabāta kā vesels skaitlis. Iepriekš peldošā komata vērtība padarītu veselu skaitļu vienumu neatbalstītu. #### Floating point values trimmed for integer items Now, if a floating point value is received for an unsigned integer item, the value will be trimmed from the decimal part and saved as an integer. Previously a floating point value would make an integer item unsupported. #### Peldošā komata vērtības tiek saīsinātas veselo skaitļu vienumiem Tagad, ja unsigned integer vienumam tiek saņemta peldošā komata vērtība, vērtības decimālā daļa tiks noņemta un tā tiks saglabāta kā vesels skaitlis. Iepriekš peldošā komata vērtība padarītu veselo skaitļu vienumu neatbalstītu. ### Float trend The float trend object has the following properties. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |clock|timestamp|Timestamp of an hour for which the value was calculated. For example, timestamp of "04:00:00" means values calculated for period "04:00:00-04:59:59".| |itemid|ID|ID of the related item.| |num|integer|Number of values that were available for the hour.| |value\_min|float|Hourly minimum value.| |value\_avg|float|Hourly average value.| |value\_max|float|Hourly maximum value.| ### Peldošā komata trends Peldošā komata trenda objektam ir šādas īpašības. |Īpašība|[Tips](/manual/api/reference_commentary#data-types)|Apraksts| |--|--|------| |clock|timestamp|Tās stundas laikspiedols, kurai tika aprēķināta vērtība. Piemēram, laikspiedols "04:00:00" nozīmē vērtības, kas aprēķinātas periodam "04:00:00-04:59:59".| |itemid|ID|Saistītā vienuma ID.| |num|integer|Stundai pieejamo vērtību skaits.| |value\_min|float|Stundas minimālā vērtība.| |value\_avg|float|Stundas vidējā vērtība.| |value\_max|float|Stundas maksimālā vērtība.| ##### floor(value) {#floor} Round the value down to the nearest smaller or equal integer. Parameter: - **value** - the value to check For example, '2.6' will be rounded down to '2'. See also [ceil()](#ceil). Example: floor(last(/host/key)) ##### floor(value) {#floor} Noapaļo vērtību uz leju līdz tuvākajam mazākajam vai vienādam veselam skaitlim. Parametrs: - **value** - pārbaudāmā vērtība Piemēram, '2.6' tiks noapaļots uz leju līdz '2'. Skatiet arī [ceil()](#ceil). Piemērs: floor(last(/host/key)) ##### fmtnum(digits) {#fmtnum} Number formatting to control the number of digits printed after the decimal point. Parameters: - **digits** - the number of digits after decimal point. Valid range: 0-20. No trailing zeros will be produced. Examples: ```default {{ITEM.VALUE}.fmtnum(2)} - will return "24.35" from a received value of "24.3483523" {{ITEM.VALUE}.fmtnum(0)} - will return "24" from a received value of "24.3483523" ``` ##### fmtnum(digits) {#fmtnum} Skaitļa formatēšana, lai kontrolētu pēc decimālpunkta izdrukāto ciparu skaitu. Parametri: - **digits** - ciparu skaits aiz decimālpunkta. Derīgais diapazons: 0-20. Beigu nulles netiks pievienotas. Piemēri: ```default {{ITEM.VALUE}.fmtnum(2)} - atgriezīs "24.35" no saņemtās vērtības "24.3483523" {{ITEM.VALUE}.fmtnum(0)} - atgriezīs "24" no saņemtās vērtības "24.3483523" ``` ##### fmttime(format,<time\_shift>) {#fmttime} Time formatting.<br> Note that this function can be used with macros that resolve to a value in one of the following time formats: - `hh:mm:ss` - `yyyy-mm-ddThh:mm:ss[tz]` (ISO8601 standard) - UNIX timestamp Parameters: - **format** - mandatory format string, compatible with `strftime` function formatting;<br> - **time\_shift** (optional) - the time shift applied to the time before formatting; should start with `-<N><time_unit>` or `+<N><time_unit>`, where:<br> - `N` - the number of time units to add or subtract; - `time_unit` - h (hour), d (day), w (week), M (month) or y (year). Comments: - The `time_shift` parameter supports multistep time operations and may include `/<time_unit>` for shifting to the beginning of the time unit (`/d` - midnight, `/w` - 1st day of the week (Monday), `/M` - 1st day of the month, etc.). Examples: `-1w` - exactly 7 days back; `-1w/w` - Monday of the previous week; `-1w/w+1d` - Tuesday of the previous week. - Time operations are calculated from left to right without priorities. For example, `-1M/d+1h/w` will be parsed as `((-1M/d)+1h)/w`. Examples: ```default {{TIMESTAMP}.fmttime(%B)} - will return "October" from a received value of "1633098961" {{TIMESTAMP}.fmttime(%d %B,-1M/M)} - will return "1 September" from a received value of "1633098961" ``` ##### fmttime(format,<time\_shift>) {#fmttime} Laika formatēšana.<br> Ņemiet vērā, ka šo funkciju var izmantot ar makro, kas tiek atrisināti uz vērtību vienā no šiem laika formātiem: - `hh:mm:ss` - `yyyy-mm-ddThh:mm:ss[tz]` (ISO8601 standarts) - UNIX laikspiedols Parametri: - **format** - obligāta formāta virkne, kas ir saderīga ar `strftime` funkcijas formatējumu;<br> - **time\_shift** (neobligāts) - laika nobīde, kas tiek piemērota laikam pirms formatēšanas; tai jāsākas ar `-<N><time_unit>` vai `+<N><time_unit>`, kur:<br> - `N` - laika vienību skaits, ko pievienot vai atņemt; - `time_unit` - h (stunda), d (diena), w (nedēļa), M (mēnesis) vai y (gads). Komentāri: - `time_shift` parametrs atbalsta vairāku soļu laika darbības un var ietvert `/<time_unit>` laika vienības sākuma noteikšanai (`/d` - pusnakts, `/w` - nedēļas 1. diena (pirmdiena), `/M` - mēneša 1. diena utt.). Piemēri: `-1w` - tieši 7 dienas atpakaļ; `-1w/w` - iepriekšējās nedēļas pirmdiena; `-1w/w+1d` - iepriekšējās nedēļas otrdiena. - Laika darbības tiek aprēķinātas no kreisās uz labo pusi bez prioritātēm. Piemēram, `-1M/d+1h/w` tiks interpretēts kā `((-1M/d)+1h)/w`. Piemēri: ```default {{TIMESTAMP}.fmttime(%B)} - atgriezīs "October" no saņemtās vērtības "1633098961" {{TIMESTAMP}.fmttime(%d %B,-1M/M)} - atgriezīs "1 September" no saņemtās vērtības "1633098961" ``` #### Footnotes ^**1**^A Linux-specific note. Zabbix agent must have read-only access to filesystem */proc*. Kernel patches from www.grsecurity.org limit access rights of non-privileged users. ^**2**^ `vfs.dev.read[]`, `vfs.dev.write[]`: Zabbix agent will terminate "stale" device connections if the item values are not accessed for more than 3 hours. This may happen if a system has devices with dynamically changing paths or if a device gets manually removed. Note also that these items, if using an update interval of 3 hours or more, will always return '0'. ^**3**^ `vfs.dev.read[]`, `vfs.dev.write[]`: If default *all* is used for the first parameter then the key will return summary statistics, including all block devices like sda, sdb, and their partitions (sda1, sda2, sdb3...) and multiple devices (MD raid) based on those block devices/partitions and logical volumes (LVM) based on those block devices/partitions. In such cases returned values should be considered only as relative value (dynamic in time) but not as absolute values. ^**4**^ SSL (HTTPS) is supported only if agent is compiled with cURL support. Otherwise the item will turn unsupported. ^**5**^ The `bytes` and `errors` values are not supported for loopback interfaces on Solaris systems up to and including Solaris 10 6/06 as byte, error and utilization statistics are not stored and/or reported by the kernel. However, if you're monitoring a Solaris system via net-snmp, values may be returned as net-snmp carries legacy code from the cmu-snmp dated as old as 1997 that, upon failing to read byte values from the interface statistics returns the packet counter (which does exist on loopback interfaces) multiplied by an arbitrary value of 308. This makes the assumption that the average length of a packet is 308 octets, which is a very rough estimation as the MTU limit on Solaris systems for loopback interfaces is 8892 bytes. These values should not be assumed to be correct or even closely accurate. They are guestimates. Zabbix agent does not do any guess work, but net-snmp will return a value for these fields. ^**6**^ The command line on Solaris, obtained from /proc/pid/psinfo, is limited to 80 bytes and contains the command line as it was when the process was started. ^**7**^ `vfs.file.contents[]`, `vfs.file.regexp[]`, `vfs.file.regmatch[]` items can be used for retrieving file contents. If you want to restrict access to specific files with sensitive information, run Zabbix agent under a user that has no access permissions to viewing these files. #### Piezīmes ^**1**^ Linux specifiska piezīme. Zabbix aģentam jābūt tikai lasīšanas piekļuvei failu sistēmai */proc*. Kodola ielāpi no www.grsecurity.org ierobežo neppriviliģētu lietotāju piekļuves tiesības. ^**2**^ `vfs.dev.read[]`, `vfs.dev.write[]`: Zabbix aģents pārtrauks "novecojušus" ierīču savienojumus, ja vienumu vērtībām nepiekļūst ilgāk par 3 stundām. Tas var notikt, ja sistēmā ir ierīces ar dinamiski mainīgiem ceļiem vai ja ierīce tiek manuāli noņemta. Ņemiet vērā arī to, ka šie vienumi, ja tiek izmantots atjaunināšanas intervāls 3 stundas vai ilgāks, vienmēr atgriezīs '0'. ^**3**^ `vfs.dev.read[]`, `vfs.dev.write[]`: Ja pirmajam parametram tiek izmantota noklusējuma vērtība *all*, tad atslēga atgriezīs kopsavilkuma statistiku, iekļaujot visas bloku ierīces, piemēram, sda, sdb, un to nodalījumus (sda1, sda2, sdb3...), kā arī vairākas ierīces (MD raid), kas balstītas uz šīm bloku ierīcēm/nodalījumiem, un loģiskos sējumus (LVM), kas balstīti uz šīm bloku ierīcēm/nodalījumiem. Šādos gadījumos atgrieztās vērtības būtu jāuzskata tikai par relatīvām vērtībām (dinamiskām laikā), nevis par absolūtām vērtībām. ^**4**^ SSL (HTTPS) tiek atbalstīts tikai tad, ja aģents ir kompilēts ar cURL atbalstu. Pretējā gadījumā vienums kļūs neatbalstīts. ^**5**^ `bytes` un `errors` vērtības netiek atbalstītas loopback saskarnēm Solaris sistēmās līdz Solaris 10 6/06 ieskaitot, jo baitu, kļūdu un noslodzes statistiku kodols neuzglabā un/vai neziņo. Tomēr, ja uzraugāt Solaris sistēmu, izmantojot net-snmp, vērtības var tikt atgrieztas, jo net-snmp satur mantotu kodu no cmu-snmp, kas datēts pat ar 1997. gadu un kas, nespējot nolasīt baitu vērtības no saskarnes statistikas, atgriež pakešu skaitītāju (kas loopback saskarnēs pastāv), reizinātu ar patvaļīgu vērtību 308. Tas balstās uz pieņēmumu, ka paketes vidējais garums ir 308 okteti, kas ir ļoti aptuvens novērtējums, jo Solaris sistēmās loopback saskarņu MTU ierobežojums ir 8892 baiti. Nevajadzētu pieņemt, ka šīs vērtības ir pareizas vai pat tuvu precīzas. Tie ir aptuveni minējumi. Zabbix aģents neveic nekādu minēšanu, taču net-snmp šiem laukiem atgriezīs vērtību. ^**6**^ Komandrinda Solaris sistēmā, kas iegūta no /proc/pid/psinfo, ir ierobežota līdz 80 baitiem un satur komandrindu tādu, kāda tā bija procesa palaišanas brīdī. ^**7**^ `vfs.file.contents[]`, `vfs.file.regexp[]`, `vfs.file.regmatch[]` vienumus var izmantot faila satura iegūšanai. Ja vēlaties ierobežot piekļuvi konkrētiem failiem ar sensitīvu informāciju, palaidiet Zabbix aģentu zem lietotāja, kuram nav piekļuves tiesību šo failu skatīšanai. ## Footnotes ^1^ API integer values in brackets, for example, ENABLED (0), are mentioned only for reference. For more information, see the linked API object page in the table entry or at the end of each section. ## Piezīmes ^1^ API veselo skaitļu vērtības iekavās, piemēram, ENABLED (0), ir minētas tikai atsaucei. Plašāku informāciju skatiet saistītajā API objekta lapā tabulas ierakstā vai katras sadaļas beigās. ## Footnotes ^1^ API integer values in brackets, for example, ENABLED (0), are mentioned only for reference. For more information, see the linked API object page in the table entry or at the end of each section. ## Piezīmes ^1^ API integer vērtības iekavās, piemēram, ENABLED (0), ir minētas tikai atsaucei. Lai iegūtu vairāk informācijas, skatiet saistīto API objekta lapu tabulas ierakstā vai katras sadaļas beigās. #### Footnotes ^1^ API integer values in brackets, for example, ENABLED (0), are mentioned only for reference. For more information, see the linked API object page in the table entry or at the end of each section. #### Piezīmes ^1^ API integer vērtības iekavās, piemēram, ENABLED (0), ir minētas tikai atsaucei. Papildinformāciju skatiet saistītā API objekta lapā tabulas ierakstā vai katras sadaļas beigās. #### Footnotes ^**1**^ DBSocket and DBPort are mutually exclusive in proxy configuration. Specify only one, or leave both undefined. #### Piezīmes ^**1**^ DBSocket un DBPort starpniekservera konfigurācijā ir savstarpēji izslēdzoši. Norādiet tikai vienu vai atstājiet abus nedefinētus. ##### Footnotes ^**1**^ Default value. ##### Piezīmes ^**1**^ Noklusējuma vērtība. ##### Footnotes ^**1**^ If multiple macros in a field or macros mixed with text are not supported for the location, a single macro has to fill the whole field. ^**2**^ Macros used in tag names and values are resolved only during event generation process. ^**3**^ URLs that contain a [secret macro](/manual/config/macros/user_macros#configuration) will not work, as the macro in them will be resolved as "\*\*\*\*\*\*". ##### Piezīmes ^**1**^ Ja atrašanās vietai netiek atbalstīti vairāki makrosi laukā vai makrosi, kas sajaukti ar tekstu, vienam makrosam ir jāaizpilda viss lauks. ^**2**^ Makrosi, kas izmantoti birku nosaukumos un vērtībās, tiek atrisināti tikai notikuma ģenerēšanas procesa laikā. ^**3**^ URL, kas satur [slepeno makrosu](/manual/config/macros/user_macros#configuration), nedarbosies, jo tajos esošais makross tiks atrisināts kā "\*\*\*\*\*\*". ##### Footnotes ^**1**^ In the fields marked with ^[1](lld_macros#footnotes)^ a single macro has to fill the whole field. Multiple macros in a field or macros mixed with text are not supported. ##### Piezīmes ^**1**^ Laukos, kas atzīmēti ar ^[1](lld_macros#footnotes)^, vienai makrokomandai ir jāaizpilda viss lauks. Vairākas makrokomandas vienā laukā vai makrokomandas kopā ar tekstu netiek atbalstītas. #### Footnotes ^**1**^ Note that too many data gathering processes (pollers, unreachable pollers, ODBC pollers, HTTP pollers, Java pollers, pingers, trappers, proxypollers) together with IPMI manager, SNMP trapper, preprocessing workers, and discovery workers can exhaust the per-process file descriptor limit for the preprocessing manager. ::: notewarning Exhausting the file descriptor limit will cause Zabbix server to stop, typically shortly after startup but sometimes taking longer. To avoid such issues, review the [Zabbix server configuration file](/manual/appendix/config/zabbix_server) to optimize the number of concurrent checks and processes. Additionally, if necessary, ensure that the file descriptor limit is set sufficiently high by checking and adjusting system limits. ::: ^**2**^ When a lot of items are deleted it increases the load to the database, because the housekeeper will need to remove all the history data that these items had. For example, if we only have to remove 1 item prototype from the template, but this template is linked to 50 hosts and for every host the prototype is expanded to 100 real items, 5000 items in total have to be removed (1\*50\*100). If `500` is set for `MaxHousekeeperDelete` (`MaxHousekeeperDelete=500`), the housekeeper process will have to remove up to 2500000 values (5000\*500) for the deleted items from history and trends tables in one cycle. ^**3**^ `DBSocket` and `DBPort` are mutually exclusive in server configuration. Specify only one, or leave both undefined. #### Piezīmes ^**1**^ Ņemiet vērā, ka pārāk daudz datu vākšanas procesu (pollers, unreachable pollers, ODBC pollers, HTTP pollers, Java pollers, pingers, trappers, proxypollers) kopā ar IPMI manager, SNMP trapper, preprocessing workers un discovery workers var izsmelt priekšapstrādes pārvaldniekam noteikto failu deskriptoru limita vērtību katram procesam. ::: notewarning Failu deskriptoru limita izsmelšana izraisīs Zabbix serveris apstāšanos, parasti neilgi pēc palaišanas, taču dažkārt tas var aizņemt ilgāku laiku. Lai izvairītos no šādām problēmām, pārskatiet [Zabbix serveris konfigurācijas failu](/manual/appendix/config/zabbix_server), lai optimizētu vienlaicīgo pārbaužu un procesu skaitu. Turklāt, ja nepieciešams, pārliecinieties, ka failu deskriptoru limits ir iestatīts pietiekami augsts, pārbaudot un pielāgojot sistēmas limitus. ::: ^**2**^ Ja tiek dzēsts daudz vienumu, tas palielina slodzi datubāzei, jo housekeeper būs jānoņem visi šo vienumu vēstures dati. Piemēram, ja no veidnes ir jānoņem tikai 1 vienuma prototips, bet šī veidne ir saistīta ar 50 hosts un katram hostam prototips tiek izvērsts līdz 100 reāliem vienumiem, kopā ir jānoņem 5000 vienumi (1\*50\*100). Ja `500` ir iestatīts parametram `MaxHousekeeperDelete` (`MaxHousekeeperDelete=500`), housekeeper procesam vienā ciklā būs jānoņem līdz pat 2500000 vērtībām (5000\*500) no dzēstajiem vienumiem no history un trends tabulām. ^**3**^ `DBSocket` un `DBPort` serveris konfigurācijā ir savstarpēji izslēdzoši. Norādiet tikai vienu vai atstājiet abus nedefinētus. ##### Footnotes ^**1**^ See [Creating custom performance counter names for VMware](/manual/appendix/items/perf_counters). ^**2**^ The value of these items is obtained from VMware performance counters and the VMwarePerfFrequency [parameter](/manual/appendix/config/zabbix_server#vmwareperffrequency) is used to refresh their data in Zabbix VMware cache: - vmware.cl.perfcounter - vmware.hv.datastore.read - vmware.hv.datastore.write - vmware.hv.network.in - vmware.hv.network.out - vmware.hv.perfcounter - vmware.vm.cpu.ready - vmware.vm.net.if.in - vmware.vm.net.if.out - vmware.vm.perfcounter - vmware.vm.vfs.dev.read - vmware.vm.vfs.dev.write ##### Piezīmes ^**1**^ Skatiet [Pielāgotu veiktspējas skaitītāju nosaukumu izveidei VMware](/manual/appendix/items/perf_counters). ^**2**^ Šo vienumu vērtības tiek iegūtas no VMware veiktspējas skaitītājiem, un VMwarePerfFrequency [parametrs](/manual/appendix/config/zabbix_server#vmwareperffrequency) tiek izmantots, lai atsvaidzinātu to datus Zabbix VMware kešatmiņā: - vmware.cl.perfcounter - vmware.hv.datastore.read - vmware.hv.datastore.write - vmware.hv.network.in - vmware.hv.network.out - vmware.hv.perfcounter - vmware.vm.cpu.ready - vmware.vm.net.if.in - vmware.vm.net.if.out - vmware.vm.perfcounter - vmware.vm.vfs.dev.read - vmware.vm.vfs.dev.write ##### Footnotes ^**1**^ The `{HOST.*}` macros supported in item key parameters will resolve to the interface that is selected for the item. When used in items without interfaces they will resolve to either the Zabbix agent, SNMP, JMX or IPMI interface of the host in this order of priority or to 'UNKNOWN' if the host does not have any interface. ^**2**^ In global scripts, interface IP/DNS fields and web scenarios the macro will resolve to the main agent interface. If an agent interface is not defined, the main SNMP interface will be used. If an SNMP interface is also not defined, the main JMX interface will be used. If a JMX interface is not defined either, the main IPMI interface will be used. If the host does not have any interface, the macro resolves to 'UNKNOWN'. ^**3**^ Only a single **avg**, **last**, **max**, **min** function with seconds as parameter (time [suffixes](/manual/appendix/suffixes) can be used) is supported in this macro in map labels. ```default # Example usage: {?avg(/{HOST.HOST}/item.key,1h)} # Unsupported usage: {?last(/host/item1)/last(/host/item2)} {?last(/host/item1)*10} {?count(/host/item1,5m)} ``` ^**4**^ `{HOST.*}` macros are supported in web scenario *Variables*, *Headers*, *SSL certificate file* and *SSL key file* fields and in scenario step *URL*, *Post*, *Headers* and *Required string* fields. Since Zabbix 5.2.2, `{HOST.*}` macros are no longer supported in web scenario *Name* and web scenario step *Name* fields. ^**5**^ Only a single **avg**, **last**, **max**, **min** function with seconds as parameter (time [suffixes](/manual/appendix/suffixes) can be used) is supported within this macro in graph names (see examples in footnote 3). The {HOST.HOST<1-9>} macro can be used as host within the macro (see also [indexed macros](#indexed-macros)). ^**6**^ Supported in Script-type items and Browser-type items and manual host action scripts for Zabbix server and Zabbix proxy. ##### Piezīmes ^**1**^ `{HOST.*}` makro, kas tiek atbalstīti vienuma atslēgas parametros, tiks atrisināti uz interfeisu, kas ir izvēlēts vienumam. Ja tos izmanto vienumos bez interfeisiem, tie tiks atrisināti uz hosta Zabbix aģenta, SNMP, JMX vai IPMI interfeisu šādā prioritātes secībā, vai uz 'UNKNOWN', ja hostam nav neviena interfeisa. ^**2**^ Globālajos skriptos, interfeisa IP/DNS laukos un tīmekļa scenārijos makro tiks atrisināts uz galveno aģenta interfeisu. Ja aģenta interfeiss nav definēts, tiks izmantots galvenais SNMP interfeiss. Ja arī SNMP interfeiss nav definēts, tiks izmantots galvenais JMX interfeiss. Ja JMX interfeiss arī nav definēts, tiks izmantots galvenais IPMI interfeiss. Ja hostam nav neviena interfeisa, makro tiek atrisināts uz 'UNKNOWN'. ^**3**^ Šajā makro kartes etiķetēs tiek atbalstīta tikai viena **avg**, **last**, **max**, **min** funkcija ar sekundēm kā parametru (var izmantot laika [sufiksus](/manual/appendix/suffixes)). ```default # Piemērs: {?avg(/{HOST.HOST}/item.key,1h)} # Neatbalstīts lietojums: {?last(/host/item1)/last(/host/item2)} {?last(/host/item1)*10} {?count(/host/item1,5m)} ``` ^**4**^ `{HOST.*}` makro tiek atbalstīti tīmekļa scenārija laukos *Variables*, *Headers*, *SSL certificate file* un *SSL key file*, kā arī scenārija soļu laukos *URL*, *Post*, *Headers* un *Required string*. Kopš Zabbix 5.2.2 `{HOST.*}` makro vairs netiek atbalstīti tīmekļa scenārija laukos *Name* un tīmekļa scenārija soļu laukos *Name*. ^**5**^ Šajā makro grafiku nosaukumos tiek atbalstīta tikai viena **avg**, **last**, **max**, **min** funkcija ar sekundēm kā parametru (var izmantot laika [sufiksus](/manual/appendix/suffixes); skatiet piemērus 3. piezīmē). Makro {HOST.HOST<1-9>} var izmantot kā hostu makro iekšpusē (skatiet arī [indeksētos makro](#indexed-macros)). ^**6**^ Atbalstīts Script tipa vienumos un Browser tipa vienumos, kā arī manuālos hosta darbību skriptos Zabbix serverim un Zabbix starpniekserverim. ##### ForceActiveChecksOnStart Perform active checks immediately after the restart for the first received configuration. Also available as a per-plugin configuration parameter, for example: `Plugins.Uptime.System.ForceActiveChecksOnStart=1` Default: `0`<br> Values: 0 - disabled, 1 - enabled ##### ForceActiveChecksOnStart Veic aktīvās pārbaudes nekavējoties pēc restartēšanas, saņemot pirmo konfigurāciju. Pieejams arī kā katra spraudņa konfigurācijas parametrs, piemēram: `Plugins.Uptime.System.ForceActiveChecksOnStart=1` Noklusējums: `0`<br> Vērtības: 0 - atspējots, 1 - iespējots ##### ForceActiveChecksOnStart Perform active checks immediately after the restart for the first received configuration. Also available as a per-plugin configuration parameter, for example: `Plugins.Uptime.System.ForceActiveChecksOnStart=1` Default: `0`<br> Values: 0 - disabled, 1 - enabled ##### ForceActiveChecksOnStart Veic aktīvās pārbaudes nekavējoties pēc restartēšanas, saņemot pirmo konfigurāciju. Pieejams arī kā katra spraudņa konfigurācijas parametrs, piemēram: `Plugins.Uptime.System.ForceActiveChecksOnStart=1` Noklusējums: `0`<br> Vērtības: 0 - atspējots, 1 - iespējots ##### forecast(/host/key,(sec|#num)<:time shift>,time,<fit>,<mode>) {#forecast} The future value, max, min, delta or avg of the item.<br> Supported value types: *Float*, *Integer*. Parameters: - See [common parameters](#common-parameters);<br> - **time** - the forecasting horizon in seconds (time suffixes can be used); negative values are supported;<br> - **fit** (optional; must be double-quoted) - the function used to fit historical data. Supported fits:<br>*linear* - linear function (default)<br>*polynomialN* - polynomial of degree N (1 <= N <= 6)<br>*exponential* - exponential function<br>*logarithmic* - logarithmic function<br>*power* - power function<br>Note that *polynomial1* is equivalent to *linear*; - **mode** (optional; must be double-quoted) - the demanded output. Supported modes:<br>*value* - value (default)<br>*max* - maximum<br>*min* - minimum<br>*delta* - *max*-*min*<br>*avg* - average<br>Note that *value* estimates the item value at the moment `now` + `time`; *max*, *min*, *delta* and *avg* investigate the item value estimate on the interval between `now` and `now` + `time`. Comments: - If the value to return is larger than 1.7976931348623158E+308 or less than -1.7976931348623158E+308, the return value is cropped to 1.7976931348623158E+308 or -1.7976931348623158E+308 correspondingly; - Becomes unsupported only if misused in the expression (wrong item type, invalid parameters), otherwise returns -1 in case of errors; - See also additional information on [predictive trigger functions](/manual/config/triggers/prediction). Examples: forecast(/host/key,#10,1h) #forecast the item value in one hour based on the last 10 values forecast(/host/key,1h,30m) #forecast the item value in 30 minutes based on the last hour data forecast(/host/key,1h:now-1d,12h) #forecast the item value in 12 hours based on one hour one day ago forecast(/host/key,1h,10m,"exponential") #forecast the item value in 10 minutes based on the last hour data and exponential function forecast(/host/key,1h,2h,"polynomial3","max") #forecast the maximum value the item can reach in the next two hours based on last hour data and cubic (third degree) polynomial forecast(/host/key,#2,-20m) #estimate the item value 20 minutes ago based on the last two values (this can be more precise than using last(), especially if the item is updated rarely, say, once an hour) ##### forecast(/host/key,(sec|#num)<:time shift>,time,<fit>,<mode>) {#forecast} Vienuma nākotnes vērtība, maksimums, minimums, delta vai vidējā vērtība.<br> Atbalstītie vērtību tipi: *Float*, *Integer*. Parametri: - Skatiet [kopīgos parametrus](#common-parameters);<br> - **time** - prognozēšanas horizonts sekundēs (var izmantot laika sufiksus); tiek atbalstītas arī negatīvas vērtības;<br> - **fit** (neobligāts; jāliek dubultpēdiņās) - funkcija, ko izmanto vēsturisko datu pielāgošanai. Atbalstītās pielāgošanas funkcijas:<br>*linear* - lineāra funkcija (noklusējums)<br>*polynomialN* - N pakāpes polinoms (1 <= N <= 6)<br>*exponential* - eksponenciāla funkcija<br>*logarithmic* - logaritmiska funkcija<br>*power* - pakāpes funkcija<br>Ņemiet vērā, ka *polynomial1* ir ekvivalents *linear*; - **mode** (neobligāts; jāliek dubultpēdiņās) - pieprasītā izvade. Atbalstītie režīmi:<br>*value* - vērtība (noklusējums)<br>*max* - maksimums<br>*min* - minimums<br>*delta* - *max*-*min*<br>*avg* - vidējā vērtība<br>Ņemiet vērā, ka *value* novērtē vienuma vērtību brīdī `now` + `time`; *max*, *min*, *delta* un *avg* analizē vienuma vērtības novērtējumu intervālā starp `now` un `now` + `time`. Komentāri: - Ja atgriežamā vērtība ir lielāka par 1.7976931348623158E+308 vai mazāka par -1.7976931348623158E+308, atgrieztā vērtība tiek attiecīgi ierobežota līdz 1.7976931348623158E+308 vai -1.7976931348623158E+308; - Kļūst neatbalstīts tikai nepareizas izmantošanas gadījumā izteiksmē (nepareizs vienuma tips, nederīgi parametri), pretējā gadījumā kļūdu gadījumā atgriež -1; - Skatiet arī papildu informāciju par [prognozējošajām trigeru funkcijām](/manual/config/triggers/prediction). Piemēri: forecast(/host/key,#10,1h) #prognozē vienuma vērtību pēc vienas stundas, pamatojoties uz pēdējām 10 vērtībām forecast(/host/key,1h,30m) #prognozē vienuma vērtību pēc 30 minūtēm, pamatojoties uz pēdējās stundas datiem forecast(/host/key,1h:now-1d,12h) #prognozē vienuma vērtību pēc 12 stundām, pamatojoties uz vienas stundas datiem pirms vienas dienas forecast(/host/key,1h,10m,"exponential") #prognozē vienuma vērtību pēc 10 minūtēm, pamatojoties uz pēdējās stundas datiem un eksponenciālu funkciju forecast(/host/key,1h,2h,"polynomial3","max") #prognozē maksimālo vērtību, ko vienums var sasniegt nākamo divu stundu laikā, pamatojoties uz pēdējās stundas datiem un kubisku (trešās pakāpes) polinomu forecast(/host/key,#2,-20m) #novērtē vienuma vērtību pirms 20 minūtēm, pamatojoties uz pēdējām divām vērtībām (tas var būt precīzāk nekā izmantot last(), īpaši, ja vienums tiek atjaunināts reti, piemēram, reizi stundā) ##### Forecasting horizon (**forecast** only)<br> Parameter `time` specifies how far in the future Zabbix should extrapolate dependencies it finds in historic data. No matter if you use `time_shift` or not, `time` is always counted starting from the current moment. ##### Prognozēšanas horizonts (tikai **prognoze**)<br> Parametrs `time` nosaka, cik tālu nākotnē Zabbix vajadzētu ekstrapolēt atkarības, ko tas atrod vēsturiskajos datos. Neatkarīgi no tā, vai izmantojat `time_shift` vai nē, `time` vienmēr tiek skaitīts, sākot no pašreizējā brīža. For information about specific vault provider configuration, see: - [HashiCorp configuration](/manual/config/secrets/hashicorp) - [CyberArk configuration](/manual/config/secrets/cyberark) Informāciju par konkrēta glabātuves nodrošinātāja konfigurāciju skatiet: - [HashiCorp konfigurācija](/manual/config/secrets/hashicorp) - [CyberArk konfigurācija](/manual/config/secrets/cyberark) #### Format-specific notes #### Formātam specifiskas piezīmes #### Form buttons Buttons at the bottom of the form allow to perform several operations. | | | |--|--------| ||Add a discovery rule. This button is only available for new discovery rules.| ||Update the properties of a discovery rule. This button is only available for existing discovery rules.| ||Create another discovery rule based on the properties of the current discovery rule.| ||Perform discovery based on the discovery rule immediately. The discovery rule must already exist. See [more details](/manual/config/items/check_now).<br>*Note* that when performing discovery immediately, configuration cache is not updated, thus the result will not reflect very recent changes to discovery rule configuration.| ||Test the discovery rule configuration. Use this button to verify the configuration settings (such as connectivity and parameter correctness) without permanently applying any changes.| ||Delete the discovery rule.| ||Cancel the editing of discovery rule properties.| #### Veidlapas pogas Pogas veidlapas apakšdaļā ļauj veikt vairākas darbības. | | | |--|--------| ||Pievienot atklāšanas kārtulu. Šī poga ir pieejama tikai jaunām atklāšanas kārtulām.| ||Atjaunināt atklāšanas kārtulas rekvizītus. Šī poga ir pieejama tikai esošām atklāšanas kārtulām.| ||Izveidot citu atklāšanas kārtulu, pamatojoties uz pašreizējās atklāšanas kārtulas rekvizītiem.| ||Nekavējoties veikt atklāšanu, pamatojoties uz atklāšanas kārtulu. Atklāšanas kārtulai jau ir jāeksistē. Skatiet [vairāk informācijas](/manual/config/items/check_now).<br>*Piezīme:* veicot atklāšanu nekavējoties, konfigurācijas kešatmiņa netiek atjaunināta, tādēļ rezultāts neatspoguļos pavisam nesenās izmaiņas atklāšanas kārtulas konfigurācijā.| ||Pārbaudīt atklāšanas kārtulas konfigurāciju. Izmantojiet šo pogu, lai pārbaudītu konfigurācijas iestatījumus (piemēram, savienojamību un parametru pareizību), pastāvīgi nepiemērojot nekādas izmaiņas.| ||Dzēst atklāšanas kārtulu.| ||Atcelt atklāšanas kārtulas rekvizītu rediģēšanu.| #### Form buttons Buttons at the bottom of the form allow to perform several operations. | | | |--|--------| ||Add an item. This button is only available for new items.| ||Update the properties of an item.| ||Create another item based on the properties of the current item.| ||Execute a check for a new item value immediately. Supported for **passive** checks only (see [more details](/manual/config/items/check_now)).<br>*Note* that when checking for a value immediately, configuration cache is not updated, thus the value will not reflect very recent changes to item configuration.| ||Test if item configuration is correct by getting a value.| ||Delete the item history and trends.| ||Delete the item.| ||Cancel the editing of item properties.| #### Veidlapas pogas Pogas veidlapas apakšdaļā ļauj veikt vairākas darbības. | | | |--|--------| ||Pievienot vienumu. Šī poga ir pieejama tikai jauniem vienumiem.| ||Atjaunināt vienuma rekvizītus.| ||Izveidot citu vienumu, pamatojoties uz pašreizējā vienuma rekvizītiem.| ||Nekavējoties izpildīt pārbaudi jaunai vienuma vērtībai. Atbalstīts tikai **pasīvajām** pārbaudēm (skatiet [sīkāku informāciju](/manual/config/items/check_now)).<br>*Ņemiet vērā*, ka, nekavējoties pārbaudot vērtību, konfigurācijas kešatmiņa netiek atjaunināta, tādēļ vērtība neatspoguļos pavisam nesenās izmaiņas vienuma konfigurācijā.| ||Pārbaudīt, vai vienuma konfigurācija ir pareiza, iegūstot vērtību.| ||Dzēst vienuma vēsturi un tendences.| ||Dzēst vienumu.| ||Atcelt vienuma rekvizītu rediģēšanu.| ##### Form buttons Buttons at the bottom of the form allow to perform several operations. | | | |--|--------| ||Add a report. This button is only available for new reports.| ||Update the properties of a report.| ||Create another report based on the properties of the current report.| ||Test if report configuration is correct by sending a report to the current user.| ||Delete the report.| ||Cancel the editing of report properties.| ##### Veidlapas pogas Pogas veidlapas apakšdaļā ļauj veikt vairākas darbības. | | | |--|--------| ||Pievienot atskaiti. Šī poga ir pieejama tikai jaunām atskaitēm.| ||Atjaunināt atskaites īpašības.| ||Izveidot citu atskaiti, pamatojoties uz pašreizējās atskaites īpašībām.| ||Pārbaudīt, vai atskaites konfigurācija ir pareiza, nosūtot atskaiti pašreizējam lietotājam.| ||Dzēst atskaiti.| ||Atcelt atskaites īpašību rediģēšanu.| For new templates and changes to existing templates, see [Template changes](/manual/installation/template_changes#changes-in-7.0.1). Jaunām veidnēm un esošo veidņu izmaiņām skatiet [Veidņu izmaiņas](/manual/installation/template_changes#changes-in-7.0.1). For new templates and changes to existing templates, see [Template changes](/manual/installation/template_changes#changes-in-7.0.2). Jaunām veidnēm un esošo veidņu izmaiņām skatiet [Veidņu izmaiņas](/manual/installation/template_changes#changes-in-7.0.2). For new templates and changes to existing templates, see [Template changes](/manual/installation/template_changes#changes-in-7.0.4). Jaunām veidnēm un esošo veidņu izmaiņām skatiet [Veidņu izmaiņas](/manual/installation/template_changes#changes-in-7.0.4). ##### Fping6Location The location of fping6. Make sure that the fping6 binary has root ownership and the SUID flag set. Make empty (`Fping6Location=`) if your fping utility is capable to process IPv6 addresses. Default: `/usr/sbin/fping6` ##### Fping6Location fping6 atrašanās vieta. Pārliecinieties, ka fping6 binārajam failam ir root īpašnieks un ir iestatīts SUID karodziņš. Atstājiet tukšu (`Fping6Location=`), ja jūsu fping utilīta spēj apstrādāt IPv6 adreses. Noklusējums: `/usr/sbin/fping6` ##### Fping6Location The location of fping6. Make sure that the fping6 binary has root ownership and the SUID flag set. Make empty (`Fping6Location=`) if your fping utility is capable to process IPv6 addresses. Default: `/usr/sbin/fping6` ##### Fping6Location fping6 atrašanās vieta. Pārliecinieties, ka fping6 binārajam failam ir root īpašumtiesības un ir iestatīts SUID karodziņš. Atstājiet tukšu (`Fping6Location=`), ja jūsu fping utilīta spēj apstrādāt IPv6 adreses. Noklusējums: `/usr/sbin/fping6` ##### FpingLocation The location of fping. Make sure that the fping binary has root ownership and the SUID flag set. Default: `/usr/sbin/fping` ##### FpingLocation fping atrašanās vieta. Pārliecinieties, ka fping binārajam failam ir root īpašnieks un ir iestatīts SUID karodziņš. Noklusējums: `/usr/sbin/fping` ##### FpingLocation The location of fping. Make sure that the fping binary has root ownership and the SUID flag set. Default: `/usr/sbin/fping` ##### FpingLocation fping atrašanās vieta. Pārliecinieties, ka fping binārajam failam ir root īpašumtiesības un ir iestatīts SUID karodziņš. Noklusējums: `/usr/sbin/fping` #### Frame selection in browser items [Browser items](/manual/config/items/itemtypes/browser) now support a new [method](/manual/config/items/preprocessing/javascript/browser_item_javascript_objects) browser.switchFrame() for switching to a specific frame specified in the method parameters. #### Rāmja izvēle pārlūka vienumos [Pārlūka vienumi](/manual/config/items/itemtypes/browser) tagad atbalsta jaunu [metodi](/manual/config/items/preprocessing/javascript/browser_item_javascript_objects) browser.switchFrame(), kas ļauj pārslēgties uz konkrētu rāmi, kas norādīts metodes parametros. #### FreeBSD See values supported for 'memtype' parameter on FreeBSD in the table. |Supported value|Description|Source in kinfo\_proc structure|Tries to be compatible with| |--|------|--|--| |vsize|Virtual memory size|kp\_eproc.e\_vm.vm\_map.size or ki\_size|ps -o vsz| |pmem|Percentage of real memory|calculated from rss|ps -o pmem| |rss|Resident set size|kp\_eproc.e\_vm.vm\_rssize or ki\_rssize|ps -o rss| |size ^[1](proc_mem_notes#footnotes)^|Size of process (code + data + stack)|tsize + dsize + ssize| | |tsize|Text (code) size|kp\_eproc.e\_vm.vm\_tsize or ki\_tsize|ps -o tsiz| |dsize|Data size|kp\_eproc.e\_vm.vm\_dsize or ki\_dsize|ps -o dsiz| |ssize|Stack size|kp\_eproc.e\_vm.vm\_ssize or ki\_ssize|ps -o ssiz| #### FreeBSD Skatiet FreeBSD atbalstītās parametra 'memtype' vērtības tabulā. |Atbalstītā vērtība|Apraksts|Avots struktūrā kinfo\_proc|Mēģina būt saderīgs ar| |--|------|--|--| |vsize|Virtuālās atmiņas izmērs|kp\_eproc.e\_vm.vm\_map.size vai ki\_size|ps -o vsz| |pmem|Reālās atmiņas procentuālā daļa|aprēķināts no rss|ps -o pmem| |rss|Rezidentās kopas izmērs|kp\_eproc.e\_vm.vm\_rssize vai ki\_rssize|ps -o rss| |size ^[1](proc_mem_notes#footnotes)^|Procesa izmērs (kods + dati + steks)|tsize + dsize + ssize| | |tsize|Teksta (koda) izmērs|kp\_eproc.e\_vm.vm\_tsize vai ki\_tsize|ps -o tsiz| |dsize|Datu izmērs|kp\_eproc.e\_vm.vm\_dsize vai ki\_dsize|ps -o dsiz| |ssize|Steka izmērs|kp\_eproc.e\_vm.vm\_ssize vai ki\_ssize|ps -o ssiz| ## Frontend ## Lietotāja saskarne ## Frontend ## Lietotāja saskarne ## Frontend ## Lietotāja saskarne #### Frontend access By default, access to the frontend is allowed from anywhere. The frontend can be accessed at *http://<host>*. This can be customized in **/etc/nginx/conf.d/zabbix.conf**. Nginx has to be restarted after modifying this file. To do so, log in using SSH as **root** user and execute: systemctl restart nginx #### Lietotāja saskarnei piekļuve Pēc noklusējuma piekļuve lietotāja saskarnei ir atļauta no jebkuras vietas. Lietotāja saskarnei var piekļūt vietnē *http://<host>*. To var pielāgot failā **/etc/nginx/conf.d/zabbix.conf**. Pēc šī faila modificēšanas Nginx ir jāpārstartē. Lai to izdarītu, piesakieties, izmantojot SSH, kā **root** lietotājs, un izpildiet: systemctl restart nginx **Frontend configuration** Create an action in the frontend, using some hard-to-guess secret code to disallow unwanted hosts: - Name: Autoregistration action Linux - Conditions: - Type of calculation: AND - Condition (A): Host metadata contains //Linux// - Condition (B): Host metadata contains //21df83bf21bf0be663090bb8d4128558ab9b95fba66a6dbf834f8b91ae5e08ae// - Operations: - Send message to users: Admin via all media - Add to host groups: Linux servers - Link templates: Linux by Zabbix agent Please note that this method alone does not provide strong protection because data is transmitted in plain text. Configuration cache reload is required for changes to have an immediate effect. **Lietotāja saskarnes konfigurācija** Izveidojiet darbību lietotāja saskarnē, izmantojot grūti uzminamu slepeno kodu, lai liegtu nevēlamiem hostiem reģistrēties: - Nosaukums: Linux automātiskās reģistrācijas darbība - Nosacījumi: - Aprēķina veids: AND - Nosacījums (A): Hosta metadati satur //Linux// - Nosacījums (B): Hosta metadati satur //21df83bf21bf0be663090bb8d4128558ab9b95fba66a6dbf834f8b91ae5e08ae// - Darbības: - Sūtīt ziņojumu lietotājiem: Admin, izmantojot visus datu nesējus - Pievienot hostu grupām: Linux serveri - Piesaistīt veidnes: Linux by Zabbix aģents Lūdzu, ņemiet vērā, ka šī metode viena pati nenodrošina spēcīgu aizsardzību, jo dati tiek pārraidīti atklātā tekstā. Lai izmaiņas stātos spēkā nekavējoties, ir nepieciešama konfigurācijas kešatmiņas pārlāde. #### Frontend configuration Loadable modules are supported by Zabbix agent, server and proxy. Therefore, item type in Zabbix frontend depends on where the module is loaded. If the module is loaded into the agent, then the item type should be "Zabbix agent" or "Zabbix agent (active)". If the module is loaded into server or proxy, then the item type should be "Simple check". History export through Zabbix modules does not need any frontend configuration. If the module is successfully loaded by server and provides **zbx\_module\_history\_write\_cbs()** function which returns at least one non-NULL callback function then history export will be enabled automatically. #### Lietotāja saskarnes konfigurācija Ielādējamie moduļi tiek atbalstīti Zabbix aģentā, serverī un starpniekserverī. Tāpēc vienuma tips Zabbix lietotāja saskarnē ir atkarīgs no tā, kur modulis ir ielādēts. Ja modulis ir ielādēts aģentā, tad vienuma tipam jābūt "Zabbix aģents" vai "Zabbix aģents (aktīvs)". Ja modulis ir ielādēts serverī vai starpniekserverī, tad vienuma tipam jābūt "Vienkārša pārbaude". Vēstures eksportam caur Zabbix moduļiem nav nepieciešama nekāda lietotāja saskarnes konfigurācija. Ja moduli serveris ir veiksmīgi ielādējis un tas nodrošina funkciju **zbx\_module\_history\_write\_cbs()**, kas atgriež vismaz vienu callback funkciju, kas nav NULL, tad vēstures eksports tiks iespējots automātiski. **Frontend configuration** The first thing to do is to configure the frontend. Create 2 actions. The first action: - Name: Linux host autoregistration - Conditions: Host metadata contains *Linux* - Operations: Link templates: Linux by Zabbix agent ::: noteclassic You can skip an "Add host" operation in this case. Linking a template to a host requires adding the host first so the server will do that automatically. ::: The second action: - Name: Windows host autoregistration - Conditions: Host metadata contains *Windows* - Operations: Link templates: Windows by Zabbix agent **Lietotāja saskarnes konfigurācija** Pirmā lieta, kas jādara, ir konfigurēt lietotāja saskarni. Izveidojiet 2 darbības. Pirmā darbība: - Nosaukums: Linux hosta automātiskā reģistrācija - Nosacījumi: Hosta metadati satur *Linux* - Darbības: Saistīt veidnes: Linux by Zabbix aģents ::: noteclassic Šajā gadījumā varat izlaist darbību "Pievienot hostu". Lai saistītu veidni ar hostu, vispirms ir jāpievieno hosts, tāpēc serveris to izdarīs automātiski. ::: Otrā darbība: - Nosaukums: Windows hosta automātiskā reģistrācija - Nosacījumi: Hosta metadati satur *Windows* - Darbības: Saistīt veidnes: Windows by Zabbix aģents **Frontend configuration** Update the action in the frontend: - Name: Autoregistration action Linux - Conditions: - Type of calculation: AND - Condition (A): Host metadata contains Linux - Condition (B): Host metadata contains 21df83bf21bf0be663090bb8d4128558ab9b95fba66a6dbf834f8b91ae5e08ae - Condition (C): Host metadata contains MySQL - Operations: - Send message to users: Admin via all media - Add to host groups: Linux servers - Link templates: Linux by Zabbix agent - Link templates: MySQL by Zabbix Agent **Lietotāja saskarnes konfigurācija** Atjauniniet darbību lietotāja saskarnē: - Nosaukums: Linux autoreģistrācijas darbība - Nosacījumi: - Aprēķina veids: AND - Nosacījums (A): Hosta metadati satur Linux - Nosacījums (B): Hosta metadati satur 21df83bf21bf0be663090bb8d4128558ab9b95fba66a6dbf834f8b91ae5e08ae - Nosacījums (C): Hosta metadati satur MySQL - Operācijas: - Sūtīt ziņojumu lietotājiem: Admin, izmantojot visus datu nesējus - Pievienot hostu grupām: Linux serveri - Piesaistīt veidnes: Linux by Zabbix aģents - Piesaistīt veidnes: MySQL by Zabbix Agent ##### Frontend configuration with Kerberos/ADFS The Zabbix frontend configuration file (*zabbix.conf.php*) can be used to configure SSO with Kerberos authentication and ADFS: ```php $SSO['SETTINGS'] = [ 'security' => [ 'requestedAuthnContext' => [ 'urn:oasis:names:tc:SAML:2.0:ac:classes:Kerberos', ], 'requestedAuthnContextComparison' => 'exact' ] ]; ``` In this case, in the SAML configuration *SP name ID* field set: urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified ##### Lietotāja saskarnes konfigurācija ar Kerberos/ADFS Zabbix lietotāja saskarnes konfigurācijas failu (*zabbix.conf.php*) var izmantot, lai konfigurētu SSO ar Kerberos autentifikāciju un ADFS: ```php $SSO['SETTINGS'] = [ 'security' => [ 'requestedAuthnContext' => [ 'urn:oasis:names:tc:SAML:2.0:ac:classes:Kerberos', ], 'requestedAuthnContextComparison' => 'exact' ] ]; ``` Šajā gadījumā SAML konfigurācijas laukā *SP name ID* iestatiet: urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified #### Frontend customization #### Lietotāja saskarnes pielāgošana ### Frontend help A help link  is provided in Zabbix frontend forms with direct links to the corresponding parts of the documentation. ### Lietotāja saskarnes palīdzība Palīdzības saite  ir pieejama Zabbix lietotāja saskarnes formās ar tiešām saitēm uz atbilstošajām dokumentācijas daļām. ##### Frontend modules [Frontend modules](/manual/extensions/frontendmodules) provide an option to extend Zabbix frontend functionality by adding third-party modules or by developing your own. With frontend modules you can add new menu items, their respective views, actions, etc. ##### Lietotāja saskarnes moduļi [Lietotāja saskarnes moduļi](/manual/extensions/frontendmodules) nodrošina iespēju paplašināt Zabbix lietotāja saskarnes funkcionalitāti, pievienojot trešo pušu moduļus vai izstrādājot savus. Ar lietotāja saskarnes moduļiem varat pievienot jaunus izvēlnes vienumus, tiem atbilstošos skatus, darbības u.c. ##### Frontend The minimum supported screen width for Zabbix frontend is 1200px. If stated as mandatory, the required software/library is strictly necessary. Optional ones are needed for supporting some specific function. |Software|Mandatory status|Supported versions|Comments| |--|-|-|------| |*PHP*|Yes|8.0.0 - 8.5.X|Added support for PHP versions:<br>- 8.4.X since Zabbix 7.0.10;<br>- 8.5.X since Zabbix 7.0.25.| |*Apache*|One of|2.4 or later| | |*Nginx*|^|1.20 or later| | |*MySQL*|One of|See [Third-party external surrounding software](/manual/installation/requirements#thirdparty-external-surrounding-software)| | |*PostgreSQL*|^|^| | |*Oracle*|^|^| | |***PHP extensions***|<|<|<| |*mysqli*|Yes| |Required if MySQL is used as Zabbix backend database.| |*pgsql*|^| |Required if PostgreSQL is used as Zabbix backend database.| |*oci8*|^| |Required if Oracle is used as Zabbix backend database.| |*bcmath*|^| |php-bcmath (*--enable-bcmath*)| |*mbstring*|^| |php-mbstring (*--enable-mbstring*)| |*sockets*|^| |php-net-socket (*--enable-sockets*); required for user script support.| |*gd*|^|2.0.28 or later|php-gd (if provided as a separate package by the distributor); PHP GD extension must support PNG images (*--with-png-dir*), JPEG images (*--with-jpeg-dir*), and FreeType 2 (*--with-freetype-dir*). Version 2.3.0 or later may be required to avoid possible [text overlapping in graphs](/manual/installation/known_issues#text-overlapping) for some frontend languages.| |*libxml*|^|2.6.15 or later|php-xml (if provided as a separate package by the distributor)| |*xmlwriter*|^| |php-xmlwriter (if provided as a separate package by the distributor)| |*xmlreader*|^| |php-xmlreader (if provided as a separate package by the distributor)| |*ctype*|^| |php-ctype (*--enable-ctype*)| |*session*|^| |php-session (if provided as a separate package by the distributor)| |*ldap*|No| |php-ldap; required for LDAP authentication.| |*openssl*|^| |php-openssl; required for SAML authentication.| |*gettext*|^| |php-gettext (*--with-gettext*); required for translations.| |*cURL*|^| |php-curl; required for Duo Universal Prompt [MFA](/manual/web_interface/frontend_sections/users/authentication/mfa).| Third-party frontend libraries that are supplied with Zabbix: |Library|Mandatory status|Supplied version|Comments| |--|-|-|------| |[jQuery JavaScript Library](https://jquery.com/)|Yes|3.6.0|JavaScript library that simplifies the process of cross-browser development.| |[jQuery UI](https://jqueryui.com/)|^|1.12.1|A set of user interface interactions, effects, widgets, and themes built on top of jQuery.| |[SAML PHP Toolkit](https://github.com/onelogin/php-saml)|^|4.3.1|A PHP toolkit that adds SAML 2.0 authentication support to be able to sign in to Zabbix.<br><br>Supplied version history:<br>- 4.0.0 since Zabbix 7.0.0;<br>- 4.3.1 since Zabbix 7.0.24 (recommended).| |[Duo Universal PHP library](https://github.com/duosecurity/duo_universal_php)|^|1.1.2|A PHP library that adds Duo Universal Prompt multi-factor authentication support for Zabbix.<br><br>Supplied version history:<br>- 1.0.2 since Zabbix 7.0.0;<br>- 1.1.0 since Zabbix 7.0.23;<br>- 1.1.2 since Zabbix 7.0.26 (recommended).| |[Symfony Yaml Component](https://symfony.com/doc/current/components/yaml.html)|^|5.1.0|Adds support to export and import Zabbix configuration elements in the YAML format.| ::: noteclassic Zabbix may work on previous versions of Apache, MySQL, Oracle, and PostgreSQL as well. ::: ::: noteimportant For other fonts than the default DejaVu, PHP function [imagerotate](http://php.net/manual/en/function.imagerotate.php) might be required. If it is missing, these fonts might be rendered incorrectly when a graph is displayed. This function is only available if PHP is compiled with bundled GD, which is not the case in Debian and other distributions. ::: Third-party libraries used for writing and debugging Zabbix frontend code: |Library|Mandatory status|Minimum version|Description| |--|-|-|------| |[Composer](https://getcomposer.org/)|No|2.4.1|An application-level package manager for PHP that provides a standard format for managing dependencies of PHP software and required libraries.| |[PHPUnit](https://phpunit.de/)|^|8.5.29|A PHP unit testing framework for testing Zabbix frontend.| |[SASS](https://sass-lang.com/)|^|3.4.22|A preprocessor scripting language that is interpreted and compiled into Cascading Style Sheets (CSS).| ##### Lietotāja saskarne Zabbix lietotāja saskarnei minimālais atbalstītais ekrāna platums ir 1200px. Ja norādīts kā obligāts, attiecīgā programmatūra/bibliotēka ir stingri nepieciešama. Papildu komponenti ir nepieciešami, lai atbalstītu kādu konkrētu funkciju. |Software|Mandatory status|Supported versions|Comments| |--|-|-|------| |*PHP*|Yes|8.0.0 - 8.5.X|Pievienots atbalsts PHP versijām:<br>- 8.4.X kopš Zabbix 7.0.10;<br>- 8.5.X kopš Zabbix 7.0.25.| |*Apache*|One of|2.4 or later| | |*Nginx*|^|1.20 or later| | |*MySQL*|One of|See [Third-party external surrounding software](/manual/installation/requirements#thirdparty-external-surrounding-software)| | |*PostgreSQL*|^|^| | |*Oracle*|^|^| | |***PHP extensions***|<|<|<| |*mysqli*|Yes| |Nepieciešams, ja MySQL tiek izmantots kā Zabbix aizmugursistēmas datubāze.| |*pgsql*|^| |Nepieciešams, ja PostgreSQL tiek izmantots kā Zabbix aizmugursistēmas datubāze.| |*oci8*|^| |Nepieciešams, ja Oracle tiek izmantots kā Zabbix aizmugursistēmas datubāze.| |*bcmath*|^| |php-bcmath (*--enable-bcmath*)| |*mbstring*|^| |php-mbstring (*--enable-mbstring*)| |*sockets*|^| |php-net-socket (*--enable-sockets*); nepieciešams lietotāja skriptu atbalstam.| |*gd*|^|2.0.28 or later|php-gd (ja izplatītājs to nodrošina kā atsevišķu pakotni); PHP GD paplašinājumam jāatbalsta PNG attēli (*--with-png-dir*), JPEG attēli (*--with-jpeg-dir*) un FreeType 2 (*--with-freetype-dir*). Var būt nepieciešama 2.3.0 vai jaunāka versija, lai izvairītos no iespējamas [teksta pārklāšanās grafikos](/manual/installation/known_issues#text-overlapping) dažām lietotāja saskarnes valodām.| |*libxml*|^|2.6.15 or later|php-xml (ja izplatītājs to nodrošina kā atsevišķu pakotni)| |*xmlwriter*|^| |php-xmlwriter (ja izplatītājs to nodrošina kā atsevišķu pakotni)| |*xmlreader*|^| |php-xmlreader (ja izplatītājs to nodrošina kā atsevišķu pakotni)| |*ctype*|^| |php-ctype (*--enable-ctype*)| |*session*|^| |php-session (ja izplatītājs to nodrošina kā atsevišķu pakotni)| |*ldap*|No| |php-ldap; nepieciešams LDAP autentifikācijai.| |*openssl*|^| |php-openssl; nepieciešams SAML autentifikācijai.| |*gettext*|^| |php-gettext (*--with-gettext*); nepieciešams tulkojumiem.| |*cURL*|^| |php-curl; nepieciešams Duo Universal Prompt [MFA](/manual/web_interface/frontend_sections/users/authentication/mfa).| Trešo pušu lietotāja saskarnes bibliotēkas, kas tiek piegādātas kopā ar Zabbix: |Library|Mandatory status|Supplied version|Comments| |--|-|-|------| |[jQuery JavaScript Library](https://jquery.com/)|Yes|3.6.0|JavaScript bibliotēka, kas vienkāršo starp pārlūkprogrammām saderīgas izstrādes procesu.| |[jQuery UI](https://jqueryui.com/)|^|1.12.1|Lietotāja saskarnes mijiedarbību, efektu, logrīku un motīvu kopums, kas veidots uz jQuery bāzes.| |[SAML PHP Toolkit](https://github.com/onelogin/php-saml)|^|4.3.1|PHP rīkkopa, kas pievieno SAML 2.0 autentifikācijas atbalstu, lai varētu pierakstīties Zabbix.<br><br>Piegādātās versijas vēsture:<br>- 4.0.0 kopš Zabbix 7.0.0;<br>- 4.3.1 kopš Zabbix 7.0.24 (ieteicams).| |[Duo Universal PHP library](https://github.com/duosecurity/duo_universal_php)|^|1.1.2|PHP bibliotēka, kas pievieno Duo Universal Prompt daudzfaktoru autentifikācijas atbalstu Zabbix.<br><br>Piegādātās versijas vēsture:<br>- 1.0.2 kopš Zabbix 7.0.0;<br>- 1.1.0 kopš Zabbix 7.0.23;<br>- 1.1.2 kopš Zabbix 7.0.26 (ieteicams).| |[Symfony Yaml Component](https://symfony.com/doc/current/components/yaml.html)|^|5.1.0|Pievieno atbalstu Zabbix konfigurācijas elementu eksportēšanai un importēšanai YAML formātā.| ::: noteclassic Zabbix var darboties arī ar iepriekšējām Apache, MySQL, Oracle un PostgreSQL versijām. ::: ::: noteimportant Citiem fontiem, kas nav noklusējuma DejaVu, var būt nepieciešama PHP funkcija [imagerotate](http://php.net/manual/en/function.imagerotate.php). Ja tās nav, šie fonti, attēlojot grafiku, var tikt renderēti nepareizi. Šī funkcija ir pieejama tikai tad, ja PHP ir kompilēts ar iebūvētu GD, kas Debian un citos izplatījumos nav gadījums. ::: Trešo pušu bibliotēkas, ko izmanto Zabbix lietotāja saskarnes koda rakstīšanai un atkļūdošanai: |Library|Mandatory status|Minimum version|Description| |--|-|-|------| |[Composer](https://getcomposer.org/)|No|2.4.1|PHP lietojumprogrammu līmeņa pakotņu pārvaldnieks, kas nodrošina standarta formātu PHP programmatūras un nepieciešamo bibliotēku atkarību pārvaldībai.| |[PHPUnit](https://phpunit.de/)|^|8.5.29|PHP vienību testēšanas ietvars Zabbix lietotāja saskarnes testēšanai.| |[SASS](https://sass-lang.com/)|^|3.4.22|Priekšapstrādes skriptu valoda, kas tiek interpretēta un kompilēta kaskādes stila lapās (CSS).| #### Frontend To enable encryption with certificate and database host identity verification for connections between Zabbix frontend and the database: - Check *Database TLS encryption* and *Verify database certificate* - Specify path to *Database TLS key file* - Specify path to *Database TLS CA file* - Specify path to *Database TLS certificate file* - Check *Database host verification* {width="600"} Alternatively, this can be set in */etc/zabbix/web/zabbix.conf.php:* $DB['ENCRYPTION'] = true; $DB['KEY_FILE'] = ''; $DB['CERT_FILE'] = ''; $DB['CA_FILE'] = '/etc/ssl/pgsql/root.crt'; $DB['VERIFY_HOST'] = true; $DB['CIPHER_LIST'] = ''; ... #### Lietotāja saskarne Lai iespējotu šifrēšanu ar sertifikātu un datubāzes hosta identitātes pārbaudi savienojumiem starp Zabbix lietotāja saskarni un datubāzi: - Atzīmējiet *Database TLS encryption* un *Verify database certificate* - Norādiet ceļu uz *Database TLS key file* - Norādiet ceļu uz *Database TLS CA file* - Norādiet ceļu uz *Database TLS certificate file* - Atzīmējiet *Database host verification* {width="600"} Alternatīvi to var iestatīt failā */etc/zabbix/web/zabbix.conf.php:* $DB['ENCRYPTION'] = true; $DB['KEY_FILE'] = ''; $DB['CERT_FILE'] = ''; $DB['CA_FILE'] = '/etc/ssl/pgsql/root.crt'; $DB['VERIFY_HOST'] = true; $DB['CIPHER_LIST'] = ''; ... #### Frontend To enable encryption with certificate authority verification for connections between Zabbix frontend and the database: - Check *Database TLS encryption* and *Verify database certificate* - Specify path to *Database TLS CA file* {width="600"} Alternatively, this can be set in */etc/zabbix/web/zabbix.conf.php:* ... $DB['ENCRYPTION'] = true; $DB['KEY_FILE'] = ''; $DB['CERT_FILE'] = ''; $DB['CA_FILE'] = '/etc/ssl/pgsql/root.crt'; $DB['VERIFY_HOST'] = false; $DB['CIPHER_LIST'] = ''; ... #### Lietotāja saskarne Lai iespējotu šifrēšanu ar sertifikācijas iestādes verifikāciju savienojumiem starp Zabbix lietotāja saskarni un datubāzi: - Atzīmējiet *Database TLS encryption* un *Verify database certificate* - Norādiet ceļu uz *Database TLS CA file* {width="600"} Alternatīvi, to var iestatīt failā */etc/zabbix/web/zabbix.conf.php:* ... $DB['ENCRYPTION'] = true; $DB['KEY_FILE'] = ''; $DB['CERT_FILE'] = ''; $DB['CA_FILE'] = '/etc/ssl/pgsql/root.crt'; $DB['VERIFY_HOST'] = false; $DB['CIPHER_LIST'] = ''; ... #### Frontend To enable encryption with certificate verification for connections between Zabbix frontend and the database: - Check *Database TLS encryption* and *Verify database certificate* - Specify path to Database TLS CA file {width="600"} Alternatively, this can be set in */etc/zabbix/web/zabbix.conf.php*: ... $DB['ENCRYPTION'] = true; $DB['KEY_FILE'] = ''; $DB['CERT_FILE'] = ''; $DB['CA_FILE'] = '/etc/ssl/mysql/ca.pem'; $DB['VERIFY_HOST'] = false; $DB['CIPHER_LIST'] = ''; ... Troubleshoot user using command-line tool to check if connection is possible for required user: mysql -u zbx_web -p -h 10.211.55.9 --ssl-mode=REQUIRED --ssl-ca=/var/lib/mysql/ca.pem #### Lietotāja saskarne Lai iespējotu šifrēšanu ar sertifikāta verifikāciju savienojumiem starp Zabbix lietotāja saskarni un datubāzi: - Atzīmējiet *Database TLS encryption* un *Verify database certificate* - Norādiet ceļu uz Database TLS CA failu {width="600"} Alternatīvi to var iestatīt failā */etc/zabbix/web/zabbix.conf.php*: ... $DB['ENCRYPTION'] = true; $DB['KEY_FILE'] = ''; $DB['CERT_FILE'] = ''; $DB['CA_FILE'] = '/etc/ssl/mysql/ca.pem'; $DB['VERIFY_HOST'] = false; $DB['CIPHER_LIST'] = ''; ... Lai novērstu problēmas, izmantojiet komandrindas rīku, lai pārbaudītu, vai savienojums ir iespējams norādītajam lietotājam: mysql -u zbx_web -p -h 10.211.55.9 --ssl-mode=REQUIRED --ssl-ca=/var/lib/mysql/ca.pem #### Frontend To enable encryption with full verification for connections between Zabbix frontend and the database: - Check *Database TLS encryption* and *Verify database certificate* - Specify path to *Database TLS key file* - Specify path to *Database TLS CA file* - Specify path to *Database TLS certificate file* Note that *Database host verification* is checked and grayed out - this step cannot be skipped for MySQL. ::: notewarning If *Database TLS cipher list* field is left empty, the common ciphers permitted by both frontend (client) and server will be enabled. Alternatively, the ciphers can be set explicitly, in conformance with the [cipher configuration requirements](https://dev.mysql.com/doc/refman/8.0/en/encrypted-connection-protocols-ciphers.html#encrypted-connection-cipher-configuration). ::: {width=600} Alternatively, this can be set in */etc/zabbix/web/zabbix.conf.php*: ... // Used for TLS connection with strictly defined Cipher list. $DB['ENCRYPTION'] = true; $DB['KEY_FILE'] = '/etc/ssl/mysql/client-key.pem'; $DB['CERT_FILE'] = '/etc/ssl/mysql/client-cert.pem'; $DB['CA_FILE'] = '/etc/ssl/mysql/ca.pem'; $DB['VERIFY_HOST'] = true; $DB['CIPHER_LIST'] = 'TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256:TLS_AES_128_CCM_SHA256:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES128-SHA256:ECDHE-RSA-AES128-SHA256:ECDHE-RSA-AES256-GC'; ... // or ... // Used for TLS connection without Cipher list defined - selected by MySQL server $DB['ENCRYPTION'] = true; $DB['KEY_FILE'] = '/etc/ssl/mysql/client-key.pem'; $DB['CERT_FILE'] = '/etc/ssl/mysql/client-cert.pem'; $DB['CA_FILE'] = '/etc/ssl/mysql/ca.pem'; $DB['VERIFY_HOST'] = true; $DB['CIPHER_LIST'] = ''; ... #### Lietotāja saskarne Lai iespējotu šifrēšanu ar pilnu verifikāciju savienojumiem starp Zabbix lietotāja saskarni un datubāzi: - Atzīmējiet *Database TLS encryption* un *Verify database certificate* - Norādiet ceļu uz *Database TLS key file* - Norādiet ceļu uz *Database TLS CA file* - Norādiet ceļu uz *Database TLS certificate file* Ņemiet vērā, ka *Database host verification* ir atzīmēts un pelēkots - šo soli MySQL nevar izlaist. ::: notewarning Ja lauks *Database TLS cipher list* ir atstāts tukšs, tiks iespējoti kopīgie šifri, ko atļauj gan lietotāja saskarne (klients), gan serveris. Alternatīvi šifrus var iestatīt tieši, ievērojot [šifru konfigurācijas prasības](https://dev.mysql.com/doc/refman/8.0/en/encrypted-connection-protocols-ciphers.html#encrypted-connection-cipher-configuration). ::: {width=600} Alternatīvi to var iestatīt failā */etc/zabbix/web/zabbix.conf.php*: ... // Used for TLS connection with strictly defined Cipher list. $DB['ENCRYPTION'] = true; $DB['KEY_FILE'] = '/etc/ssl/mysql/client-key.pem'; $DB['CERT_FILE'] = '/etc/ssl/mysql/client-cert.pem'; $DB['CA_FILE'] = '/etc/ssl/mysql/ca.pem'; $DB['VERIFY_HOST'] = true; $DB['CIPHER_LIST'] = 'TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256:TLS_AES_128_CCM_SHA256:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES128-SHA256:ECDHE-RSA-AES128-SHA256:ECDHE-RSA-AES256-GC'; ... // or ... // Used for TLS connection without Cipher list defined - selected by MySQL server $DB['ENCRYPTION'] = true; $DB['KEY_FILE'] = '/etc/ssl/mysql/client-key.pem'; $DB['CERT_FILE'] = '/etc/ssl/mysql/client-cert.pem'; $DB['CA_FILE'] = '/etc/ssl/mysql/ca.pem'; $DB['VERIFY_HOST'] = true; $DB['CIPHER_LIST'] = ''; ... #### Frontend To enable transport-only encryption for connections between Zabbix frontend and the database: - Check *Database TLS encryption* - Leave *Verify database certificate* unchecked {width="600"} #### Lietotāja saskarne Lai iespējotu tikai transporta šifrēšanu savienojumiem starp Zabbix lietotāja saskarni un datubāzi: - Atzīmējiet *Datubāzes TLS šifrēšana* - Atstājiet *Pārbaudīt datubāzes sertifikātu* neatzīmētu {width="600"} #### Frontend To enable transport-only encryption for connections between Zabbix frontend and the database: - Check *Database TLS encryption* - Leave *Verify database certificate* unchecked {width="600"} #### Lietotāja saskarne Lai iespējotu tikai transporta šifrēšanu savienojumiem starp Zabbix lietotāja saskarni un datubāzi: - Atzīmējiet *Database TLS encryption* - Neatzīmējiet *Verify database certificate* {width="600"} #### Frontend To obtain database credentials from the vault for Zabbix frontend, specify the following parameters during frontend [installation](/manual/installation/frontend). 1. At the *Configure DB Connection* step, set the *Store credentials in* parameter to "CyberArk Vault". {width="600"} 2. Then, fill in the additional parameters: |Parameter|Mandatory|Default value| Description| |---|-|---|------| |Vault API endpoint|yes|https://localhost:1858|Specify the URL for connecting to the vault in the format `scheme://host:port`| |Vault prefix|no|/AIMWebService/api/Accounts?|Provide a custom prefix for the vault path or query. If not specified, the default is used.| |Vault secret query string|yes| |A query, which specifies from where database credentials should be retrieved.<br>Example: `AppID=foo&Query=Safe=bar;Object=buzz`| |Vault certificates|no| |After marking the checkbox, additional parameters will appear allowing to configure client authentication. While this parameter is optional, it is highly recommended to enable it for communication with the CyberArk Vault.| |SSL certificate file|no|conf/certs/cyberark-cert.pem|Path to the SSL certificate file. The file must be in PEM format.<br>If the certificate file also contains the private key, leave the SSL key file parameter empty.| |SSL key file|no|conf/certs/cyberark-key.pem|Name of the SSL private key file used for client authentication. The file must be in PEM format.| #### Lietotāja saskarne Lai iegūtu datubāzes akreditācijas datus no glabātuves Zabbix lietotāja saskarnei, lietotāja saskarnes [instalēšanas](/manual/installation/frontend) laikā norādiet šādus parametrus. 1. Solī *Configure DB Connection* iestatiet parametru *Store credentials in* uz "CyberArk Vault". {width="600"} 2. Pēc tam aizpildiet papildu parametrus: |Parametrs|Obligāts|Noklusējuma vērtība| Apraksts| |---|-|---|------| |Vault API endpoint|jā|https://localhost:1858|Norādiet URL savienojumam ar glabātuvi formātā `scheme://host:port`| |Vault prefix|nē|/AIMWebService/api/Accounts?|Norādiet pielāgotu prefiksu glabātuves ceļam vai vaicājumam. Ja tas nav norādīts, tiek izmantota noklusējuma vērtība.| |Vault secret query string|jā| |Vaicājums, kas nosaka, no kurienes jāiegūst datubāzes akreditācijas dati.<br>Piemērs: `AppID=foo&Query=Safe=bar;Object=buzz`| |Vault certificates|nē| |Atzīmējot izvēles rūtiņu, tiks parādīti papildu parametri, kas ļaus konfigurēt klienta autentifikāciju. Lai gan šis parametrs nav obligāts, ir ļoti ieteicams to iespējot saziņai ar CyberArk Vault.| |SSL certificate file|nē|conf/certs/cyberark-cert.pem|Ceļš uz SSL sertifikāta failu. Failam jābūt PEM formātā.<br>Ja sertifikāta fails satur arī privāto atslēgu, atstājiet parametru SSL key file tukšu.| |SSL key file|nē|conf/certs/cyberark-key.pem|SSL privātās atslēgas faila nosaukums, kas tiek izmantots klienta autentifikācijai. Failam jābūt PEM formātā.| ##### Frontend to the database A secure connection to the database can be configured during frontend installation: - Mark the *Database TLS encryption* checkbox in the [Configure DB connection](/manual/installation/frontend#configure-db-connection) step to enable transport encryption. - Mark the *Verify database certificate* checkbox that appears when *TLS encryption* field is checked to enable encryption with certificates. ::: noteclassic For MySQL, the *Database TLS encryption* checkbox is disabled, if *Database host* is set to localhost, because connection that uses a socket file (on Unix) or shared memory (on Windows) cannot be encrypted.<br> For PostgreSQL, the *TLS encryption* checkbox is disabled, if the value of the *Database host* field begins with a slash or the field is empty. ::: The following parameters become available in the TLS encryption in certificates mode (if both checkboxes are marked): |Parameter|Description| |--|--------| |*Database TLS CA file*|Specify the full path to a valid TLS certificate authority (CA) file.| |*Database TLS key file*|Specify the full path to a valid TLS key file.| |*Database TLS certificate file*|Specify the full path to a valid TLS certificate file.| |*Database host verification*|Mark this checkbox to activate host verification.<br>Disabled for MYSQL, because PHP MySQL library does not allow to skip the peer certificate validation step.| |*Database TLS cipher list*|Specify a custom list of valid ciphers. The format of the cipher list must conform to the OpenSSL standard.<br>Available for MySQL only.| ::: noteimportant TLS parameters must point to valid files. If they point to non-existent or invalid files, it will lead to the authorization error.<br> If certificate files are writable, the frontend generates a warning in the [System information](/manual/web_interface/frontend_sections/reports/status_of_zabbix) report that "TLS certificate files must be read-only." (displayed only if the PHP user is the owner of the certificate). Certificates protected by passwords are not supported. ::: ##### Lietotāja saskarne uz datubāzi Drošu savienojumu ar datubāzi var konfigurēt lietotāja saskarnes instalēšanas laikā: - Atzīmējiet izvēles rūtiņu *Database TLS encryption* solī [Configure DB connection](/manual/installation/frontend#configure-db-connection), lai iespējotu transporta šifrēšanu. - Atzīmējiet izvēles rūtiņu *Verify database certificate*, kas parādās, kad ir atzīmēts lauks *TLS encryption*, lai iespējotu šifrēšanu ar sertifikātiem. ::: noteclassic MySQL gadījumā izvēles rūtiņa *Database TLS encryption* ir atspējota, ja *Database host* ir iestatīts uz localhost, jo savienojumu, kas izmanto ligzdas failu (Unix sistēmās) vai koplietojamo atmiņu (Windows sistēmās), nevar šifrēt.<br> PostgreSQL gadījumā izvēles rūtiņa *TLS encryption* ir atspējota, ja lauka *Database host* vērtība sākas ar slīpsvītru vai lauks ir tukšs. ::: TLS šifrēšanas režīmā ar sertifikātiem kļūst pieejami šādi parametri (ja ir atzīmētas abas izvēles rūtiņas): |Parametrs|Apraksts| |--|--------| |*Database TLS CA file*|Norādiet pilnu ceļu uz derīgu TLS sertifikācijas iestādes (CA) failu.| |*Database TLS key file*|Norādiet pilnu ceļu uz derīgu TLS atslēgas failu.| |*Database TLS certificate file*|Norādiet pilnu ceļu uz derīgu TLS sertifikāta failu.| |*Database host verification*|Atzīmējiet šo izvēles rūtiņu, lai aktivizētu hosta verifikāciju.<br>Atspējots MYSQL gadījumā, jo PHP MySQL bibliotēka neļauj izlaist partnera sertifikāta validācijas soli.| |*Database TLS cipher list*|Norādiet pielāgotu derīgu šifru sarakstu. Šifru saraksta formātam jāatbilst OpenSSL standartam.<br>Pieejams tikai MySQL.| ::: noteimportant TLS parametriem jānorāda uz derīgiem failiem. Ja tie norāda uz neeksistējošiem vai nederīgiem failiem, tas izraisīs autorizācijas kļūdu.<br> Ja sertifikātu faili ir rakstāmi, lietotāja saskarne ģenerē brīdinājumu atskaitē [System information](/manual/web_interface/frontend_sections/reports/status_of_zabbix), ka "TLS certificate files must be read-only." (tiek parādīts tikai tad, ja PHP lietotājs ir sertifikāta īpašnieks). Ar parolēm aizsargāti sertifikāti netiek atbalstīti. ::: ##### Frontend Zabbix frontend can be configured to retrieve database credentials from the vault either during frontend [installation](/manual/installation/frontend) or by updating the frontend configuration file (`zabbix.conf.php`). :::noteimportant If vault credentials have been changed since the previous frontend installation, rerun the frontend installation or update `zabbix.conf.php`. See also: [Updating existing configuration](#updating-existing-configuration). ::: During **frontend installation** the configuration parameters must be specified at the *Configure DB Connection* step: {width="600"} - Set the *Store credentials in* parameter to "HashiCorp Vault". - Specify the connection parameters: |Parameter|Mandatory|Default value|Description| |---|-|---|------| |*Vault API endpoint*|yes|https://localhost:8200|Specify the URL for connecting to the vault in the format `scheme://host:port`| |*Vault prefix*|no|/v1/secret/data/|Provide a custom prefix for the vault path or query. If not specified, the default is used.<br>Example: `/v1/secret/data/zabbix/`| |*Vault secret path*|no| |A path to the secret from where credentials for the database shall be retrieved by the keys "password" and "username".<br>Example: `database`| |*Vault authentication token*|no| |Provide an authentication token for read-only access to the secret path.<br>See [HashiCorp documentation](https://learn.hashicorp.com/tutorials/vault/tokens) for information about creating tokens and vault policies.| ##### Lietotāja saskarne Zabbix lietotāja saskarni var konfigurēt tā, lai tā izgūtu datubāzes akreditācijas datus no glabātuves vai nu lietotāja saskarnes [instalēšanas](/manual/installation/frontend) laikā, vai atjauninot lietotāja saskarnes konfigurācijas failu (`zabbix.conf.php`). :::noteimportant Ja kopš iepriekšējās lietotāja saskarnes instalēšanas glabātuves akreditācijas dati ir mainīti, atkārtoti palaidiet lietotāja saskarnes instalēšanu vai atjauniniet `zabbix.conf.php`. Skatiet arī: [Esošās konfigurācijas atjaunināšana](#updating-existing-configuration). ::: **Lietotāja saskarnes instalēšanas** laikā konfigurācijas parametri jānorāda solī *Configure DB Connection*: {width="600"} - Iestatiet parametru *Store credentials in* uz "HashiCorp Vault". - Norādiet savienojuma parametrus: |Parametrs|Obligāts|Noklusējuma vērtība|Apraksts| |---|-|---|------| |*Vault API endpoint*|jā|https://localhost:8200|Norādiet URL savienojumam ar glabātuvi formātā `scheme://host:port`| |*Vault prefix*|nē|/v1/secret/data/|Norādiet pielāgotu prefiksu glabātuves ceļam vai vaicājumam. Ja tas nav norādīts, tiek izmantota noklusējuma vērtība.<br>Piemērs: `/v1/secret/data/zabbix/`| |*Vault secret path*|nē| |Ceļš uz noslēpumu, no kura datubāzes akreditācijas dati tiks izgūti, izmantojot atslēgas "password" un "username".<br>Piemērs: `database`| |*Vault authentication token*|nē| |Norādiet autentifikācijas tokenu tikai lasīšanas piekļuvei noslēpuma ceļam.<br>Informāciju par tokenu un glabātuves politiku izveidi skatiet [HashiCorp documentation](https://learn.hashicorp.com/tutorials/vault/tokens).| ###### Full configuration of steps A complete configuration of web scenario steps should look like this: {width="600"} ###### Pilna soļu konfigurācija Pilnīga tīmekļa scenārija soļu konfigurācija izskatās šādi: {width="600"} Functionality supported by proxies: |Proxy version|Data update|[Configuration update](/manual/distributed_monitoring/proxies/sync#incremental-update)|Tasks| |--|--|--|----| |*Current*|Yes|Yes|Yes| |*Outdated*|Yes|No|[Remote commands](/manual/config/notifications/action/operation/remote_command) (e.g., shell scripts);<br>Immediate item value checks (i.e., *[Execute now](/manual/config/items/check_now)*);<br>Note: Preprocessing [tests with a real value](/manual/config/items/preprocessing/testing#testing-real-value) are not supported.| |*Unsupported*|No|No|No| Starpniekserveru atbalstītā funkcionalitāte: |Starpniekservera versija|Datu atjaunināšana|[Konfigurācijas atjaunināšana](/manual/distributed_monitoring/proxies/sync#incremental-update)|Uzdevumi| |--|--|--|----| |*Pašreizējā*|Jā|Jā|Jā| |*Novecojusi*|Jā|Nē|[Attālinātās komandas](/manual/config/notifications/action/operation/remote_command) (piemēram, čaulas skripti);<br>Tūlītējas vienuma vērtības pārbaudes (t. i., *[Izpildīt tagad](/manual/config/items/check_now)*);<br>Piezīme: priekšapstrādes [testi ar reālu vērtību](/manual/config/items/preprocessing/testing#testing-real-value) netiek atbalstīti.| |*Neatbalstīta*|Nē|Nē|Nē| ### Function details ### Funkcijas informācija #### Function details Optional function parameters are indicated by < >. #### Funkcijas informācija Neobligātie funkcijas parametri ir norādīti ar < >. ### Function details Some general notes on function parameters: - Function parameters are separated by a comma - Expressions are accepted as parameters ### Funkciju informācija Dažas vispārīgas piezīmes par funkciju parametriem: - Funkciju parametrus atdala ar komatu - Izteiksmes tiek pieņemtas kā parametri ### Function details Some general notes on function parameters: - Function parameters are separated by a comma - Expressions are accepted as parameters - Optional function parameters (or parameter parts) are indicated by `<` `>` ### Funkciju detaļas Dažas vispārīgas piezīmes par funkciju parametriem: - Funkciju parametrus atdala ar komatu - Izteiksmes tiek pieņemtas kā parametri - Neobligātie funkciju parametri (vai parametru daļas) tiek norādīti ar `<` `>` ### Function details Some general notes on function parameters: - Function parameters are separated by a comma - Expressions are accepted as parameters - Optional function parameters (or parameter parts) are indicated by `<` `>` ### Funkciju informācija Dažas vispārīgas piezīmes par funkciju parametriem: - Funkciju parametrus atdala ar komatu - Izteiksmes tiek pieņemtas kā parametri - Neobligātie funkciju parametri (vai parametru daļas) ir norādīti ar `<` `>` ### Function details Some general notes on function parameters: - Function parameters are separated by a comma - Expressions are accepted as parameters - String parameters must be double-quoted; otherwise they might get misinterpreted - Optional function parameters (or parameter parts) are indicated by `<` `>` ### Funkciju informācija Dažas vispārīgas piezīmes par funkciju parametriem: - Funkciju parametrus atdala ar komatu - Izteiksmes tiek pieņemtas kā parametri - Virknes parametriem jābūt dubultpēdiņās; pretējā gadījumā tie var tikt nepareizi interpretēti - Neobligātie funkciju parametri (vai parametru daļas) tiek norādīti ar `<` `>` ### Function details Some general notes on function parameters: - Function parameters are separated by a comma - Optional function parameters (or parameter parts) are indicated by `<` `>` - Function-specific parameters are described with each function - `/host/key` and `(sec|#num)<:time shift>` parameters must never be quoted ### Funkciju informācija Dažas vispārīgas piezīmes par funkciju parametriem: - Funkciju parametrus atdala ar komatu - Neobligātie funkciju parametri (vai parametru daļas) tiek norādīti ar `<` `>` - Katras funkcijas specifiskie parametri ir aprakstīti pie attiecīgās funkcijas - Parametri `/host/key` un `(sec|#num)<:time shift>` nekad nedrīkst būt pēdiņās ### Function details Some general notes on function parameters: - Function parameters are separated by a comma - Optional function parameters (or parameter parts) are indicated by `<` `>` - Function-specific parameters are described with each function - `/host/key` and `(sec|#num)<:time shift>` parameters must never be quoted ### Funkciju informācija Dažas vispārīgas piezīmes par funkciju parametriem: - Funkciju parametrus atdala ar komatu - Neobligātie funkciju parametri (vai parametru daļas) ir norādīti ar `<` `>` - Katrai funkcijai specifiskie parametri ir aprakstīti pie attiecīgās funkcijas - Parametri `/host/key` un `(sec|#num)<:time shift>` nekad nedrīkst būt pēdiņās ### Function details Some general notes on function parameters: - Function parameters are separated by a comma - Optional function parameters (or parameter parts) are indicated by `<` `>` - Function-specific parameters are described with each function - `/host/key` and `(sec|#num)<:time shift>` parameters must never be quoted ### Funkciju informācija Dažas vispārīgas piezīmes par funkciju parametriem: - Funkciju parametrus atdala ar komatu - Neobligātie funkciju parametri (vai parametru daļas) ir norādīti ar `<` `>` - Katras funkcijas specifiskie parametri ir aprakstīti pie attiecīgās funkcijas - Parametri `/hosts/key` un `(sec|#num)<:time shift>` nekad nedrīkst būt pēdiņās ### Function details Some general notes on function parameters: - Function parameters are separated by a comma - Optional function parameters (or parameter parts) are indicated by `<` `>` - Function-specific parameters are described with each function - `/host/key` and `time period:time shift` parameters must never be quoted ### Funkciju informācija Dažas vispārīgas piezīmes par funkciju parametriem: - Funkciju parametrus atdala ar komatu - Neobligātie funkciju parametri (vai parametru daļas) ir norādīti ar `<` `>` - Katras funkcijas specifiskie parametri ir aprakstīti pie attiecīgās funkcijas - Parametri `/hosts/key` un `time period:time shift` nekad nedrīkst būt pēdiņās #### Function parameters Function parameters allow to specify: - host and item key (functions referencing the host item history only) - function-specific parameters - other expressions (not available for functions referencing the host item history, see [other expressions](#other-expressions) for examples) The host and item key can be specified as `/host/key`.<br> Omission of the host name in the first parameter (i.e. as in `function(//key,parameter,...)`) is only supported in certain contexts: - In the formula of calculated items - In expression macros, which can be used in: - The [*Event name*](/manual/config/triggers/trigger#configuration) field - Graph name - The label of "Host" and "Trigger" [map elements](/manual/config/visualization/maps/map#adding-elements) In these contexts, you may also use the [`{HOST.HOST}`](/manual/appendix/macros/supported_by_location#hosts) macro. `{HOST.HOST<1-9>}` could be used in the case of the *Event name* field and the "Trigger" map element to refer to a specific item in the trigger expression. When the host name is omitted or replaced by `{HOST.HOST}` in these contexts, the reference points to the first item in the trigger expression or to the first item in the graph. Outside of these supported contexts, omitting the host name in trigger expressions will result in an error. See [Example 18](#example-18) for an illustration of double-slash usage in Event name macros. The referenced item must be in a supported state (except for **nodata()** function, which is calculated for unsupported items as well). While other trigger expressions as function parameters are limited to non-history functions in triggers, this limitation does not apply in [calculated items](/manual/config/items/itemtypes/calculated). #### Funkcijas parametri Funkcijas parametri ļauj norādīt: - hosts un vienuma atslēgu (funkcijas, kas atsaucas tikai uz hosta vienuma vēsturi) - funkcijai specifiskus parametrus - citas izteiksmes (nav pieejamas funkcijām, kas atsaucas uz hosta vienuma vēsturi, skatiet [citas izteiksmes](#other-expressions) piemērus) Hosta un vienuma atslēgu var norādīt kā `/host/key`.<br> Hosta nosaukuma izlaišana pirmajā parametrā (t. i., kā `function(//key,parameter,...)`) ir atbalstīta tikai noteiktos kontekstos: - Aprēķināto vienumu formulā - Izteiksmju makrosos, kurus var izmantot: - laukā [*Notikuma nosaukums*](/manual/config/triggers/trigger#configuration) - grafika nosaukumā - "Host" un "Trigger" [kartes elementu](/manual/config/visualization/maps/map#adding-elements) etiķetē Šajos kontekstos varat izmantot arī [`{HOST.HOST}`](/manual/appendix/macros/supported_by_location#hosts) makro. `{HOST.HOST<1-9>}` var izmantot *Notikuma nosaukums* laukā un "Trigger" kartes elementā, lai atsauktos uz konkrētu vienumu trigerī izteiksmē. Ja šajos kontekstos hosta nosaukums tiek izlaists vai aizstāts ar `{HOST.HOST}`, atsauce norāda uz pirmo vienumu trigerī izteiksmē vai uz pirmo vienumu grafikā. Ārpus šiem atbalstītajiem kontekstiem hosta nosaukuma izlaišana trigeru izteiksmēs radīs kļūdu. Skatiet [18. piemēru](#example-18), lai redzētu dubultā slīpsvītras lietojumu Notikuma nosaukums makrosos. Norādītajam vienumam jābūt atbalstītā stāvoklī (izņemot **nodata()** funkciju, kas tiek aprēķināta arī neatbalstītiem vienumiem). Lai gan citu trigeru izteiksmju izmantošana kā funkciju parametri ir ierobežota līdz netehistorijas funkcijām trigeros, šis ierobežojums neattiecas uz [aprēķinātajiem vienumiem](/manual/config/items/itemtypes/calculated). ## Functions ## Funkcijas #### Functions Before setting a trigger, it is necessary to define what a problem state is and how much time is needed to take action. Then there are two ways to set up a trigger signaling about a potential unwanted situation. First: the trigger must fire when the system is expected to be in a problem state after "time to act". Second: the trigger must fire when the system is going to reach the problem state in less than "time to act". Corresponding trigger functions to use are **forecast** and **timeleft**. Note that underlying statistical analysis is basically identical for both functions. You may set up a trigger whichever way you prefer with similar results. #### Funkcijas Pirms trigera iestatīšanas ir nepieciešams definēt, kas ir problēmas stāvoklis un cik daudz laika ir nepieciešams, lai veiktu darbības. Pēc tam ir divi veidi, kā iestatīt trigeri, kas signalizē par iespējamu nevēlamu situāciju. Pirmais: trigerim jāaktivizējas, kad tiek sagaidīts, ka sistēma pēc "time to act" būs problēmas stāvoklī. Otrais: trigerim jāaktivizējas, kad sistēma nonāks problēmas stāvoklī mazāk nekā "time to act" laikā. Atbilstošās izmantojamās trigeru funkcijas ir **forecast** un **timeleft**. Ņemiet vērā, ka pamatā esošā statistiskā analīze abām funkcijām ir būtībā identiska. Jūs varat iestatīt trigeri jebkurā sev vēlamā veidā, un rezultāti būs līdzīgi. #### Functions Functions allow to calculate the collected values (average, minimum, maximum, sum), find strings, reference current time and other factors. A complete list of [supported functions](/manual/appendix/functions) is available. Typically functions return numeric values for comparison. When returning strings, comparison is possible with the **=** and **<>** operators (see [example](#example-14)). #### Funkcijas Funkcijas ļauj aprēķināt savāktās vērtības (vidējo, minimālo, maksimālo, summu), atrast virknes, atsaukties uz pašreizējo laiku un citiem faktoriem. Pilns [atbalstīto funkciju](/manual/appendix/functions) saraksts ir pieejams. Parasti funkcijas atgriež skaitliskas vērtības salīdzināšanai. Atgriežot virknes, salīdzināšana ir iespējama ar operatoriem **=** un **<>** (skatiet [piemēru](#example-14)). #### Functions Functions can be used at the end of JSONPath. Multiple functions can be chained if the preceding function returns value that is accepted by the following function. Supported functions: |Function|Description|Input|Output| |-|----|--|---| |`avg`|Average value of numbers in an input array|Array of numbers|Number| |`min`|Minimum value of numbers in an input array|Array of numbers|Number| |`max`|Maximum value of numbers in an input array|Array of numbers|Number| |`sum`|Sum of numbers in an input array|Array of numbers|Number| |`length`|Number of elements in an input array|Array|Number| |`first`|The first element of an array|Array|A JSON construct (object, array, value) depending on the contents of the input array| JSONPath aggregate functions accept quoted numeric values. These values are automatically converted from strings to numeric types when aggregation is needed. Incompatible input will cause the function to generate an error. #### Funkcijas Funkcijas var izmantot JSONPath beigās. Var sasaistīt vairākas funkcijas, ja iepriekšējā funkcija atgriež vērtību, ko pieņem nākamā funkcija. Atbalstītās funkcijas: |Function|Description|Input|Output| |-|----|--|---| |`avg`|Skaitļu vidējā vērtība ievades masīvā|Skaitļu masīvs|Skaitlis| |`min`|Skaitļu minimālā vērtība ievades masīvā|Skaitļu masīvs|Skaitlis| |`max`|Skaitļu maksimālā vērtība ievades masīvā|Skaitļu masīvs|Skaitlis| |`sum`|Skaitļu summa ievades masīvā|Skaitļu masīvs|Skaitlis| |`length`|Elementu skaits ievades masīvā|Masīvs|Skaitlis| |`first`|Masīva pirmais elements|Masīvs|JSON konstrukcija (objekts, masīvs, vērtība) atkarībā no ievades masīva satura| JSONPath agregācijas funkcijas pieņem skaitliskas vērtības pēdiņās. Šīs vērtības tiek automātiski pārveidotas no virknēm uz skaitliskiem tipiem, kad nepieciešama agregācija. Nesaderīga ievade izraisīs funkcijas kļūdu. ### Functions |Macro|Supported in|Description| |--|--------|--------| |{FUNCTION.VALUE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands<br>→ Event names|*Results of the Nth item-based function in the trigger expression at the time of the event.*<br>Only functions with */host/key* as the first parameter are counted.<br><br>This macro may be used with a numeric index e.g. {FUNCTION.VALUE[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. function in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).<br><br>**Note** that before Zabbix 7.0.5, {FUNCTION.VALUE} is not supported; use {FUNCTION.VALUE1} instead.| |{FUNCTION.RECOVERY.VALUE}|→ Problem [recovery notifications](/manual/config/notifications/action/recovery_operations) and commands<br>→ Problem update notifications and commands<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands|*Results of the Nth item-based function in the recovery expression at the time of the event.*<br>Only functions with */host/key* as the first parameter are counted.<br><br>This macro may be used with a numeric index e.g. {FUNCTION.RECOVERY.VALUE[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. function in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).<br><br>**Note** that before Zabbix 7.0.5, {FUNCTION.RECOVERY.VALUE} is not supported; use {FUNCTION.RECOVERY.VALUE1} instead.| ### Funkcijas |Macro|Supported in|Description| |--|--------|--------| |{FUNCTION.VALUE}|→ Trigerim balstīti paziņojumi un komandas<br>→ Problēmas atjaunināšanas paziņojumi un komandas<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas<br>→ Notikumu nosaukumi|*Rezultāti no N-tās uz vienumu balstītās funkcijas trigeris izteiksmē notikuma brīdī.*<br>Tiek skaitītas tikai funkcijas, kuru pirmais parametrs ir */host/key*.<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {FUNCTION.VALUE[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. funkciju trigeris izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).<br><br>**Piezīme**: pirms Zabbix 7.0.5 {FUNCTION.VALUE} netiek atbalstīts; tā vietā izmantojiet {FUNCTION.VALUE1}.| |{FUNCTION.RECOVERY.VALUE}|→ Problēmas [atkopšanas paziņojumi](/manual/config/notifications/action/recovery_operations) un komandas<br>→ Problēmas atjaunināšanas paziņojumi un komandas<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas|*Rezultāti no N-tās uz vienumu balstītās funkcijas atkopšanas izteiksmē notikuma brīdī.*<br>Tiek skaitītas tikai funkcijas, kuru pirmais parametrs ir */host/key*.<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {FUNCTION.RECOVERY.VALUE[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. funkciju trigeris izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).<br><br>**Piezīme**: pirms Zabbix 7.0.5 {FUNCTION.RECOVERY.VALUE} netiek atbalstīts; tā vietā izmantojiet {FUNCTION.RECOVERY.VALUE1}.| ##### Function-specific parameters Function-specific parameters are placed after the item key and are separated from the item key by a comma. See the [supported functions](/manual/appendix/functions) for a complete list of these parameters. Most of numeric functions accept time as a parameter. You may use seconds or [time suffixes](/manual/appendix/suffixes) to indicate time. Preceded by a hash mark, the parameter has a different meaning: |Expression|Description| |----------|-----------| |**sum**(/host/key,**10m)**|Sum of values in the last 10 minutes.| |**sum**(/host/key,**\#10)**|Sum of the last ten values.| Parameters with a hash mark have a different meaning with the function **last** - they denote the Nth previous value, so given the values 30, 70, 20, 60, 50 (from the most recent to the least recent): - `last(/host/key,#2)` would return '70' - `last(/host/key,#5)` would return '50' ##### Funkcijai specifiskie parametri Funkcijai specifiskie parametri tiek ievietoti aiz vienuma atslēgas un no vienuma atslēgas tiek atdalīti ar komatu. Pilnu šo parametru sarakstu skatiet [atbalstītajās funkcijās](/manual/appendix/functions). Lielākā daļa skaitlisko funkciju pieņem laiku kā parametru. Laika norādīšanai var izmantot sekundes vai [laika sufiksus](/manual/appendix/suffixes). Ja parametram priekšā ir hash zīme, tam ir cita nozīme: |Expression|Description| |----------|-----------| |**sum**(/host/key,**10m)**|Vērtību summa pēdējās 10 minūtēs.| |**sum**(/host/key,**\#10)**|Pēdējo desmit vērtību summa.| Parametriem ar hash zīmi funkcijā **last** ir cita nozīme - tie apzīmē N-to iepriekšējo vērtību, tāpēc, ja ir šādas vērtības 30, 70, 20, 60, 50 (no jaunākās uz vecāko): - `last(/host/key,#2)` atgriezīs '70' - `last(/host/key,#5)` atgriezīs '50' ### Function syntax Foreach functions support two common parameters: `item filter` (see details below) and `time period`: ```default foreach_function(item filter,time period) ``` For example: `avg_foreach(/*/mysql.qps?[group="MySQL Servers"],5m)` will return the five-minute average of each 'mysql.qps' item in the MySQL server group. Note that some functions support additional [parameters](#additional-parameters). ### Funkcijas sintakse Foreach funkcijas atbalsta divus kopīgus parametrus: `vienuma filtrs` (skatiet detalizētu informāciju tālāk) un `laika periods`: foreach_function(item filter,time period) Piemēram: `avg_foreach(/*/mysql.qps?[group="MySQL Servers"],5m)` atgriezīs katra vienuma 'mysql.qps' piecu minūšu vidējo vērtību MySQL serveru grupā. Ņemiet vērā, ka dažas funkcijas atbalsta papildu [parametrus](#additional-parameters). ### Further reading Now, you have enough knowledge to start working with the Zabbix API, however, do not stop here. For further reading you are advised to have a look at the [list of available APIs](/manual/api/reference). ### Papildu lasīšanai Tagad jums ir pietiekami daudz zināšanu, lai sāktu strādāt ar Zabbix API, tomēr neapstājieties šeit. Papildu lasīšanai ieteicams apskatīt [pieejamo API sarakstu](/manual/api/reference). ##### fuzzytime(/host/key,sec) {#fuzzytime} Check how much the passive agent time differs from the Zabbix server/proxy time.<br> Supported value types: *Float*, *Integer*.<br> Returns: 1 - difference between the passive item value (as timestamp) and Zabbix server/proxy timestamp (the clock of value collection) is less than or equal to *sec* seconds; 0 - otherwise. Parameters: - See [common parameters](#common-parameters). Comments: - Usually used with the 'system.localtime' item to check that local time is in sync with the local time of Zabbix server. *Note* that 'system.localtime' must be configured as a [passive check](/manual/appendix/items/activepassive#passive-checks) for Zabbix agent; on Zabbix agent 2 it may be configured as an active check. - Can be used also with the `vfs.file.time[/path/file,modify]` key to check that the file did not get updates for long time. - This function is not recommended for use in complex trigger expressions (with multiple items involved), because it may cause unexpected results (time difference will be measured with the most recent metric), e.g. in `fuzzytime(/Host/system.localtime,60s)=0 or last(/Host/trap)<>0`. Examples: ```default fuzzytime(/host/system.localtime,5m)=0 #client local time differs from Zabbix server/proxy time by more than 5 minutes fuzzytime(/host/system.localtime,5m)=0 and nodata(/host/system.localtime,10m)=0 #client local time differs from Zabbix server/proxy time by more than 5 minutes (while making sure the item has not stopped reporting data) ``` ##### fuzzytime(/host/key,sec) {#fuzzytime} Pārbauda, cik lielā mērā pasīvā aģenta laiks atšķiras no Zabbix servera/starpniekservera laika.<br> Atbalstītie vērtību tipi: *Float*, *Integer*.<br> Atgriež: 1 - atšķirība starp pasīvā vienuma vērtību (kā laika zīmogu) un Zabbix servera/starpniekservera laika zīmogu (vērtības ievākšanas laiku) ir mazāka vai vienāda ar *sec* sekundēm; 0 - pretējā gadījumā. Parametri: - Skatiet [kopīgos parametrus](#common-parameters). Komentāri: - Parasti izmanto kopā ar vienumu 'system.localtime', lai pārbaudītu, vai lokālais laiks ir sinhronizēts ar Zabbix servera lokālo laiku. *Ņemiet vērā*, ka 'system.localtime' Zabbix aģentam ir jākonfigurē kā [pasīvā pārbaude](/manual/appendix/items/activepassive#passive-checks); Zabbix aģentā 2 to var konfigurēt arī kā aktīvo pārbaudi. - Var izmantot arī ar atslēgu `vfs.file.time[/path/file,modify]`, lai pārbaudītu, ka fails ilgu laiku nav ticis atjaunināts. - Šo funkciju nav ieteicams izmantot sarežģītās trigeru izteiksmēs (kur iesaistīti vairāki vienumi), jo tā var radīt negaidītus rezultātus (laika starpība tiks mērīta ar jaunāko metriku), piemēram, `fuzzytime(/Host/system.localtime,60s)=0 or last(/Host/trap)<>0`. Piemēri: ```default fuzzytime(/host/system.localtime,5m)=0 #klienta lokālais laiks atšķiras no Zabbix servera/starpniekservera laika par vairāk nekā 5 minūtēm fuzzytime(/host/system.localtime,5m)=0 and nodata(/host/system.localtime,10m)=0 #klienta lokālais laiks atšķiras no Zabbix servera/starpniekservera laika par vairāk nekā 5 minūtēm (vienlaikus pārliecinoties, ka vienums nav pārstājis ziņot datus) ``` #### Gauge A *Gauge* widget has been added to [dashboard widgets](/manual/web_interface/frontend_sections/dashboards/widgets), allowing to display the value of a single item as a gauge. For more information, see [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge). {width="600"} #### Mērītājs Pievienots *Mērītājs* logrīks [informācijas paneļa logrīkiem](/manual/web_interface/frontend_sections/dashboards/widgets), kas ļauj attēlot viena vienuma vērtību kā mērītāju. Papildinformāciju skatiet [*Mērītājs*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge). {width="600"} #### General attributes The *User* tab contains general user attributes: {width="600"} All mandatory input fields are marked with a red asterisk. |Parameter|Description| |--|--------| |*Username*|Unique username, used as the login name.| |*Name*|User first name (optional).<br>If not empty, visible in acknowledgment information and notification recipient information.| |*Last name*|User last name (optional).<br>If not empty, visible in acknowledgment information and notification recipient information.| |*Groups*|Select [user groups](usergroup) the user belongs to. This field is auto-complete so starting to type the name of a user group will offer a dropdown of matching groups. Scroll down to select. Alternatively, click on *Select* to add groups. Click on 'x' to remove the selected.<br>Adherence to user groups determines what host groups and hosts the user will have [access to](permissions).| |*Password*|Two fields for entering the user password, or a *Change password* button if the user already exists.<br>Clicking on the *Change password* button opens two fields for entering a new password.<br>For the user with the *Super admin role* changing own password, clicking on the *Change password* button opens an additional field for entering the current (old) password.<br>On a successful password change, the user for which the password was changed will be logged out of all active sessions.<br>Note that the password can only be changed for users using Zabbix [internal authentication](/manual/web_interface/frontend_sections/users/authentication#default-authentication).| |*Language*|Language of the Zabbix frontend.<br>The php gettext extension is required for the translations to work.| |*Time zone*|Select the time zone to override global [time zone](/manual/web_interface/time_zone#overview) on user level or select **System default** to use global time zone settings.| |*Theme*|Defines how the frontend looks like:<br>**System default** - use default system settings<br>**Blue** - standard blue theme<br>**Dark** - alternative dark theme<br>**High-contrast light** - light theme with high contrast<br>**High-contrast dark** - dark theme with high contrast| |*Auto-login*|Mark this checkbox to make Zabbix remember the user and log the user in automatically for 30 days. <br>When logging in with [*Remember for 30 days*](/manual/quickstart/basic_config/login#persistent-login):<br>- Auto-logout is reset (session persists for 30 days).<br>- Auto-login is enabled for seamless re-authentication.<br>When logging in without *Remember for 30 days*:<br>- Auto-login is enabled for seamless re-authentication.<br>- Auto-logout remains governed by the standard timeout setting. <br>Browser cookies are used for this.| |*Auto-logout*|With this checkbox marked the user will be logged out automatically, after the set amount of seconds (minimum 90 seconds, maximum 1 day).<br>Note, that this setting is overridden if [*Remember for 30 days*](/manual/quickstart/basic_config/login#persistent-login) is enabled, as the session is extended for the full period.<br>[Time suffixes](/manual/appendix/suffixes) are supported, e.g. 90s, 5m, 2h, 1d.<br>Note that this option will not work:<br>\* If the "Show warning if Zabbix server is down" global configuration option is enabled and Zabbix frontend is kept open.<br>\* When Monitoring menu pages perform background information refreshes.<br>\* If logging in with the *Remember me for 30 days* option checked.| |*Refresh*|Set the refresh rate used for graphs, plain text data, etc. Can be set to 0 to disable.<br>[Time suffixes](/manual/appendix/suffixes) are supported, e.g. 90s, 5m, 1h.| |*Rows per page*|You can determine how many rows per page will be displayed in lists.| |*URL (after login)*|You can make Zabbix transfer the user to a specific URL after successful login, for example, to *Problems* page.| #### Vispārīgie atribūti Cilnē *User* ir ietverti vispārīgie lietotāja atribūti: {width="600"} Visi obligātie ievades lauki ir atzīmēti ar sarkanu zvaigznīti. |Parameter|Description| |--|--------| |*Username*|Unikāls lietotājvārds, ko izmanto kā pieteikšanās vārdu.| |*Name*|Lietotāja vārds (neobligāts).<br>Ja nav tukšs, tas ir redzams apstiprinājuma informācijā un paziņojuma saņēmēja informācijā.| |*Last name*|Lietotāja uzvārds (neobligāts).<br>Ja nav tukšs, tas ir redzams apstiprinājuma informācijā un paziņojuma saņēmēja informācijā.| |*Groups*|Atlasiet [lietotāju grupas](usergroup), kurām lietotājs pieder. Šis lauks ir ar automātisko pabeigšanu, tāpēc, sākot rakstīt lietotāju grupas nosaukumu, tiks piedāvāts nolaižamais saraksts ar atbilstošajām grupām. Ritiniet uz leju, lai atlasītu. Alternatīvi noklikšķiniet uz *Select*, lai pievienotu grupas. Noklikšķiniet uz 'x', lai noņemtu atlasīto.<br>Piederība lietotāju grupām nosaka, kādām hosts grupām un hosts lietotājam būs [piekļuve](permissions).| |*Password*|Divi lauki lietotāja paroles ievadīšanai vai poga *Change password*, ja lietotājs jau pastāv.<br>Noklikšķinot uz pogas *Change password*, tiek atvērti divi lauki jaunas paroles ievadīšanai.<br>Lietotājam ar *Super admin role*, mainot savu paroli, noklikšķinot uz pogas *Change password*, tiek atvērts papildu lauks pašreizējās (vecās) paroles ievadīšanai.<br>Pēc veiksmīgas paroles maiņas lietotājs, kuram parole tika mainīta, tiks izrakstīts no visām aktīvajām sesijām.<br>Ņemiet vērā, ka paroli var mainīt tikai lietotājiem, kas izmanto Zabbix [iekšējo autentifikāciju](/manual/web_interface/frontend_sections/users/authentication#default-authentication).| |*Language*|Zabbix lietotāja saskarnes valoda.<br>Lai tulkojumi darbotos, ir nepieciešams php gettext paplašinājums.| |*Time zone*|Atlasiet laika joslu, lai lietotāja līmenī pārrakstītu globālo [laika joslu](/manual/web_interface/time_zone#overview), vai atlasiet **System default**, lai izmantotu globālos laika joslas iestatījumus.| |*Theme*|Nosaka, kā izskatās lietotāja saskarne:<br>**System default** - izmantot noklusējuma sistēmas iestatījumus<br>**Blue** - standarta zilā tēma<br>**Dark** - alternatīva tumšā tēma<br>**High-contrast light** - gaišā tēma ar augstu kontrastu<br>**High-contrast dark** - tumšā tēma ar augstu kontrastu| |*Auto-login*|Atzīmējiet šo izvēles rūtiņu, lai Zabbix atcerētos lietotāju un automātiski pieteiktu viņu 30 dienas. <br>Piesakoties ar [*Remember for 30 days*](/manual/quickstart/basic_config/login#persistent-login):<br>- Auto-logout tiek atiestatīts (sesija saglabājas 30 dienas).<br>- Auto-login ir iespējots netraucētai atkārtotai autentifikācijai.<br>Piesakoties bez *Remember for 30 days*:<br>- Auto-login ir iespējots netraucētai atkārtotai autentifikācijai.<br>- Auto-logout paliek pakļauts standarta noildzes iestatījumam. <br>Tiek izmantotas pārlūkprogrammas sīkdatnes.| |*Auto-logout*|Ja šī izvēles rūtiņa ir atzīmēta, lietotājs tiks automātiski izrakstīts pēc iestatītā sekunžu skaita (minimums 90 sekundes, maksimums 1 diena).<br>Ņemiet vērā, ka šis iestatījums tiek pārrakstīts, ja ir iespējots [*Remember for 30 days*](/manual/quickstart/basic_config/login#persistent-login), jo sesija tiek pagarināta uz visu periodu.<br>[Laika sufiksi](/manual/appendix/suffixes) tiek atbalstīti, piemēram, 90s, 5m, 2h, 1d.<br>Ņemiet vērā, ka šī opcija nedarbosies:<br>\* Ja ir iespējota globālās konfigurācijas opcija "Show warning if Zabbix server is down" un Zabbix lietotāja saskarne ir atstāta atvērta.<br>\* Kad Monitoring izvēlnes lapas veic fona informācijas atsvaidzināšanu.<br>\* Ja piesakās ar atzīmētu opciju *Remember me for 30 days*.| |*Refresh*|Iestatiet atsvaidzināšanas biežumu, ko izmanto diagrammām, vienkārša teksta datiem u. c. Var iestatīt uz 0, lai atspējotu.<br>[Laika sufiksi](/manual/appendix/suffixes) tiek atbalstīti, piemēram, 90s, 5m, 1h.| |*Rows per page*|Varat noteikt, cik rindu vienā lapā tiks rādīts sarakstos.| |*URL (after login)*|Varat iestatīt, lai Zabbix pēc veiksmīgas pieteikšanās novirza lietotāju uz noteiktu URL, piemēram, uz lapu *Problems*.| #### General Change certain global configuration options. [Autoregistration API](/manual/api/reference/autoregistration) | [Icon map API](/manual/api/reference/iconmap) | [Image API](/manual/api/reference/image) | [Settings API](/manual/api/reference/settings) | [Regular expression API](/manual/api/reference/regexp) | [Module API](/manual/api/reference/module) | [Connector API](/manual/api/reference/connector) #### Vispārīgi Mainiet noteiktas globālās konfigurācijas opcijas. [Autoreģistrācijas API](/manual/api/reference/autoregistration) | [Ikonu kartes API](/manual/api/reference/iconmap) | [Attēlu API](/manual/api/reference/image) | [Iestatījumu API](/manual/api/reference/settings) | [Regulāro izteiksmju API](/manual/api/reference/regexp) | [Moduļu API](/manual/api/reference/module) | [Savienotāju API](/manual/api/reference/connector) #### General recommendations - Start with understanding which component acts as a TLS client and which one acts as a TLS server in problem case.<br> Zabbix server, proxies and agents, depending on interaction between them, all can work as TLS servers and clients.<br> For example, Zabbix server connecting to agent for a passive check, acts as a TLS client. The agent is in role of TLS server.<br> Zabbix agent, requesting a list of active checks from proxy, acts as a TLS client. The proxy is in role of TLS server.<br> `zabbix_get` and `zabbix_sender` utilities always act as TLS clients. - Zabbix uses mutual authentication.<br> Each side verifies its peer and may refuse connection.<br> For example, Zabbix server connecting to agent can close connection immediately if agent's certificate is invalid. And vice versa - Zabbix agent accepting a connection from server can close connection if server is not trusted by agent. - Examine logfiles in both sides - in TLS client and TLS server.<br> The side which refuses connection may log a precise reason why it was refused. Other side often reports rather general error (e.g. "Connection closed by peer", "connection was non-properly terminated"). - Sometimes misconfigured encryption results in confusing error messages in no way pointing to real cause.<br> In subsections below we try to provide a (far from exhaustive) collection of messages and possible causes which could help in troubleshooting.<br> Please note that different crypto toolkits (OpenSSL, GnuTLS) often produce different error messages in same problem situations.<br> Sometimes error messages depend even on particular combination of crypto toolkits on both sides. #### Vispārīgi ieteikumi - Sāciet ar izpratni, kurš komponents konkrētajā problēmsituācijā darbojas kā TLS klients un kurš — kā TLS serveris.<br> Zabbix serveris, starpniekserveri un aģenti atkarībā no mijiedarbības starp tiem var darboties gan kā TLS serveri, gan kā TLS klienti.<br> Piemēram, Zabbix serveris, pieslēdzoties aģentam pasīvai pārbaudei, darbojas kā TLS klients. Aģents ir TLS servera lomā.<br> Zabbix aģents, pieprasot aktīvo pārbaužu sarakstu no starpniekservera, darbojas kā TLS klients. Starpniekserveris ir TLS servera lomā.<br> Utilītas `zabbix_get` un `zabbix_sender` vienmēr darbojas kā TLS klienti. - Zabbix izmanto savstarpēju autentifikāciju.<br> Katra puse pārbauda otru pusi un var atteikt savienojumu.<br> Piemēram, Zabbix serveris, pieslēdzoties aģentam, var nekavējoties aizvērt savienojumu, ja aģenta sertifikāts nav derīgs. Un otrādi — Zabbix aģents, pieņemot savienojumu no servera, var aizvērt savienojumu, ja serverim aģents neuzticas. - Pārbaudiet žurnālfailus abās pusēs — TLS klientā un TLS serverī.<br> Puse, kas atsaka savienojumu, var reģistrēt precīzu iemeslu, kāpēc tas tika atteikts. Otra puse bieži ziņo tikai par vispārīgu kļūdu (piem., "Connection closed by peer", "connection was non-properly terminated"). - Dažkārt nepareizi konfigurēta šifrēšana rada mulsinošus kļūdu ziņojumus, kas nekādā veidā nenorāda uz patieso cēloni.<br> Tālāk esošajās apakšsadaļās mēs cenšamies sniegt (nebūt ne izsmeļošu) ziņojumu un iespējamo cēloņu apkopojumu, kas var palīdzēt problēmu novēršanā.<br> Lūdzu, ņemiet vērā, ka dažādi kriptogrāfijas rīkkopas (OpenSSL, GnuTLS) vienādās problēmsituācijās bieži rada atšķirīgus kļūdu ziņojumus.<br> Dažkārt kļūdu ziņojumi ir atkarīgi pat no konkrētās kriptogrāfijas rīkkopu kombinācijas abās pusēs. #### Generate multiple tokens Generate two tokens. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "token.generate", "params": [ "1", "2" ], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "tokenid": "1", "token": "bbcfce79a2d95037502f7e9a534906d3466c9a1484beb6ea0f4e7be28e8b8ce2" }, { "tokenid": "2", "token": "fa1258a83d518eabd87698a96bd7f07e5a6ae8aeb8463cae33d50b91dd21bd6d" } ], "id": 1 } ``` #### Ģenerēt vairākus tokenus Ģenerējiet divus tokenus. [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "token.generate", "params": [ "1", "2" ], "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": [ { "tokenid": "1", "token": "bbcfce79a2d95037502f7e9a534906d3466c9a1484beb6ea0f4e7be28e8b8ce2" }, { "tokenid": "2", "token": "fa1258a83d518eabd87698a96bd7f07e5a6ae8aeb8463cae33d50b91dd21bd6d" } ], "id": 1 } ``` ##### Generating from history/trends Graphs can be drawn based on either item [history or trends](/manual/config/items/history_and_trends). For the users who have frontend [debug mode](/manual/web_interface/debug_mode) activated, a gray, vertical caption is displayed at the bottom right of a graph indicating where the data come from. Several factors influence whether history of trends is used: - longevity of item history. For example, item history can be kept for 14 days. In that case, any data older than the fourteen days will be coming from trends. - data congestion in the graph. If the amount of seconds to display in a horizontal graph pixel exceeds 3600/16, trend data are displayed (even if item history is still available for the same period). - if trends are disabled, item history is used for graph building - if available for that period. ##### Ģenerēšana no vēstures/tendencēm Grafikus var zīmēt, pamatojoties uz vienuma [vēsturi vai tendencēm](/manual/config/items/history_and_trends). Lietotājiem, kuriem ir aktivizēts lietotāja saskarne [atkļūdošanas režīms](/manual/web_interface/debug_mode), grafika apakšējā labajā stūrī tiek parādīts pelēks, vertikāls paraksts, kas norāda, no kurienes nāk dati. Vairāki faktori ietekmē to, vai tiek izmantota vēsture vai tendences: - vienuma vēstures saglabāšanas ilgums. Piemēram, vienuma vēsture var tikt glabāta 14 dienas. Šādā gadījumā visi dati, kas ir vecāki par četrpadsmit dienām, tiks ņemti no tendencēm. - datu pārslodze grafikā. Ja sekunžu skaits, kas jāattēlo vienā horizontālā grafika pikselī, pārsniedz 3600/16, tiek attēloti tendenču dati (pat ja vienuma vēsture joprojām ir pieejama tam pašam periodam). - ja tendences ir atspējotas, grafika veidošanai tiek izmantota vienuma vēsture - ja tā ir pieejama attiecīgajam periodam. #### Generating PSK For example, a 256-bit (32 bytes) PSK can be generated using the following commands: - with *OpenSSL*: ```{=html} <!-- --> ``` $ openssl rand -hex 32 af8ced32dfe8714e548694e2d29e1a14ba6fa13f216cb35c19d0feb1084b0429 - with *GnuTLS*: ```{=html} <!-- --> ``` $ psktool -u psk_identity -p database.psk -s 32 Generating a random key for user 'psk_identity' Key stored to database.psk $ cat database.psk psk_identity:9b8eafedfaae00cece62e85d5f4792c7d9c9bcc851b23216a1d300311cc4f7cb Note that "psktool" above generates a database file with a PSK identity and its associated PSK. Zabbix expects just a PSK in the PSK file, so the identity string and colon (':') should be removed from the file. #### PSK ģenerēšana Piemēram, 256 bitu (32 baitu) PSK var ģenerēt, izmantojot šādas komandas: - ar *OpenSSL*: ```{=html} <!-- --> ``` $ openssl rand -hex 32 af8ced32dfe8714e548694e2d29e1a14ba6fa13f216cb35c19d0feb1084b0429 - ar *GnuTLS*: ```{=html} <!-- --> ``` $ psktool -u psk_identity -p database.psk -s 32 Tiek ģenerēta nejauša atslēga lietotājam 'psk_identity' Atslēga saglabāta database.psk $ cat database.psk psk_identity:9b8eafedfaae00cece62e85d5f4792c7d9c9bcc851b23216a1d300311cc4f7cb Ņemiet vērā, ka iepriekš minētais "psktool" ģenerē datubāzes failu ar PSK identitāti un tai piesaistīto PSK. Zabbix PSK failā sagaida tikai PSK, tāpēc identitātes virkne un kols (':') no faila ir jāizņem. #### Geographical maps This section allows selecting geographical map tile service provider and configuring service provider settings for the Geomap [dashboard widget](/manual/web_interface/frontend_sections/dashboards/widgets/geomap). To provide visualization using the geographical maps, Zabbix uses open-source JavaScript interactive maps library Leaflet. Please note that Zabbix has no control over the quality of images provided by third-party tile providers, including the predefined tile providers.  |Parameter|Description| |--|--------| |Tile provider|Select one of the available tile service providers or select *Other* to add another tile provider or self-hosted tiles (see [Using a custom tile service provider](#using-a-custom-tile-service-provider)).| |Tile URL|The URL template (up to 2048 characters) for loading and displaying the tile layer on geographical maps.<br>This field is editable only if *Tile provider* is set to *Other*.<br><br>The following placeholders are supported:<br>*{s}* represents one of the available subdomains;<br>*{z}* represents zoom level parameter in the URL;<br>*{x}* and *{y}* represent tile coordinates;<br>*{r}* can be used to add "\@2x" to the URL to load retina tiles.<br><br>Example: `https://{s}.example.com/{z}/{x}/{y}{r}.png`| |Attribution text|Tile provider attribution text to be displayed in a small text box on the map. This field is visible only if *Tile provider* is set to *Other*.| |Max zoom level|Maximum zoom level of the map. This field is editable only if *Tile provider* is set to *Other*.| #### Ģeogrāfiskās kartes Šī sadaļa ļauj atlasīt ģeogrāfisko karšu flīžu pakalpojuma sniedzēju un konfigurēt pakalpojuma sniedzēja iestatījumus Geomap [paneļa sīkrīkam](/manual/web_interface/frontend_sections/dashboards/widgets/geomap). Lai nodrošinātu vizualizāciju, izmantojot ģeogrāfiskās kartes, Zabbix izmanto atvērtā pirmkoda JavaScript interaktīvo karšu bibliotēku Leaflet. Lūdzu, ņemiet vērā, ka Zabbix nekontrolē trešo pušu flīžu sniedzēju, tostarp iepriekš definēto flīžu sniedzēju, nodrošināto attēlu kvalitāti.  |Parameter|Description| |--|--------| |Tile provider|Atlasiet vienu no pieejamajiem flīžu pakalpojuma sniedzējiem vai atlasiet *Other*, lai pievienotu citu flīžu pakalpojuma sniedzēju vai pašmitinātas flīzes (skatiet [Pielāgota flīžu pakalpojuma sniedzēja izmantošana](#using-a-custom-tile-service-provider)).| |Tile URL|URL veidne (līdz 2048 rakstzīmēm) flīžu slāņa ielādei un attēlošanai ģeogrāfiskajās kartēs.<br>Šis lauks ir rediģējams tikai tad, ja *Tile provider* ir iestatīts uz *Other*.<br><br>Tiek atbalstīti šādi vietturi:<br>*{s}* apzīmē vienu no pieejamajiem apakšdomēniem;<br>*{z}* apzīmē tālummaiņas līmeņa parametru URL;<br>*{x}* un *{y}* apzīmē flīzes koordinātas;<br>*{r}* var izmantot, lai URL pievienotu "\@2x" un ielādētu retina flīzes.<br><br>Piemērs: `https://{s}.example.com/{z}/{x}/{y}{r}.png`| |Attribution text|Flīžu pakalpojuma sniedzēja atribūcijas teksts, kas tiks parādīts nelielā teksta lodziņā kartē. Šis lauks ir redzams tikai tad, ja *Tile provider* ir iestatīts uz *Other*.| |Max zoom level|Kartes maksimālais tālummaiņas līmenis. Šis lauks ir rediģējams tikai tad, ja *Tile provider* ir iestatīts uz *Other*.| #### Geomap widget error The maps in the Geomap widget may not load correctly, if you have upgraded from an older Zabbix version with NGINX and didn't switch to the new NGINX configuration file during the upgrade. To fix the issue, you can discard the old configuration file, use the configuration file from the current version package and reconfigure it as described in the [download instructions](https://www.zabbix.com/download?zabbix=6.0&os_distribution=red_hat_enterprise_linux&os_version=8&db=mysql&ws=nginx) in section *e. Configure PHP for Zabbix frontend*. Alternatively, you can manually edit an existing NGINX configuration file (typically, */etc/zabbix/nginx.conf*). To do so, open the file and locate the following block: ```ini location ~ /(api\/|conf[^\.]|include|locale|vendor) { deny all; return 404; } ``` Then, replace this block with: ```ini location ~ /(api\/|conf[^\.]|include|locale) { deny all; return 404; } location /vendor { deny all; return 404; } ``` #### Geomap logrīka kļūda Geomap logrīkā kartes var netikt ielādētas pareizi, ja esat veicis jaunināšanu no vecākas Zabbix versijas ar NGINX un jaunināšanas laikā nepārslēdzāties uz jauno NGINX konfigurācijas failu. Lai novērstu problēmu, varat atmest veco konfigurācijas failu, izmantot konfigurācijas failu no pašreizējās versijas pakotnes un pārkonfigurēt to, kā aprakstīts [lejupielādes instrukcijās](https://www.zabbix.com/download?zabbix=6.0&os_distribution=red_hat_enterprise_linux&os_version=8&db=mysql&ws=nginx) sadaļā *e. Configure PHP for Zabbix frontend*. Alternatīvi varat manuāli rediģēt esošu NGINX konfigurācijas failu (parasti, */etc/zabbix/nginx.conf*). Lai to izdarītu, atveriet failu un atrodiet šādu bloku: ```ini location ~ /(api\/|conf[^\.]|include|locale|vendor) { deny all; return 404; } ``` Pēc tam aizstājiet šo bloku ar: ```ini location ~ /(api\/|conf[^\.]|include|locale) { deny all; return 404; } location /vendor { deny all; return 404; } ``` #### Get a count of standby nodes [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "hanode.get", "params": { "countOutput": true, "filter": { "status": 0 } }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": "3", "id": 1 } ``` #### Iegūt gaidstāves mezglu skaitu [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "hanode.get", "params": { "countOutput": true, "filter": { "status": 0 } }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": "3", "id": 1 } ``` #### Get a list of nodes ordered by status [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "hanode.get", "params": { "preservekeys": true, "sortfield": "status", "sortorder": "DESC" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "ckuo7i1nw000h0sajj3l3hh8u": { "ha_nodeid": "ckuo7i1nw000h0sajj3l3hh8u", "name": "node-active", "address": "192.168.1.13", "port": "10051", "lastaccess": "1635335704", "status": "3" }, "ckuo7i1nw000e0sajwfttc1mp": { "ha_nodeid": "ckuo7i1nw000e0sajwfttc1mp", "name": "node6", "address": "192.168.1.10", "port": "10053", "lastaccess": "1635332902", "status": "2" }, "ckuo7i1nv000c0sajz85xcrtt": { "ha_nodeid": "ckuo7i1nv000c0sajz85xcrtt", "name": "node4", "address": "192.168.1.8", "port": "10052", "lastaccess": "1635334214", "status": "1" }, "ckuo7i1nv000a0saj1fcdkeu4": { "ha_nodeid": "ckuo7i1nv000a0saj1fcdkeu4", "name": "node2", "address": "192.168.1.6", "port": "10051", "lastaccess": "1635335705", "status": "0" } }, "id": 1 } ``` #### Iegūt pēc statusa sakārtotu mezglu sarakstu [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "hanode.get", "params": { "preservekeys": true, "sortfield": "status", "sortorder": "DESC" }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": { "ckuo7i1nw000h0sajj3l3hh8u": { "ha_nodeid": "ckuo7i1nw000h0sajj3l3hh8u", "name": "node-active", "address": "192.168.1.13", "port": "10051", "lastaccess": "1635335704", "status": "3" }, "ckuo7i1nw000e0sajwfttc1mp": { "ha_nodeid": "ckuo7i1nw000e0sajwfttc1mp", "name": "node6", "address": "192.168.1.10", "port": "10053", "lastaccess": "1635332902", "status": "2" }, "ckuo7i1nv000c0sajz85xcrtt": { "ha_nodeid": "ckuo7i1nv000c0sajz85xcrtt", "name": "node4", "address": "192.168.1.8", "port": "10052", "lastaccess": "1635334214", "status": "1" }, "ckuo7i1nv000a0saj1fcdkeu4": { "ha_nodeid": "ckuo7i1nv000a0saj1fcdkeu4", "name": "node2", "address": "192.168.1.6", "port": "10051", "lastaccess": "1635335705", "status": "0" } }, "id": 1 } ``` #### Get a list of specific nodes by their IDs [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "hanode.get", "params": { "ha_nodeids": ["ckuo7i1nw000e0sajwfttc1mp", "ckuo7i1nv000c0sajz85xcrtt"] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "ha_nodeid": "ckuo7i1nv000c0sajz85xcrtt", "name": "node4", "address": "192.168.1.8", "port": "10052", "lastaccess": "1635334214", "status": "1" }, { "ha_nodeid": "ckuo7i1nw000e0sajwfttc1mp", "name": "node6", "address": "192.168.1.10", "port": "10053", "lastaccess": "1635332902", "status": "2" } ], "id": 1 } ``` #### Iegūt konkrētu mezglu sarakstu pēc to ID [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "hanode.get", "params": { "ha_nodeids": ["ckuo7i1nw000e0sajwfttc1mp", "ckuo7i1nv000c0sajz85xcrtt"] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": [ { "ha_nodeid": "ckuo7i1nv000c0sajz85xcrtt", "name": "node4", "address": "192.168.1.8", "port": "10052", "lastaccess": "1635334214", "status": "1" }, { "ha_nodeid": "ckuo7i1nw000e0sajwfttc1mp", "name": "node6", "address": "192.168.1.10", "port": "10053", "lastaccess": "1635332902", "status": "2" } ], "id": 1 } ``` #### Get a list of stopped nodes [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "hanode.get", "params": { "output": ["ha_nodeid", "address", "port"], "filter": { "status": 1 } }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "ha_nodeid": "ckuo7i1nw000g0sajjsjre7e3", "address": "192.168.1.12", "port": "10051" }, { "ha_nodeid": "ckuo7i1nv000c0sajz85xcrtt", "address": "192.168.1.8", "port": "10052" }, { "ha_nodeid": "ckuo7i1nv000d0sajd95y1b6x", "address": "192.168.1.9", "port": "10053" } ], "id": 1 } ``` #### Iegūt apturēto mezglu sarakstu [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "hanode.get", "params": { "output": ["ha_nodeid", "address", "port"], "filter": { "status": 1 } }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": [ { "ha_nodeid": "ckuo7i1nw000g0sajjsjre7e3", "address": "192.168.1.12", "port": "10051" }, { "ha_nodeid": "ckuo7i1nv000c0sajz85xcrtt", "address": "192.168.1.8", "port": "10052" }, { "ha_nodeid": "ckuo7i1nv000d0sajd95y1b6x", "address": "192.168.1.9", "port": "10053" } ], "id": 1 } ``` ## Get started with Zabbix ## Sāciet darbu ar Zabbix ##### Getting the list of items **Agent request** The active checks request is used to obtain the active checks to be processed by agent. This request is sent by the agent upon start and then with [RefreshActiveChecks](/manual/appendix/config/zabbix_agent2) intervals. ```json { "request": "active checks", "host": "Zabbix server", "host_metadata": "mysql,nginx", "interface": "zabbix.server.lan", "ip": "159.168.1.1", "port": 12050, "version": "7.0.0", "variant": 2, "config_revision": 1, "session": "e3dcbd9ace2c9694e1d7bbd030eeef6e" } ``` | Field | Type | Mandatory | Value | |-|-|-|--------| | request | _string_ | yes | `active checks` | | host | _string_ | yes | Host name. | | host_metadata | _string_ | no | The configuration parameter HostMetadata or HostMetadataItem metric value. | | interface | _string_ | no | The configuration parameter HostInterface or HostInterfaceItem metric value. | | ip | _string_ | no | The configuration parameter ListenIP first IP if set. | | port | _number_ | no | The configuration parameter ListenPort value if set and not default agent listening port. | | version | _string_ | yes | The agent version number. | | variant | _number_ | yes | The agent variant (*1* - Zabbix agent, *2* - Zabbix agent 2). | | config_revision | _number_ | no | Configuration identifier for [incremental configuration sync](#active-checks). | | session | _string_ | no | Session identifier for [incremental configuration sync](#active-checks). | **Server response** The active checks response is sent by the server back to agent after processing the active checks request. ```json { "response": "success", "config_revision": 2, "data": [ { "key": "system.uptime", "itemid": 1234, "delay": "10s", "lastlogsize": 0, "mtime": 0 }, { "key": "agent.version", "itemid": 5678, "delay": "10m", "lastlogsize": 0, "mtime": 0, "timeout": "30s" } ], "commands": [ { "command": "df -h --output=source,size / | awk 'NR>1 {print $2}'", "id": 1324, "wait": 1 } ] } ``` | Field |<| Type | Mandatory | Value | |-|------|--|-|-----------------------| | response |<| _string_ | yes | `success` \| `failed` | | info |<| _string_ | no | Error information in case of failure. | | data |<| _array of objects_ | no | Active check items. Omitted if host configuration is unchanged. | | | key | _string_ | no | Item key with expanded macros. | |^| itemid | _number_ | no | Item identifier. | |^| delay | _string_ | no | Item update interval.<br>Flexible/scheduling intervals are supported by both Zabbix agent and Zabbix agent 2 since Zabbix 7.0. | |^| lastlogsize | _number_ | no | Item lastlogsize. | |^| mtime | _number_ | no | Item mtime. | |^| timeout | _string_ | no | Item timeout. | | refresh_unsupported |<| _number_ | no | Unsupported item refresh interval. | | regexp |<| _array of objects_ | no | Global regular expressions. | | | name | _string_ | no | Global regular expression name. | |^| expression | _string_ | no | Global regular expression. | |^| expression_type | _number_ | no | Global regular expression type. | |^| exp_delimiter | _string_ | no | Global regular expression delimiter. | |^| case_sensitive | _number_ | no | Global regular expression case sensitivity setting. | | commands |<| _array of objects_ | no | Remote commands to execute. Included if remote command execution has been triggered by an action [operation](/manual/config/notifications/action/operation#operations) or manual [script](/manual/web_interface/frontend_sections/alerts/scripts) execution. Note that remote command execution on an active agent is supported since Zabbix agent 7.0. Older active agents will ignore any remote commands included in the active checks server response. | | | command | _string_ | no | Remote command. | |^| id | _number_ | no | Remote command identifier. | |^| wait | _number_ | no | Remote command mode of execution ("0" (nowait) for commands from action [operations](/manual/config/notifications/action/operation#operations); "1" (wait) for commands from manual [script](/manual/web_interface/frontend_sections/alerts/scripts) execution). | |^| timeout | _number_ | no | Remote command execution timeout in [server](/manual/appendix/config/zabbix_server#timeout)/[proxy](/manual/appendix/config/zabbix_proxy#timeout) configuration. | | config_revision | < | _number_ | no | Configuration identifier for [incremental configuration sync](#active-checks). Omitted if host configuration is unchanged. Incremented if host configuration is changed. | The server must respond with success. For example: 1. Agent opens a TCP connection 2. Agent asks for the list of checks 3. Server responds with a list of items and remote commands to execute 4. Agent parses the response 5. TCP connection is closed 6. Agent starts periodical collection of data and executes remote commands (supported since Zabbix agent 7.0) ::: noteimportant Note that (sensitive) configuration data may become available to parties having access to the Zabbix server trapper port when using an active check. This is possible because anyone may pretend to be an active agent and request item configuration data; authentication does not take place unless you use [encryption](/manual/encryption) options. ::: ##### Vienumu saraksta iegūšana **Aģenta pieprasījums** Aktīvo pārbaužu pieprasījums tiek izmantots, lai iegūtu aktīvās pārbaudes, kuras jāapstrādā aģentam. Šo pieprasījumu aģents nosūta startēšanas laikā un pēc tam ar [RefreshActiveChecks](/manual/appendix/config/zabbix_agent2) intervāliem. ```json { "request": "active checks", "host": "Zabbix serveris", "host_metadata": "mysql,nginx", "interface": "zabbix.server.lan", "ip": "159.168.1.1", "port": 12050, "version": "7.0.0", "variant": 2, "config_revision": 1, "session": "e3dcbd9ace2c9694e1d7bbd030eeef6e" } ``` | Field | Type | Mandatory | Value | |-|-|-|--------| | request | _string_ | yes | `active checks` | | host | _string_ | yes | Host name. | | host_metadata | _string_ | no | The configuration parameter HostMetadata or HostMetadataItem metric value. | | interface | _string_ | no | The configuration parameter HostInterface or HostInterfaceItem metric value. | | ip | _string_ | no | The configuration parameter ListenIP first IP if set. | | port | _number_ | no | The configuration parameter ListenPort value if set and not default agent listening port. | | version | _string_ | yes | The agent version number. | | variant | _number_ | yes | The agent variant (*1* - Zabbix agent, *2* - Zabbix agent 2). | | config_revision | _number_ | no | Configuration identifier for [incremental configuration sync](#active-checks). | | session | _string_ | no | Session identifier for [incremental configuration sync](#active-checks). | **Servera atbilde** Aktīvo pārbaužu atbilde tiek nosūtīta no servera atpakaļ aģentam pēc aktīvo pārbaužu pieprasījuma apstrādes. ```json { "response": "success", "config_revision": 2, "data": [ { "key": "system.uptime", "itemid": 1234, "delay": "10s", "lastlogsize": 0, "mtime": 0 }, { "key": "agent.version", "itemid": 5678, "delay": "10m", "lastlogsize": 0, "mtime": 0, "timeout": "30s" } ], "commands": [ { "command": "df -h --output=source,size / | awk 'NR>1 {print $2}'", "id": 1324, "wait": 1 } ] } ``` | Field |<| Type | Mandatory | Value | |-|------|--|-|-----------------------| | response |<| _string_ | yes | `success` \| `failed` | | info |<| _string_ | no | Error information in case of failure. | | data |<| _array of objects_ | no | Active check items. Omitted if host configuration is unchanged. | | | key | _string_ | no | Item key with expanded macros. | |^| itemid | _number_ | no | Item identifier. | |^| delay | _string_ | no | Item update interval.<br>Flexible/scheduling intervals are supported by both Zabbix agent and Zabbix agent 2 since Zabbix 7.0. | |^| lastlogsize | _number_ | no | Item lastlogsize. | |^| mtime | _number_ | no | Item mtime. | |^| timeout | _string_ | no | Item timeout. | | refresh_unsupported |<| _number_ | no | Unsupported item refresh interval. | | regexp |<| _array of objects_ | no | Global regular expressions. | | | name | _string_ | no | Global regular expression name. | |^| expression | _string_ | no | Global regular expression. | |^| expression_type | _number_ | no | Global regular expression type. | |^| exp_delimiter | _string_ | no | Global regular expression delimiter. | |^| case_sensitive | _number_ | no | Global regular expression case sensitivity setting. | | commands |<| _array of objects_ | no | Remote commands to execute. Included if remote command execution has been triggered by an action [operation](/manual/config/notifications/action/operation#operations) or manual [script](/manual/web_interface/frontend_sections/alerts/scripts) execution. Note that remote command execution on an active agent is supported since Zabbix agent 7.0. Older active agents will ignore any remote commands included in the active checks server response. | | | command | _string_ | no | Remote command. | |^| id | _number_ | no | Remote command identifier. | |^| wait | _number_ | no | Remote command mode of execution ("0" (nowait) for commands from action [operations](/manual/config/notifications/action/operation#operations); "1" (wait) for commands from manual [script](/manual/web_interface/frontend_sections/alerts/scripts) execution). | |^| timeout | _number_ | no | Remote command execution timeout in [server](/manual/appendix/config/zabbix_server#timeout)/[proxy](/manual/appendix/config/zabbix_proxy#timeout) configuration. | | config_revision | < | _number_ | no | Configuration identifier for [incremental configuration sync](#active-checks). Omitted if host configuration is unchanged. Incremented if host configuration is changed. | Serverim jāatbild ar success. Piemēram: 1. Aģents atver TCP savienojumu 2. Aģents pieprasa pārbaužu sarakstu 3. Serveris atbild ar vienumu un izpildāmo attālo komandu sarakstu 4. Aģents parsē atbildi 5. TCP savienojums tiek aizvērts 6. Aģents sāk periodisku datu vākšanu un izpilda attālās komandas (atbalstīts kopš Zabbix agent 7.0) ::: noteimportant Ņemiet vērā, ka, izmantojot aktīvo pārbaudi, (sensitīvi) konfigurācijas dati var kļūt pieejami pusēm, kurām ir piekļuve Zabbix servera trapper porta. Tas ir iespējams, jo ikviens var izlikties par aktīvu aģentu un pieprasīt vienuma konfigurācijas datus; autentifikācija nenotiek, ja vien netiek izmantotas [šifrēšanas](/manual/encryption) opcijas. ::: #### Getting Zabbix source code There are several ways of getting Zabbix source code: - You can [download](https://www.zabbix.com/download_sources#70LTS) the released stable versions from the official Zabbix website - You can [download](https://www.zabbix.com/developers) nightly builds from the official Zabbix website developer page - You can get the latest development version from the Git source code repository system: - The primary location of the full repository is at <https://git.zabbix.com/scm/zbx/zabbix.git> - Master and supported releases are also mirrored to Github at <https://github.com/zabbix/zabbix> A Git client must be installed to clone the repository. The official commandline Git client package is commonly called **git** in distributions. To install, for example, on Debian/Ubuntu, run: sudo apt-get update sudo apt-get install git To grab all Zabbix source, change to the directory you want to place the code in and execute: git clone https://git.zabbix.com/scm/zbx/zabbix.git #### Zabbix avota koda iegūšana Ir vairāki veidi, kā iegūt Zabbix avota kodu: - Jūs varat [lejupielādēt](https://www.zabbix.com/download_sources#70LTS) stabilās izlaistās versijas no oficiālās Zabbix vietnes - Jūs varat [lejupielādēt](https://www.zabbix.com/developers) nakts būvējumus no oficiālās Zabbix vietnes izstrādātāju lapas - Jūs varat iegūt jaunāko izstrādes versiju no Git avota koda repozitorija sistēmas: - Galvenā pilnā repozitorija atrašanās vieta ir <https://git.zabbix.com/scm/zbx/zabbix.git> - Master un atbalstītie laidieni ir arī spoguļoti Github vietnē <https://github.com/zabbix/zabbix> Lai klonētu repozitoriju, ir jābūt instalētam Git klientam. Oficiālais komandrindas Git klienta pakotnes nosaukums distribūcijās parasti ir **git**. Piemēram, lai to instalētu Debian/Ubuntu, izpildiet: sudo apt-get update sudo apt-get install git Lai iegūtu visu Zabbix avota kodu, pārejiet uz direktoriju, kurā vēlaties ievietot kodu, un izpildiet: git clone https://git.zabbix.com/scm/zbx/zabbix.git #### Global event correlation Events may not get correlated correctly if the time interval between the first and second event is very small, i.e. half a second and less. #### Globālā notikumu korelācija Notikumi var netikt korekti korelēti, ja laika intervāls starp pirmo un otro notikumu ir ļoti mazs, t.i., puse sekundes vai mazāk. ### Global JavaScript functions Additional global JavaScript functions have been implemented with Duktape: - `btoa(data)` - encodes the data to Base64 string. - `atob(base64_string)` - since version 7.0.1, decodes Base64 string as Uint8Array buffer (in Zabbix 7.0.0 this function returns a decoded string). ```javascript try { b64 = btoa("test string"); buffer = atob(b64); // Note that decoding logic depends on the data format of the buffer. decoded = String.fromCharCode.apply(this, [].slice.call(buffer)); } catch (error) { return {'error.name' : error.name, 'error.message' : error.message}; } ``` - `md5(data)` - calculates the MD5 hash of the data. - `sha256(data)` - calculates the SHA256 hash of the data. - `hmac('<hash type>',key,data)` - returns a HMAC hash as a hex-formatted string; `md5` and `sha256` are supported as the `hash type`; the `key` and `data` parameters support binary data. Examples: - `hmac('md5',key,data)` - `hmac('sha256',key,data)` - `sign(hash,key,data)` - returns calculated signature (RSA signature with SHA-256) as a string, where:<br> **hash** - only `sha256` is allowed, otherwise an error is thrown.<br> **key** - the private key. It should correspond to PKCS#1 or PKCS#8 standard. The key can be provided in different forms:<br> - with spaces instead of newlines - with escaped or non-escaped `\n` instead of newlines - without any newlines as a single-line string - as a JSON-formatted string The key also can be loaded from a user macro/secret macro/vault. **data** - the data that will be signed. It can be a string (binary data also supported) or buffer (Uint8Array/ArrayBuffer). Example: - `sign('sha256',key,data)` OpenSSL or GnuTLS is used to calculate the signatures. If Zabbix was built without any of these encryption libraries, an error will be thrown ('missing OpenSSL or GnuTLS library'). ### Globālās JavaScript funkcijas Papildu globālās JavaScript funkcijas ir ieviestas ar Duktape: - `btoa(data)` - kodē datus Base64 virknē. - `atob(base64_string)` - начиная ar versiju 7.0.1, dekodē Base64 virkni kā Uint8Array buferi (Zabbix 7.0.0 šī funkcija atgriež dekodētu virkni). ```javascript try { b64 = btoa("test string"); buffer = atob(b64); // Ņemiet vērā, ka dekodēšanas loģika ir atkarīga no bufera datu formāta. decoded = String.fromCharCode.apply(this, [].slice.call(buffer)); } catch (error) { return {'error.name' : error.name, 'error.message' : error.message}; } ``` - `md5(data)` - aprēķina datu MD5 jaucējvērtību. - `sha256(data)` - aprēķina datu SHA256 jaucējvērtību. - `hmac('<hash type>',key,data)` - atgriež HMAC jaucējvērtību heksadecimālā formātā; kā `hash type` tiek atbalstīti `md5` un `sha256`; parametri `key` un `data` atbalsta bināros datus. Piemēri: - `hmac('md5',key,data)` - `hmac('sha256',key,data)` - `sign(hash,key,data)` - atgriež aprēķinātu parakstu (RSA paraksts ar SHA-256) kā virkni, kur:<br> **hash** - ir atļauts tikai `sha256`, pretējā gadījumā tiek izraisīta kļūda.<br> **key** - privātā atslēga. Tai jāatbilst PKCS#1 vai PKCS#8 standartam. Atslēgu var norādīt dažādos formātos:<br> - ar atstarpēm jaunu rindu vietā - ar ekrānētiem vai neekrānētiem `\n` jaunu rindu vietā - bez jebkādām jaunām rindām kā vienas rindas virkne - kā JSON formāta virkne Atslēgu var arī ielādēt no lietotāja makro/secret makro/vault. **data** - dati, kas tiks parakstīti. Tie var būt virkne (atbalstīti arī binārie dati) vai buferis (Uint8Array/ArrayBuffer). Piemērs: - `sign('sha256',key,data)` Parakstu aprēķināšanai tiek izmantots OpenSSL vai GnuTLS. Ja Zabbix ir kompilēts bez kādas no šīm šifrēšanas bibliotēkām, tiks izraisīta kļūda ('missing OpenSSL or GnuTLS library'). ### Global macro The global macro object has the following properties. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |globalmacroid|ID|ID of the global macro.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*<br>- *required* for update operations| |macro|string|Macro string.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |value|string|Value of the macro.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *write-only* if `type` is set to "Secret macro"<br>- *required* for create operations| |type|integer|Type of macro.<br><br>Possible values:<br>0 - *(default)* Text macro;<br>1 - Secret macro;<br>2 - Vault secret.| |description|string|Description of the macro.| ### Globālais makro Globālā makro objekta īpašības ir šādas. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |globalmacroid|ID|Globālā makro ID.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *tikai lasāms*<br>- *obligāts* atjaunināšanas operācijām| |macro|string|Makro virkne.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *obligāts* izveides operācijām| |value|string|Makro vērtība.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *tikai rakstāms*, ja `type` ir iestatīts uz "Secret macro"<br>- *obligāts* izveides operācijām| |type|integer|Makro tips.<br><br>Iespējamās vērtības:<br>0 - *(noklusējums)* Teksta makro;<br>1 - Slepenais makro;<br>2 - Vault slepenais.| |description|string|Makro apraksts.| ##### Global messages displayed As messages arrive, they are displayed in a floating section on the right-hand side. You can freely reposition this section by dragging the section header.  For this section, several controls are available: -  **Snooze** button silences the currently active alarm sound; -  **Mute/Unmute** button switches between playing and not playing the alarm sounds at all. ##### Parādītie globālie ziņojumi Kad pienāk ziņojumi, tie tiek parādīti peldošā sadaļā labajā pusē. Šo sadaļu var brīvi pārvietot, velkot sadaļas galveni.  Šai sadaļai ir pieejamas vairākas vadīklas: -  poga **Snooze** apklusina pašlaik aktīvo trauksmes skaņu; -  poga **Mute/Unmute** pārslēdz starp trauksmes skaņu atskaņošanu un pilnīgu to neatskaņošanu. #### Global regular expressions There is an advanced editor for creating and testing complex regular expressions in Zabbix frontend. Once a regular expression has been created this way, it can be used in several places in the frontend by referring to its name, prefixed with @, for example, *\@mycustomregexp*. To create a global regular expression: - Go to: *Administration > General* - Select *Regular expressions* from the dropdown - Click on *New regular expression* The **Expressions** tab allows to set the regular expression name and add subexpressions.  All mandatory input fields are marked with a red asterisk. |Parameter|<|Description| |-|----------|----------------------------------------| |*Name*|<|Set the regular expression name. Any Unicode characters are allowed.| |*Expressions*|<|Click on *Add* in the Expressions block to add a new subexpression.| | |*Expression type*|Select expression type:<br>**Character string included** - match the substring<br>**Any character string included** - match any substring from a delimited list. The delimited list includes a comma (,), a dot (.) or a forward slash (/).<br>**Character string not included** - match any string except the substring<br>**Result is TRUE** - match the regular expression<br>**Result is FALSE** - do not match the regular expression| |^|*Expression*|Enter substring/regular expression.| |*Delimiter*|<|A comma (,), a dot (.) or a forward slash (/) to separate text strings in a regular expression. This parameter is active only when "*Any character string included*" expression type is selected.| |*Case sensitive*|<|A checkbox to specify whether a regular expression is sensitive to capitalization of letters.| A forward slash (/) in the expression is treated literally, rather than a delimiter. This way it is possible to save expressions containing a slash, without errors. ::: noteimportant A custom regular expression name in Zabbix may contain commas, spaces, etc. In those cases where that may lead to misinterpretation when referencing (for example, a comma in the parameter of an item key) the whole reference may be put in quotes like this: *"\@My custom regexp for purpose1, purpose2"*.<br> Regular expression names must not be quoted in other locations (for example, in LLD rule properties). ::: In the **Test** tab the regular expression and its subexpressions can be tested by providing a test string.  Results show the status of each subexpression and total custom expression status. Total custom expression status is defined as *Combined result*. If several sub expressions are defined Zabbix uses AND logical operator to calculate *Combined result*. It means that if at least one Result is False *Combined result* has also False status. #### Globālas regulārās izteiksmes Zabbix lietotāja saskarnē ir pieejams paplašināts redaktors sarežģītu regulāro izteiksmju izveidei un testēšanai. Kad regulārā izteiksme ir izveidota šādā veidā, to var izmantot vairākās lietotāja saskarnes vietās, atsaucoties uz tās nosaukumu ar prefiksu @, piemēram, *\@mycustomregexp*. Lai izveidotu globālu regulāro izteiksmi: - Dodieties uz: *Administration > General* - Nolaižamajā sarakstā atlasiet *Regular expressions* - Noklikšķiniet uz *New regular expression* Cilne **Expressions** ļauj iestatīt regulārās izteiksmes nosaukumu un pievienot apakšizteiksmes.  Visi obligātie ievades lauki ir atzīmēti ar sarkanu zvaigznīti. |Parameter|<|Description| |-|----------|----------------------------------------| |*Name*|<|Iestatiet regulārās izteiksmes nosaukumu. Ir atļautas jebkādas Unicode rakstzīmes.| |*Expressions*|<|Noklikšķiniet uz *Add* blokā Expressions, lai pievienotu jaunu apakšizteiksmi.| | |*Expression type*|Atlasiet izteiksmes tipu:<br>**Character string included** - atbilst apakšvirknei<br>**Any character string included** - atbilst jebkurai apakšvirknei no norobežota saraksta. Norobežotajā sarakstā ir komats (,), punkts (.) vai slīpsvītra (/).<br>**Character string not included** - atbilst jebkurai virknei, izņemot apakšvirkni<br>**Result is TRUE** - atbilst regulārajai izteiksmei<br>**Result is FALSE** - neatbilst regulārajai izteiksmei| |^|*Expression*|Ievadiet apakšvirkni/regulāro izteiksmi.| |*Delimiter*|<|Komats (,), punkts (.) vai slīpsvītra (/) teksta virkņu atdalīšanai regulārajā izteiksmē. Šis parametrs ir aktīvs tikai tad, ja ir atlasīts izteiksmes tips "*Any character string included*".| |*Case sensitive*|<|Atzīme, lai norādītu, vai regulārā izteiksme ir jutīga pret burtu reģistru.| Slīpsvītra (/) izteiksmē tiek apstrādāta burtiski, nevis kā norobežotājs. Tādējādi ir iespējams saglabāt izteiksmes, kas satur slīpsvītru, bez kļūdām. ::: noteimportant Pielāgotas regulārās izteiksmes nosaukums Zabbix var saturēt komatus, atstarpes utt. Tajos gadījumos, kad tas var novest pie nepareizas interpretācijas, uz to atsaucoties (piemēram, komats vienuma atslēgas parametrā), visu atsauci var ievietot pēdiņās šādi: *"\@My custom regexp for purpose1, purpose2"*.<br> Citās vietās regulāro izteiksmju nosaukumus pēdiņās likt nedrīkst (piemēram, LLD noteikuma īpašībās). ::: Cilnē **Test** regulāro izteiksmi un tās apakšizteiksmes var testēt, norādot testa virkni.  Rezultātos tiek parādīts katras apakšizteiksmes statuss un kopējais pielāgotās izteiksmes statuss. Kopējais pielāgotās izteiksmes statuss ir definēts kā *Combined result*. Ja ir definētas vairākas apakšizteiksmes, Zabbix izmanto loģisko operatoru AND, lai aprēķinātu *Combined result*. Tas nozīmē, ka, ja vismaz vienam Result ir False, *Combined result* statusam arī būs False. #### Global scripts A [global script](/manual/web_interface/frontend_sections/alerts/scripts) is a user-defined set of commands that can be executed on a monitoring target (by shell (/bin/sh) interpreter), depending on the configured scope and user permissions. Global scripts can be configured for the following actions: - Action [operation](/manual/config/notifications/action/operation) - [Manual host action](/manual/web_interface/menu/host_menu#overview) - [Manual event action](/manual/web_interface/menu/event_menu#content) Global scripts are useful in many cases. For example, if configured for action operations or manual host actions, you can use global scripts to automatically or manually execute [remote commands](/manual/config/notifications/action/operation/remote_command) such as restarting an application (web server, middleware, CRM, etc.) or freeing disk space (removing older files, cleaning `/tmp`, etc). Or, another example, if configured for manual event actions, you can use global scripts to manage problem tickets in external systems. Global scripts can be executed by Zabbix server, proxy or agent. #### Globālie skripti [Globālais skripts](/manual/web_interface/frontend_sections/alerts/scripts) ir lietotāja definēta komandu kopa, ko var izpildīt uzraudzības mērķī (ar čaulas (/bin/sh) interpretētāju), atkarībā no konfigurētās darbības jomas un lietotāja atļaujām. Globālos skriptus var konfigurēt šādām darbībām: - Darbības [operācija](/manual/config/notifications/action/operation) - [Manuāla hosta darbība](/manual/web_interface/menu/host_menu#overview) - [Manuāla notikuma darbība](/manual/web_interface/menu/event_menu#content) Globālie skripti ir noderīgi daudzos gadījumos. Piemēram, ja tie ir konfigurēti darbību operācijām vai manuālām hosta darbībām, varat izmantot globālos skriptus, lai automātiski vai manuāli izpildītu [attālinātās komandas](/manual/config/notifications/action/operation/remote_command), piemēram, lietojumprogrammas restartēšanu (tīmekļa serveris, starpprogrammatūra, CRM u.c.) vai diska vietas atbrīvošanu (vecāku failu dzēšana, `/tmp` tīrīšana u.c.). Vai arī, cits piemērs, ja tie ir konfigurēti manuālām notikumu darbībām, varat izmantot globālos skriptus, lai pārvaldītu problēmu pieteikumus ārējās sistēmās. Globālos skriptus var izpildīt Zabbix serveris, starpniekserveris vai aģents. #### GLPI webhook integration updated The [GLPI media type](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/glpi/README.md?at=refs%2Fheads%2Frelease%2F7.0) now supports authentication using application tokens. #### GLPI webhook integrācijas atjauninājums [GLPI multivides tips](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/glpi/README.md?at=refs%2Fheads%2Frelease%2F7.0) tagad atbalsta autentifikāciju, izmantojot lietojumprogrammas tokenus. # graph.create # graph.create # graph.delete # graph.delete # graph.get # graph.get # graphitem.get # graphitem.get ### Graph item ::: noteclassic Graph items can only be modified via the `graph` API. ::: The graph item object has the following properties. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |gitemid|ID|ID of the graph item.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |color|string|Graph item's draw color as a hexadecimal color code.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |itemid|ID|ID of the item.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |calc\_fnc|integer|Value of the item that will be displayed.<br><br>Possible values:<br>1 - minimum value;<br>2 - *(default)* average value;<br>4 - maximum value;<br>7 - all values;<br>9 - last value, used only by pie and exploded graphs.| |drawtype|integer|Draw style of the graph item.<br><br>Possible values:<br>0 - *(default)* line;<br>1 - filled region;<br>2 - bold line;<br>3 - dot;<br>4 - dashed line;<br>5 - gradient line.| |graphid|ID|ID of the graph that the graph item belongs to.| |sortorder|integer|Position of the item in the graph.<br><br>Default: starts with "0" and increases by one with each entry.| |type|integer|Type of graph item.<br><br>Possible values:<br>0 - *(default)* simple;<br>2 - graph sum, used only by pie and exploded graphs.| |yaxisside|integer|Side of the graph where the graph item's Y scale will be drawn.<br><br>Possible values:<br>0 - *(default)* left side;<br>1 - right side.| ### Grafika vienums ::: noteclassic Grafika vienumus var modificēt tikai, izmantojot `graph` API. ::: Grafika vienuma objektam ir šādas īpašības. |Īpašība|[Tips](/manual/api/reference_commentary#data-types)|Apraksts| |--|--|------| |gitemid|ID|Grafika vienuma ID.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *tikai lasāms*| |color|string|Grafika vienuma attēlošanas krāsa heksadecimāla krāsas koda formātā.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāta* izveides darbībām| |itemid|ID|Vienuma ID.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāta* izveides darbībām| |calc\_fnc|integer|Vienuma vērtība, kas tiks attēlota.<br><br>Iespējamās vērtības:<br>1 - minimālā vērtība;<br>2 - *(noklusējums)* vidējā vērtība;<br>4 - maksimālā vērtība;<br>7 - visas vērtības;<br>9 - pēdējā vērtība, tiek izmantota tikai sektoru un sadalītajos grafikos.| |drawtype|integer|Grafika vienuma zīmēšanas stils.<br><br>Iespējamās vērtības:<br>0 - *(noklusējums)* līnija;<br>1 - aizpildīts apgabals;<br>2 - trekna līnija;<br>3 - punkts;<br>4 - pārtraukta līnija;<br>5 - gradienta līnija.| |graphid|ID|Grafika ID, kuram pieder grafika vienums.| |sortorder|integer|Vienuma pozīcija grafikā.<br><br>Noklusējums: sākas ar "0" un ar katru ierakstu palielinās par vienu.| |type|integer|Grafika vienuma tips.<br><br>Iespējamās vērtības:<br>0 - *(noklusējums)* vienkāršs;<br>2 - grafika summa, tiek izmantota tikai sektoru un sadalītajos grafikos.| |yaxisside|integer|Grafika puse, kurā tiks attēlota grafika vienuma Y skala.<br><br>Iespējamās vērtības:<br>0 - *(noklusējums)* kreisā puse;<br>1 - labā puse.| # Graph item object The following objects are directly related to the `graphitem` API. # Grafika vienuma objekts Tālāk norādītie objekti ir tieši saistīti ar `graphitem` API. # Graph item This class is designed to work with graph items. Object references: - [Graph item](/manual/api/reference/graphitem/object#graph-item) Available methods: - [graphitem.get](/manual/api/reference/graphitem/get) - retrieve graph items # Grafika vienums Šī klase ir paredzēta darbam ar grafika vienumiem. Objektu atsauces: - [Grafika vienums](/manual/api/reference/graphitem/object#graph-item) Pieejamās metodes: - [graphitem.get](/manual/api/reference/graphitem/get) - izgūt grafika vienumus # Graph object The following objects are directly related to the `graph` API. # Grafika objekts Tālāk norādītie objekti ir tieši saistīti ar `graph` API. ##### Graph preview In the *Preview* tab, a preview of the graph is displayed so you can immediately see what you are creating. {width="600"} Note that the preview will not show any data for template items. {width="600"} In this example, pay attention to the dashed bold line displaying the trigger level and the trigger information displayed in the legend. ::: noteclassic No more than 3 trigger lines can be displayed. If there are more triggers then the triggers with lower severity are prioritized for display.<br><br> If graph height is set as less than 120 pixels, no trigger will be displayed in the legend. ::: ##### Grafika priekšskatījums Cilnē *Priekšskatījums* tiek parādīts grafika priekšskatījums, lai jūs varētu uzreiz redzēt, ko veidojat. {width="600"} Ņemiet vērā, ka priekšskatījumā netiks rādīti nekādi dati veidnes vienumiem. {width="600"} Šajā piemērā pievērsiet uzmanību pārtrauktajai treknajai līnijai, kas attēlo trigera līmeni, un trigera informācijai, kas parādīta leģendā. ::: noteclassic Var tikt parādītas ne vairāk kā 3 trigeru līnijas. Ja trigeru ir vairāk, parādīšanai prioritāri tiek izvēlēti trigeri ar zemāku nopietnības līmeni.<br><br> Ja grafika augstums ir iestatīts mazāks par 120 pikseļiem, leģendā netiks parādīts neviens trigeris. ::: # graphprototype.create # graphprototype.create # graphprototype.delete # graphprototype.delete # graphprototype.get # graphprototype.get # Graph prototype object The following objects are directly related to the `graphprototype` API. # Grafika prototipa objekts Tālāk norādītie objekti ir tieši saistīti ar `graphprototype` API. #### Graph prototypes The following screenshot illustrates how we can use these macros in graph prototypes: {width="600"} {width="600"} A summary of our discovery rule: {width="600"} #### Grafiku prototipi Šis ekrānuzņēmums ilustrē, kā mēs varam izmantot šos makrosus grafiku prototipos: {width="600"} {width="600"} Mūsu atklāšanas kārtulas kopsavilkums: {width="600"} ### Graph prototype The graph prototype object has the following properties. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |graphid|ID|ID of the graph prototype.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*<br>- *required* for update operations| |height|integer|Height of the graph prototype in pixels.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |name|string|Name of the graph prototype.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |width|integer|Width of the graph prototype in pixels.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |graphtype|integer|Graph prototypes's layout type.<br><br>Possible values:<br>0 - *(default)* normal;<br>1 - stacked;<br>2 - pie;<br>3 - exploded.| |percent\_left|float|Left percentile.<br><br>Default: 0.| |percent\_right|float|Right percentile.<br><br>Default: 0.| |show\_3d|integer|Whether to show discovered pie and exploded graphs in 3D.<br><br>Possible values:<br>0 - *(default)* show in 2D;<br>1 - show in 3D.| |show\_legend|integer|Whether to show the legend on the discovered graph.<br><br>Possible values:<br>0 - hide;<br>1 - *(default)* show.| |show\_work\_period|integer|Whether to show the working time on the discovered graph.<br><br>Possible values:<br>0 - hide;<br>1 - *(default)* show.| |templateid|ID|ID of the parent template graph prototype.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |yaxismax|float|The fixed maximum value for the Y axis.| |yaxismin|float|The fixed minimum value for the Y axis.| |ymax\_itemid|ID|ID of the item that is used as the maximum value for the Y axis.<br><br>If a user has no access to the specified item, the graph is rendered as if `ymax_type` is set to "calculated".| |ymax\_type|integer|Maximum value calculation method for the Y axis.<br><br>Possible values:<br>0 - *(default)* calculated;<br>1 - fixed;<br>2 - item.| |ymin\_itemid|ID|ID of the item that is used as the minimum value for the Y axis.<br><br>If a user has no access to the specified item, the graph is rendered as if `ymin_type` is set to "calculated".| |ymin\_type|integer|Minimum value calculation method for the Y axis.<br><br>Possible values:<br>0 - *(default)* calculated;<br>1 - fixed;<br>2 - item.| |discover|integer|Graph prototype discovery status.<br><br>Possible values:<br>0 - *(default)* new graphs will be discovered;<br>1 - new graphs will not be discovered and existing graphs will be marked as lost.| |uuid|string|Universal unique identifier, used for linking imported graph prototypes to already existing ones. Auto-generated, if not given.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if the graph prototype belongs to a template| ### Grafika prototips Grafikas prototipa objektam ir šādi rekvizīti. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |graphid|ID|Grafikas prototipa ID.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *tikai lasāms*<br>- *obligāts* atjaunināšanas operācijām| |height|integer|Grafikas prototipa augstums pikseļos.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *obligāts* izveides operācijām| |name|string|Grafikas prototipa nosaukums.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *obligāts* izveides operācijām| |width|integer|Grafikas prototipa platums pikseļos.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *obligāts* izveides operācijām| |graphtype|integer|Grafikas prototipa izkārtojuma tips.<br><br>Iespējamās vērtības:<br>0 - *(noklusējums)* parasta;<br>1 - sakrauta;<br>2 - sektoru diagramma;<br>3 - izvērsta.| |percent\_left|float|Kreisais procentuālais rādītājs.<br><br>Noklusējums: 0.| |percent\_right|float|Labais procentuālais rādītājs.<br><br>Noklusējums: 0.| |show\_3d|integer|Vai atklātās sektoru un izvērstās grafikas rādīt 3D režīmā.<br><br>Iespējamās vērtības:<br>0 - *(noklusējums)* rādīt 2D režīmā;<br>1 - rādīt 3D režīmā.| |show\_legend|integer|Vai atklātajā grafikā rādīt leģendu.<br><br>Iespējamās vērtības:<br>0 - slēpt;<br>1 - *(noklusējums)* rādīt.| |show\_work\_period|integer|Vai atklātajā grafikā rādīt darba laiku.<br><br>Iespējamās vērtības:<br>0 - slēpt;<br>1 - *(noklusējums)* rādīt.| |templateid|ID|Vecākveidnes grafikas prototipa ID.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *tikai lasāms*| |yaxismax|float|Fiksētā maksimālā vērtība Y asij.| |yaxismin|float|Fiksētā minimālā vērtība Y asij.| |ymax\_itemid|ID|Vienuma ID, kas tiek izmantots kā maksimālā vērtība Y asij.<br><br>Ja lietotājam nav piekļuves norādītajam vienumam, grafiks tiek attēlots tā, it kā `ymax_type` būtu iestatīts uz "calculated".| |ymax\_type|integer|Maksimālās vērtības aprēķināšanas metode Y asij.<br><br>Iespējamās vērtības:<br>0 - *(noklusējums)* calculated;<br>1 - fixed;<br>2 - item.| |ymin\_itemid|ID|Vienuma ID, kas tiek izmantots kā minimālā vērtība Y asij.<br><br>Ja lietotājam nav piekļuves norādītajam vienumam, grafiks tiek attēlots tā, it kā `ymin_type` būtu iestatīts uz "calculated".| |ymin\_type|integer|Minimālās vērtības aprēķināšanas metode Y asij.<br><br>Iespējamās vērtības:<br>0 - *(noklusējums)* calculated;<br>1 - fixed;<br>2 - item.| |discover|integer|Grafikas prototipa atklāšanas statuss.<br><br>Iespējamās vērtības:<br>0 - *(noklusējums)* tiks atklātas jaunas grafikas;<br>1 - jaunas grafikas netiks atklātas, un esošās grafikas tiks atzīmētas kā pazudušas.| |uuid|string|Universāls unikāls identifikators, ko izmanto importēto grafikas prototipu sasaistīšanai ar jau esošajiem. Ja nav norādīts, tiek ģenerēts automātiski.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *atbalstīts*, ja grafikas prototips pieder veidnei| # Graph prototype This class is designed to work with graph prototypes. Object references: - [Graph prototype](/manual/api/reference/graphprototype/object#graph-prototype) Available methods: - [graphprototype.create](/manual/api/reference/graphprototype/create) - create new graph prototypes - [graphprototype.delete](/manual/api/reference/graphprototype/delete) - delete graph prototypes - [graphprototype.get](/manual/api/reference/graphprototype/get) - retrieve graph prototypes - [graphprototype.update](/manual/api/reference/graphprototype/update) - update graph prototypes # Grafika prototips Šī klase ir paredzēta darbam ar grafiku prototipiem. Objektu atsauces: - [Grafika prototips](/manual/api/reference/graphprototype/object#graph-prototype) Pieejamās metodes: - [graphprototype.create](/manual/api/reference/graphprototype/create) - izveidot jaunus grafiku prototipus - [graphprototype.delete](/manual/api/reference/graphprototype/delete) - dzēst grafiku prototipus - [graphprototype.get](/manual/api/reference/graphprototype/get) - izgūt grafiku prototipus - [graphprototype.update](/manual/api/reference/graphprototype/update) - atjaunināt grafiku prototipus # graphprototype.update # graphprototype.update #### Graphs and history The *Graph/History* column in the item list offers the following links: - **History** - for all textual items, leading to listings (*Values/500 latest values*) displaying the history of previous item values. - **Graph** - for all numeric items, leading to a [simple graph](/manual/config/visualization/graphs/simple). Note that when the graph is displayed, a dropdown on the upper right offers a possibility to switch to *Values/500 latest values* as well. {width="600"} The values displayed in this list are raw, that is, no postprocessing is applied. ::: noteclassic The total amount of values displayed is defined by the value of *Limit for search and filter results* parameter, set in *Administration* → *General* → [*GUI*](/manual/web_interface/frontend_sections/administration/general#gui). ::: #### Grafiki un vēsture Kolonna *Graph/History* vienumu sarakstā piedāvā šādas saites: - **History** - visiem teksta vienumiem, ved uz sarakstiem (*Values/500 latest values*), kuros tiek parādīta iepriekšējo vienuma vērtību vēsture. - **Graph** - visiem skaitliskajiem vienumiem, ved uz [vienkāršu grafiku](/manual/config/visualization/graphs/simple). Ņemiet vērā, ka, kad grafiks tiek parādīts, nolaižamā izvēlne augšējā labajā stūrī piedāvā arī iespēju pārslēgties uz *Values/500 latest values*. {width="600"} Šajā sarakstā parādītās vērtības ir neapstrādātas, tas ir, tām netiek piemērota nekāda pēcapstrāde. ::: noteclassic Kopējo parādīto vērtību skaitu nosaka parametra *Limit for search and filter results* vērtība, kas iestatīta sadaļā *Administration* → *General* → [*GUI*](/manual/web_interface/frontend_sections/administration/general#gui). ::: #### Graphs Edit graphs or separate graph items for better presentation of the gathered data. [Graph API](/manual/api/reference/graph) | [Graph item API](/manual/api/reference/graphitem) #### Grafiki Rediģējiet grafikus vai atsevišķus grafiku vienumus, lai labāk attēlotu savāktos datus. [Grafiku API](/manual/api/reference/graph) | [Grafiku vienumu API](/manual/api/reference/graphitem) #### Graphs ##### Graphs (classic) issues If you encounter issues with classic graphs, it is recommended to update GD library (libgd) to version 2.3.3-13 or higher, and PHP to version 8.0.19, 8.1.33, 8.2.29, 8.3.25, 8.4.12, or higher. ##### Daylight Saving Time Changes to Daylight Saving Time (DST) result in irregularities when displaying X axis labels (date duplication, date missing, etc). ##### Sum aggregation When using [sum aggregation](/manual/config/visualization/graphs/aggregate#configuration) in a graph for period that is less than one hour, graphs display incorrect (multiplied) values when data come from trends. ##### Text overlapping For some frontend languages (e.g., Japanese), local fonts can cause text overlapping in graph legend. To avoid this, use version 2.3.0 (or later) of PHP GD extension. #### Grafiki ##### Grafiku (klasisko) problēmas Ja saskaraties ar problēmām ar klasiskajiem grafikiem, ieteicams atjaunināt GD bibliotēku (libgd) uz versiju 2.3.3-13 vai jaunāku, un PHP uz versiju 8.0.19, 8.1.33, 8.2.29, 8.3.25, 8.4.12 vai jaunāku. ##### Vasaras laiks Pārejas uz vasaras laiku (DST) izmaiņas izraisa neatbilstības X ass etiķešu attēlošanā (datumu dublēšanās, datuma trūkums u.c.). ##### Summas agregācija Izmantojot [summas agregāciju](/manual/config/visualization/graphs/aggregate#configuration) grafikā periodam, kas ir mazāks par vienu stundu, grafikos tiek attēlotas nepareizas (reizinātas) vērtības, ja dati nāk no trendiem. ##### Teksta pārklāšanās Dažām lietotāja saskarne valodām (piemēram, japāņu) lokālie fonti var izraisīt teksta pārklāšanos grafika leģendā. Lai no tā izvairītos, izmantojiet PHP GD paplašinājuma versiju 2.3.0 (vai jaunāku). ##### Graphs With the item working for a while, it might be time to see something visual. [Simple graphs](/manual/config/visualization/graphs/simple) are available for any monitored numeric item without any additional configuration. These graphs are generated on runtime. To view the graph, go to *Monitoring → Latest data* and click on the 'Graph' link next to the item. {width="600"} ##### Grafiki Kad vienums kādu laiku ir darbojies, var būt pienācis laiks apskatīt kaut ko vizuālu. [Vienkāršie grafiki](/manual/config/visualization/graphs/simple) ir pieejami jebkuram uzraudzītam skaitliskam vienumam bez papildu konfigurācijas. Šie grafiki tiek ģenerēti izpildes laikā. Lai skatītu grafiku, dodieties uz *Monitoring → Latest data* un noklikšķiniet uz saistes 'Graph' blakus vienumam. {width="600"} ### Graph The graph object has the following properties. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |graphid|ID|ID of the graph.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*<br>- *required* for update operations| |height|integer|Height of the graph in pixels.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |name|string|Name of the graph.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |width|integer|Width of the graph in pixels.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |flags|integer|Origin of the graph.<br><br>Possible values:<br>0 - *(default)* a plain graph;<br>4 - a discovered graph.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |graphtype|integer|Graph's layout type.<br><br>Possible values:<br>0 - *(default)* normal;<br>1 - stacked;<br>2 - pie;<br>3 - exploded.| |percent\_left|float|Left percentile.<br><br>Default: 0.| |percent\_right|float|Right percentile.<br><br>Default: 0.| |show\_3d|integer|Whether to show pie and exploded graphs in 3D.<br><br>Possible values:<br>0 - *(default)* show in 2D;<br>1 - show in 3D.| |show\_legend|integer|Whether to show the legend on the graph.<br><br>Possible values:<br>0 - hide;<br>1 - *(default)* show.| |show\_work\_period|integer|Whether to show the working time on the graph.<br><br>Possible values:<br>0 - hide;<br>1 - *(default)* show.| |show\_triggers|integer|Whether to show the trigger line on the graph.<br><br>Possible values:<br>0 - hide;<br>1 - *(default)* show.| |templateid|ID|ID of the parent template graph.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |yaxismax|float|The fixed maximum value for the Y axis.<br><br>Default: 100.| |yaxismin|float|The fixed minimum value for the Y axis.<br><br>Default: 0.| |ymax\_itemid|ID|ID of the item that is used as the maximum value for the Y axis.<br><br>If a user has no access to the specified item, the graph is rendered as if `ymax_type` is set to "calculated".| |ymax\_type|integer|Maximum value calculation method for the Y axis.<br><br>Possible values:<br>0 - *(default)* calculated;<br>1 - fixed;<br>2 - item.| |ymin\_itemid|ID|ID of the item that is used as the minimum value for the Y axis.<br><br>If a user has no access to the specified item, the graph is rendered as if `ymin_type` is set to "calculated".| |ymin\_type|integer|Minimum value calculation method for the Y axis.<br><br>Possible values:<br>0 - *(default)* calculated;<br>1 - fixed;<br>2 - item.| |uuid|string|Universal unique identifier, used for linking imported graphs to already existing ones. Auto-generated, if not given.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if the graph belongs to a template| ### Grafiks Grafika objektam ir šādi rekvizīti. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |graphid|ID|Grafika ID.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *tikai lasāms*<br>- *obligāts* atjaunināšanas operācijām| |height|integer|Grafika augstums pikseļos.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *obligāts* izveides operācijām| |name|string|Grafika nosaukums.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *obligāts* izveides operācijām| |width|integer|Grafika platums pikseļos.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *obligāts* izveides operācijām| |flags|integer|Grafika izcelsme.<br><br>Iespējamās vērtības:<br>0 - *(noklusējums)* vienkāršs grafiks;<br>4 - atklāts grafiks.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *tikai lasāms*| |graphtype|integer|Grafika izkārtojuma tips.<br><br>Iespējamās vērtības:<br>0 - *(noklusējums)* parasts;<br>1 - sakrauts;<br>2 - sektoru;<br>3 - izvērsts.| |percent\_left|float|Kreisais procentīlis.<br><br>Noklusējums: 0.| |percent\_right|float|Labais procentīlis.<br><br>Noklusējums: 0.| |show\_3d|integer|Vai sektoru un izvērstos grafikus rādīt 3D režīmā.<br><br>Iespējamās vērtības:<br>0 - *(noklusējums)* rādīt 2D režīmā;<br>1 - rādīt 3D režīmā.| |show\_legend|integer|Vai grafikā rādīt leģendu.<br><br>Iespējamās vērtības:<br>0 - slēpt;<br>1 - *(noklusējums)* rādīt.| |show\_work\_period|integer|Vai grafikā rādīt darba laiku.<br><br>Iespējamās vērtības:<br>0 - slēpt;<br>1 - *(noklusējums)* rādīt.| |show\_triggers|integer|Vai grafikā rādīt trigeru līniju.<br><br>Iespējamās vērtības:<br>0 - slēpt;<br>1 - *(noklusējums)* rādīt.| |templateid|ID|Vecākveidnes grafika ID.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *tikai lasāms*| |yaxismax|float|Fiksētā maksimālā vērtība Y asij.<br><br>Noklusējums: 100.| |yaxismin|float|Fiksētā minimālā vērtība Y asij.<br><br>Noklusējums: 0.| |ymax\_itemid|ID|vienuma ID, kas tiek izmantots kā maksimālā vērtība Y asij.<br><br>Ja lietotājam nav piekļuves norādītajam vienumam, grafiks tiek attēlots tā, it kā `ymax_type` būtu iestatīts uz "calculated".| |ymax\_type|integer|Maksimālās vērtības aprēķināšanas metode Y asij.<br><br>Iespējamās vērtības:<br>0 - *(noklusējums)* calculated;<br>1 - fixed;<br>2 - item.| |ymin\_itemid|ID|vienuma ID, kas tiek izmantots kā minimālā vērtība Y asij.<br><br>Ja lietotājam nav piekļuves norādītajam vienumam, grafiks tiek attēlots tā, it kā `ymin_type` būtu iestatīts uz "calculated".| |ymin\_type|integer|Minimālās vērtības aprēķināšanas metode Y asij.<br><br>Iespējamās vērtības:<br>0 - *(noklusējums)* calculated;<br>1 - fixed;<br>2 - item.| |uuid|string|Universāls unikāls identifikators, ko izmanto importēto grafiku sasaistīšanai ar jau esošajiem. Ja nav norādīts, tiek ģenerēts automātiski.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *atbalstīts*, ja grafiks pieder veidnei| # Graph This class is designed to work with graphs. Object references: - [Graph](/manual/api/reference/graph/object#graph) Available methods: - [graph.create](/manual/api/reference/graph/create) - create new graphs - [graph.delete](/manual/api/reference/graph/delete) - delete graphs - [graph.get](/manual/api/reference/graph/get) - retrieve graphs - [graph.update](/manual/api/reference/graph/update) - update graphs # Grafiks Šī klase ir paredzēta darbam ar grafikiem. Objektu atsauces: - [Graph](/manual/api/reference/graph/object#graph) Pieejamās metodes: - [graph.create](/manual/api/reference/graph/create) - izveidot jaunus grafikus - [graph.delete](/manual/api/reference/graph/delete) - dzēst grafikus - [graph.get](/manual/api/reference/graph/get) - izgūt grafikus - [graph.update](/manual/api/reference/graph/update) - atjaunināt grafikus # graph.update # graph.update #### graph [ZBXNEXT-2020](https://support.zabbix.com/browse/ZBXNEXT-2020) `graph.get`: Method now also supports `status` property if `selectGraphDiscovery` parameter is used. #### graph [ZBXNEXT-2020](https://support.zabbix.com/browse/ZBXNEXT-2020) `graph.get`: Metode tagad atbalsta arī `status` īpašību, ja tiek izmantots parametrs `selectGraphDiscovery`. ### Group link The group link object links a host prototype with a host group. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |groupid|ID|ID of the host group.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| ### Grupas saite Grupas saites objekts sasaista hosta prototipu ar hostu grupu. Tam ir šādas īpašības. |Īpašība|[Type](/manual/api/reference_commentary#data-types)|Apraksts| |--|--|------| |groupid|ID|Hostu grupas ID.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāts*| ### Group prototype The group prototype object defines a group that will be created for a discovered host. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |group_prototypeid|ID|ID of the group prototype.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |name|string|Name of the group prototype.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| ### Grupas prototips Grupas prototipa objekts definē grupu, kas tiks izveidota atklātam hostam. Tam ir šādas īpašības. |Īpašība|[Type](/manual/api/reference_commentary#data-types)|Apraksts| |--|--|------| |group_prototypeid|ID|Grupas prototipa ID.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *tikai lasāms*| |name|string|Grupas prototipa nosaukums.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāts* izveides darbībām| #### GUI This section provides customization of several frontend-related defaults.  Configuration parameters: |Parameter|Description| |--|--------| |*Default language*|Default language for users who have not specified a language in their profiles and guest users.<br>For more information, see [Installation of additional frontend languages](/manual/appendix/install/locales).| |*Default time zone*|Default [time zone](/manual/web_interface/time_zone#overview) for users who have not specified a time zone in their profiles and guest users.| |*Default theme*|Default theme for users who have not specified a theme in their profiles and guest users.| |*Limit for search and filter results*|Maximum amount of elements (rows) that will be displayed in a web-interface list, for example, in *Data collection > Hosts*.<br>*Note*: If set to, for example, '50', only the first 50 elements will be displayed in all affected frontend lists. If some list contains more than fifty elements, the indication of that will be the '+' sign in *"Displaying 1 to 50 of **50+** found"*. Also, if filtering is used and still there are more than 50 matches, only the first 50 will be displayed.<br>Note that increasing the value of this parameter may lead to decreased performance and increased memory consumption on the web server side.| |*Max number of columns<br>and rows in overview tables*|Maximum number of columns and rows to display in Data overview and Trigger overview dashboard widgets. The same limit applies to both columns and rows. If more rows and/or columns than shown exist, the system will display a warning at the bottom of the table: "Not all results are displayed. Please provide more specific search criteria."| |*Max count of elements<br>to show inside table cell*|For entries that are displayed in a single table cell, no more than configured here will be shown.| |*Show warning if Zabbix server is down*|This parameter enables a warning message to be displayed in a browser window if the Zabbix server cannot be reached (possibly down). The message remains visible even if the user scrolls down the page. When hovered over, the message is temporarily hidden to reveal the contents underneath it.| |*Working time*|This system-wide parameter defines working hours. In graphs, working time is displayed as a white background and non-working time is displayed as gray.<br>See [Time period specification](/manual/appendix/time_period) page for description of the time format.<br>[User macros](/manual/config/macros/user_macros) are supported.| |*Show technical errors*|If checked, all registered users will be able to see technical errors (PHP/SQL). If unchecked, the information is only available to [Zabbix Super Admins](/manual/web_interface/frontend_sections/users/user_list#users-1) and users belonging to the user groups with enabled [debug mode](/manual/web_interface/debug_mode).| |*Max history display period*|Maximum time period for which to display historical data in *Monitoring > Latest data*, host [web scenario](/manual/web_interface/frontend_sections/monitoring/hosts/web) information in *Monitoring > Hosts*, and in the *Data overview* dashboard widget.<br>Allowed range: 24 hours (default) - 1 week. [Time suffixes](/manual/appendix/suffixes), e.g. 1w (one week), 36h (36 hours), are supported.| |*Time filter default period*|Time period to be used in graphs and dashboards by default. Allowed range: 1 minute - 10 years (default: 1 hour).<br>[Time suffixes](/manual/appendix/suffixes), e.g. 10m (ten minutes), 5w (five weeks), are supported.<br>Note: when a user changes the time period while viewing a graph, this time period is stored as user preference, replacing the global default or a previous user selection.| |*Max period for time selector*|Maximum available time period for graphs and dashboards. Users will not be able to visualize older data. Allowed range: 1 year - 10 years (default: 2 years).<br>[Time suffixes](/manual/appendix/suffixes), e.g. 1y (one year), 365w (365 weeks), are supported.| #### GUI Šī sadaļa nodrošina vairāku ar lietotāja saskarni saistītu noklusējuma iestatījumu pielāgošanu.  Konfigurācijas parametri: |Parameter|Description| |--|--------| |*Default language*|Noklusējuma valoda lietotājiem, kuri savos profilos nav norādījuši valodu, un vieslietotājiem.<br>Vairāk informācijas skatiet [Papildu lietotāja saskarnes valodu instalēšana](/manual/appendix/install/locales).| |*Default time zone*|Noklusējuma [laika josla](/manual/web_interface/time_zone#overview) lietotājiem, kuri savos profilos nav norādījuši laika joslu, un vieslietotājiem.| |*Default theme*|Noklusējuma motīvs lietotājiem, kuri savos profilos nav norādījuši motīvu, un vieslietotājiem.| |*Limit for search and filter results*|Maksimālais elementu (rindu) skaits, kas tiks parādīts lietotāja saskarnes sarakstā, piemēram, sadaļā *Data collection > Hosts*.<br>*Piezīme*: ja iestatīts, piemēram, '50', visos ietekmētajos lietotāja saskarnes sarakstos tiks parādīti tikai pirmie 50 elementi. Ja kāds saraksts satur vairāk nekā piecdesmit elementus, to norādīs '+' zīme tekstā *"Displaying 1 to 50 of **50+** found"*. Tāpat, ja tiek izmantota filtrēšana un joprojām ir vairāk nekā 50 atbilstību, tiks parādīti tikai pirmie 50.<br>Ņemiet vērā, ka šī parametra vērtības palielināšana var samazināt veiktspēju un palielināt atmiņas patēriņu tīmekļa servera pusē.| |*Max number of columns<br>and rows in overview tables*|Maksimālais kolonnu un rindu skaits, kas jāparāda Data overview un Trigger overview paneļa sīkrīkos. Vienāds ierobežojums attiecas gan uz kolonnām, gan rindām. Ja ir vairāk rindu un/vai kolonnu, nekā tiek rādīts, sistēma tabulas apakšā parādīs brīdinājumu: "Not all results are displayed. Please provide more specific search criteria."| |*Max count of elements<br>to show inside table cell*|Ierakstiem, kas tiek parādīti vienā tabulas šūnā, tiks rādīts ne vairāk kā šeit konfigurētais skaits.| |*Show warning if Zabbix server is down*|Šis parametrs iespējo brīdinājuma ziņojuma parādīšanu pārlūkprogrammas logā, ja Zabbix serveris nav sasniedzams (iespējams, tas nedarbojas). Ziņojums paliek redzams pat tad, ja lietotājs ritina lapu uz leju. Novietojot kursoru virs tā, ziņojums īslaicīgi tiek paslēpts, lai atklātu zem tā esošo saturu.| |*Working time*|Šis sistēmas mēroga parametrs nosaka darba laiku. Grafikos darba laiks tiek attēlots ar baltu fonu, bet ārpus darba laiks - ar pelēku.<br>Skatiet lapu [Laika perioda specifikācija](/manual/appendix/time_period), lai uzzinātu laika formāta aprakstu.<br>Tiek atbalstīti [lietotāja makrosi](/manual/config/macros/user_macros).| |*Show technical errors*|Ja atzīmēts, visi reģistrētie lietotāji varēs redzēt tehniskās kļūdas (PHP/SQL). Ja nav atzīmēts, informācija ir pieejama tikai [Zabbix Super Admins](/manual/web_interface/frontend_sections/users/user_list#users-1) un lietotājiem, kas pieder lietotāju grupām ar iespējotu [atkļūdošanas režīmu](/manual/web_interface/debug_mode).| |*Max history display period*|Maksimālais laika periods, par kuru rādīt vēsturiskos datus sadaļā *Monitoring > Latest data*, hosts [web scenario](/manual/web_interface/frontend_sections/monitoring/hosts/web) informāciju sadaļā *Monitoring > Hosts* un paneļa sīkrīkā *Data overview*.<br>Atļautais diapazons: 24 stundas (noklusējums) - 1 nedēļa. Tiek atbalstīti [laika sufiksi](/manual/appendix/suffixes), piemēram, 1w (viena nedēļa), 36h (36 stundas).| |*Time filter default period*|Laika periods, kas pēc noklusējuma tiks izmantots grafikos un paneļos. Atļautais diapazons: 1 minūte - 10 gadi (noklusējums: 1 stunda).<br>Tiek atbalstīti [laika sufiksi](/manual/appendix/suffixes), piemēram, 10m (desmit minūtes), 5w (piecas nedēļas).<br>Piezīme: kad lietotājs, skatot grafiku, maina laika periodu, šis laika periods tiek saglabāts kā lietotāja preference, aizstājot globālo noklusējumu vai iepriekšējo lietotāja izvēli.| |*Max period for time selector*|Maksimālais pieejamais laika periods grafikiem un paneļiem. Lietotāji nevarēs vizualizēt vecākus datus. Atļautais diapazons: 1 gads - 10 gadi (noklusējums: 2 gadi).<br>Tiek atbalstīti [laika sufiksi](/manual/appendix/suffixes), piemēram, 1y (viens gads), 365w (365 nedēļas).| #### Handling of regular expression compilation and runtime errors If a regular expression used in `log[]`, `logrt[]`, `log.count[]` or `logrt.count[]` item cannot be compiled by PCRE or PCRE2 library then the item goes into NOTSUPPORTED state with an error message. To continue monitoring the log item, the regular expression should be fixed. If the regular expression compiles successfully, but fails at runtime (on some or on all log records), then the log item remains supported and monitoring continues. The runtime error is logged in the Zabbix agent log file (without the log file record). The logging rate is limited to one runtime error per check to allow Zabbix agent to monitor its own log file. For example, if 10 records are analyzed and 3 records fail with a regexp runtime error, one record is produced in the agent log. Exception: if `MaxLinesPerSecond=1` and update interval=1 (only 1 record is allowed to analyze per check) then regexp runtime errors are not logged. zabbix_agentd logs the item key in case of a runtime error, zabbix_agent2 logs the item ID to help identify which log item has runtime errors. It is recommended to redesign the regular expression in case of runtime errors. #### Regulārās izteiksmes kompilēšanas un izpildes laika kļūdu apstrāde Ja regulāro izteiksmi, kas tiek izmantota `log[]`, `logrt[]`, `log.count[]` vai `logrt.count[]` vienumā, nevar nokompilēt ar PCRE vai PCRE2 bibliotēku, tad vienums nonāk NOTSUPPORTED stāvoklī ar kļūdas ziņojumu. Lai turpinātu loga vienuma uzraudzību, regulārā izteiksme ir jāizlabo. Ja regulārā izteiksme tiek veiksmīgi nokompilēta, bet neizdodas izpildes laikā (dažos vai visos žurnāla ierakstos), tad loga vienums paliek atbalstīts un uzraudzība turpinās. Izpildes laika kļūda tiek reģistrēta Zabbix aģenta žurnāla failā (bez žurnāla faila ieraksta). Reģistrēšanas biežums ir ierobežots līdz vienai izpildes laika kļūdai uz vienu pārbaudi, lai ļautu Zabbix aģentam uzraudzīt savu žurnāla failu. Piemēram, ja tiek analizēti 10 ieraksti un 3 ieraksti neizdodas ar regexp izpildes laika kļūdu, aģenta žurnālā tiek izveidots viens ieraksts. Izņēmums: ja `MaxLinesPerSecond=1` un atjaunināšanas intervāls ir 1 (uz vienu pārbaudi ir atļauts analizēt tikai 1 ierakstu), tad regexp izpildes laika kļūdas netiek reģistrētas. zabbix_agentd izpildes laika kļūdas gadījumā reģistrē vienuma atslēgu, bet zabbix_agent2 reģistrē vienuma ID, lai palīdzētu identificēt, kuram loga vienumam ir izpildes laika kļūdas. Izpildes laika kļūdu gadījumā ieteicams pārveidot regulāro izteiksmi. # hanode.get # hanode.get ##### HANodeName The high availability cluster node name. When empty the server is working in standalone mode and a node with empty name is created. ##### HANodeName Augstas pieejamības klastera mezgla nosaukums. Ja tas ir tukšs, serveris darbojas atsevišķā režīmā un tiek izveidots mezgls ar tukšu nosaukumu. #### Hardening security of Zabbix components Some functionality can be switched off to harden the security of Zabbix components: - Global script execution on Zabbix server can be disabled by setting `EnableGlobalScripts=0` in [server configuration](/manual/appendix/config/zabbix_server). - Global script execution on Zabbix proxy is disabled by default (can be enabled by setting `EnableRemoteCommands=1` in [proxy configuration](/manual/appendix/config/zabbix_proxy)). - Global script execution on Zabbix agents is disabled by default (can be enabled by adding an `AllowKey=system.run[<command>,*]` parameter for each allowed command in [agent configuration](/manual/appendix/config/zabbix_agentd)). - User HTTP authentication can be disabled by setting `$ALLOW_HTTP_AUTH=false` in the [frontend configuration file](/manual/installation/frontend#install) (`zabbix.conf.php`). Note that reinstalling the frontend (running `setup.php`) will remove this parameter. #### Zabbix komponentu drošības pastiprināšana Dažas funkcijas var izslēgt, lai pastiprinātu Zabbix komponentu drošību: - Globālo skriptu izpildi Zabbix serverī var atspējot, iestatot `EnableGlobalScripts=0` [servera konfigurācijā](/manual/appendix/config/zabbix_server). - Globālo skriptu izpilde Zabbix starpniekserverī pēc noklusējuma ir atspējota (to var iespējot, iestatot `EnableRemoteCommands=1` [starpniekservera konfigurācijā](/manual/appendix/config/zabbix_proxy)). - Globālo skriptu izpilde Zabbix aģentos pēc noklusējuma ir atspējota (to var iespējot, katrai atļautajai komandai [aģenta konfigurācijā](/manual/appendix/config/zabbix_agentd) pievienojot parametru `AllowKey=system.run[<command>,*]`). - Lietotāja HTTP autentifikāciju var atspējot, iestatot `$ALLOW_HTTP_AUTH=false` [lietotāja saskarnes konfigurācijas failā](/manual/installation/frontend#install) (`zabbix.conf.php`). Ņemiet vērā, ka lietotāja saskarnes atkārtota instalēšana (palaižot `setup.php`) noņems šo parametru. #### Hardware #### Aparatūra #### HashiCorp token auto renewal For HashiCorp [vault secrets](/manual/config/secrets/hashicorp), the automatic renewal of service tokens and periodic service tokens is now supported. If Zabbix detects that a token is renewable, it will keep automatically renewing it until the token's maximum TTL is reached or, in the case of periodic service tokens, indefinitely. #### HashiCorp tokena automātiska atjaunošana HashiCorp [vault secrets](/manual/config/secrets/hashicorp) tagad tiek atbalstīta pakalpojuma tokenu un periodisko pakalpojuma tokenu automātiska atjaunošana. Ja Zabbix konstatē, ka tokens ir atjaunojams, tas turpinās to automātiski atjaunot līdz tiek sasniegts tokena maksimālais TTL vai, periodisko pakalpojuma tokenu gadījumā, bezgalīgi. ##### HDD/flash image (raw) dd if=./zabbix_appliance_7.0.0.raw of=/dev/sdc bs=4k conv=fdatasync Replace */dev/sdc* with your Flash/HDD disk device. ##### HDD/flash attēls (raw) dd if=./zabbix_appliance_7.0.0.raw of=/dev/sdc bs=4k conv=fdatasync Aizstājiet */dev/sdc* ar sava Flash/HDD diska ierīci. #### Header processing The CSV file header line can be processed in two different ways: - If the *With header row* checkbox is marked - header line values are interpreted as column names. In this case the column names must be unique and the data row should not contain more columns than the header row. - If the *With header row* checkbox is not marked - the header line is interpreted as data. Column names are generated automatically (1,2,3,4...). CSV file example: Nr,Item name,Key,Qty 1,active agent item,agent.hostname,33 "2","passive agent item","agent.version","44" 3,"active,passive agent items",agent.ping,55 ::: noteclassic A quotation character within a quoted field in the input must be escaped by preceding it with another quotation character. ::: **Processing header line** JSON output when a header line is expected: ``` {.json} [ { "Nr":"1", "Item name":"active agent item", "Key":"agent.hostname", "Qty":"33" }, { "Nr":"2", "Item name":"passive agent item", "Key":"agent.version", "Qty":"44" }, { "Nr":"3", "Item name":"active,passive agent items", "Key":"agent.ping", "Qty":"55" } ] ``` **No header line processing** JSON output when a header line is not expected: ``` {.json} [ { "1":"Nr", "2":"Item name", "3":"Key" "4":"Qty" }, { "1":"1", "2":"active agent item", "3":"agent.hostname" "4":"33" }, { "1":"2", "2":"passive agent item", "3":"agent.version" "4":"44" }, { "1":"3", "2":"active,passive agent items", "3":"agent.ping" "4":"55" } ] ``` #### Header processing The CSV file header line can be processed in two different ways: - If the *With header row* checkbox is marked - header line values are interpreted as column names. In this case the column names must be unique and the data row should not contain more columns than the header row; - If the *With header row* checkbox is not marked - the header line is interpreted as data. Column names are generated automatically (1,2,3,4...) CSV file example: Nr,Item name,Key,Qty 1,active agent item,agent.hostname,33 "2","passive agent item","agent.version","44" 3,"active,passive agent items",agent.ping,55 ::: noteclassic A quotation character within a quoted field in the input must be escaped by preceding it with another quotation character. ::: **Processing header line** JSON output when a header line is expected: ``` {.json} [ { "Nr":"1", "Item name":"active agent item", "Key":"agent.hostname", "Qty":"33" }, { "Nr":"2", "Item name":"passive agent item", "Key":"agent.version", "Qty":"44" }, { "Nr":"3", "Item name":"active,passive agent items", "Key":"agent.ping", "Qty":"55" } ] ``` **No header line processing** JSON output when a header line is not expected: ``` {.json} [ { "1":"Nr", "2":"Item name", "3":"Key" "4":"Qty" }, { "1":"1", "2":"active agent item", "3":"agent.hostname" "4":"33" }, { "1":"2", "2":"passive agent item", "3":"agent.version" "4":"44" }, { "1":"3", "2":"active,passive agent items", "3":"agent.ping" "4":"55" } ] ``` ##### HeartbeatFrequency The frequency of heartbeat messages in seconds. Used for monitoring the availability of active checks.<br>0 - heartbeat messages disabled. Default: `60`<br> Range: 0-3600 ##### HeartbeatFrequency Sirdsdarbības ziņojumu biežums sekundēs. Tiek izmantots aktīvo pārbaužu pieejamības uzraudzībai.<br>0 - sirdsdarbības ziņojumi ir atspējoti. Noklusējums: `60`<br> Diapazons: 0-3600 ##### HeartbeatFrequency The frequency of heartbeat messages in seconds. Used for monitoring the availability of active checks.<br>0 - heartbeat messages disabled. Default: `60`<br> Range: 0-3600 ##### HeartbeatFrequency Sirdsdarbības ziņojumu biežums sekundēs. Tiek izmantots aktīvo pārbaužu pieejamības uzraudzībai.<br>0 - sirdsdarbības ziņojumi ir atspējoti. Noklusējums: `60`<br> Diapazons: 0-3600 ##### HeartbeatFrequency The frequency of heartbeat messages in seconds. Used for monitoring the availability of active checks.<br>0 - heartbeat messages disabled. Default: `60`<br> Range: 0-3600 ##### HeartbeatFrequency Sirdsdarbības ziņojumu biežums sekundēs. Tiek izmantots aktīvo pārbaužu pieejamības uzraudzībai.<br>0 - sirdsdarbības ziņojumi ir atspējoti. Noklusējums: `60`<br> Diapazons: 0-3600 ##### HeartbeatFrequency The frequency of heartbeat messages in seconds. Used for monitoring the availability of active checks.<br>0 - heartbeat messages disabled. Default: `60`<br> Range: 0-3600 ##### HeartbeatFrequency Sirdsdarbības ziņojumu biežums sekundēs. Tiek izmantots aktīvo pārbaužu pieejamības uzraudzībai.<br>0 - sirdsdarbības ziņojumi ir atspējoti. Noklusējums: `60`<br> Diapazons: 0-3600 ##### Heartbeat message **Agent sends** The heartbeat message is sent by an active agent to Zabbix server/proxy every HeartbeatFrequency seconds (configured in the [Zabbix agent](/manual/appendix/config/zabbix_agentd)/ [agent 2](/manual/appendix/config/zabbix_agent2) configuration file). It is used to monitor the availability of active checks. ```json { "request": "active check heartbeat", "host": "Zabbix server", "heartbeat_freq": 60, "version": "7.0.0", "variant": 2 } ``` | Field | Type | Mandatory | Value | |-|-|-|--------| | request | _string_ | yes | `active check heartbeat` | | host | _string_ | yes | The host name. | | heartbeat_freq | _number_ | yes | The agent heartbeat frequency (HeartbeatFrequency configuration parameter). | | version | _string_ | yes | The agent version number. | | variant | _number_ | yes | The agent variant (*1* - Zabbix agent, *2* - Zabbix agent 2). | **Redirect response** When a host has been reassigned, the server may instruct the agent to redirect its heartbeat (and subsequent active checks) to another proxy or server instance. ```json { "response": "failed", "redirect": { "revision": 2, "address": "192.0.2.1:10055" } } ``` | Field |<| Type | Mandatory | Value | |-|------|--|-|-----------------------| | response |<| _string_ | yes | `success` \| `failed` | | redirect |<| _object_ | yes | Redirect instructions. | | | revision | _number_ | yes | Configuration revision identifier. | |^| address | _string_ | yes | Target server/proxy address. | ##### Sirdspējas ziņojums **Aģents nosūta** Sirdspējas ziņojumu aktīvs aģents nosūta Zabbix serverim/starpniekserverim ik pēc HeartbeatFrequency sekundēm (konfigurēts [Zabbix agent](/manual/appendix/config/zabbix_agentd)/ [agent 2](/manual/appendix/config/zabbix_agent2) konfigurācijas failā). To izmanto, lai uzraudzītu aktīvo pārbaužu pieejamību. ```json { "request": "active check heartbeat", "host": "Zabbix server", "heartbeat_freq": 60, "version": "7.0.0", "variant": 2 } ``` | Field | Type | Mandatory | Value | |-|-|-|-| | request | _string_ | yes | `active check heartbeat` | | host | _string_ | yes | Saimniekdatora nosaukums. | | heartbeat_freq | _number_ | yes | Aģenta sirdspējas biežums (HeartbeatFrequency konfigurācijas parametrs). | | version | _string_ | yes | Aģenta versijas numurs. | | variant | _number_ | yes | Aģenta variants (*1* - Zabbix agent, *2* - Zabbix agent 2). | **Pāradresācijas atbilde** Ja hosts ir pārdalīts, serveris var norādīt aģentam pāradresēt tā sirdspēju (un turpmākās aktīvās pārbaudes) uz citu starpniekservera vai servera instanci. ```json { "response": "failed", "redirect": { "revision": 2, "address": "192.0.2.1:10055" } } ``` | Field |<| Type | Mandatory | Value | |-|------|--|-|-----------------------| | response |<| _string_ | yes | `success` \| `failed` | | redirect |<| _object_ | yes | Pāradresācijas norādījumi. | | | revision | _number_ | yes | Konfigurācijas revīzijas identifikators. | |^| address | _string_ | yes | Mērķa servera/starpniekservera adrese. | ##### Hexadecimal to decimal {#hexadecimal} Convert the value from hexadecimal format to decimal. If you mark the *Custom on fail* checkbox, it is possible to specify custom error-handling options: either to discard the value, set a specified value, or set a specified error message. In case of a failed preprocessing step, the item will not become unsupported if the option to discard the value or set a specified value is selected. ##### No heksadecimālā uz decimālo {#hexadecimal} Pārveido vērtību no heksadecimālā formāta uz decimālo. Ja atzīmējat izvēles rūtiņu *Pielāgots kļūmes gadījumā*, ir iespējams norādīt pielāgotas kļūdu apstrādes opcijas: vai nu atmest vērtību, iestatīt norādīto vērtību vai iestatīt norādīto kļūdas ziņojumu. Ja priekšapstrādes solis neizdodas, vienums nekļūs par neatbalstītu, ja ir atlasīta opcija atmest vērtību vai iestatīt norādīto vērtību. ##### Hidden menu Even when the menu is hidden completely, a full menu is just one mouse click away, by clicking on the burger icon {class="nozoom"}. Note that it reappears over page content; to move page content to the right you have to unhide the menu by clicking on the show sidebar button. ##### Slēptā izvēlne Pat tad, ja izvēlne ir pilnībā paslēpta, pilna izvēlne ir pieejama ar vienu peles klikšķi, noklikšķinot uz burgera ikonas {class="nozoom"}. Ņemiet vērā, ka tā atkal parādās virs lapas satura; lai pārvietotu lapas saturu pa labi, jums ir jāatceļ izvēlnes paslēpšana, noklikšķinot uz pogas "show sidebar". #### Hiding the file with list of common passwords To increase the complexity of password brute force attacks, limiting access to the `ui/data/top_passwords.txt` file is recommended. This file contains a list of the most common and context-specific passwords and prevents users from setting such passwords (if the *Avoid easy-to-guess passwords* parameter is enabled in the [password policy](/manual/web_interface/frontend_sections/users/authentication#internal-authentication)). To limit access to the `top_passwords.txt` file, modify your web server configuration. On Apache, file access can be limited using the `.htaccess` file: ```ini <Files "top_passwords.txt"> Order Allow,Deny Deny from all </Files> ``` On NGINX, file access can be limited using the `location` directive: ```ini location = /data/top_passwords.txt { deny all; return 404; } ``` #### Faila ar biežāk lietoto paroļu sarakstu slēpšana Lai palielinātu paroļu brutālpiespiedu uzbrukumu sarežģītību, ieteicams ierobežot piekļuvi failam `ui/data/top_passwords.txt`. Šajā failā ir iekļauts visbiežāk lietoto un kontekstam specifisko paroļu saraksts, un tas neļauj lietotājiem iestatīt šādas paroles (ja ir iespējots parametrs *Avoid easy-to-guess passwords* [paroļu politikā](/manual/web_interface/frontend_sections/users/authentication#internal-authentication)). Lai ierobežotu piekļuvi failam `top_passwords.txt`, modificējiet sava tīmekļa servera konfigurāciju. Apache gadījumā piekļuvi failam var ierobežot, izmantojot `.htaccess` failu: ```ini <Files "top_passwords.txt"> Order Allow,Deny Deny from all </Files> ``` NGINX gadījumā piekļuvi failam var ierobežot, izmantojot direktīvu `location`: ```ini location = /data/top_passwords.txt { deny all; return 404; } ``` #### High availability cluster Retrieve a list of server nodes and their status. [High availability cluster API](/manual/api/reference/hanode) #### Augstas pieejamības klasteris Iegūstiet servera mezglu sarakstu un to statusu. [Augstas pieejamības klastera API](/manual/api/reference/hanode) ### High availability node ::: noteclassic Nodes are created by the Zabbix server and cannot be modified via the API. ::: The High availability node object has the following properties. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |ha\_nodeid|ID|ID of the node.| |name|string|Name assigned to the node, using the HANodeName configuration entry of zabbix\_server.conf. Empty for a server running in standalone mode.| |address|string|IP or DNS name where the node connects from.| |port|integer|Port on which the node is running.| |lastaccess|integer|Heartbeat time, that is, time of last update from the node. UTC timestamp.| |status|integer|State of the node.<br><br>Possible values:<br>0 - standby;<br>1 - stopped manually;<br>2 - unavailable;<br>3 - active.| ### Augstas pieejamības mezgls ::: noteclassic Mezglus izveido Zabbix serveris, un tos nevar mainīt, izmantojot API. ::: Augstas pieejamības mezgla objektam ir šādas īpašības. |Īpašība|[Tips](/manual/api/reference_commentary#data-types)|Apraksts| |--|--|------| |ha\_nodeid|ID|Mezgla ID.| |name|string|Mezglam piešķirtais nosaukums, izmantojot HANodeName konfigurācijas ierakstu failā zabbix\_server.conf. Tukšs serverim, kas darbojas savrupā režīmā.| |address|string|IP adrese vai DNS nosaukums, no kura mezgls pieslēdzas.| |port|integer|Ports, kurā mezgls darbojas.| |lastaccess|integer|Sirdspuksta laiks, tas ir, pēdējās atjaunināšanas laiks no mezgla. UTC laikspiedols.| |status|integer|Mezgla stāvoklis.<br><br>Iespējamās vērtības:<br>0 - gaidstāve;<br>1 - apturēts manuāli;<br>2 - nav pieejams;<br>3 - aktīvs.| # High availability node object The following object is related to operating a High availability cluster of Zabbix servers. # Augstas pieejamības mezgla objekts Tālāk aprakstītais objekts ir saistīts ar Zabbix serveris augstas pieejamības klastera darbību. #### High availability nodes If [high availability cluster](/manual/concepts/server/ha) is enabled, then another block of data is displayed with the status of each high availability node. {width="600"} Displayed data: |Column|Description| |--|--------| |*Name*|Node name, as defined in server configuration.| |*Address*|Node IP address and port.| |*Last access*|Time of node last access.<br>Hovering over the cell shows the timestamp of last access in long format.| |*Status*|Node status. Table rows are sorted by these statuses in this priority order:<br>**Active** - node is up and working<br>**Unavailable** - node hasn't been seen for more than failover delay (you may want to find out why)<br>**Stopped** - node has been stopped or couldn't start (you may want to start it or delete it)<br>**Standby** - node is up and waiting| #### Augstas pieejamības mezgli Ja ir iespējota [augstas pieejamības kopa](/manual/concepts/server/ha), tad tiek parādīts vēl viens datu bloks ar katra augstas pieejamības mezgla statusu. {width="600"} Parādītie dati: |Column|Description| |--|--------| |*Name*|Mezgla nosaukums, kā definēts servera konfigurācijā.| |*Address*|Mezgla IP adrese un ports.| |*Last access*|Mezgla pēdējās piekļuves laiks.<br>Novietojot kursoru virs šūnas, tiek parādīts pēdējās piekļuves laikspiedols pilnajā formātā.| |*Status*|Mezgla statuss. Tabulas rindas tiek kārtotas pēc šiem statusiem šādā prioritātes secībā:<br>**Active** - mezgls darbojas un ir pieejams<br>**Unavailable** - mezgls nav bijis redzams ilgāk par pārslēgšanās aizturi (iespējams, vēlēsieties noskaidrot iemeslu)<br>**Stopped** - mezgls ir apturēts vai to neizdevās palaist (iespējams, vēlēsieties to palaist vai dzēst)<br>**Standby** - mezgls darbojas un gaida| # High availability node This class is designed to work with server nodes that are part of a high availability cluster or a standalone server instance. Object references: - [High availability node](/manual/api/reference/hanode/object#high-availability-node) Available methods: - [hanode.get](/manual/api/reference/hanode/get) - retrieve nodes # Augstas pieejamības mezgls Šī klase ir paredzēta darbam ar servera mezgliem, kas ir daļa no augstas pieejamības klastera vai atsevišķas servera instances. Objektu atsauces: - [Augstas pieejamības mezgls](/manual/api/reference/hanode/object#high-availability-node) Pieejamās metodes: - [hanode.get](/manual/api/reference/hanode/get) - izgūt mezglus #### Highlight whole row in Problems view and Problems widget The *Highlight whole row* option is now available in the non-compact [Monitoring > Problems](/manual/web_interface/frontend_sections/monitoring/problems#overview) view and in the [Problems](/manual/web_interface/frontend_sections/dashboards/widgets/problems) dashboard widget. #### Iezīmēt visu rindu Problems skatā un Problems logrīkā Opcija *Iezīmēt visu rindu* tagad ir pieejama nekompaktajā [Monitoring > Problems](/manual/web_interface/frontend_sections/monitoring/problems#overview) skatā un [Problems](/manual/web_interface/frontend_sections/dashboards/widgets/problems) informācijas paneļa logrīkā. ##### histogram_quantile(quantile,bucket1,value1,bucket2,value2,...) {#histogram-quantile} Calculates the φ-quantile from the buckets of a histogram.<br> Supported [foreach function](/manual/appendix/functions/aggregate/foreach): *bucket_rate_foreach*. Parameters: - **quantile** - 0 ≤ φ ≤ 1;<br> - **bucketN, valueN** - manually entered pairs (>=2) of parameters or the response of [bucket_rate_foreach](/manual/appendix/functions/aggregate/foreach). Comments: - Supported only in calculated items; - Functionally corresponds to '[histogram\_quantile](https://prometheus.io/docs/prometheus/latest/querying/functions/#histogram-quantile)' of PromQL; - Returns -1 if values of the last 'Infinity' bucket (*"+inf"*) are equal to 0. Examples: ```default histogram_quantile(0.75,1.0,last(/host/rate_bucket[1.0]),"+Inf",last(/host/rate_bucket[Inf])) histogram_quantile(0.5,bucket_rate_foreach(//item_key,30s)) ``` ##### histogram_quantile(quantile,bucket1,value1,bucket2,value2,...) {#histogram-quantile} Aprēķina φ-kvantiļu no histogrammas spaiņiem.<br> Atbalstīta [foreach funkcija](/manual/appendix/functions/aggregate/foreach): *bucket_rate_foreach*. Parametri: - **quantile** - 0 ≤ φ ≤ 1;<br> - **bucketN, valueN** - manuāli ievadīti parametru pāri (>=2) vai [bucket_rate_foreach](/manual/appendix/functions/aggregate/foreach) atbilde. Piezīmes: - Atbalstīta tikai aprēķinātajos vienumos; - Funkcionāli atbilst PromQL funkcijai '[histogram\_quantile](https://prometheus.io/docs/prometheus/latest/querying/functions/#histogram-quantile)'; - Atgriež -1, ja pēdējā 'Infinity' spaiņa (*"+inf"*) vērtības ir vienādas ar 0. Piemēri: ```default histogram_quantile(0.75,1.0,last(/host/rate_bucket[1.0]),"+Inf",last(/host/rate_bucket[Inf])) histogram_quantile(0.5,bucket_rate_foreach(//item_key,30s)) ``` ##### HistoryCacheSize The size of the history cache, in bytes. The shared memory size for storing history data. Default: `16M`<br> Range: 128K-2G ##### HistoryCacheSize Vēstures kešatmiņas lielums baitos. Koplietotās atmiņas apjoms vēstures datu glabāšanai. Noklusējums: `16M`<br> Diapazons: 128K-2G ##### HistoryCacheSize The size of the history cache, in bytes. The shared memory size for storing history data. Default: `16M`<br> Range: 128K-2G ##### HistoryCacheSize Vēstures kešatmiņas lielums baitos. Koplietotās atmiņas apjoms vēstures datu glabāšanai. Noklusējums: `16M`<br> Diapazons: 128K-2G # history.clear # history.clear # history.get # history.get ##### HistoryIndexCacheSize The size of the history index cache, in bytes. The shared memory size for indexing the history data stored in history cache. The index cache size needs roughly 100 bytes to cache one item. Default: `4M`<br> Range: 128K-2G ##### HistoryIndexCacheSize Vēstures indeksa kešatmiņas lielums baitos. Koplietotās atmiņas apjoms vēstures datu indeksēšanai, kas glabājas vēstures kešatmiņā. Indeksa kešatmiņas lielumam viena vienuma kešošanai nepieciešami aptuveni 100 baiti. Noklusējums: `4M`<br> Diapazons: 128K-2G ##### HistoryIndexCacheSize The size of the history index cache, in bytes. The shared memory size for indexing the history data stored in history cache. The index cache size needs roughly 100 bytes to cache one item. Default: `4M`<br> Range: 128K-2G ##### HistoryIndexCacheSize Vēstures indeksa kešatmiņas lielums baitos. Koplietotās atmiņas apjoms, kas tiek izmantots vēstures datu indeksēšanai, kuri glabājas vēstures kešatmiņā. Indeksa kešatmiņas lielumam viena vienuma kešošanai nepieciešami aptuveni 100 baiti. Noklusējums: `4M`<br> Diapazons: 128K-2G # History object The following objects are directly related to the `history` API. ::: noteclassic History objects differ depending on the item's type of information. They are created by Zabbix server and cannot be modified via the API. ::: # Vēstures objekts Tālāk norādītie objekti ir tieši saistīti ar `history` API. ::: noteclassic Vēstures objekti atšķiras atkarībā no vienuma informācijas tipa. Tos izveido Zabbix serveris, un tos nevar modificēt, izmantojot API. ::: # history.push # history.push **history.push** For sending data to Zabbix server using the `history.push` API method, you could make the following HTTP POST request containing some test values: ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer 0424bd59b807674191e7d77572075f33' \ --header 'Content-Type: application/json-rpc' \ --data '{"jsonrpc":"2.0","method":"history.push","params":[{"itemid":10600,"value":"test value 1"},{"itemid":10601,"value":"test value 2"},{"itemid":99999,"value":"test value 3"}],"id":1}' ``` If the request is correct, the response returned by API could look as follows: ```json { "jsonrpc": "2.0", "result": { "response": "success", "data": [ { "itemid": "10600" }, { "itemid": "10601", "error": "Item is disabled." }, { "error": "No permissions to referred object or it does not exist." } ] }, "id": 1 } ``` Errors in response data indicate that sending data for specific items has failed validation by Zabbix server. This can happen for the following reasons: - the user sending the data has no *read* permission to the item's host; - the host is disabled or in maintenance without data collection; - the item does not exist or is not yet included in the server configuration cache; - the item is disabled or its type is other than Zabbix trapper or [HTTP agent](/manual/config/items/itemtypes/http) (with trapping enabled); - the user's IP or DNS is not set in the item's *Allowed hosts* list; - another item has a value with a duplicate timestamp on the nanosecond level. The absence of errors indicates that the values sent have been accepted for processing, which includes preprocessing (if any), trigger processing, and saving to the database. Note that the processing of an accepted value may also fail (for example, during [preprocessing](/manual/config/items/preprocessing)), resulting in the value being discarded. For more information on how to work with Zabbix API, see [API](/manual/api). **history.push** Lai nosūtītu datus uz Zabbix serveris, izmantojot `history.push` API metodi, varat veikt šādu HTTP POST pieprasījumu, kas satur dažas testa vērtības: ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer 0424bd59b807674191e7d77572075f33' \ --header 'Content-Type: application/json-rpc' \ --data '{"jsonrpc":"2.0","method":"history.push","params":[{"itemid":10600,"value":"test value 1"},{"itemid":10601,"value":"test value 2"},{"itemid":99999,"value":"test value 3"}],"id":1}' ``` Ja pieprasījums ir pareizs, API atgrieztā atbilde varētu izskatīties šādi: ```json { "jsonrpc": "2.0", "result": { "response": "success", "data": [ { "itemid": "10600" }, { "itemid": "10601", "error": "Item is disabled." }, { "error": "No permissions to referred object or it does not exist." } ] }, "id": 1 } ``` Kļūdas atbildes datos norāda, ka datu nosūtīšana konkrētiem vienumiem nav izturējusi Zabbix serveris validāciju. Tas var notikt šādu iemeslu dēļ: - lietotājam, kurš nosūta datus, nav *lasīšanas* atļaujas uz vienuma hostu; - hosts ir atspējots vai atrodas uzturēšanas režīmā bez datu vākšanas; - vienums neeksistē vai vēl nav iekļauts servera konfigurācijas kešatmiņā; - vienums ir atspējots vai tā tips nav Zabbix trapper vai [HTTP aģents](/manual/config/items/itemtypes/http) (ar iespējotu trapping); - lietotāja IP vai DNS nav iestatīts vienuma *Allowed hosts* sarakstā; - citam vienumam ir vērtība ar dublējošu laikspiedolu nanosekunžu līmenī. Kļūdu neesamība norāda, ka nosūtītās vērtības ir pieņemtas apstrādei, kas ietver priekšapstrādi (ja tāda ir), trigeris apstrādi un saglabāšanu datubāzē. Ņemiet vērā, ka arī pieņemtās vērtības apstrāde var neizdoties (piemēram, [priekšapstrādes](/manual/config/items/preprocessing) laikā), kā rezultātā vērtība tiek atmesta. Plašāku informāciju par darbu ar Zabbix API skatiet sadaļā [API](/manual/api). #### History Retrieve historical values gathered by Zabbix monitoring processes for presentation or further processing. [History API](/manual/api/reference/history) #### Vēsture Iegūstiet vēsturiskās vērtības, ko Zabbix uzraudzības procesi apkopojuši attēlošanai vai tālākai apstrādei. [Vēstures API](/manual/api/reference/history) ##### HistoryStorageDateIndex Enable preprocessing of history values in history storage to store values in different indices based on date. Default: `0`<br> Values: 0 - disable; 1 - enable ##### HistoryStorageDateIndex Iespējot vēstures vērtību pirmapstrādi vēstures glabātuvē, lai saglabātu vērtības dažādos indeksos, pamatojoties uz datumu. Noklusējums: `0`<br> Vērtības: 0 - atspējot; 1 - iespējot ##### HistoryStorageTypes A comma-separated list of value types to be sent to the history storage. This parameter is used for [Elasticsearch](/manual/appendix/install/elastic_search_setup) setup. Default: `uint,dbl,str,log,text` ##### HistoryStorageTypes Ar komatiem atdalīts vērtību tipu saraksts, kas jānosūta uz vēstures krātuvi. Šis parametrs tiek izmantots [Elasticsearch](/manual/appendix/install/elastic_search_setup) iestatīšanai. Noklusējums: `uint,dbl,str,log,text` ##### HistoryStorageURL The history storage HTTP\[S\] URL. This parameter is used for [Elasticsearch](/manual/appendix/install/elastic_search_setup) setup. ##### HistoryStorageURL Vēstures krātuves HTTP\[S\] URL. Šis parametrs tiek izmantots [Elasticsearch](/manual/appendix/install/elastic_search_setup) iestatīšanai. ## History tab The *History* tab lets you configure how long different types of historical data are stored. {width="600"} You can set the storage period for each data type (e.g., numeric, text, logs) and choose the unit (days, months, years). Changes can be made up to three times every 24 hours. After updating the values, click *Save* to apply the changes. ::: notewarning Longer retention periods can increase disk usage and may impact performance. It is recommended to configure retention periods based on your actual data and analysis needs.<br> Zabbix Cloud uses database partitioning to manage data storage instead of traditional Zabbix housekeeping. This enables faster performance and more predictable retention handling. ::: ## Vēstures cilne Cilne *Vēsture* ļauj konfigurēt, cik ilgi tiek glabāti dažādu tipu vēsturiskie dati. {width="600"} Varat iestatīt glabāšanas periodu katram datu tipam (piemēram, skaitliskie dati, teksts, žurnāli) un izvēlēties mērvienību (dienas, mēneši, gadi). Izmaiņas var veikt ne vairāk kā trīs reizes 24 stundu laikā. Pēc vērtību atjaunināšanas noklikšķiniet uz *Saglabāt*, lai piemērotu izmaiņas. ::: notewarning Ilgāki glabāšanas periodi var palielināt diska vietas izmantošanu un ietekmēt veiktspēju. Ieteicams konfigurēt glabāšanas periodus atbilstoši jūsu faktiskajiem datiem un analīzes vajadzībām.<br> Zabbix Cloud datu glabāšanas pārvaldībai izmanto datubāzes particionēšanu tradicionālās Zabbix housekeepinga vietā. Tas nodrošina ātrāku veiktspēju un paredzamāku glabāšanas periodu pārvaldību. ::: # History This class is designed to work with history data. Object references: - [Float history](/manual/api/reference/history/object#float-history) - [Integer history](/manual/api/reference/history/object#integer-history) - [String history](/manual/api/reference/history/object#string-history) - [Text history](/manual/api/reference/history/object#text-history) - [Log history](/manual/api/reference/history/object#log-history) Available methods: - [history.clear](/manual/api/reference/history/clear) - clear history data - [history.get](/manual/api/reference/history/get) - retrieve history data - [history.push](/manual/api/reference/history/push) - send history data to Zabbix server # Vēsture Šī klase ir paredzēta darbam ar vēstures datiem. Objektu atsauces: - [Peldošā komata vēsture](/manual/api/reference/history/object#float-history) - [Veselu skaitļu vēsture](/manual/api/reference/history/object#integer-history) - [Virknes vēsture](/manual/api/reference/history/object#string-history) - [Teksta vēsture](/manual/api/reference/history/object#text-history) - [Žurnāla vēsture](/manual/api/reference/history/object#log-history) Pieejamās metodes: - [history.clear](/manual/api/reference/history/clear) - notīrīt vēstures datus - [history.get](/manual/api/reference/history/get) - izgūt vēstures datus - [history.push](/manual/api/reference/history/push) - nosūtīt vēstures datus uz Zabbix serveri #### History, trends and audit log compression settings The *History and trends compression* block has been renamed to *History, trends and audit log compression* in the Administration > Housekeeping section of the Zabbix frontend, accessible after [installing or updating TimescaleDB](/manual/appendix/install/timescaledb). #### Vēstures, tendenču un audita žurnāla saspiešanas iestatījumi Bloks *Vēstures un tendenču saspiešana* Zabbix lietotāja saskarnes sadaļā Administration > Housekeeping ir pārdēvēts par *Vēstures, tendenču un audita žurnāla saspiešana*, kas ir pieejama pēc [TimescaleDB instalēšanas vai atjaunināšanas](/manual/appendix/install/timescaledb). #### history [ZBXNEXT-9193](https://support.zabbix.com/browse/ZBXNEXT-9193) `history.get`: Parameter `sortfield` now supports `ns`.<br> [ZBXNEXT-8541](https://support.zabbix.com/browse/ZBXNEXT-8541) Added new method `history.push`. #### vēsture [ZBXNEXT-9193](https://support.zabbix.com/browse/ZBXNEXT-9193) `history.get`: Parametrs `sortfield` tagad atbalsta `ns`.<br> [ZBXNEXT-8541](https://support.zabbix.com/browse/ZBXNEXT-8541) Pievienota jauna metode `history.push`. #### Honeycomb A *Honeycomb* widget has been added to [dashboard widgets](/manual/web_interface/frontend_sections/dashboards/widgets), which offers a dynamic and vibrant overview of the monitored network infrastructure and resources, where host groups, such as virtual machines and network devices, along with their respective items, are visually represented as interactive hexagonal cells. For more information, see [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb). {width="450"} #### Honeycomb [lietotāja saskarnes paneļa logrīkiem](/manual/web_interface/frontend_sections/dashboards/widgets) ir pievienots *Honeycomb* logrīks, kas nodrošina dinamisku un vizuāli pievilcīgu pārskatu par uzraudzīto tīkla infrastruktūru un resursiem, kur hosts grupas, piemēram, virtuālās mašīnas un tīkla ierīces, kopā ar to attiecīgajiem vienumiem, tiek vizuāli attēlotas kā interaktīvas sešstūra šūnas. Papildinformāciju skatiet sadaļā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb). {width="450"} #### Host availability status calculation The [availability](/manual/web_interface/frontend_sections/data_collection/hosts) status of all host interfaces of a single type (Agent, SNMP, IPMI, JMX) is now determined only by those interfaces that are used by at least one enabled item. It is no longer determined by all interfaces of the same type, regardless of whether any items use them. #### Hosts pieejamības statusa aprēķins Visu viena tipa hosta saskarņu ([availability](/manual/web_interface/frontend_sections/data_collection/hosts)) statuss (Agent, SNMP, IPMI, JMX) tagad tiek noteikts tikai pēc tām saskarnēm, kuras izmanto vismaz viens iespējots vienums. Tas vairs netiek noteikts pēc visām tā paša tipa saskarnēm neatkarīgi no tā, vai tās izmanto kādi vienumi. ##### Host configuration A host must be configured to process IPMI checks. An IPMI interface must be added, with the respective IP and port numbers, and IPMI authentication parameters must be defined. See the [configuration of hosts](/manual/config/hosts/host) for more details. ##### Hosta konfigurācija Lai apstrādātu IPMI pārbaudes, hosts ir jākonfigurē. Jāpievieno IPMI saskarne, norādot attiecīgo IP adresi un porta numuru, kā arī jādefinē IPMI autentifikācijas parametri. Plašāku informāciju skatiet [hostu konfigurācijā](/manual/config/hosts/host). ##### Host configuration You can specify that an individual host should be monitored by a proxy or proxy group in the [host configuration](/manual/config/hosts/host) form, using the *Monitored by* field. {width="600"} Host [mass update](/manual/config/hosts/hostupdate) is another way of specifying that hosts should be monitored by a proxy or proxy group. ##### Hosts konfigurācija Varat norādīt, ka atsevišķs hosts jāuzrauga ar starpniekserveri vai starpniekserveru grupu [hosts konfigurācijas](/manual/config/hosts/host) formā, izmantojot lauku *Monitored by*. {width="600"} Hosts [masveida atjaunināšana](/manual/config/hosts/hostupdate) ir vēl viens veids, kā norādīt, ka hosts jāuzrauga ar starpniekserveri vai starpniekserveru grupu. # host.create # host.create ##### Host creation A host is added if the *Add host* operation is selected. A host is also added, even if the *Add host* operation is missing, if you select operations resulting in actions on a host. Such operations are: - enable host - disable host - add host to a host group - link template to a host Created hosts are added to the *Discovered hosts* group (by default, configurable in *Administration* > *General* > *[Other](/manual/web_interface/frontend_sections/administration/general#other-parameters)*). If you wish hosts to be added to another group, add a *Remove from host groups* operation (specifying "Discovered hosts") and also add an *Add to host groups* operation (specifying another host group), because a host must belong to a host group. The IP address of the discovered device, together with the discovery source (Zabbix server, Zabbix proxy, or proxy group) and the interface type, is used as the criterion for finding a host in the system. If a host with the same IP address, interface type and discovery source already exists, that host will be the target for performing operations. If the discovery source differs, the discovered entity is treated as a different host and a new host may be created. If the IP address of the discovered host is changed or the interface is deleted, a new host will be created upon the next discovery. ##### Hosta izveide Hosts tiek pievienots, ja ir atlasīta operācija *Pievienot hostu*. Hosts tiek pievienots arī tad, ja operācijas *Pievienot hostu* nav, bet jūs atlasāt operācijas, kuru rezultātā tiek veiktas darbības ar hostu. Šādas operācijas ir: - iespējot hostu - atspējot hostu - pievienot hostu hostu grupai - piesaistīt veidni hostam Izveidotie hosti tiek pievienoti grupai *Atklātie hosti* (*Discovered hosts*) (pēc noklusējuma; konfigurējams sadaļā *Administrēšana* > *Vispārīgi* > *[Cits](/manual/web_interface/frontend_sections/administration/general#other-parameters)*). Ja vēlaties, lai hosti tiktu pievienoti citai grupai, pievienojiet operāciju *Noņemt no hostu grupām* (norādot "Discovered hosts") un arī operāciju *Pievienot hostu grupām* (norādot citu hostu grupu), jo hostam ir jāpieder hostu grupai. Atklātās ierīces IP adrese kopā ar atklāšanas avotu (Zabbix serveris, Zabbix starpniekserveris vai starpniekserveru grupa) un saskarnes tipu tiek izmantota kā kritērijs hosta atrašanai sistēmā. Ja hosts ar tādu pašu IP adresi, saskarnes tipu un atklāšanas avotu jau pastāv, šis hosts būs mērķis operāciju izpildei. Ja atklāšanas avots atšķiras, atklātā entītija tiek uzskatīta par citu hostu, un var tikt izveidots jauns hosts. Ja atklātā hosta IP adrese tiek mainīta vai saskarne tiek dzēsta, nākamās atklāšanas laikā tiks izveidots jauns hosts. #### Host dashboards tabs All of the configured [host dashboards](/manual/web_interface/frontend_sections/monitoring/hosts/dashboards) for the selected host are now displayed as tabs under the host dashboards page header, replacing the previous dropdown in the upper right corner. This allows easy transition between various host dashboards and improves navigation through monitoring data. #### Hosts informācijas paneļu cilnes Visi konfigurētie [hosts informācijas paneļi](/manual/web_interface/frontend_sections/monitoring/hosts/dashboards) atlasītajam hostam tagad tiek parādīti kā cilnes zem hosts informācijas paneļu lapas virsraksta, aizstājot iepriekšējo nolaižamo izvēlni augšējā labajā stūrī. Tas ļauj ērti pārslēgties starp dažādiem hosts informācijas paneļiem un uzlabo navigāciju monitoringa datos. # host.delete # host.delete # host.get # host.get ##### Host graph items |Element|<|Type|Description| |-|---|---|-----------------------| |sortorder|<|integer|Draw order. The smaller value is drawn first. Can be used to draw lines or regions behind (or in front of) another.| |drawtype|<|string|Draw style of the graph item.<br>Supported for NORMAL graphs.<br>Possible values:^[1](#footnotes)^ SINGLE\_LINE (0, default), FILLED\_REGION (1), BOLD\_LINE (2), DOTTED\_LINE (3), DASHED\_LINE (4), GRADIENT\_LINE (5).| |color|<|string|Element color (6 symbols, hex).| |yaxisside|<|string|Side of the graph where the graph item's Y scale will be drawn.<br>Supported for NORMAL and STACKED graphs.|<br>Possible values:^[1](#footnotes)^ LEFT (0, default), RIGHT (1).| |calc\_fnc|<|string|Data to draw if more than one value exists for an item.<br>Possible values:^[1](#footnotes)^ MIN (1), AVG (2, default), MAX (4), ALL (7; minimum, average, and maximum; supported for simple graphs), LAST (9, supported for pie/exploded graphs).| |type|<|string|Graph item type.<br>Possible values:^[1](#footnotes)^ SIMPLE (0, default), GRAPH\_SUM (2; value of the item represents the whole pie; supported for pie/exploded graphs).| |item|<| |(required) Individual item.| |<|host|string|(required) Item host.| |^|key|string|(required) Item key.| ::: noteclassic See also: [Graph item object](/manual/api/reference/graphitem/object) (refer to the relevant property with a matching name). ::: ##### Hostu grafika vienumi |Element|<|Type|Description| |-|---|---|-----------------------| |sortorder|<|integer|Zīmēšanas secība. Mazākā vērtība tiek zīmēta pirmā. Var izmantot, lai zīmētu līnijas vai apgabalus aiz citas līnijas vai apgabala (vai to priekšā).| |drawtype|<|string|Grafika vienuma zīmēšanas stils.<br>Atbalstīts NORMAL grafikiem.<br>Iespējamās vērtības:^[1](#footnotes)^ SINGLE\_LINE (0, noklusējuma), FILLED\_REGION (1), BOLD\_LINE (2), DOTTED\_LINE (3), DASHED\_LINE (4), GRADIENT\_LINE (5).| |color|<|string|Elementa krāsa (6 simboli, hex).| |yaxisside|<|string|Grafika puse, kurā tiks zīmēta grafika vienuma Y ass mērogs.<br>Atbalstīts NORMAL un STACKED grafikiem.|<br>Iespējamās vērtības:^[1](#footnotes)^ LEFT (0, noklusējuma), RIGHT (1).| |calc\_fnc|<|string|Dati, ko zīmēt, ja vienumam ir vairāk nekā viena vērtība.<br>Iespējamās vērtības:^[1](#footnotes)^ MIN (1), AVG (2, noklusējuma), MAX (4), ALL (7; minimums, vidējais un maksimums; atbalstīts vienkāršiem grafikiem), LAST (9, atbalstīts sektoru/sadalītajiem sektoru grafikiem).| |type|<|string|Grafika vienuma tips.<br>Iespējamās vērtības:^[1](#footnotes)^ SIMPLE (0, noklusējuma), GRAPH\_SUM (2; vienuma vērtība attēlo visu sektoru; atbalstīts sektoru/sadalītajiem sektoru grafikiem).| |item|<| |(obligāts) Atsevišķs vienums.| |<|host|string|(obligāts) Vienuma hosts.| |^|key|string|(obligāts) Vienuma atslēga.| ::: noteclassic Skatiet arī: [Grafika vienuma objekts](/manual/api/reference/graphitem/object) (skatiet attiecīgo īpašību ar atbilstošu nosaukumu). ::: #### Host graphs |Element|<|Type|Description| |-|---|---|-----------------------| |uuid|<|string|Unique identifier of the graph.| |name|<|string|(required) Graph name.| |width|<|integer|Graph width, in pixels.<br>Used for preview and for pie/exploded graphs.<br>Possible values:^[1](#footnotes)^ 20-65535 (default: 900).| |height|<|integer|Graph height, in pixels.<br>Used for preview and for pie/exploded graphs.<br>Possible values:^[1](#footnotes)^ 20-65535 (default: 900).| |yaxismin|<|double|Value of Y axis minimum.<br>Supported for FIXED minimum value of Y axis.<br>Default: 0.| |yaxismax|<|double|Value of Y axis maximum.<br>Supported for FIXED minimum value of X axis.<br>Default: 0.| |show\_work\_period|<|string|Highlight non-working hours.<br>Supported for NORMAL and STACKED graphs.<br>Possible values:^[1](#footnotes)^ NO (0), YES (1, default).| |show\_triggers|<|string|Display simple trigger values as a line.<br>Supported for NORMAL and STACKED graphs.<br>Possible values:^[1](#footnotes)^ NO (0), YES (1, default).| |type|<|string|Graph type.<br>Possible values:^[1](#footnotes)^ NORMAL (0, default), STACKED (1), PIE (2), EXPLODED (3).| |show\_legend|<|string|Display graph legend.<br>Possible values:^[1](#footnotes)^ NO (0), YES (1, default).| |show\_3d|<|string|Enable 3D style.<br>Supported for NORMAL and STACKED graphs.<br>Possible values:^[1](#footnotes)^ NO (0, default), YES (1).| |percent\_left|<|double|Show the percentile line for left axis.<br>Supported for NORMAL graphs.<br>Default: 0.| |percent\_right|<|double|Show the percentile line for right axis.<br>Supported for NORMAL graphs.<br>Default: 0.| |ymin\_type\_1|<|string|Minimum value of Y axis.<br>Supported for NORMAL and STACKED graphs.<br>Possible values:^[1](#footnotes)^ CALCULATED (0, default), FIXED (1), ITEM (2).| |ymin\_item\_1|<| |(required if `ymin_type_1` is set to `ITEM`) Root element for individual item details.| |<|host|string|(required) Item host.| |^|key|string|(required) Item key.| |ymax\_type\_1|<|string|Maximum value of Y axis.<br>Supported for NORMAL and STACKED graphs.<br>Possible values:^[1](#footnotes)^ CALCULATED (0, default), FIXED (1), ITEM (2).| |ymax\_item\_1|<| |(required if `ymax_type_1` is set to `ITEM`) Root element for individual item details.| |<|host|string|(required) Item host.| |^|key|string|(required) Item key.| |graph\_items|<| |(required) Root element for [host graph items](#host-graph-items).| ::: noteclassic See also: [Graph object](/manual/api/reference/graph/object) (refer to the relevant property with a matching name). ::: #### Hosts grafiki |Element|<|Type|Apraksts| |-|---|---|-----------------------| |uuid|<|string|Grafika unikālais identifikators.| |name|<|string|(obligāts) Grafika nosaukums.| |width|<|integer|Grafika platums pikseļos.<br>Tiek izmantots priekšskatījumam un pīrāga/sadalītajiem grafikiem.<br>Iespējamās vērtības:^[1](#footnotes)^ 20-65535 (noklusējums: 900).| |height|<|integer|Grafika augstums pikseļos.<br>Tiek izmantots priekšskatījumam un pīrāga/sadalītajiem grafikiem.<br>Iespējamās vērtības:^[1](#footnotes)^ 20-65535 (noklusējums: 900).| |yaxismin|<|double|Y ass minimālā vērtība.<br>Atbalstīts Y ass FIXED minimālajai vērtībai.<br>Noklusējums: 0.| |yaxismax|<|double|Y ass maksimālā vērtība.<br>Atbalstīts X ass FIXED minimālajai vērtībai.<br>Noklusējums: 0.| |show\_work\_period|<|string|Iezīmēt nestrādājošās stundas.<br>Atbalstīts NORMAL un STACKED grafikiem.<br>Iespējamās vērtības:^[1](#footnotes)^ NO (0), YES (1, noklusējums).| |show\_triggers|<|string|Parādīt vienkāršas trigeru vērtības kā līniju.<br>Atbalstīts NORMAL un STACKED grafikiem.<br>Iespējamās vērtības:^[1](#footnotes)^ NO (0), YES (1, noklusējums).| |type|<|string|Grafika tips.<br>Iespējamās vērtības:^[1](#footnotes)^ NORMAL (0, noklusējums), STACKED (1), PIE (2), EXPLODED (3).| |show\_legend|<|string|Parādīt grafika leģendu.<br>Iespējamās vērtības:^[1](#footnotes)^ NO (0), YES (1, noklusējums).| |show\_3d|<|string|Iespējot 3D stilu.<br>Atbalstīts NORMAL un STACKED grafikiem.<br>Iespējamās vērtības:^[1](#footnotes)^ NO (0, noklusējums), YES (1).| |percent\_left|<|double|Parādīt procentiles līniju kreisajai asij.<br>Atbalstīts NORMAL grafikiem.<br>Noklusējums: 0.| |percent\_right|<|double|Parādīt procentiles līniju labajai asij.<br>Atbalstīts NORMAL grafikiem.<br>Noklusējums: 0.| |ymin\_type\_1|<|string|Y ass minimālā vērtība.<br>Atbalstīts NORMAL un STACKED grafikiem.<br>Iespējamās vērtības:^[1](#footnotes)^ CALCULATED (0, noklusējums), FIXED (1), ITEM (2).| |ymin\_item\_1|<| |(obligāts, ja `ymin_type_1` ir iestatīts uz `ITEM`) Saknes elements atsevišķa vienuma detaļām.| |<|host|string|(obligāts) Vienuma hosts.| |^|key|string|(obligāts) Vienuma atslēga.| |ymax\_type\_1|<|string|Y ass maksimālā vērtība.<br>Atbalstīts NORMAL un STACKED grafikiem.<br>Iespējamās vērtības:^[1](#footnotes)^ CALCULATED (0, noklusējums), FIXED (1), ITEM (2).| |ymax\_item\_1|<| |(obligāts, ja `ymax_type_1` ir iestatīts uz `ITEM`) Saknes elements atsevišķa vienuma detaļām.| |<|host|string|(obligāts) Vienuma hosts.| |^|key|string|(obligāts) Vienuma atslēga.| |graph\_items|<| |(obligāts) Saknes elements [hosts grafika vienumiem](#host-graph-items).| ::: noteclassic Skatīt arī: [Graph object](/manual/api/reference/graph/object) (skatiet attiecīgo īpašību ar atbilstošu nosaukumu). ::: # hostgroup.create # hostgroup.create # hostgroup.delete # hostgroup.delete # hostgroup.get # hostgroup.get # hostgroup.massadd # hostgroup.massadd # hostgroup.massremove # hostgroup.massremove # hostgroup.massupdate # hostgroup.massupdate # Host group object The following objects are directly related to the `hostgroup` API. # Hostu grupas objekts Tālāk norādītie objekti ir tieši saistīti ar `hostgroup` API. # hostgroup.propagate # hostgroup.propagate ##### Host groups, Hosts, Item, Item list The *Host groups*, *Hosts*, *Item*, and *Item list* (since Zabbix 7.0.1) parameters allow selecting either the respective entities or a data source containing either host groups, hosts or items for which the widget can display data. For *Host groups*, *Item*, and *Item list* parameters, the data source can be a compatible widget from the same dashboard. For *Hosts* parameter, the data source can be a compatible widget from the same dashboard or the dashboard itself. ::: noteclassic The *Map* widget can also broadcast host group and host data to compatible widgets. For more information, see [Widget behavior](#widget-behavior). ::: ##### Hosts grupas, hosts, Vienums, Vienumu saraksts Parametri *Hosts grupas*, *Hosts*, *Vienums* un *Vienumu saraksts* (kopš Zabbix 7.0.1) ļauj atlasīt vai nu attiecīgos objektus, vai datu avotu, kas satur hosts grupas, hosts vai vienumus, kuru datus sīkrīks var attēlot. Parametriem *Hosts grupas*, *Vienums* un *Vienumu saraksts* datu avots var būt saderīgs sīkrīks no tās pašas informācijas paneļa. Parametram *Hosts* datu avots var būt saderīgs sīkrīks no tās pašas informācijas paneļa vai pats informācijas panelis. ::: noteclassic *Map* sīkrīks var arī pārraidīt hostu grupu un hostu datus uz saderīgiem sīkrīkiem. Plašāku informāciju skatiet [Sīkrīka darbība](#widget-behavior). ::: ### Host groups |Macro|Supported in|Description| |--|--------|--------| |{HOSTGROUP.ID}|→ Map element labels, map URL names and values|*Host group ID.*| ### Hostu grupas |Macro|Supported in|Description| |--|--------|--------| |{HOSTGROUP.ID}|→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības|*Host group ID.*| ### Host group The host group object has the following properties. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |groupid|ID|ID of the host group.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*<br>- *required* for update operations| |name|string|Name of the host group.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |flags|integer|Origin of the host group.<br><br>Possible values:<br>0 - a plain host group;<br>4 - a discovered host group.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |uuid|string|Universal unique identifier, used for linking imported host groups to already existing ones. Auto-generated, if not given.| ### Hostu grupa Hostu grupas objektam ir šādas īpašības. |Īpašība|[Tips](/manual/api/reference_commentary#data-types)|Apraksts| |--|--|------| |groupid|ID|Hostu grupas ID.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *tikai lasāms*<br>- *obligāts* atjaunināšanas operācijām| |name|string|Hostu grupas nosaukums.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāts* izveides operācijām| |flags|integer|Hostu grupas izcelsme.<br><br>Iespējamās vērtības:<br>0 - parasta hostu grupa;<br>4 - atklāta hostu grupa.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *tikai lasāms*| |uuid|string|Universāli unikāls identifikators, ko izmanto, lai sasaistītu importētās hostu grupas ar jau esošajām. Tiek ģenerēts automātiski, ja nav norādīts.| # Host group This class is designed to work with host groups. Object references: - [Host group](/manual/api/reference/hostgroup/object#host-group) Available methods: - [hostgroup.create](/manual/api/reference/hostgroup/create) - create new host groups - [hostgroup.delete](/manual/api/reference/hostgroup/delete) - delete host groups - [hostgroup.get](/manual/api/reference/hostgroup/get) - retrieve host groups - [hostgroup.massadd](/manual/api/reference/hostgroup/massadd) - add related objects to host groups - [hostgroup.massremove](/manual/api/reference/hostgroup/massremove) - remove related objects from host groups - [hostgroup.massupdate](/manual/api/reference/hostgroup/massupdate) - replace or remove related objects from host groups - [hostgroup.propagate](/manual/api/reference/hostgroup/propagate) - propagate permissions and tag filters to host groups' subgroups - [hostgroup.update](/manual/api/reference/hostgroup/update) - update host groups # Hosts grupa Šī klase ir paredzēta darbam ar hosts grupām. Objektu atsauces: - [Hosts grupa](/manual/api/reference/hostgroup/object#host-group) Pieejamās metodes: - [hostgroup.create](/manual/api/reference/hostgroup/create) - izveidot jaunas hosts grupas - [hostgroup.delete](/manual/api/reference/hostgroup/delete) - dzēst hosts grupas - [hostgroup.get](/manual/api/reference/hostgroup/get) - izgūt hosts grupas - [hostgroup.massadd](/manual/api/reference/hostgroup/massadd) - pievienot saistītos objektus hosts grupām - [hostgroup.massremove](/manual/api/reference/hostgroup/massremove) - noņemt saistītos objektus no hosts grupām - [hostgroup.massupdate](/manual/api/reference/hostgroup/massupdate) - aizstāt vai noņemt saistītos objektus no hosts grupām - [hostgroup.propagate](/manual/api/reference/hostgroup/propagate) - izplatīt atļaujas un tagu filtrus uz hosts grupu apakšgrupām - [hostgroup.update](/manual/api/reference/hostgroup/update) - atjaunināt hosts grupas # hostgroup.update # hostgroup.update #### hostgroup [ZBX-23760](https://support.zabbix.com/browse/ZBX-23760) `hostgroup.delete`: It is no longer possible to delete a host group that is used in action condition or operation. In such cases, an error message is returned instead of automatically disabling the action. #### hostgroup [ZBX-23760](https://support.zabbix.com/browse/ZBX-23760) `hostgroup.delete`: vairs nav iespējams dzēst hostu grupu, kas tiek izmantota darbības nosacījumā vai operācijā. Šādos gadījumos tiek atgriezts kļūdas ziņojums, nevis automātiski atspējota darbība. #### hostgroup [ZBXNEXT-2020](https://support.zabbix.com/browse/ZBXNEXT-2020) `hostgroup.get`: Method now also supports `status` property if `selectGroupDiscoveries` parameter is used. #### hostgrupa [ZBXNEXT-2020](https://support.zabbix.com/browse/ZBXNEXT-2020) `hostgroup.get`: Metode tagad arī atbalsta `status` īpašību, ja tiek izmantots parametrs `selectGroupDiscoveries`. #### hostgroup [ZBXNEXT-8702](https://support.zabbix.com/browse/ZBXNEXT-8702) `hostgroup.get`: Renamed parameters `selectHostPrototype` to `selectHostPrototypes`, `selectDiscoveryRule` to `selectDiscoveryRules`, `selectGroupDiscovery` to `selectGroupDiscoveries`; now each parameter will return an array of objects instead of an object.<br> [ZBXNEXT-8702](https://support.zabbix.com/browse/ZBXNEXT-8702) `hostgroup.get`: Renamed output properties `hostPrototype` to `hostPrototypes`, `discoveryRule` to `discoveryRules`, `groupDiscovery` to `groupDiscoveries`.<br> [ZBXNEXT-8702](https://support.zabbix.com/browse/ZBXNEXT-8702) `hostgroup.get`: Removed support for `groupid` property in `selectGroupDiscoveries` (previously - `selectGroupDiscovery`) parameter. #### hosts grupa [ZBXNEXT-8702](https://support.zabbix.com/browse/ZBXNEXT-8702) `hostgroup.get`: Pārdēvēti parametri `selectHostPrototype` uz `selectHostPrototypes`, `selectDiscoveryRule` uz `selectDiscoveryRules`, `selectGroupDiscovery` uz `selectGroupDiscoveries`; tagad katrs parametrs atgriezīs objektu masīvu, nevis objektu.<br> [ZBXNEXT-8702](https://support.zabbix.com/browse/ZBXNEXT-8702) `hostgroup.get`: Pārdēvētas izvades īpašības `hostPrototype` uz `hostPrototypes`, `discoveryRule` uz `discoveryRules`, `groupDiscovery` uz `groupDiscoveries`.<br> [ZBXNEXT-8702](https://support.zabbix.com/browse/ZBXNEXT-8702) `hostgroup.get`: Noņemts atbalsts `groupid` īpašībai parametrā `selectGroupDiscoveries` (iepriekš - `selectGroupDiscovery`). ##### HostInterface An optional parameter that defines the host interface (IP address or DNS name) used during the host [autoregistration](/manual/discovery/auto_registration) process. This value will be used to populate the interface in the newly created host, and allows configuring either IP or DNS address explicitly. For more details, see [Using DNS as default interface](/manual/discovery/auto_registration#using-dns-as-default-interface). If not defined, the value will be acquired from `HostInterfaceItem`. The agent will issue an error and not start if the value is over the limit of 255 characters. Range: 0-255 characters ##### HostInterface Neobligāts parametrs, kas nosaka host interfeisu (IP adresi vai DNS nosaukumu), ko izmanto host [autoregistrācijas](/manual/discovery/auto_registration) procesā. Šī vērtība tiks izmantota, lai aizpildītu interfeisu jaunizveidotajā host, un ļauj skaidri konfigurēt vai nu IP, vai DNS adresi. Plašāku informāciju skatiet sadaļā [Using DNS as default interface](/manual/discovery/auto_registration#using-dns-as-default-interface). Ja nav definēts, vērtība tiks iegūta no `HostInterfaceItem`. aģents izvadīs kļūdu un netiks palaists, ja vērtība pārsniedz 255 rakstzīmju limitu. Diapazons: 0-255 rakstzīmes ##### HostInterface An optional parameter that defines the host interface (IP address or DNS name) used during the host [autoregistration](/manual/discovery/auto_registration) process. This value will be used to populate the interface in the newly created host, and allows configuring either IP or DNS address explicitly. For more details, see [Using DNS as default interface](/manual/discovery/auto_registration#using-dns-as-default-interface). If not defined, the value will be acquired from `HostInterfaceItem`. The agent will issue an error and not start if the value is over the limit of 255 characters. Range: 0-255 characters ##### HostInterface Neobligāts parametrs, kas nosaka hosta saskarni (IP adresi vai DNS nosaukumu), ko izmanto hosta [autoregistrācijas](/manual/discovery/auto_registration) procesa laikā. Šī vērtība tiks izmantota, lai aizpildītu saskarni jaunizveidotajā hostā, un ļauj skaidri konfigurēt vai nu IP, vai DNS adresi. Plašāku informāciju skatiet sadaļā [Using DNS as default interface](/manual/discovery/auto_registration#using-dns-as-default-interface). Ja nav definēts, vērtība tiks iegūta no `HostInterfaceItem`. Aģents izvadīs kļūdu un netiks palaists, ja vērtība pārsniegs 255 rakstzīmju ierobežojumu. Diapazons: 0-255 rakstzīmes ##### HostInterface An optional parameter that defines the host interface (IP address or DNS name) used during the host [autoregistration](/manual/discovery/auto_registration) process. This value will be used to populate the interface in the newly created host, and allows configuring either IP or DNS address explicitly. For more details, see [Using DNS as default interface](/manual/discovery/auto_registration#using-dns-as-default-interface). If not defined, the value will be acquired from HostInterfaceItem. The agent will issue an error and not start if the value is over the limit of 255 characters. Range: 0-255 characters ##### HostInterface Neobligāts parametrs, kas nosaka host interfeisu (IP adresi vai DNS nosaukumu), ko izmanto host [automātiskās reģistrācijas](/manual/discovery/auto_registration) procesa laikā. Šī vērtība tiks izmantota, lai aizpildītu interfeisu jaunizveidotajā host, un ļauj skaidri konfigurēt IP vai DNS adresi. Plašāku informāciju skatiet sadaļā [DNS izmantošana kā noklusējuma interfeiss](/manual/discovery/auto_registration#using-dns-as-default-interface). Ja nav norādīts, vērtība tiks iegūta no HostInterfaceItem. aģents izsniegs kļūdu un netiks palaists, ja vērtība pārsniedz 255 rakstzīmju limitu. Diapazons: 0-255 rakstzīmes ##### HostInterface An optional parameter that defines the host interface (IP address or DNS name) used during the host [autoregistration](/manual/discovery/auto_registration) process. This value will be used to populate the interface in the newly created host, and allows configuring either IP or DNS address explicitly. For more details, see [Using DNS as default interface](/manual/discovery/auto_registration#using-dns-as-default-interface). If not defined, the value will be acquired from HostInterfaceItem. The agent will issue an error and not start if the value is over the limit of 255 characters. Range: 0-255 characters ##### HostInterface Neobligāts parametrs, kas nosaka hosta saskarni (IP adresi vai DNS nosaukumu), ko izmanto hosta [automātiskās reģistrācijas](/manual/discovery/auto_registration) procesā. Šī vērtība tiks izmantota, lai aizpildītu saskarni jaunizveidotajā hostā, un ļauj skaidri konfigurēt vai nu IP, vai DNS adresi. Plašāku informāciju skatiet sadaļā [DNS izmantošana kā noklusējuma saskarne](/manual/discovery/auto_registration#using-dns-as-default-interface). Ja nav definēts, vērtība tiks iegūta no HostInterfaceItem. aģents izsniegs kļūdu un netiks palaists, ja vērtība pārsniedz 255 rakstzīmju ierobežojumu. Diapazons: 0-255 rakstzīmes # hostinterface.create # hostinterface.create # hostinterface.delete # hostinterface.delete # hostinterface.get # hostinterface.get ##### HostInterfaceItem An optional parameter that defines an item used to determine the host interface (IP address or DNS name) during the host [autoregistration](/manual/discovery/auto_registration) process. This value is used only if `HostInterface` is not defined. For more details, see [Using DNS as default interface](/manual/discovery/auto_registration#using-dns-as-default-interface). During an autoregistration request the agent will log a warning message if the value returned by the specified item is over the limit of 255 characters. The [`system.run[]`](/manual/config/items/itemtypes/zabbix_agent#system.run) item is supported regardless of `AllowKey`/`DenyKey` settings. ##### HostInterfaceItem Neobligāts parametrs, kas nosaka vienumu, ko izmanto, lai noteiktu hosta saskarni (IP adresi vai DNS nosaukumu) hosta [automātiskās reģistrācijas](/manual/discovery/auto_registration) procesa laikā. Šī vērtība tiek izmantota tikai tad, ja `HostInterface` nav definēts. Plašāku informāciju skatiet sadaļā [DNS izmantošana kā noklusējuma saskarne](/manual/discovery/auto_registration#using-dns-as-default-interface). Automātiskās reģistrācijas pieprasījuma laikā aģents reģistrēs brīdinājuma ziņojumu, ja norādītā vienuma atgrieztā vērtība pārsniedz 255 rakstzīmju limitu. [`system.run[]`](/manual/config/items/itemtypes/zabbix_agent#system.run) vienums tiek atbalstīts neatkarīgi no `AllowKey`/`DenyKey` iestatījumiem. ##### HostInterfaceItem An optional parameter that defines an item used to determine the host interface (IP address or DNS name) during the host [autoregistration](/manual/discovery/auto_registration) process. This value is used only if `HostInterface` is not defined. For more details, see [Using DNS as default interface](/manual/discovery/auto_registration#using-dns-as-default-interface). During an autoregistration request the agent will log a warning message if the value returned by the specified item is over the limit of 255 characters. The [`system.run[]`](/manual/config/items/itemtypes/zabbix_agent#system.run) item is supported regardless of `AllowKey`/`DenyKey` settings. ##### HostInterfaceItem Neobligāts parametrs, kas nosaka vienumu, ko izmanto, lai noteiktu hosta saskarni (IP adresi vai DNS nosaukumu) hosta [automātiskās reģistrācijas](/manual/discovery/auto_registration) procesa laikā. Šī vērtība tiek izmantota tikai tad, ja `HostInterface` nav definēts. Plašāku informāciju skatiet sadaļā [DNS izmantošana kā noklusējuma saskarne](/manual/discovery/auto_registration#using-dns-as-default-interface). Automātiskās reģistrācijas pieprasījuma laikā aģents reģistrēs brīdinājuma ziņojumu, ja norādītā vienuma atgrieztā vērtība pārsniedz 255 rakstzīmju limitu. [`system.run[]`](/manual/config/items/itemtypes/zabbix_agent#system.run) vienums tiek atbalstīts neatkarīgi no `AllowKey`/`DenyKey` iestatījumiem. ##### HostInterfaceItem An optional parameter that defines an item used to determine the host interface (IP address or DNS name) during the host [autoregistration](/manual/discovery/auto_registration) process. This value is used only if `HostInterface` is not defined. For more details, see [Using DNS as default interface](/manual/discovery/auto_registration#using-dns-as-default-interface). During an autoregistration request the agent will log a warning message if the value returned by the specified item is over the limit of 255 characters. The [system.run[]](/manual/config/items/itemtypes/zabbix_agent#system.run) item is supported regardless of `AllowKey`/`DenyKey` settings. ##### HostInterfaceItem Neobligāts parametrs, kas nosaka vienumu, ko izmanto, lai hosta [automātiskās reģistrācijas](/manual/discovery/auto_registration) procesa laikā noteiktu hosta saskarni (IP adresi vai DNS nosaukumu). Šī vērtība tiek izmantota tikai tad, ja `HostInterface` nav definēts. Papildinformāciju skatiet sadaļā [DNS izmantošana kā noklusējuma saskarne](/manual/discovery/auto_registration#using-dns-as-default-interface). Automātiskās reģistrācijas pieprasījuma laikā aģents reģistrēs brīdinājuma ziņojumu, ja norādītā vienuma atgrieztā vērtība pārsniedz 255 rakstzīmju limitu. Vienums [system.run[]](/manual/config/items/itemtypes/zabbix_agent#system.run) tiek atbalstīts neatkarīgi no `AllowKey`/`DenyKey` iestatījumiem. ##### HostInterfaceItem An optional parameter that defines an item used to determine the host interface (IP address or DNS name) during the host [autoregistration](/manual/discovery/auto_registration) process. This value is used only if `HostInterface` is not defined. For more details, see [Using DNS as default interface](/manual/discovery/auto_registration#using-dns-as-default-interface). During an autoregistration request the agent will log a warning message if the value returned by the specified item is over the limit of 255 characters. The [system.run[]](/manual/config/items/itemtypes/zabbix_agent#system.run) item is supported regardless of `AllowKey`/`DenyKey` settings. ##### HostInterfaceItem Neobligāts parametrs, kas nosaka vienumu, ko izmanto, lai noteiktu hosta saskarni (IP adresi vai DNS nosaukumu) hosta [automātiskās reģistrācijas](/manual/discovery/auto_registration) procesa laikā. Šī vērtība tiek izmantota tikai tad, ja `HostInterface` nav definēts. Plašāku informāciju skatiet sadaļā [DNS izmantošana kā noklusējuma saskarne](/manual/discovery/auto_registration#using-dns-as-default-interface). Automātiskās reģistrācijas pieprasījuma laikā aģents reģistrēs brīdinājuma ziņojumu, ja norādītā vienuma atgrieztā vērtība pārsniedz 255 rakstzīmju limitu. Vienums [system.run[]](/manual/config/items/itemtypes/zabbix_agent#system.run) tiek atbalstīts neatkarīgi no `AllowKey`/`DenyKey` iestatījumiem. # hostinterface.massadd # hostinterface.massadd # hostinterface.massremove # hostinterface.massremove # Host interface object The following objects are directly related to the `hostinterface` API. # Hosta saskarnes objekts Tālāk norādītie objekti ir tieši saistīti ar `hostinterface` API. # hostinterface.replacehostinterfaces # hostinterface.replacehostinterfaces #### Host interfaces |Element|<|Type|Description| |-|---|---|-----------------------| |default|<|string|Whether this is the primary host interface. Note that there can be only one primary interface of one type on a host.<br>Possible values:^[1](#footnotes)^ NO (0), YES (1, default).| |type|<|string|Interface type.<br>Possible values:^[1](#footnotes)^ ZABBIX (1, default), SNMP (2), IPMI (3), JMX (4).| |useip|<|string|Whether to use IP as the interface for connecting to the host (otherwise, DNS will be used).<br>Possible values:^[1](#footnotes)^ NO (0), YES (1, default).| |ip|<|string|(required for IP connections) IP address (IPv4 or IPv6).| |dns|<|string|(required for DNS connections) DNS name.| |port|<|string|Port number.| |details|<| |Root element for interface details.| |<|version|string|Use this SNMP version.<br>Possible values:^[1](#footnotes)^ SNMPV1 (1), SNMP\_V2C (2, default), SNMP\_V3 (3).| |^|community|string|(required for SNMPv1 and SNMPv2 items) SNMP community.| |^|max_repetitions|string|Max repetition value for native SNMP bulk requests (GetBulkRequest-PDUs).<br>Supported for SNMPv2 and SNMPv3 items (`discovery[]` and `walk[]` items).<br>Default: 10.| |^|contextname|string|SNMPv3 context name.<br>Supported for SNMPv3 items.| |^|securityname|string|SNMPv3 security name.<br>Supported for SNMPv3 items.| |^|securitylevel|string|SNMPv3 security level.<br>Supported for SNMPv3 items.<br>Possible values:^[1](#footnotes)^ NOAUTHNOPRIV (0, default), AUTHNOPRIV (1), AUTHPRIV (2).| |^|authprotocol|string|SNMPv3 authentication protocol.<br>Supported for SNMPv3 items.<br>Possible values:^[1](#footnotes)^ MD5 (0, default), SHA1 (1), SHA224 (2), SHA256 (3), SHA384 (4), SHA512 (5).| |^|authpassphrase|string|SNMPv3 authentication passphrase.<br>Supported for SNMPv3 items.| |^|privprotocol|string|SNMPv3 privacy protocol.<br>Supported for SNMPv3 items.<br>Possible values:^[1](#footnotes)^ DES (0, default), AES128 (1), AES192 (2), AES256 (3), AES192C (4), AES256C (5).| |^|privpassphrase|string|SNMPv3 privacy passphrase.<br>Supported for SNMPv3 items.| |^|bulk|string|Use bulk requests for SNMP.<br>Possible values:^[1](#footnotes)^ NO (0), YES (1, default).| |interface\_ref|<|string|Interface reference name to be used in items (format: `if<N>`).| ::: noteclassic See also: [Host interface object](/manual/api/reference/hostinterface/object) (refer to the relevant property with a matching name). ::: #### Hosts saskarnes |Element|<|Type|Apraksts| |-|---|---|-----------------------| |default|<|string|Vai šī ir primārā hosts saskarne. Ņemiet vērā, ka vienam hosts var būt tikai viena primārā saskarne viena tipa ietvaros.<br>Iespējamās vērtības:^[1](#footnotes)^ NĒ (0), JĀ (1, noklusējums).| |type|<|string|Saskarnes tips.<br>Iespējamās vērtības:^[1](#footnotes)^ ZABBIX (1, noklusējums), SNMP (2), IPMI (3), JMX (4).| |useip|<|string|Vai IP jāizmanto kā saskarne savienojumam ar hosts (pretējā gadījumā tiks izmantots DNS).<br>Iespējamās vērtības:^[1](#footnotes)^ NĒ (0), JĀ (1, noklusējums).| |ip|<|string|(obligāts IP savienojumiem) IP adrese (IPv4 vai IPv6).| |dns|<|string|(obligāts DNS savienojumiem) DNS nosaukums.| |port|<|string|Porta numurs.| |details|<| |Saknes elements saskarnes detaļām.| |<|version|string|Izmantot šo SNMP versiju.<br>Iespējamās vērtības:^[1](#footnotes)^ SNMPV1 (1), SNMP\_V2C (2, noklusējums), SNMP\_V3 (3).| |^|community|string|(obligāts SNMPv1 un SNMPv2 vienumiem) SNMP kopiena.| |^|max_repetitions|string|Maksimālā atkārtojumu vērtība SNMP masveida pieprasījumiem (GetBulkRequest-PDU).<br>Atbalstīts SNMPv2 un SNMPv3 vienumiem (`discovery[]` un `walk[]` vienumi).<br>Noklusējums: 10.| |^|contextname|string|SNMPv3 konteksta nosaukums.<br>Atbalstīts SNMPv3 vienumiem.| |^|securityname|string|SNMPv3 drošības nosaukums.<br>Atbalstīts SNMPv3 vienumiem.| |^|securitylevel|string|SNMPv3 drošības līmenis.<br>Atbalstīts SNMPv3 vienumiem.<br>Iespējamās vērtības:^[1](#footnotes)^ NOAUTHNOPRIV (0, noklusējums), AUTHNOPRIV (1), AUTHPRIV (2).| |^|authprotocol|string|SNMPv3 autentifikācijas protokols.<br>Atbalstīts SNMPv3 vienumiem.<br>Iespējamās vērtības:^[1](#footnotes)^ MD5 (0, noklusējums), SHA1 (1), SHA224 (2), SHA256 (3), SHA384 (4), SHA512 (5).| |^|authpassphrase|string|SNMPv3 autentifikācijas parole.<br>Atbalstīts SNMPv3 vienumiem.| |^|privprotocol|string|SNMPv3 privātuma protokols.<br>Atbalstīts SNMPv3 vienumiem.<br>Iespējamās vērtības:^[1](#footnotes)^ DES (0, noklusējums), AES128 (1), AES192 (2), AES256 (3), AES192C (4), AES256C (5).| |^|privpassphrase|string|SNMPv3 privātuma parole.<br>Atbalstīts SNMPv3 vienumiem.| |^|bulk|string|Izmantot SNMP masveida pieprasījumus.<br>Iespējamās vērtības:^[1](#footnotes)^ NĒ (0), JĀ (1, noklusējums).| |interface\_ref|<|string|Saskarnes atsauces nosaukums, ko izmantot vienumos (formāts: `if<N>`).| ::: noteclassic Skatīt arī: [Host interface object](/manual/api/reference/hostinterface/object) (skatiet attiecīgo īpašību ar atbilstošu nosaukumu). ::: ##### Host interfaces To add custom interfaces, switch the *Interfaces* selector from "Inherit" to "Custom". Click  and select the interface type - Zabbix agent, SNMP, JMX, IPMI. ::: noteclassic If *Custom* is selected, but no interfaces have been set, the hosts will be created without interfaces.<br> If *Inherit* is selected and the host prototype belongs to a template, all discovered hosts will inherit the host interface from the host to which the template is linked. ::: If multiple custom interfaces are specified, the primary interface can be set in the *Default* column. For an example of how to configure a custom host interface, see [*VMware monitoring setup example*](/manual/vm_monitoring/example#advanced-host-interface-configuration). ::: notewarning A host will only be created if a host interface contains correct data. ::: ##### Hostu saskarnes Lai pievienotu pielāgotas saskarnes, pārslēdziet *Interfaces* atlasītāju no "Inherit" uz "Custom". Noklikšķiniet uz  un atlasiet saskarnes tipu — Zabbix aģents, SNMP, JMX, IPMI. ::: noteclassic Ja ir atlasīts *Custom*, bet nav iestatīta neviena saskarne, hosti tiks izveidoti bez saskarnēm.<br> Ja ir atlasīts *Inherit* un hosta prototips pieder veidnei, visi atklātie hosti mantos hosta saskarni no hosta, ar kuru veidne ir saistīta. ::: Ja ir norādītas vairākas pielāgotas saskarnes, primāro saskarni var iestatīt kolonnā *Default*. Piemēru, kā konfigurēt pielāgotu hosta saskarni, skatiet [*VMware monitoringa iestatīšanas piemērā*](/manual/vm_monitoring/example#advanced-host-interface-configuration). ::: notewarning Hosts tiks izveidots tikai tad, ja hosta saskarne saturēs pareizus datus. ::: ### Host interface The host interface object has the following properties. ::: noteimportant Note that both `ip` and `dns` properties are *required* for create operations. If you do not want to use DNS, set it to an empty string. ::: |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |interfaceid|ID|ID of the interface.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*<br>- *required* for update operations| |available|integer|Availability of host interface.<br><br>Possible values:<br>0 - *(default)* unknown;<br>1 - available;<br>2 - unavailable.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |hostid|ID|ID of the host that the interface belongs to.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *constant*<br>- *required* for create operations| |type|integer|Interface type.<br><br>Possible values:<br>1 - Agent;<br>2 - SNMP;<br>3 - IPMI;<br>4 - JMX.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |ip|string|IP address used by the interface.<br><br>Can be empty if the connection is made via DNS.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |dns|string|DNS name used by the interface.<br><br>Can be empty if the connection is made via IP.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |port|string|Port number used by the interface.<br>Can contain user macros.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |useip|integer|Whether the connection should be made via IP.<br><br>Possible values:<br>0 - connect using host DNS name;<br>1 - connect using host IP address.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |main|integer|Whether the interface is used as default on the host. Only one interface of some type can be set as default on a host.<br><br>Possible values:<br>0 - not default;<br>1 - default.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |details|object|Additional [details](#details) object for interface.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "SNMP"| |disable\_until|timestamp|The next polling time of an unavailable host interface.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |error|string|Error text if host interface is unavailable.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |errors\_from|timestamp|Time when host interface became unavailable.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| ### Hosta saskarne Hosta saskarnes objektam ir šādas īpašības. ::: noteimportant Ņemiet vērā, ka gan `ip`, gan `dns` īpašības ir *obligātas* izveides darbībām. Ja nevēlaties izmantot DNS, iestatiet to kā tukšu virkni. ::: |Īpašība|[Type](/manual/api/reference_commentary#data-types)|Apraksts| |--|--|------| |interfaceid|ID|Saskarnes ID.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *tikai lasāms*<br>- *obligāts* atjaunināšanas darbībām| |available|integer|Hosta saskarnes pieejamība.<br><br>Iespējamās vērtības:<br>0 - *(noklusējums)* nezināma;<br>1 - pieejama;<br>2 - nepieejama.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *tikai lasāms*| |hostid|ID|Hosta, kuram pieder saskarne, ID.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *konstants*<br>- *obligāts* izveides darbībām| |type|integer|Saskarnes tips.<br><br>Iespējamās vērtības:<br>1 - Aģents;<br>2 - SNMP;<br>3 - IPMI;<br>4 - JMX.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāts* izveides darbībām| |ip|string|Saskarnes izmantotā IP adrese.<br><br>Var būt tukša, ja savienojums tiek veidots, izmantojot DNS.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāts* izveides darbībām| |dns|string|Saskarnes izmantotais DNS nosaukums.<br><br>Var būt tukšs, ja savienojums tiek veidots, izmantojot IP.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāts* izveides darbībām| |port|string|Saskarnes izmantotais porta numurs.<br>Var saturēt lietotāja makrosus.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāts* izveides darbībām| |useip|integer|Vai savienojums jāveido, izmantojot IP.<br><br>Iespējamās vērtības:<br>0 - savienoties, izmantojot hosta DNS nosaukumu;<br>1 - savienoties, izmantojot hosta IP adresi.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāts* izveides darbībām| |main|integer|Vai saskarne tiek izmantota kā noklusējuma saskarne hostā. Tikai viena noteikta tipa saskarne hostā var būt iestatīta kā noklusējuma saskarne.<br><br>Iespējamās vērtības:<br>0 - nav noklusējuma;<br>1 - noklusējuma.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāts* izveides darbībām| |details|object|Papildu saskarnes [details](#details) objekts.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāts*, ja `type` ir iestatīts uz "SNMP"| |disable\_until|timestamp|Nākamais nepieejama hosta saskarnes aptaujas laiks.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *tikai lasāms*| |error|string|Kļūdas teksts, ja hosta saskarne nav pieejama.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *tikai lasāms*| |errors\_from|timestamp|Laiks, kad hosta saskarne kļuva nepieejama.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *tikai lasāms*| # Host interface This class is designed to work with host interfaces. Object references: - [Host interface](/manual/api/reference/hostinterface/object#host-interface) - [Details](/manual/api/reference/hostinterface/object#details) Available methods: - [hostinterface.create](/manual/api/reference/hostinterface/create) - create new host interfaces - [hostinterface.delete](/manual/api/reference/hostinterface/delete) - delete host interfaces - [hostinterface.get](/manual/api/reference/hostinterface/get) - retrieve host interfaces - [hostinterface.massadd](/manual/api/reference/hostinterface/massadd) - add host interfaces to hosts - [hostinterface.massremove](/manual/api/reference/hostinterface/massremove) - remove host interfaces from hosts - [hostinterface.replacehostinterfaces](/manual/api/reference/hostinterface/replacehostinterfaces) - replace host interfaces on a host - [hostinterface.update](/manual/api/reference/hostinterface/update) - update host interfaces # Hosts interfeiss Šī klase ir paredzēta darbam ar hosts interfeisiem. Objektu atsauces: - [Hosts interfeiss](/manual/api/reference/hostinterface/object#host-interface) - [Detaļas](/manual/api/reference/hostinterface/object#details) Pieejamās metodes: - [hostinterface.create](/manual/api/reference/hostinterface/create) - izveidot jaunus hosts interfeisus - [hostinterface.delete](/manual/api/reference/hostinterface/delete) - dzēst hosts interfeisus - [hostinterface.get](/manual/api/reference/hostinterface/get) - izgūt hosts interfeisus - [hostinterface.massadd](/manual/api/reference/hostinterface/massadd) - pievienot hosts interfeisus hosts - [hostinterface.massremove](/manual/api/reference/hostinterface/massremove) - noņemt hosts interfeisus no hosts - [hostinterface.replacehostinterfaces](/manual/api/reference/hostinterface/replacehostinterfaces) - aizstāt hosts interfeisus uz hosta - [hostinterface.update](/manual/api/reference/hostinterface/update) - atjaunināt hosts interfeisus # hostinterface.update # hostinterface.update ### Host inventory |Macro|Supported in|Description| |--|--------|--------| |{INVENTORY.ALIAS}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Alias field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.ALIAS[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.ASSET.TAG}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Asset tag field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.ASSET.TAG[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.CHASSIS}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Chassis field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.CHASSIS[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.CONTACT}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Contact field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.CONTACT[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).<br><br>`{PROFILE.CONTACT<1-9>}` is deprecated and may not resolve in supported locations.| |{INVENTORY.CONTRACT.NUMBER}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Contract number field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.CONTRACT.NUMBER[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.DEPLOYMENT.STATUS}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Deployment status field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.DEPLOYMENT.STATUS[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.HARDWARE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Hardware field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.HARDWARE[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).<br><br>`{PROFILE.HARDWARE<1-9>}` is deprecated and may not resolve in supported locations.| |{INVENTORY.HARDWARE.FULL}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Hardware (Full details) field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.HARDWARE.FULL[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.HOST.NETMASK}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Host subnet mask field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.HOST.NETMASK[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.HOST.NETWORKS}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Host networks field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.HOST.NETWORKS[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.HOST.ROUTER}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Host router field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.HOST.ROUTER[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.HW.ARCH}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Hardware architecture field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.HW.ARCH[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.HW.DATE.DECOMM}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Date hardware decommissioned field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.HW.DATE.DECOMM[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.HW.DATE.EXPIRY}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Date hardware maintenance expires field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.HW.DATE.EXPIRY[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.HW.DATE.INSTALL}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Date hardware installed field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.HW.DATE.INSTALL[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.HW.DATE.PURCHASE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Date hardware purchased field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.HW.DATE.PURCHASE[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.INSTALLER.NAME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Installer name field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.INSTALLER.NAME[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.LOCATION}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Location field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.LOCATION[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).<br><br>`{PROFILE.LOCATION<1-9>}` is deprecated and may not resolve in supported locations.| |{INVENTORY.LOCATION.LAT}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Location latitude field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.LOCATION.LAT[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.LOCATION.LON}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Location longitude field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.LOCATION.LON[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.MACADDRESS.A}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*MAC address A field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.MACADDRESS.A[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).<br><br>`{PROFILE.MACADDRESS<1-9>}` is deprecated and may not resolve in supported locations.| |{INVENTORY.MACADDRESS.B}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*MAC address B field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.MACADDRESS.B[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.MODEL}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Model field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.MODEL[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.NAME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Name field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.NAME[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).<br><br>`{PROFILE.NAME<1-9>}` is deprecated and may not resolve in supported locations.| |{INVENTORY.NOTES}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Notes field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.NOTES[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).<br><br>`{PROFILE.NOTES<1-9>}` is deprecated and may not resolve in supported locations.| |{INVENTORY.OOB.IP}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*OOB IP address field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.OOB.IP[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.OOB.NETMASK}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*OOB subnet mask field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.OOB.NETMASK[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.OOB.ROUTER}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*OOB router field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.OOB.ROUTER[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.OS}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*OS field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.OS[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).<br><br>`{PROFILE.OS<1-9>}` is deprecated and may not resolve in supported locations.| |{INVENTORY.OS.FULL}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*OS (Full details) field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.OS.FULL[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.OS.SHORT}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*OS (Short) field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.OS.SHORT[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.POC.PRIMARY.CELL}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Primary POC cell field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.POC.PRIMARY.CELL[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.POC.PRIMARY.EMAIL}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Primary POC email field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.POC.PRIMARY.EMAIL[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.POC.PRIMARY.NAME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Primary POC name field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.POC.PRIMARY.NAME[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.POC.PRIMARY.NOTES}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Primary POC notes field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.POC.PRIMARY.NOTES[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.POC.PRIMARY.PHONE.A}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Primary POC phone A field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.POC.PRIMARY.PHONE.A[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.POC.PRIMARY.PHONE.B}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Primary POC phone B field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.POC.PRIMARY.PHONE.B[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.POC.PRIMARY.SCREEN}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Primary POC screen name field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.POC.PRIMARY.SCREEN[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.POC.SECONDARY.CELL}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Secondary POC cell field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.POC.SECONDARY.CELL[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.POC.SECONDARY.EMAIL}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Secondary POC email field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.POC.SECONDARY.EMAIL[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.POC.SECONDARY.NAME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Secondary POC name field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.POC.SECONDARY.NAME[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.POC.SECONDARY.NOTES}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Secondary POC notes field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.POC.SECONDARY.NOTES[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.POC.SECONDARY.PHONE.A}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Secondary POC phone A field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.POC.SECONDARY.PHONE.A[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.POC.SECONDARY.PHONE.B}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Secondary POC phone B field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.POC.SECONDARY.PHONE.B[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.POC.SECONDARY.SCREEN}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Secondary POC screen name field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.POC.SECONDARY.SCREEN[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.SERIALNO.A}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Serial number A field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SERIALNO.A[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).<br><br>`{PROFILE.SERIALNO<1-9>}` is deprecated and may not resolve in supported locations.| |{INVENTORY.SERIALNO.B}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Serial number B field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SERIALNO.B[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.SITE.ADDRESS.A}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Site address A field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SITE.ADDRESS.A[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.SITE.ADDRESS.B}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Site address B field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SITE.ADDRESS.B[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.SITE.ADDRESS.C}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Site address C field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SITE.ADDRESS.C[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.SITE.CITY}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Site city field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SITE.CITY[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.SITE.COUNTRY}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Site country field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SITE.COUNTRY[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.SITE.NOTES}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Site notes field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SITE.NOTES[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.SITE.RACK}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Site rack location field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SITE.RACK[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.SITE.STATE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Site state/province field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SITE.STATE[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.SITE.ZIP}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Site ZIP/postal field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SITE.ZIP[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.SOFTWARE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Software field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SOFTWARE[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).<br><br>`{PROFILE.SOFTWARE<1-9>}` is deprecated and may not resolve in supported locations.| |{INVENTORY.SOFTWARE.APP.A}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Software application A field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SOFTWARE.APP.A[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.SOFTWARE.APP.B}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Software application B field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SOFTWARE.APP.B[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.SOFTWARE.APP.C}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Software application C field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SOFTWARE.APP.C[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.SOFTWARE.APP.D}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Software application D field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SOFTWARE.APP.D[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.SOFTWARE.APP.E}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Software application E field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SOFTWARE.APP.E[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.SOFTWARE.FULL}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Software (Full details) field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SOFTWARE.FULL[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.TAG}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Tag field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.TAG[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).<br><br>`{PROFILE.TAG<1-9>}` is deprecated and may not resolve in supported locations.| |{INVENTORY.TYPE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Type field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.TYPE[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).<br><br>`{PROFILE.DEVICETYPE<1-9>}` is deprecated and may not resolve in supported locations.| |{INVENTORY.TYPE.FULL}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Type (Full details) field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.TYPE.FULL[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.URL.A}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*URL A field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.URL.A[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.URL.B}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*URL B field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.URL.B[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.URL.C}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*URL C field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.URL.C[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{INVENTORY.VENDOR}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Map element labels, map URL names and values<br>→ Script-type items and Browser-type items^[6](supported_by_location#footnotes)^<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text^[6](supported_by_location#footnotes)^<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Vendor field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.VENDOR[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| ### Hosts inventārijs |Macro|Supported in|Description| |--|--------|--------| |{INVENTORY.ALIAS}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Alias lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.ALIAS[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.ASSET.TAG}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Asset tag lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.ASSET.TAG[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.CHASSIS}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Chassis lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.CHASSIS[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.CONTACT}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Contact lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.CONTACT[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).<br><br>`{PROFILE.CONTACT<1-9>}` ir novecojis un atbalstītajās vietās var netikt atrisināts.| |{INVENTORY.CONTRACT.NUMBER}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Contract number lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.CONTRACT.NUMBER[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.DEPLOYMENT.STATUS}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Deployment status lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.DEPLOYMENT.STATUS[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.HARDWARE}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Hardware lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.HARDWARE[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).<br><br>`{PROFILE.HARDWARE<1-9>}` ir novecojis un atbalstītajās vietās var netikt atrisināts.| |{INVENTORY.HARDWARE.FULL}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Hardware (Full details) lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.HARDWARE.FULL[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.HOST.NETMASK}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Hosta apakštīkla maskas lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.HOST.NETMASK[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.HOST.NETWORKS}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Hosta tīklu lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.HOST.NETWORKS[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.HOST.ROUTER}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Hosta maršrutētāja lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.HOST.ROUTER[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.HW.ARCH}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Hosta aparatūras arhitektūras lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.HW.ARCH[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.HW.DATE.DECOMM}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Datums, kad hosta aparatūra tika norakstīta, lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.HW.DATE.DECOMM[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.HW.DATE.EXPIRY}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Datums, kad beidzas hosta aparatūras uzturēšanas termiņš, lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.HW.DATE.EXPIRY[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.HW.DATE.INSTALL}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Datums, kad hosta aparatūra tika uzstādīta, lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.HW.DATE.INSTALL[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.HW.DATE.PURCHASE}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Datums, kad hosta aparatūra tika iegādāta, lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.HW.DATE.PURCHASE[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.INSTALLER.NAME}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Instalētāja vārda lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.INSTALLER.NAME[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.LOCATION}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Location lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.LOCATION[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).<br><br>`{PROFILE.LOCATION<1-9>}` ir novecojis un atbalstītajās vietās var netikt atrisināts.| |{INVENTORY.LOCATION.LAT}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Location latitude lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.LOCATION.LAT[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.LOCATION.LON}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Location longitude lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.LOCATION.LON[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.MACADDRESS.A}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*MAC address A lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.MACADDRESS.A[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).<br><br>`{PROFILE.MACADDRESS<1-9>}` ir novecojis un atbalstītajās vietās var netikt atrisināts.| |{INVENTORY.MACADDRESS.B}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*MAC address B lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.MACADDRESS.B[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.MODEL}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Model lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.MODEL[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.NAME}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Name lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.NAME[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).<br><br>`{PROFILE.NAME<1-9>}` ir novecojis un atbalstītajās vietās var netikt atrisināts.| |{INVENTORY.NOTES}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Notes lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.NOTES[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).<br><br>`{PROFILE.NOTES<1-9>}` ir novecojis un atbalstītajās vietās var netikt atrisināts.| |{INVENTORY.OOB.IP}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*OOB IP address lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.OOB.IP[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.OOB.NETMASK}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*OOB subnet mask lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.OOB.NETMASK[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.OOB.ROUTER}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*OOB router lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.OOB.ROUTER[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.OS}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*OS lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.OS[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).<br><br>`{PROFILE.OS<1-9>}` ir novecojis un atbalstītajās vietās var netikt atrisināts.| |{INVENTORY.OS.FULL}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*OS (Full details) lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.OS.FULL[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.OS.SHORT}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*OS (Short) lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.OS.SHORT[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.POC.PRIMARY.CELL}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Primary POC cell lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.POC.PRIMARY.CELL[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.POC.PRIMARY.EMAIL}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Primary POC email lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.POC.PRIMARY.EMAIL[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.POC.PRIMARY.NAME}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Primary POC name lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.POC.PRIMARY.NAME[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.POC.PRIMARY.NOTES}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Primary POC notes lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.POC.PRIMARY.NOTES[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.POC.PRIMARY.PHONE.A}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Primary POC phone A lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.POC.PRIMARY.PHONE.A[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.POC.PRIMARY.PHONE.B}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Primary POC phone B lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.POC.PRIMARY.PHONE.B[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.POC.PRIMARY.SCREEN}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Primary POC screen name lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.POC.PRIMARY.SCREEN[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.POC.SECONDARY.CELL}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Secondary POC cell lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.POC.SECONDARY.CELL[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.POC.SECONDARY.EMAIL}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Secondary POC email lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.POC.SECONDARY.EMAIL[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.POC.SECONDARY.NAME}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Secondary POC name lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.POC.SECONDARY.NAME[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.POC.SECONDARY.NOTES}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Secondary POC notes lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.POC.SECONDARY.NOTES[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.POC.SECONDARY.PHONE.A}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Secondary POC phone A lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.POC.SECONDARY.PHONE.A[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.POC.SECONDARY.PHONE.B}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Secondary POC phone B lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.POC.SECONDARY.PHONE.B[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.POC.SECONDARY.SCREEN}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Secondary POC screen name lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.POC.SECONDARY.SCREEN[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.SERIALNO.A}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Serial number A lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.SERIALNO.A[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).<br><br>`{PROFILE.SERIALNO<1-9>}` ir novecojis un atbalstītajās vietās var netikt atrisināts.| |{INVENTORY.SERIALNO.B}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Serial number B lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.SERIALNO.B[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.SITE.ADDRESS.A}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Site address A lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.SITE.ADDRESS.A[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.SITE.ADDRESS.B}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Site address B lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.SITE.ADDRESS.B[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.SITE.ADDRESS.C}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Site address C lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.SITE.ADDRESS.C[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.SITE.CITY}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Site city lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.SITE.CITY[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.SITE.COUNTRY}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Site country lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.SITE.COUNTRY[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.SITE.NOTES}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Site notes lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.SITE.NOTES[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.SITE.RACK}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Site rack location lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.SITE.RACK[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.SITE.STATE}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Site state/province lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.SITE.STATE[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.SITE.ZIP}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Site ZIP/postal lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.SITE.ZIP[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.SOFTWARE}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Software lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.SOFTWARE[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).<br><br>`{PROFILE.SOFTWARE<1-9>}` ir novecojis un atbalstītajās vietās var netikt atrisināts.| |{INVENTORY.SOFTWARE.APP.A}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Software application A lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.SOFTWARE.APP.A[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.SOFTWARE.APP.B}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Software application B lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.SOFTWARE.APP.B[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.SOFTWARE.APP.C}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Software application C lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.SOFTWARE.APP.C[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.SOFTWARE.APP.D}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Software application D lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.SOFTWARE.APP.D[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.SOFTWARE.APP.E}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Software application E lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.SOFTWARE.APP.E[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.SOFTWARE.FULL}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Software (Full details) lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.SOFTWARE.FULL[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.TAG}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Tag lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.TAG[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).<br><br>`{PROFILE.TAG<1-9>}` ir novecojis un atbalstītajās vietās var netikt atrisināts.| |{INVENTORY.TYPE}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Type lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.TYPE[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).<br><br>`{PROFILE.DEVICETYPE<1-9>}` ir novecojis un atbalstītajās vietās var netikt atrisināts.| |{INVENTORY.TYPE.FULL}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Type (Full details) lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.TYPE.FULL[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.URL.A}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*URL A lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.URL.A[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.URL.B}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*URL B lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.URL.B[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.URL.C}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*URL C lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.URL.C[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| |{INVENTORY.VENDOR}|→ Paziņojumi un komandas, kas balstītas uz trigeriem<br>→ Paziņojumi un komandas problēmu atjaunināšanai<br>→ Iekšējie paziņojumi<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Skripta tipa vienumi un pārlūka tipa vienumi^[6](supported_by_location#footnotes)^<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts^[6](supported_by_location#footnotes)^<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ *Description* parametrs logrīkā [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes *Text* parametrs logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Vendor lauks hosta inventārijā.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {INVENTORY.VENDOR[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētos makro](supported_by_location#indexed-macros).| ### Host inventory The host inventory object has the following properties. ::: notetip Each property has it's own unique ID number, which is used to associate host inventory fields with items. ::: |ID|Property|[Type](/manual/api/reference_commentary#data-types)|Description|Maximum length| |-|--|-|-----|-----| |4|alias|string|Alias.|128 characters| |11|asset\_tag|string|Asset tag.|64 characters| |28|chassis|string|Chassis.|64 characters| |23|contact|string|Contact person.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |32|contract\_number|string|Contract number.|64 characters| |47|date\_hw\_decomm|string|HW decommissioning date.|64 characters| |46|date\_hw\_expiry|string|HW maintenance expiry date.|64 characters| |45|date\_hw\_install|string|HW installation date.|64 characters| |44|date\_hw\_purchase|string|HW purchase date.|64 characters| |34|deployment\_status|string|Deployment status.|64 characters| |14|hardware|string|Hardware.|255 characters| |15|hardware\_full|string|Detailed hardware.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |39|host\_netmask|string|Host subnet mask.|39 characters| |38|host\_networks|string|Host networks.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |40|host\_router|string|Host router.|39 characters| |30|hw\_arch|string|HW architecture.|32 characters| |33|installer\_name|string|Installer name.|64 characters| |24|location|string|Location.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |25|location\_lat|string|Location latitude.|16 characters| |26|location\_lon|string|Location longitude.|16 characters| |12|macaddress\_a|string|MAC address A.|64 characters| |13|macaddress\_b|string|MAC address B.|64 characters| |29|model|string|Model.|64 characters| |3|name|string|Name.|128 characters| |27|notes|string|Notes.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |41|oob\_ip|string|OOB IP address.|39 characters| |42|oob\_netmask|string|OOB host subnet mask.|39 characters| |43|oob\_router|string|OOB router.|39 characters| |5|os|string|OS name.|128 characters| |6|os\_full|string|Detailed OS name.|255 characters| |7|os\_short|string|Short OS name.|128 characters| |61|poc\_1\_cell|string|Primary POC mobile number.|64 characters| |58|poc\_1\_email|string|Primary email.|128 characters| |57|poc\_1\_name|string|Primary POC name.|128 characters| |63|poc\_1\_notes|string|Primary POC notes.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |59|poc\_1\_phone\_a|string|Primary POC phone A.|64 characters| |60|poc\_1\_phone\_b|string|Primary POC phone B.|64 characters| |62|poc\_1\_screen|string|Primary POC screen name.|64 characters| |68|poc\_2\_cell|string|Secondary POC mobile number.|64 characters| |65|poc\_2\_email|string|Secondary POC email.|128 characters| |64|poc\_2\_name|string|Secondary POC name.|128 characters| |70|poc\_2\_notes|string|Secondary POC notes.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |66|poc\_2\_phone\_a|string|Secondary POC phone A.|64 characters| |67|poc\_2\_phone\_b|string|Secondary POC phone B.|64 characters| |69|poc\_2\_screen|string|Secondary POC screen name.|64 characters| |8|serialno\_a|string|Serial number A.|64 characters| |9|serialno\_b|string|Serial number B.|64 characters| |48|site\_address\_a|string|Site address A.|128 characters| |49|site\_address\_b|string|Site address B.|128 characters| |50|site\_address\_c|string|Site address C.|128 characters| |51|site\_city|string|Site city.|128 characters| |53|site\_country|string|Site country.|64 characters| |56|site\_notes|string|Site notes.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |55|site\_rack|string|Site rack location.|128 characters| |52|site\_state|string|Site state.|64 characters| |54|site\_zip|string|Site ZIP/postal code.|64 characters| |16|software|string|Software.|255 characters| |18|software\_app\_a|string|Software application A.|64 characters| |19|software\_app\_b|string|Software application B.|64 characters| |20|software\_app\_c|string|Software application C.|64 characters| |21|software\_app\_d|string|Software application D.|64 characters| |22|software\_app\_e|string|Software application E.|64 characters| |17|software\_full|string|Software details.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |10|tag|string|Tag.|64 characters| |1|type|string|Type.|64 characters| |2|type\_full|string|Type details.|64 characters| |35|url\_a|string|URL A.|2048 characters| |36|url\_b|string|URL B.|2048 characters| |37|url\_c|string|URL C.|2048 characters| |31|vendor|string|Vendor.|64 characters| ### Hosts inventārs Hosts inventāra objektam ir šādi rekvizīti. ::: notetip Katram rekvizītam ir savs unikāls ID numurs, kas tiek izmantots, lai saistītu hosts inventāra laukus ar vienumiem. ::: |ID|Rekvizīts|[Tips](/manual/api/reference_commentary#data-types)|Apraksts|Maksimālais garums| |-|--|-|-----|-----| |4|alias|string|Alias.|128 rakstzīmes| |11|asset\_tag|string|Aktīva birka.|64 rakstzīmes| |28|chassis|string|Korpuss.|64 rakstzīmes| |23|contact|string|Kontaktpersona.|Atkarīgs no izmantotās datubāzes:<br>- 65535 rakstzīmes SQL datubāzēm<br>- 2048 rakstzīmes Oracle datubāzēm| |32|contract\_number|string|Līguma numurs.|64 rakstzīmes| |47|date\_hw\_decomm|string|HW ekspluatācijas pārtraukšanas datums.|64 rakstzīmes| |46|date\_hw\_expiry|string|HW apkopes beigu datums.|64 rakstzīmes| |45|date\_hw\_install|string|HW uzstādīšanas datums.|64 rakstzīmes| |44|date\_hw\_purchase|string|HW iegādes datums.|64 rakstzīmes| |34|deployment\_status|string|Izvietošanas statuss.|64 rakstzīmes| |14|hardware|string|Aparatūra.|255 rakstzīmes| |15|hardware\_full|string|Detalizēta aparatūra.|Atkarīgs no izmantotās datubāzes:<br>- 65535 rakstzīmes SQL datubāzēm<br>- 2048 rakstzīmes Oracle datubāzēm| |39|host\_netmask|string|Hosts apakštīkla maska.|39 rakstzīmes| |38|host\_networks|string|Hosts tīkli.|Atkarīgs no izmantotās datubāzes:<br>- 65535 rakstzīmes SQL datubāzēm<br>- 2048 rakstzīmes Oracle datubāzēm| |40|host\_router|string|Hosts maršrutētājs.|39 rakstzīmes| |30|hw\_arch|string|HW arhitektūra.|32 rakstzīmes| |33|installer\_name|string|Uzstādītāja vārds.|64 rakstzīmes| |24|location|string|Atrašanās vieta.|Atkarīgs no izmantotās datubāzes:<br>- 65535 rakstzīmes SQL datubāzēm<br>- 2048 rakstzīmes Oracle datubāzēm| |25|location\_lat|string|Atrašanās vietas platums.|16 rakstzīmes| |26|location\_lon|string|Atrašanās vietas garums.|16 rakstzīmes| |12|macaddress\_a|string|MAC adrese A.|64 rakstzīmes| |13|macaddress\_b|string|MAC adrese B.|64 rakstzīmes| |29|model|string|Modelis.|64 rakstzīmes| |3|name|string|Nosaukums.|128 rakstzīmes| |27|notes|string|Piezīmes.|Atkarīgs no izmantotās datubāzes:<br>- 65535 rakstzīmes SQL datubāzēm<br>- 2048 rakstzīmes Oracle datubāzēm| |41|oob\_ip|string|OOB IP adrese.|39 rakstzīmes| |42|oob\_netmask|string|OOB hosts apakštīkla maska.|39 rakstzīmes| |43|oob\_router|string|OOB maršrutētājs.|39 rakstzīmes| |5|os|string|OS nosaukums.|128 rakstzīmes| |6|os\_full|string|Detalizēts OS nosaukums.|255 rakstzīmes| |7|os\_short|string|Īss OS nosaukums.|128 rakstzīmes| |61|poc\_1\_cell|string|Primārā POC mobilā tālruņa numurs.|64 rakstzīmes| |58|poc\_1\_email|string|Primārais e-pasts.|128 rakstzīmes| |57|poc\_1\_name|string|Primārās POC vārds.|128 rakstzīmes| |63|poc\_1\_notes|string|Primārās POC piezīmes.|Atkarīgs no izmantotās datubāzes:<br>- 65535 rakstzīmes SQL datubāzēm<br>- 2048 rakstzīmes Oracle datubāzēm| |59|poc\_1\_phone\_a|string|Primārās POC tālrunis A.|64 rakstzīmes| |60|poc\_1\_phone\_b|string|Primārās POC tālrunis B.|64 rakstzīmes| |62|poc\_1\_screen|string|Primārās POC ekrāna nosaukums.|64 rakstzīmes| |68|poc\_2\_cell|string|Sekundārā POC mobilā tālruņa numurs.|64 rakstzīmes| |65|poc\_2\_email|string|Sekundārais e-pasts.|128 rakstzīmes| |64|poc\_2\_name|string|Sekundārās POC vārds.|128 rakstzīmes| |70|poc\_2\_notes|string|Sekundārās POC piezīmes.|Atkarīgs no izmantotās datubāzes:<br>- 65535 rakstzīmes SQL datubāzēm<br>- 2048 rakstzīmes Oracle datubāzēm| |66|poc\_2\_phone\_a|string|Sekundārās POC tālrunis A.|64 rakstzīmes| |67|poc\_2\_phone\_b|string|Sekundārās POC tālrunis B.|64 rakstzīmes| |69|poc\_2\_screen|string|Sekundārās POC ekrāna nosaukums.|64 rakstzīmes| |8|serialno\_a|string|Sērijas numurs A.|64 rakstzīmes| |9|serialno\_b|string|Sērijas numurs B.|64 rakstzīmes| |48|site\_address\_a|string|Vietas adrese A.|128 rakstzīmes| |49|site\_address\_b|string|Vietas adrese B.|128 rakstzīmes| |50|site\_address\_c|string|Vietas adrese C.|128 rakstzīmes| |51|site\_city|string|Vietas pilsēta.|128 rakstzīmes| |53|site\_country|string|Vietas valsts.|64 rakstzīmes| |56|site\_notes|string|Vietas piezīmes.|Atkarīgs no izmantotās datubāzes:<br>- 65535 rakstzīmes SQL datubāzēm<br>- 2048 rakstzīmes Oracle datubāzēm| |55|site\_rack|string|Vietas statīva atrašanās vieta.|128 rakstzīmes| |52|site\_state|string|Vietas štats.|64 rakstzīmes| |54|site\_zip|string|Vietas pasta indekss.|64 rakstzīmes| |16|software|string|Programmatūra.|255 rakstzīmes| |18|software\_app\_a|string|Programmatūras lietojumprogramma A.|64 rakstzīmes| |19|software\_app\_b|string|Programmatūras lietojumprogramma B.|64 rakstzīmes| |20|software\_app\_c|string|Programmatūras lietojumprogramma C.|64 rakstzīmes| |21|software\_app\_d|string|Programmatūras lietojumprogramma D.|64 rakstzīmes| |22|software\_app\_e|string|Programmatūras lietojumprogramma E.|64 rakstzīmes| |17|software\_full|string|Programmatūras informācija.|Atkarīgs no izmantotās datubāzes:<br>- 65535 rakstzīmes SQL datubāzēm<br>- 2048 rakstzīmes Oracle datubāzēm| |10|tag|string|Birka.|64 rakstzīmes| |1|type|string|Tips.|64 rakstzīmes| |2|type\_full|string|Tipa informācija.|64 rakstzīmes| |35|url\_a|string|URL A.|2048 rakstzīmes| |36|url\_b|string|URL B.|2048 rakstzīmes| |37|url\_c|string|URL C.|2048 rakstzīmes| |31|vendor|string|Piegādātājs.|64 rakstzīmes| #### Host items |Element|<|Type|Description| |-|---|---|-----------------------| |name|<|string|(required) Item name.| |type|<|string|Item type.<br>Possible values:^[1](#footnotes)^ ZABBIX\_PASSIVE (0, default), TRAP (2), SIMPLE (3), INTERNAL (5), ZABBIX\_ACTIVE (7), EXTERNAL (10), ODBC (11), IPMI (12), SSH (13), TELNET (14), CALCULATED (15), JMX (16), SNMP\_TRAP (17), DEPENDENT (18), HTTP\_AGENT (19), SNMP\_AGENT (20), ITEM\_TYPE\_SCRIPT (21), ITEM\_TYPE\_BROWSER (22).| |snmp\_oid|<|string|(required for SNMP\_AGENT items) SNMP object ID.| |key|<|string|(required) Item key.| |delay|<|string|Update interval of the item.<br>Default: 1m. The value will always be 0 for TRAP items.| |history|<|string|Time period (using [time suffix](/manual/appendix/suffixes#time-suffixes), [user macro](/manual/config/macros/user_macros) or [LLD macro](/manual/config/macros/lld_macros)) of how long the history data should be stored.<br>Default: 31d.| |trends|<|string|Time period (using [time suffix](/manual/appendix/suffixes#time-suffixes), [user macro](/manual/config/macros/user_macros) or [LLD macro](/manual/config/macros/lld_macros)) of how long the trends data should be stored.<br>Default: 365d.| |status|<|string|Item status.<br>Possible values:^[1](#footnotes)^ ENABLED (0, default), DISABLED (1).| |value\_type|<|string|Received value type.<br>Possible values:^[1](#footnotes)^ FLOAT (0), CHAR (1), LOG (2), UNSIGNED (3, default), TEXT (4), BINARY (5).| |allowed\_hosts|<|string|List of comma-delimited IP addresses of hosts allowed to send data for the item.<br>Supported for TRAP and HTTP\_AGENT items.| |units|<|string|Received value units (bps, B, etc.).| |params|<|text|Additional parameters depending on the type of the item (executed script for SSH and TELNET items; SQL query for ODBC items; formula for CALCULATED items; the script for ITEM\_TYPE\_SCRIPT and ITEM\_TYPE\_BROWSER items).| |ipmi\_sensor|<|string|IPMI sensor.<br>Supported for IPMI items.| |authtype|<|string|Authentication type.<br>Supported for SSH and HTTP\_AGENT items.<br>Possible values for SSH items:^[1](#footnotes)^ PASSWORD (0, default), PUBLIC\_KEY (1).<br>Possible values for HTTP\_AGENT items:^[1](#footnotes)^ NONE (0, default), BASIC (1), NTLM (2), Kerberos (3), or Digest (4).| |username|<|string|(required for SSH and TELNET items) Username for authentication.<br>Supported for SIMPLE, ODBC, JMX and HTTP\_AGENT items.<br>When used for JMX items, `password` (see below) should also be specified or both elements should be left blank.| |password|<|string|(required for SSH and TELNET items) Password for authentication.<br>Supported for SIMPLE, ODBC, JMX and HTTP\_AGENT items.<br>When used for JMX items, `username` (see above) should also be specified or both elements should be left blank.| |publickey|<|string|(required for SSH items) Name of the public key file.| |privatekey|<|string|(required for SSH items) Name of the private key file.| |description|<|text|Item description.| |inventory\_link|<|string|Host inventory field that is populated by the item.<br>Possible values:^[1](#footnotes)^ NONE (0), ALIAS (4), etc. (see [Host inventory](/manual/api/reference/host/object#host-inventory) for supported fields).| |valuemap|<| |Root element for item value maps.| | |name|string|(required) Name of the value map to use for the item.| |logtimefmt|<|string|Format of the time in log entries.<br>Supported for items of LOG value type.| |preprocessing|<| |Root element for item value preprocessing.| | |step| |Root element for [host item value preprocessing steps](#host-item-value-preprocessing-steps).| |interface\_ref|<|string|Reference to the host interface (format: `if<N>`).| |jmx\_endpoint|<|string|JMX endpoint.<br>Supported for JMX items.| |master_item|<| |(required for DEPENDENT items) Root element for dependent item's master item.| | |key|string|(required) Dependent item's master item key.| |timeout|<|string|Item data polling request timeout.<br>Supported for the [Timeouts](/manual/web_interface/frontend_sections/administration/general#timeouts) list of item types.| |url|<|string|(required for HTTP\_AGENT items) URL string.| |query_fields|<| |Root element for query parameters.<br>Supported for HTTP\_AGENT items.| |<|name|string|(required for HTTP\_AGENT items) Query parameter name.| |^|value|string|Query parameter value.<br>Supported for HTTP\_AGENT items.| |parameters|<| |Root element for user-defined parameters.<br>Supported for ITEM\_TYPE\_SCRIPT and ITEM\_TYPE\_BROWSER items.| |<|name|string|(required for ITEM\_TYPE\_SCRIPT and ITEM\_TYPE\_BROWSER items) User-defined parameter name.| |^|value|string|User-defined parameter value.<br>Supported for ITEM\_TYPE\_SCRIPT and ITEM\_TYPE\_BROWSER items.| |posts|<|string|HTTP(S) request body data.<br>Supported for HTTP\_AGENT items.| |status\_codes|<|string|Ranges of required HTTP status codes, separated by commas.<br>Supported for HTTP\_AGENT items.| |follow\_redirects|<|string|Follow response redirects while polling data.<br>Supported for HTTP\_AGENT items.<br>Possible values:^[1](#footnotes)^ NO (0), YES (1, default).| |post\_type|<|string|Type of post data body.<br>Supported for HTTP\_AGENT items.<br>Possible values:^[1](#footnotes)^ RAW (0, default), JSON (2), XML (3).| |http\_proxy|<|string|HTTP(S) proxy connection string.<br>Supported for HTTP\_AGENT items.| |headers|<| |Root element for HTTP(S) request headers.<br>Supported for HTTP\_AGENT items.| |<|name|string|(required for HTTP\_AGENT items) Header name.| |^|value|string|(required for HTTP\_AGENT items) Header value.| |retrieve\_mode|<|string|What part of response should be stored.<br>Supported for HTTP\_AGENT items.<br>Possible values:^[1](#footnotes)^ BODY (0, default), HEADERS (1), BOTH (2).| |request\_method|<|string|Request method type.<br>Supported for HTTP\_AGENT items.<br>Possible values:^[1](#footnotes)^ GET (0, default), POST (1), PUT (2), HEAD (3).| |output\_format|<|string|How to process response.<br>Supported for HTTP\_AGENT items.<br>Possible values:^[1](#footnotes)^ RAW (0, default), JSON (1).| |allow\_traps|<|string|Allow to populate value similarly to the trapper item.<br>Supported for HTTP\_AGENT items.<br>Possible values:^[1](#footnotes)^ NO (0, default), YES (1).| |ssl\_cert\_file|<|string|Public SSL Key file path.<br>Supported for HTTP\_AGENT items.| |ssl\_key\_file|<|string|Private SSL Key file path.<br>Supported for HTTP\_AGENT items.| |ssl\_key\_password|<|string|Password for SSL Key file.<br>Supported for HTTP\_AGENT items.| |verify\_peer|<|string|Whether to validate that the host's certificate is authentic.<br>Supported for HTTP\_AGENT items.<br>Possible values:^[1](#footnotes)^ NO (0, default), YES (1).| |verify\_host|<|string|Whether to validate that the host name for the connection matches the one in the host's certificate.<br>Supported for HTTP\_AGENT items.<br>Possible values:^[1](#footnotes)^ NO (0, default), YES (1).| |tags|<| |Root element for item tags.| |<|tag|string|(required) Tag name.| |^|value|string|Tag value.| |triggers|<| |Root element for [host item triggers](#host-item-triggers).| ::: noteclassic See also: [Item object](/manual/api/reference/item/object) (refer to the relevant property with a matching name). ::: #### Hosts vienumi |Element|<|Type|Description| |-|---|---|-----------------------| |name|<|string|(required) Vienuma nosaukums.| |type|<|string|Vienuma tips.<br>Iespējamās vērtības:^[1](#footnotes)^ ZABBIX\_PASSIVE (0, default), TRAP (2), SIMPLE (3), INTERNAL (5), ZABBIX\_ACTIVE (7), EXTERNAL (10), ODBC (11), IPMI (12), SSH (13), TELNET (14), CALCULATED (15), JMX (16), SNMP\_TRAP (17), DEPENDENT (18), HTTP\_AGENT (19), SNMP\_AGENT (20), ITEM\_TYPE\_SCRIPT (21), ITEM\_TYPE\_BROWSER (22).| |snmp\_oid|<|string|(required for SNMP\_AGENT items) SNMP objekta ID.| |key|<|string|(required) Vienuma atslēga.| |delay|<|string|Vienuma atjaunināšanas intervāls.<br>Noklusējums: 1m. Vērtība TRAP vienumiem vienmēr būs 0.| |history|<|string|Laika periods (izmantojot [laika sufiksu](/manual/appendix/suffixes#time-suffixes), [lietotāja makro](/manual/config/macros/user_macros) vai [LLD makro](/manual/config/macros/lld_macros)), cik ilgi jāglabā vēstures dati.<br>Noklusējums: 31d.| |trends|<|string|Laika periods (izmantojot [laika sufiksu](/manual/appendix/suffixes#time-suffixes), [lietotāja makro](/manual/config/macros/user_macros) vai [LLD makro](/manual/config/macros/lld_macros)), cik ilgi jāglabā tendenču dati.<br>Noklusējums: 365d.| |status|<|string|Vienuma statuss.<br>Iespējamās vērtības:^[1](#footnotes)^ ENABLED (0, default), DISABLED (1).| |value\_type|<|string|Saņemtās vērtības tips.<br>Iespējamās vērtības:^[1](#footnotes)^ FLOAT (0), CHAR (1), LOG (2), UNSIGNED (3, default), TEXT (4), BINARY (5).| |allowed\_hosts|<|string|Ar komatiem atdalīts to hostu IP adrešu saraksts, kuriem atļauts sūtīt datus šim vienumam.<br>Atbalstīts TRAP un HTTP\_AGENT vienumiem.| |units|<|string|Saņemtās vērtības vienības (bps, B utt.).| |params|<|text|Papildu parametri atkarībā no vienuma tipa (izpildāmais skripts SSH un TELNET vienumiem; SQL vaicājums ODBC vienumiem; formula CALCULATED vienumiem; skripts ITEM\_TYPE\_SCRIPT un ITEM\_TYPE\_BROWSER vienumiem).| |ipmi\_sensor|<|string|IPMI sensors.<br>Atbalstīts IPMI vienumiem.| |authtype|<|string|Autentifikācijas tips.<br>Atbalstīts SSH un HTTP\_AGENT vienumiem.<br>Iespējamās vērtības SSH vienumiem:^[1](#footnotes)^ PASSWORD (0, default), PUBLIC\_KEY (1).<br>Iespējamās vērtības HTTP\_AGENT vienumiem:^[1](#footnotes)^ NONE (0, default), BASIC (1), NTLM (2), Kerberos (3) vai Digest (4).| |username|<|string|(required for SSH and TELNET items) Lietotājvārds autentifikācijai.<br>Atbalstīts SIMPLE, ODBC, JMX un HTTP\_AGENT vienumiem.<br>Ja tiek izmantots JMX vienumiem, jānorāda arī `password` (skat. zemāk) vai abi elementi jāatstāj tukši.| |password|<|string|(required for SSH and TELNET items) Parole autentifikācijai.<br>Atbalstīts SIMPLE, ODBC, JMX un HTTP\_AGENT vienumiem.<br>Ja tiek izmantots JMX vienumiem, jānorāda arī `username` (skat. iepriekš) vai abi elementi jāatstāj tukši.| |publickey|<|string|(required for SSH items) Publiskās atslēgas faila nosaukums.| |privatekey|<|string|(required for SSH items) Privātās atslēgas faila nosaukums.| |description|<|text|Vienuma apraksts.| |inventory\_link|<|string|Hosta inventāra lauks, ko aizpilda vienums.<br>Iespējamās vērtības:^[1](#footnotes)^ NONE (0), ALIAS (4) utt. (skat. [Host inventory](/manual/api/reference/host/object#host-inventory) atbalstītos laukus).| |valuemap|<| |Saknes elements vienuma vērtību kartēm.| | |name|string|(required) Vienuma izmantotās vērtību kartes nosaukums.| |logtimefmt|<|string|Laika formāts žurnāla ierakstos.<br>Atbalstīts LOG vērtības tipa vienumiem.| |preprocessing|<| |Saknes elements vienuma vērtību pirmapstrādei.| | |step| |Saknes elements [host item value preprocessing steps](#host-item-value-preprocessing-steps).| |interface\_ref|<|string|Atsauce uz hosta saskarni (formāts: `if<N>`).| |jmx\_endpoint|<|string|JMX galapunkts.<br>Atbalstīts JMX vienumiem.| |master_item|<| |(required for DEPENDENT items) Saknes elements atkarīgā vienuma galvenajam vienumam.| | |key|string|(required) Atkarīgā vienuma galvenā vienuma atslēga.| |timeout|<|string|Vienuma datu aptaujas pieprasījuma noildze.<br>Atbalstīts [Timeouts](/manual/web_interface/frontend_sections/administration/general#timeouts) vienumu tipu sarakstam.| |url|<|string|(required for HTTP\_AGENT items) URL virkne.| |query_fields|<| |Saknes elements vaicājuma parametriem.<br>Atbalstīts HTTP\_AGENT vienumiem.| |<|name|string|(required for HTTP\_AGENT items) Vaicājuma parametra nosaukums.| |^|value|string|Vaicājuma parametra vērtība.<br>Atbalstīts HTTP\_AGENT vienumiem.| |parameters|<| |Saknes elements lietotāja definētiem parametriem.<br>Atbalstīts ITEM\_TYPE\_SCRIPT un ITEM\_TYPE\_BROWSER vienumiem.| |<|name|string|(required for ITEM\_TYPE\_SCRIPT and ITEM\_TYPE\_BROWSER items) Lietotāja definēta parametra nosaukums.| |^|value|string|Lietotāja definēta parametra vērtība.<br>Atbalstīts ITEM\_TYPE\_SCRIPT un ITEM\_TYPE\_BROWSER vienumiem.| |posts|<|string|HTTP(S) pieprasījuma pamatteksta dati.<br>Atbalstīts HTTP\_AGENT vienumiem.| |status\_codes|<|string|Nepieciešamo HTTP statusa kodu diapazoni, atdalīti ar komatiem.<br>Atbalstīts HTTP\_AGENT vienumiem.| |follow\_redirects|<|string|Sekot atbildes pāradresācijām datu aptaujas laikā.<br>Atbalstīts HTTP\_AGENT vienumiem.<br>Iespējamās vērtības:^[1](#footnotes)^ NO (0), YES (1, default).| |post\_type|<|string|Pamatteksta datu tips.<br>Atbalstīts HTTP\_AGENT vienumiem.<br>Iespējamās vērtības:^[1](#footnotes)^ RAW (0, default), JSON (2), XML (3).| |http\_proxy|<|string|HTTP(S) starpniekservera savienojuma virkne.<br>Atbalstīts HTTP\_AGENT vienumiem.| |headers|<| |Saknes elements HTTP(S) pieprasījuma galvenēm.<br>Atbalstīts HTTP\_AGENT vienumiem.| |<|name|string|(required for HTTP\_AGENT items) Galvenes nosaukums.| |^|value|string|(required for HTTP\_AGENT items) Galvenes vērtība.| |retrieve\_mode|<|string|Kura atbildes daļa jāglabā.<br>Atbalstīts HTTP\_AGENT vienumiem.<br>Iespējamās vērtības:^[1](#footnotes)^ BODY (0, default), HEADERS (1), BOTH (2).| |request\_method|<|string|Pieprasījuma metodes tips.<br>Atbalstīts HTTP\_AGENT vienumiem.<br>Iespējamās vērtības:^[1](#footnotes)^ GET (0, default), POST (1), PUT (2), HEAD (3).| |output\_format|<|string|Kā apstrādāt atbildi.<br>Atbalstīts HTTP\_AGENT vienumiem.<br>Iespējamās vērtības:^[1](#footnotes)^ RAW (0, default), JSON (1).| |allow\_traps|<|string|Atļaut vērtības aizpildīšanu līdzīgi kā trapper vienumam.<br>Atbalstīts HTTP\_AGENT vienumiem.<br>Iespējamās vērtības:^[1](#footnotes)^ NO (0, default), YES (1).| |ssl\_cert\_file|<|string|Publiskās SSL atslēgas faila ceļš.<br>Atbalstīts HTTP\_AGENT vienumiem.| |ssl\_key\_file|<|string|Privātās SSL atslēgas faila ceļš.<br>Atbalstīts HTTP\_AGENT vienumiem.| |ssl\_key\_password|<|string|Parole SSL atslēgas failam.<br>Atbalstīts HTTP\_AGENT vienumiem.| |verify\_peer|<|string|Vai validēt, ka hosta sertifikāts ir autentisks.<br>Atbalstīts HTTP\_AGENT vienumiem.<br>Iespējamās vērtības:^[1](#footnotes)^ NO (0, default), YES (1).| |verify\_host|<|string|Vai validēt, ka savienojuma hosta nosaukums atbilst hosta sertifikātā norādītajam.<br>Atbalstīts HTTP\_AGENT vienumiem.<br>Iespējamās vērtības:^[1](#footnotes)^ NO (0, default), YES (1).| |tags|<| |Saknes elements vienuma tagiem.| |<|tag|string|(required) Taga nosaukums.| |^|value|string|Taga vērtība.| |triggers|<| |Saknes elements [host item triggers](#host-item-triggers).| ::: noteclassic Skatiet arī: [Item object](/manual/api/reference/item/object) (skatiet atbilstošo īpašību ar tādu pašu nosaukumu). ::: ##### Host item triggers |Element|<|Type|Description| |-|---|---|-----------------------| |uuid|<|string|(required) Unique identifier for this trigger.| |expression|<|string|(required) Trigger expression.| |recovery\_mode|<|string|Basis for generating OK events.<br>Possible values:^[1](#footnotes)^ EXPRESSION (0, default), RECOVERY\_EXPRESSION (1), NONE (2).| |recovery\_expression|<|string|Trigger recovery expression.| |correlation\_mode|<|string|Correlation mode (no event correlation or event correlation by tag).<br>Possible values:^[1](#footnotes)^ DISABLED (0, default), TAG\_VALUE (1).| |correlation\_tag|<|string|The tag name to be used for event correlation.| |name|<|string|(required) Trigger name.| |event\_name|<|string|Event name.| |opdata|<|string|Operational data.| |url\_name|<|string|Label for the URL associated with the trigger.| |url|<|string|URL associated with the trigger.| |status|<|string|Trigger status.<br>Possible values:^[1](#footnotes)^ ENABLED (0, default), DISABLED (1).| |priority|<|string|Trigger severity.<br>Possible values:^[1](#footnotes)^ NOT\_CLASSIFIED (0, default), INFO (1), WARNING (2), AVERAGE (3), HIGH (4), DISASTER (5).| |description|<|text|Trigger description.| |type|<|string|Event generation type (single problem event or multiple problem events).<br>Possible values:^[1](#footnotes)^ SINGLE (0, default), MULTIPLE (1).| |manual\_close|<|string|Manual closing of problem events.<br>Possible values:^[1](#footnotes)^ NO (0, default), YES (1).| |dependencies|<| |Root element for dependencies.| |<|name|string|(required) Dependency trigger name.| |^|expression|string|(required) Dependency trigger expression.| |^|recovery\_expression|string|Dependency trigger recovery expression.| |tags|<| |Root element for trigger tags.| |<|tag|string|(required) Tag name.| |^|value|string|Tag value.| ::: noteclassic See also: [Trigger object](/manual/api/reference/trigger/object) (refer to the relevant property with a matching name). ::: ##### Hosts vienuma trigeri |Element|<|Type|Description| |-|---|---|-----------------------| |uuid|<|string|(required) Unikāls šī trigera identifikators.| |expression|<|string|(required) Trigera izteiksme.| |recovery\_mode|<|string>OK notikumu ģenerēšanas pamats.<br>Iespējamās vērtības:^[1](#footnotes)^ EXPRESSION (0, default), RECOVERY\_EXPRESSION (1), NONE (2).| |recovery\_expression|<|string>Trigera atjaunošanās izteiksme.| |correlation\_mode|<|string>Korelācijas režīms (bez notikumu korelācijas vai notikumu korelācija pēc taga).<br>Iespējamās vērtības:^[1](#footnotes)^ DISABLED (0, default), TAG\_VALUE (1).| |correlation\_tag|<|string>Taga nosaukums, ko izmantot notikumu korelācijai.| |name|<|string|(required) Trigera nosaukums.| |event\_name|<|string>Notikuma nosaukums.| |opdata|<|string>Operatīvie dati.| |url\_name|<|string>Etiķete URL, kas saistīts ar trigeri.| |url|<|string>URL, kas saistīts ar trigeri.| |status|<|string>Trigera statuss.<br>Iespējamās vērtības:^[1](#footnotes)^ ENABLED (0, default), DISABLED (1).| |priority|<|string>Trigera nopietnība.<br>Iespējamās vērtības:^[1](#footnotes)^ NOT\_CLASSIFIED (0, default), INFO (1), WARNING (2), AVERAGE (3), HIGH (4), DISASTER (5).| |description|<|text>Trigera apraksts.| |type|<|string>Notikumu ģenerēšanas veids (viens problēmas notikums vai vairāki problēmas notikumi).<br>Iespējamās vērtības:^[1](#footnotes)^ SINGLE (0, default), MULTIPLE (1).| |manual\_close|<|string>Problēmas notikumu manuāla aizvēršana.<br>Iespējamās vērtības:^[1](#footnotes)^ NO (0, default), YES (1).| |dependencies|<| |Atsevišķs elements atkarībām.| |<|name|string|(required) Atkarīgā trigera nosaukums.| |^|expression|string|(required) Atkarīgā trigera izteiksme.| |^|recovery\_expression|string|Atkarīgā trigera atjaunošanās izteiksme.| |tags|<| |Atsevišķs elements trigera tagiem.| |<|tag|string|(required) Taga nosaukums.| |^|value|string|Taga vērtība.| ::: noteclassic Skatiet arī: [Trigger object](/manual/api/reference/trigger/object) (skatiet atbilstošo īpašību ar tādu pašu nosaukumu). ::: ##### Host item value preprocessing steps |Element|<|Type|Description| |-|---|---|-----------------------| |type|<|string|(required) The item value preprocessing step type.<br>Possible values:^[1](#footnotes)^ MULTIPLIER (1), RTRIM (2), LTRIM (3), TRIM (4), REGEX (5), BOOL\_TO\_DECIMAL (6), OCTAL\_TO\_DECIMAL (7), HEX\_TO\_DECIMAL (8), SIMPLE\_CHANGE (9, calculated: received value - previous value), CHANGE\_PER\_SECOND (10, calculated: (received value - previous value)/(time now - time of last check)), XMLPATH (11), JSONPATH (12), IN\_RANGE (13), MATCHES\_REGEX (14), NOT\_MATCHES\_REGEX (15), CHECK\_JSON\_ERROR (16), CHECK\_XML\_ERROR (17), CHECK\_REGEX\_ERROR (18), DISCARD\_UNCHANGED (19), DISCARD\_UNCHANGED\_HEARTBEAT (20), JAVASCRIPT (21), PROMETHEUS\_PATTERN (22), PROMETHEUS\_TO\_JSON (23), CSV\_TO\_JSON (24), STR\_REPLACE (25), CHECK\_NOT\_SUPPORTED (26), XML\_TO\_JSON (27), SNMP\_WALK\_VALUE (28), SNMP\_WALK\_TO\_JSON (29), SNMP\_GET\_VALUE (30).| |parameters|<| |(required) Root element for parameters of the item value preprocessing step.| | |parameter|string|Individual parameter of the item value preprocessing step.| |error\_handler|<|string|Action type used in case of preprocessing step failure.<br>Possible values:^[1](#footnotes)^ ORIGINAL\_ERROR (0, default), DISCARD\_VALUE (1), CUSTOM\_VALUE (2), CUSTOM\_ERROR (3).| |error\_handler\_params|<|string|Error handler parameters.| ::: noteclassic See also: [Item preprocessing object](/manual/api/reference/item/object#item-preprocessing) (refer to the relevant property with a matching name). ::: ##### Hosts vienuma vērtības pirmapstrādes soļi |Element|<|Type|Description| |-|---|---|-----------------------| |type|<|string|(obligāts) Vienuma vērtības pirmapstrādes soļa tips.<br>Iespējamās vērtības:^[1](#footnotes)^ MULTIPLIER (1), RTRIM (2), LTRIM (3), TRIM (4), REGEX (5), BOOL\_TO\_DECIMAL (6), OCTAL\_TO\_DECIMAL (7), HEX\_TO\_DECIMAL (8), SIMPLE\_CHANGE (9, calculated: received value - previous value), CHANGE\_PER\_SECOND (10, calculated: (received value - previous value)/(time now - time of last check)), XMLPATH (11), JSONPATH (12), IN\_RANGE (13), MATCHES\_REGEX (14), NOT\_MATCHES\_REGEX (15), CHECK\_JSON\_ERROR (16), CHECK\_XML\_ERROR (17), CHECK\_REGEX\_ERROR (18), DISCARD\_UNCHANGED (19), DISCARD\_UNCHANGED\_HEARTBEAT (20), JAVASCRIPT (21), PROMETHEUS\_PATTERN (22), PROMETHEUS\_TO\_JSON (23), CSV\_TO\_JSON (24), STR\_REPLACE (25), CHECK\_NOT\_SUPPORTED (26), XML\_TO\_JSON (27), SNMP\_WALK\_VALUE (28), SNMP\_WALK\_TO\_JSON (29), SNMP\_GET\_VALUE (30).| |parameters|<| |(obligāts) Saknes elements vienuma vērtības pirmapstrādes soļa parametriem.| | |parameter|string|Atsevišķs vienuma vērtības pirmapstrādes soļa parametrs.| |error\_handler|<|string|Darbības tips, ko izmanto pirmapstrādes soļa kļūmes gadījumā.<br>Iespējamās vērtības:^[1](#footnotes)^ ORIGINAL\_ERROR (0, default), DISCARD\_VALUE (1), CUSTOM\_VALUE (2), CUSTOM\_ERROR (3).| |error\_handler\_params|<|string|Kļūdu apstrādātāja parametri.| ::: noteclassic Skatiet arī: [Vienuma pirmapstrādes objekts](/manual/api/reference/item/object#item-preprocessing) (skatiet attiecīgo īpašību ar atbilstošu nosaukumu). ::: ##### Host low-level discovery rule filters |Element|<|Type|Description| |-|---|---|-----------------------| |evaltype|<|string|Override filter condition evaluation method.<br>Possible values:^[1](#footnotes)^ AND\_OR (0, default), AND (1), OR (2), FORMULA (3).| |formula|<|string|Custom calculation formula for filter conditions.| |conditions|<| |Root element for filter conditions.| |<|macro|string|(required) The name of the low-level discovery macro to perform the check on.| |^|value|string|Value to compare with.| |^|operator|string|Condition operator.<br>Possible values:^[1](#footnotes)^ MATCHES\_REGEX (8, default), NOT\_MATCHES\_REGEX (9).| |^|formulaid|string|(required) Arbitrary unique ID that is used to reference a condition from the custom expression. Can only contain capital-case letters. The ID must be defined by the user when modifying filter conditions, but will be generated anew when requesting them afterward.| ::: noteclassic See also: [LLD rule filter object](/manual/api/reference/discoveryrule/object#lld-rule-filter) (refer to the relevant property with a matching name). ::: ##### Hosts zemā līmeņa atklāšanas noteikuma filtri |Element|<|Type|Description| |-|---|---|-----------------------| |evaltype|<|string|Pārraksta filtra nosacījumu izvērtēšanas metodi.<br>Iespējamās vērtības:^[1](#footnotes)^ AND\_OR (0, noklusējuma), AND (1), OR (2), FORMULA (3).| |formula|<|string|Pielāgota aprēķina formula filtra nosacījumiem.| |conditions|<| |Filtra nosacījumu saknes elements.| |<|macro|string|(obligāts) Zemā līmeņa atklāšanas makro nosaukums, uz kuru veikt pārbaudi.| |^|value|string|Vērtība, ar ko salīdzināt.| |^|operator|string|Nosacījuma operators.<br>Iespējamās vērtības:^[1](#footnotes)^ MATCHES\_REGEX (8, noklusējuma), NOT\_MATCHES\_REGEX (9).| |^|formulaid|string|(obligāts) Patvaļīgs unikāls ID, kas tiek izmantots, lai atsauktos uz nosacījumu no pielāgotās izteiksmes. Var saturēt tikai lielos burtus. ID lietotājam ir jādefinē, modificējot filtra nosacījumus, taču, pieprasot tos vēlāk, tas tiks ģenerēts no jauna.| ::: noteclassic Skatiet arī: [LLD noteikuma filtra objekts](/manual/api/reference/discoveryrule/object#lld-rule-filter) (skatiet atbilstošo īpašību ar sakrītošu nosaukumu). ::: ##### Host low-level discovery rule override operations |Element|<|Type|Description| |-|---|---|-----------------------| |operationobject|<|string|Object to which the operation is applied.<br>Possible values:^[1](#footnotes)^ ITEM_PROTOTYPE (0), TRIGGER_PROTOTYPE (1), GRAPH_PROTOTYPE (2), HOST_PROTOTYPE (3).| |operator|<|string|Override condition operator.<br>Possible values:^[1](#footnotes)^ EQUAL (1), NOT_EQUAL (2), LIKE (3), NOT_LIKE (4), REGEXP (5), NOT_REGEXP (6).| |value|<|string|A regular expression or a string for the override condition operator.| |status|<|string|Status of the object upon the override operation.| |discover|<|string|Whether the object is added as a result of the discovery.| |delay|<|string|Update interval set for the item prototype upon the override operation.| |history|<|string|History storage period set for the item prototype upon the override operation.| |trends|<|string|Trend storage period set for the item prototype upon the override operation.| |severity|<|string|Trigger prototype severity set upon the override operation.| |tags|<| |Root element for the tags set for the object upon the override operation.| |<|tag|string|(required) Tag name.| |^|value|string|Tag value.| |templates|<| |Root element for the templates linked to the host prototype upon the override operation.| | |name|string|(required) Template name.| |inventory_mode|<|string|Host prototype inventory mode set upon the override operation.| ::: noteclassic See also: [LLD rule override operation object](/manual/api/reference/discoveryrule/object#lld-rule-override-operation) (refer to the relevant property with a matching name). ::: ##### Hosts zema līmeņa atklāšanas noteikuma pārrakstīšanas operācijas |Element|<|Type|Description| |-|---|---|-----------------------| |operationobject|<|string|Objekts, uz kuru tiek lietota operācija.<br>Iespējamās vērtības:^[1](#footnotes)^ ITEM_PROTOTYPE (0), TRIGGER_PROTOTYPE (1), GRAPH_PROTOTYPE (2), HOST_PROTOTYPE (3).| |operator|<|string|Pārrakstīšanas nosacījuma operators.<br>Iespējamās vērtības:^[1](#footnotes)^ EQUAL (1), NOT_EQUAL (2), LIKE (3), NOT_LIKE (4), REGEXP (5), NOT_REGEXP (6).| |value|<|string|Regulārā izteiksme vai virkne pārrakstīšanas nosacījuma operatoram.| |status|<|string|Objekta statuss pēc pārrakstīšanas operācijas.| |discover|<|string|Vai objekts tiek pievienots atklāšanas rezultātā.| |delay|<|string|Atjaunināšanas intervāls, kas iestatīts vienuma prototipam pēc pārrakstīšanas operācijas.| |history|<|string|Vēstures glabāšanas periods, kas iestatīts vienuma prototipam pēc pārrakstīšanas operācijas.| |trends|<|string|Tendenču glabāšanas periods, kas iestatīts vienuma prototipam pēc pārrakstīšanas operācijas.| |severity|<|string|Trigeris prototipa smaguma pakāpe, kas iestatīta pēc pārrakstīšanas operācijas.| |tags|<| |Saknes elements tagiem, kas iestatīti objektam pēc pārrakstīšanas operācijas.| |<|tag|string|(obligāts) Taga nosaukums.| |^|value|string|Taga vērtība.| |templates|<| |Saknes elements veidnēm, kas saistītas ar hosta prototipu pēc pārrakstīšanas operācijas.| | |name|string|(obligāts) Veidnes nosaukums.| |inventory_mode|<|string|Hosta prototipa inventāra režīms, kas iestatīts pēc pārrakstīšanas operācijas.| ::: noteclassic Skatiet arī: [LLD noteikuma pārrakstīšanas operācijas objekts](/manual/api/reference/discoveryrule/object#lld-rule-override-operation) (skatiet attiecīgo īpašību ar atbilstošu nosaukumu). ::: #### Host low-level discovery rules ::: noteimportant Most host low-level discovery rule elements are the same as for [host items](#host-items). The table below describes those elements that differ from host items. ::: |Element|<|Type|Description| |-|---|---|-----------------------| |type|<|string|Item type.<br>Possible values:^[1](#footnotes)^ ZABBIX\_PASSIVE (0, default), TRAP (2), SIMPLE (3), INTERNAL (5), ZABBIX\_ACTIVE (7), EXTERNAL (10), ODBC (11), IPMI (12), SSH (13), TELNET (14), JMX (16), DEPENDENT (18), HTTP\_AGENT (19), SNMP\_AGENT (20), ITEM\_TYPE\_SCRIPT (21), ITEM\_TYPE\_BROWSER (22).| |key|<|string|(required) The low-level discovery rule key.| |filter|<| |Root element for [host low-level discovery rule filters](#host-low-level-discovery-rule-filters).| |lifetime|<|string|Time period (using seconds, [time suffix](/manual/appendix/suffixes#time-suffixes), or [user macro](/manual/config/macros/user_macros)), after which no longer discovered resources will be deleted.<br>Default: 7d.| |lifetime_type|<|string|Scenario for deleting lost LLD resources.<br>Possible values: DELETE\_NEVER, DELETE\_IMMEDIATELY, DELETE\_AFTER.| |enabled_lifetime|<|string|Time period (using seconds, [time suffix](/manual/appendix/suffixes#time-suffixes), or [user macro](/manual/config/macros/user_macros)), after which no longer discovered resources will be disabled.| |enabled_lifetime_type|<|string|Scenario for disabling lost LLD resources.<br>Possible values: DISABLE\_NEVER, DISABLE\_IMMEDIATELY, DISABLE\_AFTER.| |item\_prototypes|<| |Root element for host item prototype elements, which are the same as for [host items](#host-items).| |trigger\_prototypes|<| |Root element for host trigger prototype elements, which are the same as for [host item triggers](#host-item-triggers).| |graph\_prototypes|<| |Root element for host graph prototypes, which are the same as for [host graphs](#host-graphs).| |host\_prototypes|<| |Root element for host prototypes, which are the same as for [hosts](#hosts).| |master_item|<|string|(required for DEPENDENT rules) Root element for the dependent rule's master item.| |lld\_macro\_paths|<| |Root element for low-level discovery rule macro paths.| |<|lld\_macro|string|(required) Low-level discovery rule macro name.| |^|path|string|(required) Selector for value, which will be assigned to the corresponding macro.| |preprocessing|<| |Root element for low-level discovery rule value preprocessing.| | |step| |Root element for low-level discovery rule value preprocessing step elements, which are the same as for [host item value preprocessing steps](#host-item-preprocessing-steps), except with fewer possible values. See also: [LLD rule preprocessing object](/manual/api/reference/discoveryrule/object#lld-rule-preprocessing).| |overrides|<| |Root element for low-level discovery rule override rules.| |<|name|string|(required) Unique override name.| |^|step|string|(required) Unique order number of the override.| |^|stop|string|Stop processing next overrides if matches.| |^|filter| |Root element for low-level discovery rule override rule filter elements, which are the same as for [host low-level discovery rule filters](#host-low-level-discovery-rule-filters).| |^|operations| |Root element for [host low-level discovery rule override operations](#host-low-level-discovery-rule-override-operations).| ::: noteclassic See also: [LLD rule object](/manual/api/reference/discoveryrule/object) (refer to the relevant property with a matching name). ::: #### Hosts zema līmeņa atklāšanas noteikumi ::: noteimportant Lielākā daļa hosts zema līmeņa atklāšanas noteikuma elementu ir tādi paši kā [host vienumiem](#host-items). Tālāk esošajā tabulā ir aprakstīti tie elementi, kas atšķiras no host vienumiem. ::: |Element|<|Type|Description| |-|---|---|-----------------------| |type|<|string|Vienuma tips.<br>Iespējamās vērtības:^[1](#footnotes)^ ZABBIX\_PASSIVE (0, default), TRAP (2), SIMPLE (3), INTERNAL (5), ZABBIX\_ACTIVE (7), EXTERNAL (10), ODBC (11), IPMI (12), SSH (13), TELNET (14), JMX (16), DEPENDENT (18), HTTP\_AGENT (19), SNMP\_AGENT (20), ITEM\_TYPE\_SCRIPT (21), ITEM\_TYPE\_BROWSER (22).| |key|<|string|(obligāts) Zema līmeņa atklāšanas noteikuma atslēga.| |filter|<| |Saknes elements [host zema līmeņa atklāšanas noteikuma filtriem](#host-low-level-discovery-rule-filters).| |lifetime|<|string|Laika periods (sekundēs, [laika sufiksā](/manual/appendix/suffixes#time-suffixes) vai [lietotāja makro](/manual/config/macros/user_macros)), pēc kura vairs neatklātie resursi tiks dzēsti.<br>Noklusējums: 7d.| |lifetime_type|<|string|Scenārijs zaudēto LLD resursu dzēšanai.<br>Iespējamās vērtības: DELETE\_NEVER, DELETE\_IMMEDIATELY, DELETE\_AFTER.| |enabled_lifetime|<|string|Laika periods (sekundēs, [laika sufiksā](/manual/appendix/suffixes#time-suffixes) vai [lietotāja makro](/manual/config/macros/user_macros)), pēc kura vairs neatklātie resursi tiks atspējoti.| |enabled_lifetime_type|<|string|Scenārijs zaudēto LLD resursu atspējošanai.<br>Iespējamās vērtības: DISABLE\_NEVER, DISABLE\_IMMEDIATELY, DISABLE\_AFTER.| |item\_prototypes|<| |Saknes elements host vienumu prototipu elementiem, kas ir tādi paši kā [host vienumiem](#host-items).| |trigger\_prototypes|<| |Saknes elements host trigeru prototipu elementiem, kas ir tādi paši kā [host vienumu trigeriem](#host-item-triggers).| |graph\_prototypes|<| |Saknes elements host grafiku prototipiem, kas ir tādi paši kā [host grafikiem](#host-graphs).| |host\_prototypes|<| |Saknes elements host prototipiem, kas ir tādi paši kā [hosts](#hosts).| |master_item|<|string|(obligāts DEPENDENT noteikumiem) Saknes elements atkarīgā noteikuma galvenajam vienumam.| |lld\_macro\_paths|<| |Saknes elements zema līmeņa atklāšanas noteikuma makro ceļiem.| |<|lld\_macro|string|(obligāts) Zema līmeņa atklāšanas noteikuma makro nosaukums.| |^|path|string|(obligāts) Vērtības atlasītājs, kas tiks piešķirts atbilstošajam makro.| |preprocessing|<| |Saknes elements zema līmeņa atklāšanas noteikuma vērtības pirmapstrādei.| | |step| |Saknes elements zema līmeņa atklāšanas noteikuma vērtības pirmapstrādes soļa elementiem, kas ir tādi paši kā [host vienuma vērtības pirmapstrādes soļiem](#host-item-preprocessing-steps), izņemot to, ka pieejamo vērtību ir mazāk. Skatiet arī: [LLD noteikuma pirmapstrādes objekts](/manual/api/reference/discoveryrule/object#lld-rule-preprocessing).| |overrides|<| |Saknes elements zema līmeņa atklāšanas noteikuma pārrakstīšanas noteikumiem.| |<|name|string|(obligāts) Unikāls pārrakstīšanas nosaukums.| |^|step|string|(obligāts) Pārrakstīšanas unikālais kārtas numurs.| |^|stop|string|Pārtraukt nākamo pārrakstīšanu apstrādi, ja sakrīt.| |^|filter| |Saknes elements zema līmeņa atklāšanas noteikuma pārrakstīšanas noteikuma filtra elementiem, kas ir tādi paši kā [host zema līmeņa atklāšanas noteikuma filtriem](#host-low-level-discovery-rule-filters).| |^|operations| |Saknes elements [host zema līmeņa atklāšanas noteikuma pārrakstīšanas darbībām](#host-low-level-discovery-rule-override-operations).| ::: noteclassic Skatiet arī: [LLD noteikuma objekts](/manual/api/reference/discoveryrule/object) (skatiet atbilstošo īpašību ar sakritīgu nosaukumu). ::: #### Host macro configuration To use VMware simple checks, the host must have the following user macros defined: - {$VMWARE.URL} - VMware service (vCenter or ESXi hypervisor) SDK URL (https://servername/sdk) - {$VMWARE.USERNAME} - VMware service user name - {$VMWARE.PASSWORD} - VMware service {$VMWARE.USERNAME} user password #### Hosts makro konfigurācija Lai izmantotu VMware vienkāršās pārbaudes, hostam ir jābūt definētiem šādiem lietotāja makro: - {$VMWARE.URL} - VMware pakalpojuma (vCenter vai ESXi hipervizora) SDK URL (https://servername/sdk) - {$VMWARE.USERNAME} - VMware pakalpojuma lietotājvārds - {$VMWARE.PASSWORD} - VMware pakalpojuma {$VMWARE.USERNAME} lietotāja parole ### Host macro The host macro object defines a macro available on a host, host prototype or template. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |hostmacroid|ID|ID of the host macro.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*<br>- *required* for update operations| |hostid|ID|ID of the host that the macro belongs to.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *constant*<br>- *required* for create operations| |macro|string|Macro string.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |value|string|Value of the macro.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *write-only* if `type` is set to "Secret macro"<br>- *required* for create operations| |type|integer|Type of macro.<br><br>Possible values:<br>0 - *(default)* Text macro;<br>1 - Secret macro;<br>2 - Vault secret.| |description|string|Description of the macro.| |automatic|integer|Defines whether the macro is controlled by discovery rule.<br><br>Possible values:<br>0 - *(default)* Macro is managed by user;<br>1 - Macro is managed by discovery rule.<br><br>User is not allowed to create automatic macro.<br>To update automatic macro, it must be [converted to manual](/manual/api/reference/usermacro/update#change-macro-value-that-was-created-by-discovery-rule).| ### Hosts makro Hosts makro objekts definē makro, kas ir pieejams uz hosta, hosta prototipa vai veidnes. Tam ir šādi rekvizīti. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |hostmacroid|ID|Hosta makro ID.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*<br>- *required* for update operations| |hostid|ID|Hosta ID, kuram pieder makro.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *constant*<br>- *required* for create operations| |macro|string|Makro virkne.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |value|string|Makro vērtība.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *write-only* if `type` is set to "Secret macro"<br>- *required* for create operations| |type|integer|Makro tips.<br><br>Possible values:<br>0 - *(default)* Teksta makro;<br>1 - Slepenais makro;<br>2 - Vault slepenais.| |description|string|Makro apraksts.| |automatic|integer|Nosaka, vai makro kontrolē atklāšanas noteikums.<br><br>Possible values:<br>0 - *(default)* Makro pārvalda lietotājs;<br>1 - Makro pārvalda atklāšanas noteikums.<br><br>Lietotājam nav atļauts izveidot automātisku makro.<br>Lai atjauninātu automātisku makro, tas ir [jāpārveido par manuālu](/manual/api/reference/usermacro/update#change-macro-value-that-was-created-by-discovery-rule).| Host markers displayed on the map have the color of the host's most serious problem and green color if a host has no problems. Clicking on a host marker allows viewing the host's visible name and the number of unresolved problems grouped by severity. Clicking on the visible name will open [host menu](/manual/web_interface/menu/host_menu). Hosts displayed on the map can be filtered by problem severity. Press on the filter icon in the widget's upper right corner and mark the required severities.  Kartē attēlotajiem hosts marķieriem ir tā hosta visnopietnākās problēmas krāsa, bet zaļa krāsa, ja hostam nav problēmu. Noklikšķinot uz hosta marķiera, var skatīt hosta redzamo nosaukumu un neatrisināto problēmu skaitu, kas grupēts pēc nopietnības. Noklikšķinot uz redzamā nosaukuma, tiks atvērta [hosta izvēlne](/manual/web_interface/menu/host_menu). Kartē attēlotos hosts var filtrēt pēc problēmu nopietnības. Nospiediet filtra ikonu logrīka augšējā labajā stūrī un atzīmējiet nepieciešamos nopietnības līmeņus.  # host.massadd # host.massadd # host.massremove # host.massremove # host.massupdate # host.massupdate ##### HostMetadata An optional parameter that defines the [metadata](/manual/discovery/auto_registration#using-host-metadata) used to identify or distinguish the host during the host [autoregistration](/manual/discovery/auto_registration) process (active agent). `HostMetadata` allows distinguishing between hosts beyond the hostname. If not defined, the value will be acquired from `HostMetadataItem`. The agent will issue an error and not start if the specified value is over the limit of 2034 bytes or a non-UTF-8 string. When a parameter expects an IP address or DNS name, values that are valid UTF-8 but are not valid IPs or DNS names will also be rejected and reported as invalid. Multi-line metadata is not supported — the output will be truncated at the first line break. Range: 0-2034 bytes ##### HostMetadata Neobligāts parametrs, kas definē [metadatus](/manual/discovery/auto_registration#using-host-metadata), ko izmanto, lai identificētu vai atšķirtu hostu hosta [autoreģistrācijas](/manual/discovery/auto_registration) procesa laikā (aktīvais aģents). `HostMetadata` ļauj atšķirt hostus ne tikai pēc hostname. Ja tas nav definēts, vērtība tiks iegūta no `HostMetadataItem`. Aģents ziņos par kļūdu un netiks palaists, ja norādītā vērtība pārsniedz 2034 baitus vai ir ne-UTF-8 virkne. Ja parametrs sagaida IP adresi vai DNS nosaukumu, tiks noraidītas un par nederīgām ziņotas arī vērtības, kas ir derīgs UTF-8, bet nav derīgas IP adreses vai DNS nosaukumi. Vairāku rindu metadati netiek atbalstīti — izvade tiks saīsināta pie pirmās rindiņas pārtraukuma. Diapazons: 0-2034 baiti ##### HostMetadata An optional parameter that defines the [metadata](/manual/discovery/auto_registration#using-host-metadata) used to identify or distinguish the host during the host [autoregistration](/manual/discovery/auto_registration) process (active agent). `HostMetadata` allows distinguishing between hosts beyond the hostname. If not defined, the value will be acquired from `HostMetadataItem`. The agent will issue an error and not start if the specified value is over the limit of 2034 bytes or a non-UTF-8 string. When a parameter expects an IP address or DNS name, values that are valid UTF-8 but are not valid IPs or DNS names will also be rejected and reported as invalid. Multi-line metadata is not supported — the output will be truncated at the first line break. Range: 0-2034 bytes ##### HostMetadata Neobligāts parametrs, kas definē [metadatus](/manual/discovery/auto_registration#using-host-metadata), ko izmanto, lai identificētu vai atšķirtu hostu hosta [autoregistrācijas](/manual/discovery/auto_registration) procesa laikā (aktīvais aģents). `HostMetadata` ļauj atšķirt hostus ne tikai pēc hostname. Ja tas nav definēts, vērtība tiks iegūta no `HostMetadataItem`. Aģents paziņos par kļūdu un netiks palaists, ja norādītā vērtība pārsniedz 2034 baitus vai ir ne-UTF-8 virkne. Ja parametrs sagaida IP adresi vai DNS nosaukumu, tiks noraidītas arī vērtības, kas ir derīgs UTF-8, bet nav derīgas IP adreses vai DNS nosaukumi, un tās tiks ziņotas kā nederīgas. Vairāku rindu metadati netiek atbalstīti — izvade tiks saīsināta pie pirmā rindu pārtraukuma. Diapazons: 0-2034 baiti ##### HostMetadata An optional parameter that defines the [metadata](/manual/discovery/auto_registration#using-host-metadata) used to identify or distinguish the host during the host [autoregistration](/manual/discovery/auto_registration) process (active agent). `HostMetadata` allows distinguishing between hosts beyond the hostname. If not defined, the value will be acquired from `HostMetadataItem`. The agent will issue an error and not start if the specified value is over the limit of 2034 bytes or a non-UTF-8 string. When a parameter expects an IP address or DNS name, values that are valid UTF-8 but are not valid IPs or DNS names will also be rejected and reported as invalid. Multi-line metadata is not supported — the output will be truncated at the first line break. Range: 0-2034 bytes ##### HostMetadata Neobligāts parametrs, kas definē [metadatus](/manual/discovery/auto_registration#using-host-metadata), ko izmanto, lai identificētu vai atšķirtu hostu hosta [autoregistrācijas](/manual/discovery/auto_registration) procesa laikā (aktīvais aģents). `HostMetadata` ļauj atšķirt hostus ne tikai pēc hostname. Ja tas nav definēts, vērtība tiks iegūta no `HostMetadataItem`. Aģents izsniegs kļūdu un netiks palaists, ja norādītā vērtība pārsniedz 2034 baitu limitu vai ir ne-UTF-8 virkne. Ja parametrs sagaida IP adresi vai DNS nosaukumu, tiks noraidītas arī vērtības, kas ir derīgs UTF-8, bet nav derīgas IP adreses vai DNS nosaukumi, un tās tiks ziņotas kā nederīgas. Vairākrindu metadati netiek atbalstīti — izvade tiks saīsināta pie pirmās rindas pārtraukuma. Diapazons: 0-2034 baiti ##### HostMetadata An optional parameter that defines the [metadata](/manual/discovery/auto_registration#using-host-metadata) used to identify or distinguish the host during the host [autoregistration](/manual/discovery/auto_registration) process. `HostMetadata` allows distinguishing between hosts beyond the hostname. If not defined, the value will be acquired from `HostMetadataItem`. The agent will issue an error and not start if the specified value is over the limit of 2034 bytes or a non-UTF-8 string. When a parameter expects an IP address or DNS name, values that are valid UTF-8 but are not valid IPs or DNS names will also be rejected and reported as invalid. Multi-line metadata is not supported — the output will be truncated at the first line break. Range: 0-2034 bytes ##### HostMetadata Neobligāts parametrs, kas definē [metadatus](/manual/discovery/auto_registration#using-host-metadata), ko izmanto, lai identificētu vai atšķirtu hostu hosta [autoregistrācijas](/manual/discovery/auto_registration) procesa laikā. `HostMetadata` ļauj atšķirt hostus ne tikai pēc hostname. Ja tas nav definēts, vērtība tiks iegūta no `HostMetadataItem`. aģents izsniegs kļūdu un netiks palaists, ja norādītā vērtība pārsniedz 2034 baitu limitu vai ir ne-UTF-8 virkne. Ja parametrs sagaida IP adresi vai DNS nosaukumu, tiks noraidītas arī vērtības, kas ir derīgs UTF-8, bet nav derīgas IP adreses vai DNS nosaukumi, un tās tiks ziņotas kā nederīgas. Vairākrindu metadati netiek atbalstīti — izvade tiks saīsināta pie pirmās rindiņas pārtraukuma. Diapazons: 0-2034 baiti ##### HostMetadataItem An optional parameter that defines a Zabbix agent item used to obtain [host metadata](/manual/discovery/auto_registration#using-host-metadata). This option is only used when `HostMetadata` is not defined. The `HostMetadataItem` value is retrieved on each [autoregistration](/manual/discovery/auto_registration) attempt and is used only at host autoregistration process (active agent). `HostMetadataItem` allows distinguishing between hosts beyond the hostname. User parameters and aliases are supported. The [system.run[]](/manual/config/items/itemtypes/zabbix_agent#system.run) item is supported regardless of `AllowKey`/`DenyKey` settings. During an autoregistration request the agent will log a warning message if the value returned by the specified item is over the limit of 65535 UTF-8 code points. The value returned by the item must be a UTF-8 string otherwise it will be ignored. When a parameter expects an IP address or DNS name, values that are valid UTF-8 but are not valid IPs or DNS names will also be rejected and reported as invalid. Multi-line metadata is not supported — the output will be truncated at the first line break. ##### HostMetadataItem Neobligāts parametrs, kas definē Zabbix aģenta vienumu, ko izmanto [hosts metadatu](/manual/discovery/auto_registration#using-host-metadata) iegūšanai. Šī opcija tiek izmantota tikai tad, ja `HostMetadata` nav definēts. `HostMetadataItem` vērtība tiek izgūta katra [autoregistrācijas](/manual/discovery/auto_registration) mēģinājuma laikā un tiek izmantota tikai hosts autoreģistrācijas procesā (aktīvais aģents). `HostMetadataItem` ļauj atšķirt hosts pēc vairāk nekā tikai hostname. Tiek atbalstīti lietotāja parametri un aizstājvārdi. Tiek atbalstīts [system.run[]](/manual/config/items/itemtypes/zabbix_agent#system.run) vienums neatkarīgi no `AllowKey`/`DenyKey` iestatījumiem. Autoreģistrācijas pieprasījuma laikā aģents reģistrēs brīdinājuma ziņojumu, ja norādītā vienuma atgrieztā vērtība pārsniedz 65535 UTF-8 koda punktu limitu. Vienuma atgrieztajai vērtībai jābūt UTF-8 virknei, pretējā gadījumā tā tiks ignorēta. Ja parametrs sagaida IP adresi vai DNS nosaukumu, vērtības, kas ir derīgs UTF-8, bet nav derīgas IP adreses vai DNS nosaukumi, arī tiks noraidītas un ziņotas kā nederīgas. Vairāku rindu metadati netiek atbalstīti — izvade tiks saīsināta pie pirmās rindas pārtraukuma. ##### HostMetadataItem An optional parameter that defines a Zabbix agent item used to obtain [host metadata](/manual/discovery/auto_registration#using-host-metadata). This option is only used when `HostMetadata` is not defined. The `HostMetadataItem` value is retrieved on each [autoregistration](/manual/discovery/auto_registration) attempt and is used only at host autoregistration process (active agent). `HostMetadataItem` allows distinguishing between hosts beyond the hostname. User parameters and aliases are supported. The [system.run[]](/manual/config/items/itemtypes/zabbix_agent#system.run) item is supported regardless of `AllowKey`/`DenyKey` settings. During an autoregistration request the agent will log a warning message if the value returned by the specified item is over the limit of 65535 UTF-8 code points. The value returned by the item must be a UTF-8 string otherwise it will be ignored. When a parameter expects an IP address or DNS name, values that are valid UTF-8 but are not valid IPs or DNS names will also be rejected and reported as invalid. Multi-line metadata is not supported — the output will be truncated at the first line break. ##### HostMetadataItem Neobligāts parametrs, kas definē Zabbix aģenta vienumu, ko izmanto [hosts metadatu](/manual/discovery/auto_registration#using-host-metadata) iegūšanai. Šī opcija tiek izmantota tikai tad, ja `HostMetadata` nav definēts. `HostMetadataItem` vērtība tiek izgūta katra [autoregistrācijas](/manual/discovery/auto_registration) mēģinājuma laikā un tiek izmantota tikai hosts autoreģistrācijas procesā (aktīvs aģents). `HostMetadataItem` ļauj atšķirt hosts pēc vairāk nekā tikai hostname. Tiek atbalstīti lietotāja parametri un aizstājvārdi. [system.run[]](/manual/config/items/itemtypes/zabbix_agent#system.run) vienums tiek atbalstīts neatkarīgi no `AllowKey`/`DenyKey` iestatījumiem. Autoregistrācijas pieprasījuma laikā aģents reģistrēs brīdinājuma ziņojumu, ja norādītā vienuma atgrieztā vērtība pārsniedz 65535 UTF-8 koda punktu limitu. Vienuma atgrieztajai vērtībai jābūt UTF-8 virknei, pretējā gadījumā tā tiks ignorēta. Ja parametrs sagaida IP adresi vai DNS nosaukumu, vērtības, kas ir derīgs UTF-8, bet nav derīgas IP adreses vai DNS nosaukumi, arī tiks noraidītas un atzīmētas kā nederīgas. Vairāku rindu metadati netiek atbalstīti — izvade tiks saīsināta pie pirmās rindiņas pārtraukuma. ##### HostMetadataItem An optional parameter that defines a Zabbix agent item used to obtain [host metadata](/manual/discovery/auto_registration#using-host-metadata). This option is only used when `HostMetadata` is not defined. The `HostMetadataItem` value is retrieved on each [autoregistration](/manual/discovery/auto_registration) attempt and is used only at host autoregistration process (active agent). `HostMetadataItem` allows distinguishing between hosts beyond the hostname. User parameters, performance counters and aliases are supported. The [`system.run[]`](/manual/config/items/itemtypes/zabbix_agent#system.run) item is supported regardless of `AllowKey`/`DenyKey` settings. During an autoregistration request the agent will log a warning message if the value returned by the specified item is over the limit of 65535 UTF-8 code points. The value returned by the item must be a UTF-8 string otherwise it will be ignored. When a parameter expects an IP address or DNS name, values that are valid UTF-8 but are not valid IPs or DNS names will also be rejected and reported as invalid. Multi-line metadata is not supported — the output will be truncated at the first line break. ##### HostMetadataItem Neobligāts parametrs, kas definē Zabbix aģenta vienumu, ko izmanto [hosts metadatu](/manual/discovery/auto_registration#using-host-metadata) iegūšanai. Šī opcija tiek izmantota tikai tad, ja `HostMetadata` nav definēts. `HostMetadataItem` vērtība tiek izgūta katrā [autoreģistrācijas](/manual/discovery/auto_registration) mēģinājumā un tiek izmantota tikai hosts autoreģistrācijas procesā (aktīvs aģents). `HostMetadataItem` ļauj atšķirt hosts ne tikai pēc hostname. Tiek atbalstīti lietotāja parametri, veiktspējas skaitītāji un aizstājvārdi. [`system.run[]`](/config/items/itemtypes/zabbix_agent#system.run) vienums tiek atbalstīts neatkarīgi no `AllowKey`/`DenyKey` iestatījumiem. Autoreģistrācijas pieprasījuma laikā aģents reģistrēs brīdinājuma ziņojumu, ja norādītā vienuma atgrieztā vērtība pārsniedz 65535 UTF-8 koda punktu limitu. Vienuma atgrieztajai vērtībai jābūt UTF-8 virknei, pretējā gadījumā tā tiks ignorēta. Ja parametrs sagaida IP adresi vai DNS nosaukumu, vērtības, kas ir derīgas UTF-8, bet nav derīgas IP adreses vai DNS nosaukumi, arī tiks noraidītas un atzīmētas kā nederīgas. Vairāku rindu metadati netiek atbalstīti — izvade tiks saīsināta pie pirmās rindiņas pārtraukuma. ##### HostMetadataItem An optional parameter that defines a Zabbix agent item used to obtain [host metadata](/manual/discovery/auto_registration#using-host-metadata). This option is only used when `HostMetadata` is not defined. The `HostMetadataItem` value is retrieved on each [autoregistration](/manual/discovery/auto_registration) attempt and is used only at host autoregistration process. `HostMetadataItem` allows distinguishing between hosts beyond the hostname. User parameters and aliases are supported. The [system.run[]](/manual/config/items/itemtypes/zabbix_agent#system.run) item is supported regardless of `AllowKey`/`DenyKey` settings. During an autoregistration request the agent will log a warning message if the value returned by the specified item is over the limit of 65535 UTF-8 code points. The value returned by the item must be a UTF-8 string otherwise it will be ignored. When a parameter expects an IP address or DNS name, values that are valid UTF-8 but are not valid IPs or DNS names will also be rejected and reported as invalid. Multi-line metadata is not supported — the output will be truncated at the first line break. ##### HostMetadataItem Neobligāts parametrs, kas definē Zabbix aģenta vienumu, ko izmanto, lai iegūtu [hosts metadatus](/manual/discovery/auto_registration#using-host-metadata). Šī opcija tiek izmantota tikai tad, ja `HostMetadata` nav definēts. `HostMetadataItem` vērtība tiek izgūta katrā [autoreģistrācijas](/manual/discovery/auto_registration) mēģinājumā un tiek izmantota tikai hosts autoreģistrācijas procesā. `HostMetadataItem` ļauj atšķirt hosts ne tikai pēc hostname. Tiek atbalstīti lietotāja parametri un aizstājvārdi. Tiek atbalstīts [system.run[]](/manual/config/items/itemtypes/zabbix_agent#system.run) vienums neatkarīgi no `AllowKey`/`DenyKey` iestatījumiem. Autoreģistrācijas pieprasījuma laikā aģents reģistrēs brīdinājuma ziņojumu, ja norādītā vienuma atgrieztā vērtība pārsniedz 65535 UTF-8 koda punktu limitu. Vienuma atgrieztajai vērtībai jābūt UTF-8 virknei, pretējā gadījumā tā tiks ignorēta. Ja parametrs sagaida IP adresi vai DNS nosaukumu, vērtības, kas ir derīgas UTF-8, bet nav derīgas IP adreses vai DNS nosaukumi, arī tiks noraidītas un ziņotas kā nederīgas. Vairākrindu metadati netiek atbalstīti — izvade tiks saīsināta pie pirmās rindiņas pārtraukuma. ##### Hostname A list of comma-delimited, unique, case-sensitive hostnames. Required for active checks and must match hostnames as configured on the server. The value is acquired from `HostnameItem` if undefined.<br>Allowed characters: alphanumeric, '.', ' ', '\_' and '-'. Maximum length: 128 characters per hostname, 2048 characters for the entire line. Default: Set by `HostnameItem` ##### Hostname Ar komatiem atdalīts, unikāls, reģistrjutīgs hostu nosaukumu saraksts. Nepieciešams aktīvajām pārbaudēm, un tam jāsakrīt ar hostu nosaukumiem, kas konfigurēti serverī. Vērtība tiek iegūta no `HostnameItem`, ja tā nav definēta.<br>Atļautās rakstzīmes: burtcipari, '.', ' ', '\_' un '-'. Maksimālais garums: 128 rakstzīmes katram hosta nosaukumam, 2048 rakstzīmes visai rindai. Noklusējums: iestatīts ar `HostnameItem` ##### Hostname A list of comma-delimited, unique, case-sensitive hostnames. Required for active checks and must match hostnames as configured on the server. The value is acquired from `HostnameItem` if undefined.<br>Allowed characters: alphanumeric, '.', ' ', '\_' and '-'. Maximum length: 128 characters per hostname, 2048 characters for the entire line. Default: Set by HostnameItem ##### Hostname Ar komatiem atdalīts, unikāls, reģistrjutīgs hostu nosaukumu saraksts. Nepieciešams aktīvajām pārbaudēm, un tam jāsakrīt ar serverī konfigurētajiem hostu nosaukumiem. Vērtība tiek iegūta no `HostnameItem`, ja tā nav definēta.<br>Atļautās rakstzīmes: burti un cipari, '.', ' ', '\_' un '-'. Maksimālais garums: 128 rakstzīmes katram hosta nosaukumam, 2048 rakstzīmes visai rindai. Noklusējums: iestatīts ar `HostnameItem` ##### Hostname A list of comma-delimited, unique, case-sensitive hostnames. Required for active checks and must match hostnames as configured on the server. The value is acquired from `HostnameItem` if undefined.<br>Allowed characters: alphanumeric, '.', ' ', '\_' and '-'. Maximum length: 128 characters per hostname, 2048 characters for the entire line. Default: Set by HostnameItem ##### Hostname Ar komatiem atdalīts, unikālu, reģistrjutīgu hostu nosaukumu saraksts. Nepieciešams aktīvajām pārbaudēm, un tam jāsakrīt ar hostu nosaukumiem, kā tie konfigurēti serverī. Vērtība tiek iegūta no `HostnameItem`, ja tā nav definēta.<br>Atļautās rakstzīmes: burtciparu rakstzīmes, '.', ' ', '\_' un '-'. Maksimālais garums: 128 rakstzīmes katram hosta nosaukumam, 2048 rakstzīmes visai rindai. Noklusējums: iestatīts ar `HostnameItem` ##### Hostname A list of comma-delimited, unique, case-sensitive hostnames. Required for active checks and must match hostnames as configured on the server. The value is acquired from HostnameItem if undefined.<br>Allowed characters: alphanumeric, '.', ' ', '\_' and '-'. Maximum length: 128 characters per hostname, 2048 characters for the entire line. Default: Set by HostnameItem ##### Hostname Ar komatiem atdalīts, unikāls, reģistrjutīgs hostu nosaukumu saraksts. Nepieciešams aktīvajām pārbaudēm, un tam jāsakrīt ar hostu nosaukumiem, kā tie konfigurēti serverī. Vērtība tiek iegūta no HostnameItem, ja tā nav definēta.<br>Atļautās rakstzīmes: burtcipari, '.', ' ', '\_' un '-'. Maksimālais garums: 128 rakstzīmes katram hosta nosaukumam, 2048 rakstzīmes visai rindai. Noklusējums: iestatīts ar HostnameItem ##### Hostname A unique, case sensitive proxy name. Make sure the proxy name is known to the server.<br>Allowed characters: alphanumeric, '.', ' ', '\_' and '-'. Maximum length: 128 Default: Set by HostnameItem ##### Hostname Unikāls, reģistrjutīgs starpniekservera nosaukums. Pārliecinieties, ka serveris zina starpniekservera nosaukumu.<br>Atļautās rakstzīmes: burti un cipari, '.', ' ', '\_' un '-'. Maksimālais garums: 128 Noklusējums: iestata HostnameItem ##### HostnameItem An optional parameter that defines an item used for getting the host name. This option is only used when `Hostname` is not defined. User parameters or aliases are not supported, but the [`system.run[]`](/manual/config/items/itemtypes/zabbix_agent#system.run) item is supported regardless of `AllowKey`/`DenyKey` values. Default: `system.hostname` ##### HostnameItem Neobligāts parametrs, kas definē vienumu, ko izmanto hosta nosaukuma iegūšanai. Šī opcija tiek izmantota tikai tad, ja `Hostname` nav definēts. Lietotāja parametri vai aizstājvārdi netiek atbalstīti, taču [`system.run[]`](/manual/config/items/itemtypes/zabbix_agent#system.run) vienums tiek atbalstīts neatkarīgi no `AllowKey`/`DenyKey` vērtībām. Noklusējums: `system.hostname` ##### HostnameItem An optional parameter that defines an item used for getting the host name. This option is only used when `Hostname` is not defined. User parameters or aliases are not supported, but the [system.run[]](/manual/config/items/itemtypes/zabbix_agent#system.run) item is supported regardless of AllowKey/DenyKey values. Default: `system.hostname` ##### HostnameItem Neobligāts parametrs, kas nosaka vienumu, ko izmanto hosta nosaukuma iegūšanai. Šī opcija tiek izmantota tikai tad, ja `Hostname` nav definēts. Lietotāja parametri vai aizstājvārdi netiek atbalstīti, taču [system.run[]](/manual/config/items/itemtypes/zabbix_agent#system.run) vienums tiek atbalstīts neatkarīgi no AllowKey/DenyKey vērtībām. Noklusējums: `system.hostname` ##### HostnameItem An optional parameter that defines a Zabbix agent item used for getting the host name. This option is only used when `Hostname` is not defined. User parameters or aliases are not supported, but the [`system.run[]`](/manual/config/items/itemtypes/zabbix_agent#system.run) item is supported regardless of `AllowKey`/`DenyKey` values. Default: `system.hostname` ##### HostnameItem Neobligāts parametrs, kas definē Zabbix aģenta vienumu, ko izmanto hosta nosaukuma iegūšanai. Šī opcija tiek izmantota tikai tad, ja `Hostname` nav definēts. Lietotāja parametri vai aizstājvārdi netiek atbalstīti, taču [`system.run[]`](/manual/config/items/itemtypes/zabbix_agent#system.run) vienums tiek atbalstīts neatkarīgi no `AllowKey`/`DenyKey` vērtībām. Noklusējums: `system.hostname` ##### HostnameItem An optional parameter that defines a Zabbix agent item used for getting the host name. This option is only used when `Hostname` is not defined. User parameters, performance counters or aliases are not supported, but the [system.run[]](/manual/config/items/itemtypes/zabbix_agent#system.run) item is supported regardless of `AllowKey`/`DenyKey` values.<br>See also a [more detailed description](/manual/appendix/install/windows_agent#configuration). Default: `system.hostname` ##### HostnameItem Neobligāts parametrs, kas nosaka Zabbix aģenta vienumu, ko izmanto hosta nosaukuma iegūšanai. Šī opcija tiek izmantota tikai tad, ja `Hostname` nav definēts. Lietotāja parametri, veiktspējas skaitītāji vai aizstājvārdi netiek atbalstīti, taču [system.run[]](/manual/config/items/itemtypes/zabbix_agent#system.run) vienums tiek atbalstīts neatkarīgi no `AllowKey`/`DenyKey` vērtībām.<br>Skatiet arī [detalizētāku aprakstu](/manual/appendix/install/windows_agent#configuration). Noklusējums: `system.hostname` ##### HostnameItem The item used for setting `Hostname` if it is undefined (this will be run on the proxy similarly as on an agent). Ignored if `Hostname` is set.<br>Does not support `UserParameters`, performance counters or aliases, but does support `system.run[]`. Default: system.hostname ##### HostnameItem Vienums, ko izmanto `Hostname` iestatīšanai, ja tas nav definēts (tas tiks izpildīts starpniekserverī tāpat kā aģentā). Tiek ignorēts, ja `Hostname` ir iestatīts.<br>Nepieļauj `UserParameters`, veiktspējas skaitītājus vai aizstājvārdus, bet atbalsta `system.run[]`. Noklusējums: system.hostname ##### Hostname parameter To perform [active checks](/manual/appendix/items/activepassive#active-checks) on a host Zabbix agent needs to have the hostname defined. Moreover, the hostname value set on the agent side should exactly match the "[Host name](/manual/config/hosts/host)" configured for the host in the frontend. The hostname value on the agent side can be defined by either the **Hostname** or **HostnameItem** parameter in the agent [configuration file](/manual/appendix/config/zabbix_agentd_win) - or the default values are used if any of these parameters are not specified. The default value for **HostnameItem** parameter is the value returned by the "system.hostname" agent key. For Windows, it returns result of the gethostname() function, which queries namespace providers to determine the local host name. If no namespace provider responds, the NetBIOS name is returned. The default value for **Hostname** is the value returned by the HostnameItem parameter. So, in effect, if both these parameters are unspecified, the actual hostname will be the host NetBIOS name; Zabbix agent will use NetBIOS host name to retrieve the list of active checks from Zabbix server and send results to it. The "system.hostname" key supports two optional parameters - *type* and *transform*. *Type* determines the type of the name the item should return: - *netbios* (default) - returns the NetBIOS host name which is limited to 15 symbols and is in the UPPERCASE only; - *host* - case-sensitive, returns the full, real Windows host name (without a domain); - *shorthost* - returns part of the hostname before the first dot. It will return a full string if the name does not contain a dot. - *fqdn* - returns Fully Qualified Domain Name (without the trailing dot). *Transform* allows to specify additional transformation rule for the hostname: - *none* (default) - use the original letter case; - *lower* - convert the text into lowercase. So, to simplify the configuration of zabbix\_agentd.conf file and make it unified, three different approaches can be used: 1. Leave **Hostname** or **HostnameItem** parameters undefined and Zabbix agent will use NetBIOS host name as the hostname. 2. Leave **Hostname** parameter undefined and define **HostnameItem** like this:<br> **HostnameItem=system.hostname\[host\]** - for Zabbix agent to use the full, real (case-sensitive) Windows host name as the hostname.<br> **HostnameItem=system.hostname\[shorthost,lower\]** - for Zabbix agent to use only part of the hostname before the first dot, converted into lowercase.<br> **HostnameItem=system.hostname\[fqdn\]** - for Zabbix agent to use the Fully Qualified Domain Name as the hostname. Host name is also used as part of Windows service name which is used for installing, starting, stopping and uninstalling the Windows service. For example, if Zabbix agent configuration file specifies `Hostname=Windows_db_server`, then the agent will be installed as a Windows service "`Zabbix Agent [Windows_db_server]`". Therefore, to have a different Windows service name for each Zabbix agent instance, each instance must use a different host name. ##### 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. ##### Host naming When adding hosts, a host name is the result of reverse DNS lookup or IP address if reverse lookup fails. Lookup is performed from the Zabbix server or Zabbix proxy, depending on which is doing the discovery. If lookup fails on the proxy, it is not retried on the server. If the host with such a name already exists, the next host would get **\_2** appended to the name, then **\_3** and so on. It is also possible to override DNS/IP lookup and instead use an item value for host name, for example: - You may discover multiple servers with Zabbix agent running using a Zabbix agent item for discovery and assign proper names to them automatically, based on the string value returned by this item - You may discover multiple SNMP network devices using an SNMP agent item for discovery and assign proper names to them automatically, based on the string value returned by this item If the host name has been set using an item value, it is not updated during the following discovery checks. If it is not possible to set host name using an item value, default value (DNS name) is used. If a host already exists with the discovered IP address and the discovery source (Zabbix server, proxy or proxy group) has not changed, a new host is not created. If the discovery source differs, the discovered entity is treated as distinct and a new host may be created. However, if the discovery action contains operations (link template, add to host group, etc), they are performed on the existing host that matches by IP address, interface type and discovery source. ##### Hostu nosaukumu piešķiršana Pievienojot hostus, hosta nosaukums tiek noteikts pēc reversās DNS uzmeklēšanas rezultāta vai IP adreses, ja reversā uzmeklēšana neizdodas. Uzmeklēšanu veic Zabbix serveris vai Zabbix starpniekserveris atkarībā no tā, kurš veic atklāšanu. Ja uzmeklēšana neizdodas starpniekserverī, tā netiek atkārtota serverī. Ja hosts ar šādu nosaukumu jau pastāv, nākamajam hostam nosaukumam tiks pievienots **\_2**, pēc tam **\_3** un tā tālāk. Ir iespējams arī ignorēt DNS/IP uzmeklēšanu un tā vietā hosta nosaukumam izmantot vienuma vērtību, piemēram: - Varat atklāt vairākus serverus ar darbojošos Zabbix aģentu, izmantojot Zabbix aģenta vienumu atklāšanai, un automātiski piešķirt tiem atbilstošus nosaukumus, pamatojoties uz šī vienuma atgriezto virknes vērtību - Varat atklāt vairākas SNMP tīkla ierīces, izmantojot SNMP aģenta vienumu atklāšanai, un automātiski piešķirt tām atbilstošus nosaukumus, pamatojoties uz šī vienuma atgriezto virknes vērtību Ja hosta nosaukums ir iestatīts, izmantojot vienuma vērtību, turpmāko atklāšanas pārbaužu laikā tas netiek atjaunināts. Ja nav iespējams iestatīt hosta nosaukumu, izmantojot vienuma vērtību, tiek izmantota noklusējuma vērtība (DNS nosaukums). Ja hosts ar atklāto IP adresi jau pastāv un atklāšanas avots (Zabbix serveris, starpniekserveris vai starpniekserveru grupa) nav mainījies, jauns hosts netiek izveidots. Ja atklāšanas avots atšķiras, atklātā entītija tiek uzskatīta par atsevišķu, un var tikt izveidots jauns hosts. Tomēr, ja atklāšanas darbība satur operācijas (veidnes piesaiste, pievienošana hostu grupai utt.), tās tiek izpildītas esošajam hostam, kas atbilst pēc IP adreses, saskarnes tipa un atklāšanas avota. #### Host navigator and Item navigator *Host navigator* and *Item navigator* widgets have been added to [dashboard widgets](/manual/web_interface/frontend_sections/dashboards/widgets). These widgets display hosts or items, respectively, based on various filtering and grouping options, and allow to control the information displayed in other widgets based on the selected host or item. For more information, see [*Host navigator*](/manual/web_interface/frontend_sections/dashboards/widgets/host_navigator) and [*Item navigator*](/manual/web_interface/frontend_sections/dashboards/widgets/item_navigator). {width="600"} #### Hosts navigator un vienums navigator *Hosts navigator* un *Vienums navigator* sīklietotnes ir pievienotas [informācijas paneļa sīklietotnēm](/manual/web_interface/frontend_sections/dashboards/widgets). Šīs sīklietotnes attēlo hosts vai vienumus atkarībā no dažādām filtrēšanas un grupēšanas opcijām, kā arī ļauj kontrolēt citās sīklietotnēs attēloto informāciju, pamatojoties uz atlasīto hostu vai vienumu. Papildinformāciju skatiet [*Hosts navigator*](/manual/web_interface/frontend_sections/dashboards/widgets/host_navigator) un [*Vienums navigator*](/manual/web_interface/frontend_sections/dashboards/widgets/item_navigator). {width="600"} # Host object The following objects are directly related to the host API. # Hosta objekts Tālāk norādītie objekti ir tieši saistīti ar hosta API. # hostprototype.create # hostprototype.create # hostprototype.delete # hostprototype.delete # hostprototype.get # hostprototype.get # Host prototype object The following objects are directly related to the `hostprototype` API. # Hosta prototipa objekts Tālāk norādītie objekti ir tieši saistīti ar `hostprototype` API. Host prototypes are blueprints for creating hosts through [low-level discovery](/manual/discovery/low_level_discovery) rules. Before being discovered as hosts, these prototypes cannot have items and triggers, except those linked from templates. Hostu prototipi ir rasējumi hostu izveidei, izmantojot [zemā līmeņa atklāšanas](/manual/discovery/low_level_discovery) noteikumus. Pirms tie tiek atklāti kā hosti, šiem prototipiem nevar būt vienumi un trigeri, izņemot tos, kas ir piesaistīti no veidnēm. ### Host prototype tag The host prototype tag object has the following properties. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |tag|string|Host prototype tag name.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |value|string|Host prototype tag value.| ### Hosts prototipa taga Hosts prototipa taga objekts satur šādas īpašības. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |tag|string|Hosts prototipa taga nosaukums.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |value|string|Hosts prototipa taga vērtība.| ### Host prototype The host prototype object has the following properties. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |hostid|ID|ID of the host prototype.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*<br>- *required* for update operations| |host|string|Technical name of the host prototype.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations<br>- *read-only* for inherited objects| |name|string|Visible name of the host prototype.<br><br>Default: `host` property value.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only* for inherited objects| |status|integer|Status of the host prototype.<br><br>Possible values:<br>0 - *(default)* monitored host;<br>1 - unmonitored host.| |inventory\_mode|integer|Host inventory population mode.<br><br>Possible values:<br>-1 - *(default)* disabled;<br>0 - manual;<br>1 - automatic.| |templateid|ID|ID of the parent template host prototype.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |discover|integer|Host prototype discovery status.<br><br>Possible values:<br>0 - *(default)* new hosts will be discovered;<br>1 - new hosts will not be discovered and existing hosts will be marked as lost.| |custom\_interfaces|integer|Source of [custom interfaces](#custom-interface) for hosts created by the host prototype.<br><br>Possible values:<br>0 - *(default)* inherit interfaces from parent host;<br>1 - use host prototypes custom interfaces.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only* for inherited objects| |uuid|string|Universal unique identifier, used for linking imported host prototypes to already existing ones. Auto-generated, if not given.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if the host prototype belongs to a template| ### Hosts prototips Hosts prototipa objektam ir šādas īpašības. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |hostid|ID|Hosts prototipa ID.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*<br>- *required* for update operations| |host|string|Hosts prototipa tehniskais nosaukums.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations<br>- *read-only* for inherited objects| |name|string|Hosts prototipa redzamais nosaukums.<br><br>Default: `host` property value.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only* for inherited objects| |status|integer|Hosts prototipa statuss.<br><br>Possible values:<br>0 - *(default)* monitored host;<br>1 - unmonitored host.| |inventory\_mode|integer|Hosts inventāra aizpildīšanas režīms.<br><br>Possible values:<br>-1 - *(default)* disabled;<br>0 - manual;<br>1 - automatic.| |templateid|ID|Vecākveidnes hosts prototipa ID.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |discover|integer|Hosts prototipa atklāšanas statuss.<br><br>Possible values:<br>0 - *(default)* new hosts will be discovered;<br>1 - new hosts will not be discovered and existing hosts will be marked as lost.| |custom\_interfaces|integer|[Pielāgoto saskarņu](#custom-interface) avots hostiem, ko izveido hosts prototips.<br><br>Possible values:<br>0 - *(default)* inherit interfaces from parent host;<br>1 - use host prototypes custom interfaces.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only* for inherited objects| |uuid|string|Universāls unikāls identifikators, ko izmanto importētu hosts prototipu sasaistīšanai ar jau esošajiem. Ja nav norādīts, tiek ģenerēts automātiski.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if the host prototype belongs to a template| # Host prototype This class is designed to work with host prototypes. Object references: - [Host prototype](/manual/api/reference/hostprototype/object#host-prototype) - [Group link](/manual/api/reference/hostprototype/object#group-link) - [Group prototype](/manual/api/reference/hostprototype/object#group-prototype) - [Host prototype tag](/manual/api/reference/hostprototype/object#host-prototype-tag) - [Custom interface](/manual/api/reference/hostprototype/object#custom-interface) - [Custom interface details](/manual/api/reference/hostprototype/object#custom-interface-details) Available methods: - [hostprototype.create](/manual/api/reference/hostprototype/create) - create new host prototypes - [hostprototype.delete](/manual/api/reference/hostprototype/delete) - delete host prototypes - [hostprototype.get](/manual/api/reference/hostprototype/get) - retrieve host prototypes - [hostprototype.update](/manual/api/reference/hostprototype/update) - update host prototypes # Hosta prototips Šī klase ir paredzēta darbam ar hostu prototipiem. Objektu atsauces: - [Hosta prototips](/manual/api/reference/hostprototype/object#host-prototype) - [Grupas saite](/manual/api/reference/hostprototype/object#group-link) - [Grupas prototips](/manual/api/reference/hostprototype/object#group-prototype) - [Hosta prototipa tags](/manual/api/reference/hostprototype/object#host-prototype-tag) - [Pielāgota saskarne](/manual/api/reference/hostprototype/object#custom-interface) - [Pielāgotas saskarnes informācija](/manual/api/reference/hostprototype/object#custom-interface-details) Pieejamās metodes: - [hostprototype.create](/manual/api/reference/hostprototype/create) - izveidot jaunus hostu prototipus - [hostprototype.delete](/manual/api/reference/hostprototype/delete) - dzēst hostu prototipus - [hostprototype.get](/manual/api/reference/hostprototype/get) - izgūt hostu prototipus - [hostprototype.update](/manual/api/reference/hostprototype/update) - atjaunināt hostu prototipus # hostprototype.update # hostprototype.update #### hostprototype [ZBX-23284](https://support.zabbix.com/browse/ZBX-23284) `hostprototype.get`, `hostprototype.update`: returned support for `group_prototypeid` property of Group prototype objects. #### hostprototype [ZBX-23284](https://support.zabbix.com/browse/ZBX-23284) `hostprototype.get`, `hostprototype.update`: atgriezts atbalsts `group_prototypeid` īpašumam grupas prototipa objektos. #### Host redistribution Proxy load balancing and high availability is managed by Zabbix server via the [proxy group manager](/manual/concepts/server#server-process-types-and-threads), which continuously monitors the state of all proxies in each proxy group and their host distribution. Proxy high availability within a group is ensured via proxy failover: when a proxy goes offline, its hosts are immediately redistributed to other proxies. Proxy load balancing also occurs, as hosts are reassigned to proxies with the fewest assigned hosts. Additionally, proxy load balancing is triggered when proxy host count differs from the group average by at least 10 hosts and a factor of 2 (host excess or host deficit). If the imbalance persists after a grace period (10 x [failover delay](#configuring-a-proxy-group)), the proxy group is queued for host redistribution. The proxy group manager redistributes hosts using the following logic: 1. Calculate the average number of hosts per proxy. 2. For proxies with host excess—move the excess hosts to the unassigned pool of proxies. 3. For proxies with host deficit—calculate how many hosts are needed to reach balance. 4. Remove the required number of hosts from proxies with the most hosts. 5. Move unassigned hosts to proxies with the fewest hosts. Examples of host redistribution: |Hosts on proxy|Group average|Host reassignment| |-|-|-| |100|50|Yes| |60|50|No| |40|50|No| |25|50|Yes| |15|5|Yes| |10|5|No| ::: noteimportant Having fewer than 10 hosts [monitored by](/manual/config/hosts/host#configuration) a proxy group may lead to uneven host distribution among proxies in the group. ::: #### Hostu pārdale Starpniekserveru slodzes līdzsvarošanu un augstu pieejamību pārvalda Zabbix serveris, izmantojot [starpniekserveru grupas pārvaldnieku](/manual/concepts/server#server-process-types-and-threads), kas nepārtraukti uzrauga visu katras starpniekserveru grupas starpniekserveru stāvokli un to hostu sadalījumu. Starpniekserveru augsta pieejamība grupā tiek nodrošināta ar starpniekserveru pārslēgšanos atteices gadījumā: kad starpniekserveris kļūst bezsaistē, tā hosti tiek nekavējoties pārdalīti citiem starpniekserveriem. Notiek arī starpniekserveru slodzes līdzsvarošana, jo hosti tiek atkārtoti piešķirti starpniekserveriem ar vismazāko piešķirto hostu skaitu. Papildus tam starpniekserveru slodzes līdzsvarošana tiek aktivizēta, ja starpniekservera hostu skaits atšķiras no grupas vidējā rādītāja vismaz par 10 hostiem un 2 reizes (hostu pārpalikums vai hostu trūkums). Ja nelīdzsvarotība saglabājas pēc nogaidīšanas perioda (10 x [pārslēgšanās aizture](#configuring-a-proxy-group)), starpniekserveru grupa tiek ievietota hostu pārdales rindā. Starpniekserveru grupas pārvaldnieks pārdala hostus, izmantojot šādu loģiku: 1. Aprēķina vidējo hostu skaitu uz vienu starpniekserveri. 2. Starpniekserveriem ar hostu pārpalikumu — pārvieto liekos hostus uz nepiešķirto starpniekserveru kopu. 3. Starpniekserveriem ar hostu trūkumu — aprēķina, cik hostu nepieciešams, lai sasniegtu līdzsvaru. 4. No starpniekserveriem ar vislielāko hostu skaitu noņem nepieciešamo hostu skaitu. 5. Pārvieto nepiešķirtos hostus uz starpniekserveriem ar vismazāko hostu skaitu. Hostu pārdales piemēri: |Hosti uz starpniekservera|Grupas vidējais rādītājs|Hostu atkārtota piešķiršana| |-|-|-| |100|50|Jā| |60|50|Nē| |40|50|Nē| |25|50|Jā| |15|5|Jā| |10|5|Nē| ::: noteimportant Ja starpniekserveru grupa [uzrauga](/manual/config/hosts/host#configuration) mazāk nekā 10 hostus, tas var izraisīt nevienmērīgu hostu sadalījumu starp grupas starpniekserveriem. ::: ##### Host removal Hosts discovered by a network discovery rule are removed automatically from *Monitoring* > *Discovery* if a discovered entity is not in the rule's IP range any more. Hosts are removed immediately. ##### Hostu noņemšana Hosti, ko atklāj tīkla atklāšanas kārtula, tiek automātiski noņemti no *Monitoring* > *Discovery*, ja atklātā entītija vairs neatrodas kārtulas IP diapazonā. Hosti tiek noņemti nekavējoties. #### Hosts and host groups Manage host groups, hosts and everything related to them, including host interfaces, host macros and maintenance periods. [Host API](/manual/api/reference/host) | [Host group API](/manual/api/reference/hostgroup) | [Host interface API](/manual/api/reference/hostinterface) | [User macro API](/manual/api/reference/usermacro) | [Value map API](/manual/api/reference/valuemap) | [Maintenance API](/manual/api/reference/maintenance) #### Hosti un hostu grupas Pārvaldiet hostu grupas, hostus un visu ar tiem saistīto, tostarp hostu saskarnes, hostu makrosus un uzturēšanas periodus. [Host API](/manual/api/reference/host) | [Host group API](/manual/api/reference/hostgroup) | [Host interface API](/manual/api/reference/hostinterface) | [User macro API](/manual/api/reference/usermacro) | [Value map API](/manual/api/reference/valuemap) | [Maintenance API](/manual/api/reference/maintenance) ### Hosts and items ### Hosts un vienumi ### Hosts |Element|<|Type|Description| |-|---|---|-----------------------| |host|<|string|(required) Unique host name.| |name|<|string|Visible host name.| |description|<|text|Host description.| |monitored_by|<|string|Host is monitored by: SERVER, PROXY, or PROXY_GROUP.| |proxy|<| |Root element for proxy.| | |name|string|(required) Name of the proxy (if any) that monitors the host.| |proxy_group|<| |Root element for proxy group.| | |name|string|(required) Name of the proxy group (if any) that is used to monitor the host.| |status|<|string|Host status.<br>Possible values:^[1](#footnotes)^ ENABLED (0, default), DISABLED (1).| |ipmi\_authtype|<|string|IPMI session authentication type.<br>Possible values:^[1](#footnotes)^ DEFAULT (-1, default), NONE (0), MD2 (1), MD5 (2), STRAIGHT (4), OEM (5), RMCP\_PLUS (6).| |ipmi\_privilege|<|string|IPMI session privilege level.<br>Possible values:^[1](#footnotes)^ CALLBACK (1), USER (2, default), OPERATOR (3), ADMIN (4), OEM (5).| |ipmi\_username|<|string|Username for IPMI checks.| |ipmi\_password|<|string|Password for IPMI checks.| |templates|<| |Root element for linked templates.| | |name|string|(required) Template name.| |groups|<| |Root element for host groups to which the host belongs.| | |name|string|(required) Host group name.| |interfaces|<| |Root element for [host interfaces](#host-interfaces).| |items|<| |Root element for [host items](#host-items).| |discovery_rules|<| |Root element for [host low-level discovery rules](#host-low-level-discovery-rules).| |http_tests|<| |Root element for [host web scenarios](#host-web-scenarios).| |tags|<| |Root element for host tags.| |<|tag|string|(required) Tag name.| |^|value|string|Tag value.| |macros|<| |Root element for host macros.| |<|macro|string|(required) User macro name.| |^|type|string|User macro type.<br>Possible values:^[1](#footnotes)^ TEXT (0, default), SECRET\_TEXT (1), VAULT (2).| |^|value|string|User macro value.| |^|description|string|User macro description.| |inventory|<| |Root element for host inventory.| | |<inventory\_property>|string|Inventory property. All properties have their respective element (`type`, `name`, `os`, etc.; for example, see [Export format](#export-format)).| |inventory\_mode|<|string|Inventory mode.<br>Possible values:^[1](#footnotes)^ DISABLED (-1), MANUAL (0, default), AUTOMATIC (1).| |valuemaps|<| |Root element for [host value maps](#host-value-maps).| ::: noteclassic See also: [Host object](/manual/api/reference/host/object) (refer to the relevant property with a matching name). ::: ### Hosts |Element|<|Type|Description| |-|---|---|-----------------------| |host|<|string|(required) Unikāls hosts nosaukums.| |name|<|string|Redzamais hosts nosaukums.| |description|<|text|Hosts apraksts.| |monitored_by|<|string|Hosts tiek uzraudzīts ar: SERVER, PROXY vai PROXY_GROUP.| |proxy|<| |Saknes elements starpniekserverim.| | |name|string|(required) Starpniekservera nosaukums (ja tāds ir), kas uzrauga hosts.| |proxy_group|<| |Saknes elements starpniekserveru grupai.| | |name|string|(required) Starpniekserveru grupas nosaukums (ja tāda ir), kas tiek izmantota hosts uzraudzībai.| |status|<|string|Hosts statuss.<br>Iespējamās vērtības:^[1](#footnotes)^ ENABLED (0, default), DISABLED (1).| |ipmi\_authtype|<|string|IPMI sesijas autentifikācijas tips.<br>Iespējamās vērtības:^[1](#footnotes)^ DEFAULT (-1, default), NONE (0), MD2 (1), MD5 (2), STRAIGHT (4), OEM (5), RMCP\_PLUS (6).| |ipmi\_privilege|<|string|IPMI sesijas privilēģiju līmenis.<br>Iespējamās vērtības:^[1](#footnotes)^ CALLBACK (1), USER (2, default), OPERATOR (3), ADMIN (4), OEM (5).| |ipmi\_username|<|string|Lietotājvārds IPMI pārbaudēm.| |ipmi\_password|<|string|Parole IPMI pārbaudēm.| |templates|<| |Saknes elements saistītajām veidnēm.| | |name|string|(required) Veidnes nosaukums.| |groups|<| |Saknes elements hosts grupām, kurām hosts pieder.| | |name|string|(required) Hosts grupas nosaukums.| |interfaces|<| |Saknes elements [hosts saskarnēm](#host-interfaces).| |items|<| |Saknes elements [hosts vienumiem](#host-items).| |discovery_rules|<| |Saknes elements [hosts zema līmeņa atklāšanas noteikumiem](#host-low-level-discovery-rules).| |http_tests|<| |Saknes elements [hosts tīmekļa scenārijiem](#host-web-scenarios).| |tags|<| |Saknes elements hosts tagiem.| |<|tag|string|(required) Taga nosaukums.| |^|value|string|Taga vērtība.| |macros|<| |Saknes elements hosts makro.| |<|macro|string|(required) Lietotāja makro nosaukums.| |^|type|string|Lietotāja makro tips.<br>Iespējamās vērtības:^[1](#footnotes)^ TEXT (0, default), SECRET\_TEXT (1), VAULT (2).| |^|value|string|Lietotāja makro vērtība.| |^|description|string|Lietotāja makro apraksts.| |inventory|<| |Saknes elements hosts inventāram.| | |<inventory\_property>|string|Inventāra īpašība. Visām īpašībām ir attiecīgais elements (`type`, `name`, `os` utt.; piemēram, skatiet [Export format](#export-format)).| |inventory\_mode|<|string|Inventāra režīms.<br>Iespējamās vērtības:^[1](#footnotes)^ DISABLED (-1), MANUAL (0, default), AUTOMATIC (1).| |valuemaps|<| |Saknes elements [hosts vērtību kartēm](#host-value-maps).| ::: noteclassic Skatiet arī: [Host object](/manual/api/reference/host/object) (skatiet attiecīgo īpašību ar atbilstošu nosaukumu). ::: #### Hosts/host prototypes In a [host](/manual/config/hosts/host) and [host prototype](/manual/vm_monitoring/example#create-a-host-prototype) configuration, user macros can be used in the following fields: |Location|<|Multiple macros/mix with text^[1](supported_by_location_user#footnotes)^| |-|------------------------------|----------| |Interface IP/DNS|<|DNS only| |Interface port|<|no| |*SNMP v1, v2*|<|<| | |SNMP community|yes| |*SNMP v3*|<|<| | |Context name|yes| |^|Security name|yes| |^|Authentication passphrase|yes| |^|Privacy passphrase|yes| |*IPMI*|<|<| | |Username|yes| |^|Password|yes| |*Tags*^[2](supported_by_location_user#footnotes)^|<|<| | |Tag names|yes| |^|Tag values|yes| #### Hosti/hostu prototipi [hosta](/manual/config/hosts/host) un [hosta prototipa](/manual/vm_monitoring/example#create-a-host-prototype) konfigurācijā lietotāja makrosus var izmantot šādos laukos: |Atrašanās vieta|<|Vairāki makrosi/sajaukums ar tekstu^[1](supported_by_location_user#footnotes)^| |-|------------------------------|----------| |Saskarnes IP/DNS|<|tikai DNS| |Saskarnes ports|<|nē| |*SNMP v1, v2*|<|<| | |SNMP kopiena|jā| |*SNMP v3*|<|<| | |Konteksta nosaukums|jā| |^|Drošības nosaukums|jā| |^|Autentifikācijas parole|jā| |^|Privātuma parole|jā| |*IPMI*|<|<| | |Lietotājvārds|jā| |^|Parole|jā| |*Birkas*^[2](supported_by_location_user#footnotes)^|<|<| | |Birku nosaukumi|jā| |^|Birku vērtības|jā| ### Hosts |Macro|Supported in|Description| |--|--------|--------| |{HOST.CONN}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ Map element labels, map URL names and values<br>→ Item key parameters^[1](supported_by_location#footnotes)^<br>→ Host interface IP/DNS<br>→ Trapper item "Allowed hosts" field<br>→ Database monitoring additional parameters<br>→ SSH and Telnet scripts<br>→ JMX item endpoint field<br>→ Web monitoring^[4](supported_by_location#footnotes)^<br>→ Low-level discovery rule filter regular expressions<br>→ URL field of dynamic URL dashboard widget<br>→ Trigger names, event names, operational data and descriptions<br>→ Trigger URLs<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Script-type item and Browser-type item, item prototype and discovery rule parameter names and values<br>→ HTTP agent type item, item prototype and discovery rule fields:<br>URL, Query fields, Request body, Headers, SSL certificate file, SSL key file, Allowed hosts.<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Host IP address or DNS name, depending on host settings*^[2](supported_by_location#footnotes)^.<br><br>May be used with a numeric index as {HOST.CONN[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{HOST.DESCRIPTION}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ Map element labels<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Host description.*<br><br>This macro may be used with a numeric index e.g. {HOST.DESCRIPTION[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{HOST.DNS}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ Map element labels, map URL names and values<br>→ Item key parameters^[1](supported_by_location#footnotes)^<br>→ Host interface IP/DNS<br>→ Trapper item "Allowed hosts" field<br>→ Database monitoring additional parameters<br>→ SSH and Telnet scripts<br>→ JMX item endpoint field<br>→ Web monitoring^[4](supported_by_location#footnotes)^<br>→ Low-level discovery rule filter regular expressions<br>→ URL field of dynamic URL dashboard widget<br>→ Trigger names, event names, operational data and descriptions<br>→ Trigger URLs<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Script-type item and Browser-type item, item prototype and discovery rule parameter names and values<br>→ HTTP agent type item, item prototype and discovery rule fields:<br>URL, Query fields, Request body, Headers, SSL certificate file, SSL key file, Allowed hosts.<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Host DNS name*^[2](supported_by_location#footnotes)^.<br><br>This macro may be used with a numeric index e.g. {HOST.DNS[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{HOST.HOST}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications<br>→ Item key parameters<br>→ Map element labels, map URL names and values<br>→ Host interface IP/DNS<br>→ Trapper item "Allowed hosts" field<br>→ Database monitoring additional parameters<br>→ SSH and Telnet scripts<br>→ JMX item endpoint field<br>→ Web monitoring^[4](supported_by_location#footnotes)^<br>→ Low-level discovery rule filter regular expressions<br>→ URL field of dynamic URL dashboard widget<br>→ Trigger names, event names, operational data and descriptions<br>→ Trigger URLs<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Script-type item and Browser-type item, item prototype and discovery rule parameter names and values<br>→ HTTP agent type item, item prototype and discovery rule fields:<br>URL, Query fields, Request body, Headers, SSL certificate file, SSL key file, Allowed hosts.<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Host name.*<br><br>This macro may be used with a numeric index e.g. {HOST.HOST[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).<br><br>`{HOSTNAME<1-9>}` is deprecated and may not resolve in supported locations.<br><br>[Macro functions](/manual/config/macros/macro_functions) are not supported for this macro if it is used as a placeholder in the first parameter of a [history function](/manual/appendix/functions/history), for example, `last(/{HOST.HOST}/{ITEM.KEY})`.| |{HOST.ID}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ Map element labels, map URL names and values<br>→ URL field of dynamic URL dashboard widget<br>→ Trigger URLs<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) confirmation text<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Host ID.*<br><br>May be used with a numeric index as {HOST.ID[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{HOST.IP}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications<br>→ Map element labels, map URL names and values<br>→ Item key parameters^[1](supported_by_location#footnotes)^<br>→ Host interface IP/DNS<br>→ Trapper item "Allowed hosts" field<br>→ Database monitoring additional parameters<br>→ SSH and Telnet scripts<br>→ JMX item endpoint field<br>→ Web monitoring^[4](supported_by_location#footnotes)^<br>→ Low-level discovery rule filter regular expressions<br>→ URL field of dynamic URL dashboard widget<br>→ Trigger names, event names, operational data and descriptions<br>→ Trigger URLs<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Script-type item and Browser-type item, item prototype and discovery rule parameter names and values<br>→ HTTP agent type item, item prototype and discovery rule fields:<br>URL, Query fields, Request body, Headers, SSL certificate file, SSL key file, Allowed hosts.<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Host IP address*^[2](supported_by_location#footnotes)^.<br><br>This macro may be used with a numeric index e.g. {HOST.IP[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).<br><br>`{IPADDRESS<1-9>}` is deprecated and may not resolve in supported locations.| |{HOST.METADATA}|→ Autoregistration notifications and commands|*Host metadata.*<br>Used only for active agent autoregistration.| |{HOST.NAME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ Map element labels, map URL names and values<br>→ Item key parameters<br>→ Host interface IP/DNS<br>→ Trapper item "Allowed hosts" field<br>→ Database monitoring additional parameters<br>→ SSH and Telnet scripts<br>→ Web monitoring^[4](supported_by_location#footnotes)^<br>→ Low-level discovery rule filter regular expressions<br>→ URL field of dynamic URL dashboard widget<br>→ Trigger names, event names, operational data and descriptions<br>→ Trigger URLs<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Script-type item and Browser-type item, item prototype and discovery rule parameter names and values<br>→ HTTP agent type item, item prototype and discovery rule fields:<br>URL, Query fields, Request body, Headers, SSL certificate file, SSL key file, Allowed hosts.<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Visible host name.*<br><br>This macro may be used with a numeric index e.g. {HOST.NAME[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{HOST.PORT}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications<br>→ Trigger names, event names, operational data and descriptions<br>→ Trigger URLs<br>→ JMX item endpoint field<br>→ [Tag names and values](/manual/config/tagging#macro-support)<br>→ Manual host action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event action [script](/manual/web_interface/frontend_sections/alerts/scripts) commands, confirmation text<br>→ Manual event/host action URLs, confirmation text<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget<br>→ Column of data type *Text* in [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration) widget|*Host (agent) port*^[2](supported_by_location#footnotes)^.<br><br>This macro may be used with a numeric index e.g. {HOST.PORT[<1-9>](supported_by_location#indexed-macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed-macros).| |{HOST.TARGET.CONN}|→ Trigger-based commands<br>→ Problem update commands<br>→ Discovery commands<br>→ Autoregistration commands|*IP address or DNS name of the target host*, depending on host settings.| |{HOST.TARGET.DNS}|→ Trigger-based commands<br>→ Problem update commands<br>→ Discovery commands<br>→ Autoregistration commands|*DNS name of the target host*.| |{HOST.TARGET.HOST}|→ Trigger-based commands<br>→ Problem update commands<br>→ Discovery commands<br>→ Autoregistration commands|*Technical name of the target host*.| |{HOST.TARGET.IP}|→ Trigger-based commands<br>→ Problem update commands<br>→ Discovery commands<br>→ Autoregistration commands|*IP address of the target host*.| |{HOST.TARGET.NAME}|→ Trigger-based commands<br>→ Problem update commands<br>→ Discovery commands<br>→ Autoregistration commands|*Visible name of the target host*.| See also: [Host inventory](#host-inventory) ### Hosts |Macro|Supported in|Description| |--|--------|--------| |{HOST.CONN}|→ Paziņojumi un komandas, kas balstītas uz trigeri<br>→ Problēmas atjaunināšanas paziņojumi un komandas<br>→ Iekšējie paziņojumi<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Vienuma atslēgas parametri^[1](supported_by_location#footnotes)^<br>→ Hosta saskarnes IP/DNS<br>→ Trapper vienuma lauks "Allowed hosts"<br>→ Papildu parametri datubāzes uzraudzībai<br>→ SSH un Telnet skripti<br>→ JMX vienuma galapunkta lauks<br>→ Tīmekļa uzraudzība^[4](supported_by_location#footnotes)^<br>→ Zema līmeņa atklāšanas noteikuma filtra regulārās izteiksmes<br>→ Dinamiskā URL paneļa logrīka URL lauks<br>→ Trigeru nosaukumi, notikumu nosaukumi, operatīvie dati un apraksti<br>→ Trigeru URL<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Skripta tipa vienuma un Browser tipa vienuma, vienuma prototipa un atklāšanas noteikuma parametru nosaukumi un vērtības<br>→ HTTP aģents tipa vienuma, vienuma prototipa un atklāšanas noteikuma lauki:<br>URL, Query fields, Request body, Headers, SSL certificate file, SSL key file, Allowed hosts.<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ Parametrs *Description* logrīkos [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes parametrs *Text* logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Hosta IP adrese vai DNS nosaukums atkarībā no hosta iestatījumiem*^[2](supported_by_location#footnotes)^.<br><br>Var izmantot ar skaitlisku indeksu kā {HOST.CONN[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētās makro](/supported_by_location#indexed-macros).| |{HOST.DESCRIPTION}|→ Paziņojumi un komandas, kas balstītas uz trigeri<br>→ Problēmas atjaunināšanas paziņojumi un komandas<br>→ Iekšējie paziņojumi<br>→ Kartes elementu etiķetes<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas<br>→ Parametrs *Description* logrīkos [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes parametrs *Text* logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Hosta apraksts.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {HOST.DESCRIPTION[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētās makro](/supported_by_location#indexed-macros).| |{HOST.DNS}|→ Paziņojumi un komandas, kas balstītas uz trigeri<br>→ Problēmas atjaunināšanas paziņojumi un komandas<br>→ Iekšējie paziņojumi<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Vienuma atslēgas parametri^[1](supported_by_location#footnotes)^<br>→ Hosta saskarnes IP/DNS<br>→ Trapper vienuma lauks "Allowed hosts"<br>→ Papildu parametri datubāzes uzraudzībai<br>→ SSH un Telnet skripti<br>→ JMX vienuma galapunkta lauks<br>→ Tīmekļa uzraudzība^[4](supported_by_location#footnotes)^<br>→ Zema līmeņa atklāšanas noteikuma filtra regulārās izteiksmes<br>→ Dinamiskā URL paneļa logrīka URL lauks<br>→ Trigeru nosaukumi, notikumu nosaukumi, operatīvie dati un apraksti<br>→ Trigeru URL<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Skripta tipa vienuma un Browser tipa vienuma, vienuma prototipa un atklāšanas noteikuma parametru nosaukumi un vērtības<br>→ HTTP aģents tipa vienuma, vienuma prototipa un atklāšanas noteikuma lauki:<br>URL, Query fields, Request body, Headers, SSL certificate file, SSL key file, Allowed hosts.<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ Parametrs *Description* logrīkos [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes parametrs *Text* logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Hosta DNS nosaukums*^[2](supported_by_location#footnotes)^.<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {HOST.DNS[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētās makro](/supported_by_location#indexed-macros).| |{HOST.HOST}|→ Paziņojumi un komandas, kas balstītas uz trigeri<br>→ Problēmas atjaunināšanas paziņojumi un komandas<br>→ Autoreģistrācijas paziņojumi un komandas<br>→ Iekšējie paziņojumi<br>→ Vienuma atslēgas parametri<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Hosta saskarnes IP/DNS<br>→ Trapper vienuma lauks "Allowed hosts"<br>→ Papildu parametri datubāzes uzraudzībai<br>→ SSH un Telnet skripti<br>→ JMX vienuma galapunkta lauks<br>→ Tīmekļa uzraudzība^[4](supported_by_location#footnotes)^<br>→ Zema līmeņa atklāšanas noteikuma filtra regulārās izteiksmes<br>→ Dinamiskā URL paneļa logrīka URL lauks<br>→ Trigeru nosaukumi, notikumu nosaukumi, operatīvie dati un apraksti<br>→ Trigeru URL<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Skripta tipa vienuma un Browser tipa vienuma, vienuma prototipa un atklāšanas noteikuma parametru nosaukumi un vērtības<br>→ HTTP aģents tipa vienuma, vienuma prototipa un atklāšanas noteikuma lauki:<br>URL, Query fields, Request body, Headers, SSL certificate file, SSL key file, Allowed hosts.<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ Parametrs *Description* logrīkos [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes parametrs *Text* logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Hosta nosaukums.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {HOST.HOST[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētās makro](/supported_by_location#indexed-macros).<br><br>`{HOSTNAME<1-9>}` ir novecojis un var netikt atrisināts atbalstītajās vietās.<br><br>[Makro funkcijas](/manual/config/macros/macro_functions) šim makro netiek atbalstītas, ja tas tiek izmantots kā vietturis [vēstures funkcijas](/manual/appendix/functions/history) pirmajā parametrā, piemēram, `last(/{HOST.HOST}/{ITEM.KEY})`.| |{HOST.ID}|→ Paziņojumi un komandas, kas balstītas uz trigeri<br>→ Problēmas atjaunināšanas paziņojumi un komandas<br>→ Iekšējie paziņojumi<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Dinamiskā URL paneļa logrīka URL lauks<br>→ Trigeru URL<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) apstiprinājuma teksts<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ Parametrs *Description* logrīkos [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes parametrs *Text* logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Hosta ID.*<br><br>Var izmantot ar skaitlisku indeksu kā {HOST.ID[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētās makro](/supported_by_location#indexed-macros).| |{HOST.IP}|→ Paziņojumi un komandas, kas balstītas uz trigeri<br>→ Problēmas atjaunināšanas paziņojumi un komandas<br>→ Autoreģistrācijas paziņojumi un komandas<br>→ Iekšējie paziņojumi<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Vienuma atslēgas parametri^[1](supported_by_location#footnotes)^<br>→ Hosta saskarnes IP/DNS<br>→ Trapper vienuma lauks "Allowed hosts"<br>→ Papildu parametri datubāzes uzraudzībai<br>→ SSH un Telnet skripti<br>→ JMX vienuma galapunkta lauks<br>→ Tīmekļa uzraudzība^[4](supported_by_location#footnotes)^<br>→ Zema līmeņa atklāšanas noteikuma filtra regulārās izteiksmes<br>→ Dinamiskā URL paneļa logrīka URL lauks<br>→ Trigeru nosaukumi, notikumu nosaukumi, operatīvie dati un apraksti<br>→ Trigeru URL<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Skripta tipa vienuma un Browser tipa vienuma, vienuma prototipa un atklāšanas noteikuma parametru nosaukumi un vērtības<br>→ HTTP aģents tipa vienuma, vienuma prototipa un atklāšanas noteikuma lauki:<br>URL, Query fields, Request body, Headers, SSL certificate file, SSL key file, Allowed hosts.<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ Parametrs *Description* logrīkos [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes parametrs *Text* logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Hosta IP adrese*^[2](supported_by_location#footnotes)^.<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {HOST.IP[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētās makro](/supported_by_location#indexed-macros).<br><br>`{IPADDRESS<1-9>}` ir novecojis un var netikt atrisināts atbalstītajās vietās.| |{HOST.METADATA}|→ Autoreģistrācijas paziņojumi un komandas|*Hosta metadati.*<br>Tiek izmantots tikai aktīvā aģenta autoreģistrācijai.| |{HOST.NAME}|→ Paziņojumi un komandas, kas balstītas uz trigeri<br>→ Problēmas atjaunināšanas paziņojumi un komandas<br>→ Iekšējie paziņojumi<br>→ Kartes elementu etiķetes, kartes URL nosaukumi un vērtības<br>→ Vienuma atslēgas parametri<br>→ Hosta saskarnes IP/DNS<br>→ Trapper vienuma lauks "Allowed hosts"<br>→ Papildu parametri datubāzes uzraudzībai<br>→ SSH un Telnet skripti<br>→ Tīmekļa uzraudzība^[4](supported_by_location#footnotes)^<br>→ Zema līmeņa atklāšanas noteikuma filtra regulārās izteiksmes<br>→ Dinamiskā URL paneļa logrīka URL lauks<br>→ Trigeru nosaukumi, notikumu nosaukumi, operatīvie dati un apraksti<br>→ Trigeru URL<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Skripta tipa vienuma un Browser tipa vienuma, vienuma prototipa un atklāšanas noteikuma parametru nosaukumi un vērtības<br>→ HTTP aģents tipa vienuma, vienuma prototipa un atklāšanas noteikuma lauki:<br>URL, Query fields, Request body, Headers, SSL certificate file, SSL key file, Allowed hosts.<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ Parametrs *Description* logrīkos [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes parametrs *Text* logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Redzamais hosta nosaukums.*<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {HOST.NAME[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētās makro](/supported_by_location#indexed-macros).| |{HOST.PORT}|→ Paziņojumi un komandas, kas balstītas uz trigeri<br>→ Problēmas atjaunināšanas paziņojumi un komandas<br>→ Autoreģistrācijas paziņojumi un komandas<br>→ Iekšējie paziņojumi<br>→ Trigeru nosaukumi, notikumu nosaukumi, operatīvie dati un apraksti<br>→ Trigeru URL<br>→ JMX vienuma galapunkta lauks<br>→ [Tagu nosaukumi un vērtības](/manual/config/tagging#macro-support)<br>→ Manuālas hosta darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma darbības [skripta](/manual/web_interface/frontend_sections/alerts/scripts) komandas, apstiprinājuma teksts<br>→ Manuālas notikuma/hosta darbības URL, apstiprinājuma teksts<br>→ Parametrs *Description* logrīkos [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) un [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Primārās/sekundārās etiķetes parametrs *Text* logrīkā [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)<br>→ Datu tipa *Text* kolonna logrīkā [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts#column-configuration)|*Hosta (aģenta) ports*^[2](supported_by_location#footnotes)^.<br><br>Šo makro var izmantot ar skaitlisku indeksu, piemēram, {HOST.PORT[<1-9>](supported_by_location#indexed-macros)}, lai norādītu uz pirmo, otro, trešo utt. hostu trigeru izteiksmē. Skatiet [indeksētās makro](/supported_by_location#indexed-macros).| |{HOST.TARGET.CONN}|→ Paziņojumi, kas balstīti uz trigeri<br>→ Problēmas atjaunināšanas paziņojumi<br>→ Atklāšanas komandas<br>→ Autoreģistrācijas komandas|*Mērķa hosta IP adrese vai DNS nosaukums* atkarībā no hosta iestatījumiem.| |{HOST.TARGET.DNS}|→ Paziņojumi, kas balstīti uz trigeri<br>→ Problēmas atjaunināšanas paziņojumi<br>→ Atklāšanas komandas<br>→ Autoreģistrācijas komandas|*Mērķa hosta DNS nosaukums*.| |{HOST.TARGET.HOST}|→ Paziņojumi, kas balstīti uz trigeri<br>→ Problēmas atjaunināšanas paziņojumi<br>→ Atklāšanas komandas<br>→ Autoreģistrācijas komandas|*Mērķa hosta tehniskais nosaukums*.| |{HOST.TARGET.IP}|→ Paziņojumi, kas balstīti uz trigeri<br>→ Problēmas atjaunināšanas paziņojumi<br>→ Atklāšanas komandas<br>→ Autoreģistrācijas komandas|*Mērķa hosta IP adrese*.| |{HOST.TARGET.NAME}|→ Paziņojumi, kas balstīti uz trigeri<br>→ Problēmas atjaunināšanas paziņojumi<br>→ Atklāšanas komandas<br>→ Autoreģistrācijas komandas|*Mērķa hosta redzamais nosaukums*.| Skatīt arī: [Host inventory](#host-inventory) #### Hosts with duplicated items If you have several similar hosts, such as *Network switch 1* and *Network switch 2*, Zabbix provides multiple ways to quickly recreate the host. You can simply clone a host with all of its metrics by pressing the Clone button, but in this case, to update an item later, you will need to do it manually on each host. The best practice is to create a template with all of the required metrics, for example, *Network switch template*. Then group the similar hosts into a host group, for the example above it could be *Network switches*. Now, in the *Data Collection -> Hosts* section you can filter all hosts by host group and use the *Mass update* button to link the template to all of your network switches. #### Hosts ar dublētiem vienumiem Ja jums ir vairāki līdzīgi hosts, piemēram, *Network switch 1* un *Network switch 2*, Zabbix piedāvā vairākus veidus, kā ātri izveidot hostu no jauna. Jūs varat vienkārši klonēt hostu kopā ar visiem tā metrikiem, nospiežot pogu *Clone*, taču šādā gadījumā, lai vēlāk atjauninātu vienumu, tas būs jādara manuāli katrā hostā. Labākā prakse ir izveidot veidni ar visiem nepieciešamajiem metriķiem, piemēram, *Network switch template*. Pēc tam grupējiet līdzīgos hostus hostu grupā; iepriekš minētajā piemērā tā varētu būt *Network switches*. Tagad sadaļā *Data Collection -> Hosts* varat filtrēt visus hostus pēc hostu grupas un izmantot pogu *Mass update*, lai piesaistītu veidni visiem jūsu tīkla komutatoriem. ### Host tag The host tag object has the following properties. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |tag|string|Host tag name.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |value|string|Host tag value.| |automatic|integer|Type of host tag.<br><br>Possible values:<br>0 - *(default)* manual (tag created by user);<br>1 - automatic (tag created by low-level discovery)<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| ### Hosts taga Hosts taga objekts satur šādus rekvizītus. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |tag|string|Hosts taga nosaukums.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |value|string|Hosts taga vērtība.| |automatic|integer|Hosts taga tips.<br><br>Iespējamās vērtības:<br>0 - *(default)* manuāls (tags, ko izveidojis lietotājs);<br>1 - automātisks (tags, ko izveidojusi zemā līmeņa atklāšana)<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| ### Host The host object has the following properties. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |hostid|ID|ID of the host.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*<br>- *required* for update operations| |host|string|Technical name of the host.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |description|text|Description of the host.| |flags|integer|Origin of the host.<br><br>Possible values:<br>0 - a plain host;<br>4 - a discovered host.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |inventory\_mode|integer|Host inventory population mode.<br><br>Possible values:<br>-1 - *(default)* disabled;<br>0 - manual;<br>1 - automatic.| |ipmi\_authtype|integer|IPMI authentication algorithm.<br><br>Possible values:<br>-1 - *(default)* default;<br>0 - none;<br>1 - MD2;<br>2 - MD5<br>4 - straight;<br>5 - OEM;<br>6 - RMCP+.| |ipmi\_password|string|IPMI password.| |ipmi\_privilege|integer|IPMI privilege level.<br><br>Possible values:<br>1 - callback;<br>2 - *(default)* user;<br>3 - operator;<br>4 - admin;<br>5 - OEM.| |ipmi\_username|string|IPMI username.| |maintenance\_from|timestamp|Starting time of the effective maintenance.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |maintenance\_status|integer|Effective maintenance status.<br><br>Possible values:<br>0 - *(default)* no maintenance;<br>1 - maintenance in effect.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |maintenance\_type|integer|Effective maintenance type.<br><br>Possible values:<br>0 - *(default)* maintenance with data collection;<br>1 - maintenance without data collection.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |maintenanceid|ID|ID of the maintenance that is currently in effect on the host.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |name|string|Visible name of the host.<br><br>Default: `host` property value.| |monitored_by|integer|Source that is used to monitor the host.<br><br>Possible values:<br>0 - *(default)* Zabbix server;<br>1 - Proxy;<br>2 - Proxy group.| |proxyid|ID|ID of the proxy that is used to monitor the host.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `monitored_by` is set to "Proxy"| |proxy_groupid|ID|ID of the proxy group that is used to monitor the host.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `monitored_by` is set to "Proxy group"| |status|integer|Status and function of the host.<br><br>Possible values:<br>0 - *(default)* enabled;<br>1 - disabled.| |tls\_connect|integer|Connections to host.<br><br>Possible values:<br>1 - *(default)* No encryption;<br>2 - PSK;<br>4 - certificate.| |tls\_accept|integer|Connections from host.<br><br>Possible bitmap values:<br>1 - *(default)* No encryption;<br>2 - PSK;<br>4 - certificate.<br><br>This is a bitmask field; any sum of possible bitmap values is acceptable (for example, 6 for PSK and certificate).| |tls\_issuer|string|Certificate issuer.| |tls\_subject|string|Certificate subject.| |tls\_psk\_identity|string|PSK identity; must be paired with only one PSK (across [autoregistration](/manual/api/reference/autoregistration/object), [hosts](/manual/api/reference/host/object), and [proxies](/manual/api/reference/proxy/object)).<br><br>Do not include sensitive information in the PSK identity, as it is sent unencrypted over the network to inform the receiver which PSK to use.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *write-only*<br>- *required* if `tls_connect` is set to "PSK", or `tls_accept` contains the "PSK" bit| |tls\_psk|string|Pre-shared key (PSK); must be at least 32 hex digits.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *write-only*<br>- *required* if `tls_connect` is set to "PSK", or `tls_accept` contains the "PSK" bit| |active_available|integer|Host active interface availability status.<br><br>Possible values:<br>0 - interface status is unknown;<br>1 - interface is available;<br>2 - interface is not available.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |assigned_proxyid|ID|ID of the proxy assigned by Zabbix server, if the host is monitored by a proxy group.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| ### Hosts Hosts objektsi ir šādi rekvizīti. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |hostid|ID|Hosts ID.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *tikai lasāms*<br>- *obligāts* atjaunināšanas operācijām| |host|string|Hosts tehniskais nosaukums.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *obligāts* izveides operācijām| |description|text|Hosts apraksts.| |flags|integer|Hosts izcelsme.<br><br>Iespējamās vērtības:<br>0 - parasts hosts;<br>4 - atklāts hosts.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *tikai lasāms*| |inventory\_mode|integer|Hosts inventāra aizpildīšanas režīms.<br><br>Iespējamās vērtības:<br>-1 - *(noklusējums)* atspējots;<br>0 - manuāls;<br>1 - automātisks.| |ipmi\_authtype|integer|IPMI autentifikācijas algoritms.<br><br>Iespējamās vērtības:<br>-1 - *(noklusējums)* noklusējuma;<br>0 - nav;<br>1 - MD2;<br>2 - MD5<br>4 - straight;<br>5 - OEM;<br>6 - RMCP+.| |ipmi\_password|string|IPMI parole.| |ipmi\_privilege|integer|IPMI privilēģiju līmenis.<br><br>Iespējamās vērtības:<br>1 - callback;<br>2 - *(noklusējums)* user;<br>3 - operator;<br>4 - admin;<br>5 - OEM.| |ipmi\_username|string|IPMI lietotājvārds.| |maintenance\_from|timestamp|Efektīvās apkopes sākuma laiks.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *tikai lasāms*| |maintenance\_status|integer|Efektīvās apkopes statuss.<br><br>Iespējamās vērtības:<br>0 - *(noklusējums)* nav apkopes;<br>1 - apkope ir spēkā.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *tikai lasāms*| |maintenance\_type|integer|Efektīvās apkopes veids.<br><br>Iespējamās vērtības:<br>0 - *(noklusējums)* apkope ar datu vākšanu;<br>1 - apkope bez datu vākšanas.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *tikai lasāms*| |maintenanceid|ID|Apkopes ID, kas pašlaik ir spēkā uz hosta.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *tikai lasāms*| |name|string|Redzamais hosta nosaukums.<br><br>Noklusējums: `host` rekvizīta vērtība.| |monitored_by|integer|Avots, kas tiek izmantots hosta uzraudzībai.<br><br>Iespējamās vērtības:<br>0 - *(noklusējums)* Zabbix serveris;<br>1 - starpniekserveris;<br>2 - starpniekserveru grupa.| |proxyid|ID|Starpniekservera ID, kas tiek izmantots hosta uzraudzībai.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *obligāts* ja `monitored_by` ir iestatīts uz "Proxy"| |proxy_groupid|ID|Starpniekserveru grupas ID, kas tiek izmantots hosta uzraudzībai.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *obligāts* ja `monitored_by` ir iestatīts uz "Proxy group"| |status|integer|Hosta statuss un funkcija.<br><br>Iespējamās vērtības:<br>0 - *(noklusējums)* iespējots;<br>1 - atspējots.| |tls\_connect|integer|Savienojumi ar hostu.<br><br>Iespējamās vērtības:<br>1 - *(noklusējums)* bez šifrēšanas;<br>2 - PSK;<br>4 - sertifikāts.| |tls\_accept|integer|Savienojumi no hosta.<br><br>Iespējamās bitkartes vērtības:<br>1 - *(noklusējums)* bez šifrēšanas;<br>2 - PSK;<br>4 - sertifikāts.<br><br>Šis ir bitmaskas lauks; ir pieļaujama jebkura iespējamo bitkartes vērtību summa (piemēram, 6 PSK un sertifikātam).| |tls\_issuer|string|Sertifikāta izdevējs.| |tls\_subject|string|Sertifikāta subjekts.| |tls\_psk\_identity|string|PSK identitāte; tai jābūt saistītai tikai ar vienu PSK (starp [autoregistration](/manual/api/reference/autoregistration/object), [hosts](/manual/api/reference/host/object) un [proxies](/manual/api/reference/proxy/object)).<br><br>Neiekļaujiet sensitīvu informāciju PSK identitātē, jo tā tiek nosūtīta tīklā nešifrētā veidā, lai informētu saņēmēju, kuru PSK izmantot.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *tikai rakstāms*<br>- *obligāts* ja `tls_connect` ir iestatīts uz "PSK", vai `tls_accept` satur "PSK" bitu| |tls\_psk|string|Iepriekš koplietota atslēga (PSK); tai jābūt vismaz 32 heksadecimālām zīmēm.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *tikai rakstāms*<br>- *obligāts* ja `tls_connect` ir iestatīts uz "PSK", vai `tls_accept` satur "PSK" bitu| |active_available|integer|Hosta aktīvās saskarnes pieejamības statuss.<br><br>Iespējamās vērtības:<br>0 - saskarnes statuss nav zināms;<br>1 - saskarne ir pieejama;<br>2 - saskarne nav pieejama.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *tikai lasāms*| |assigned_proxyid|ID|Starpniekservera ID, ko piešķīris Zabbix serveris, ja hostu uzrauga starpniekserveru grupa.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *tikai lasāms*| # Host This class is designed to work with hosts. Object references: - [Host](/manual/api/reference/host/object#host) - [Host inventory](/manual/api/reference/host/object#host-inventory) - [Host tag](/manual/api/reference/host/object#host-tag) Available methods: - [host.create](/manual/api/reference/host/create) - create new hosts - [host.delete](/manual/api/reference/host/delete) - delete hosts - [host.get](/manual/api/reference/host/get) - retrieve hosts - [host.massadd](/manual/api/reference/host/massadd) - add related objects to hosts - [host.massremove](/manual/api/reference/host/massremove) - remove related objects from hosts - [host.massupdate](/manual/api/reference/host/massupdate) - replace or remove related objects from hosts - [host.update](/manual/api/reference/host/update) - update hosts # Hosts Šī klase ir paredzēta darbam ar hosts. Objektu atsauces: - [Host](/manual/api/reference/host/object#host) - [Host inventory](/manual/api/reference/host/object#host-inventory) - [Host tag](/manual/api/reference/host/object#host-tag) Pieejamās metodes: - [host.create](/manual/api/reference/host/create) - izveidot jaunus hosts - [host.delete](/manual/api/reference/host/delete) - dzēst hosts - [host.get](/manual/api/reference/host/get) - izgūt hosts - [host.massadd](/manual/api/reference/host/massadd) - pievienot saistītos objektus hosts - [host.massremove](/manual/api/reference/host/massremove) - noņemt saistītos objektus no hosts - [host.massupdate](/manual/api/reference/host/massupdate) - aizstāt vai noņemt saistītos objektus no hosts - [host.update](/manual/api/reference/host/update) - atjaunināt hosts # host.update # host.update #### Host value maps |Element|<|Type|Description| |-|---|---|-----------------------| |uuid|<|string|(required) Unique identifier for this value map.| |name|<|string|(required) Value map name.| |mapping|<| |Root element for mappings.| |<|type|string|Mapping match type.<br>Possible values:^[1](#footnotes)^ EQUAL (0, default), GREATER_OR_EQUAL (2), LESS_OR_EQUAL (3), IN_RANGE (4), REGEXP (5), DEFAULT (6).| |^|value|string|Original value.| |^|newvalue|string|(required) Value to which the original value is mapped to.| ::: noteclassic See also: [Value map object](/manual/api/reference/valuemap/object) (refer to the relevant property with a matching name). ::: #### Hosts vērtību kartes |Element|<|Type|Description| |-|---|---|-----------------------| |uuid|<|string|(required) Unique identifier for this value map.| |name|<|string|(required) Value map name.| |mapping|<| |Root element for mappings.| |<|type|string|Mapping match type.<br>Possible values:^[1](#footnotes)^ EQUAL (0, default), GREATER_OR_EQUAL (2), LESS_OR_EQUAL (3), IN_RANGE (4), REGEXP (5), DEFAULT (6).| |^|value|string|Original value.| |^|newvalue|string|(required) Value to which the original value is mapped to.| ::: noteclassic See also: [Value map object](/manual/api/reference/valuemap/object) (refer to the relevant property with a matching name). ::: #### Host web scenarios |Element|<|Type|Description| |-|---|---|-----------------------| |uuid|<|string|(required) Unique identifier for this web scenario.| |name|<|string|(required) Web scenario name.| |delay|<|string|Frequency (using seconds, [time suffix](/manual/appendix/suffixes#time-suffixes), or [user macro](/manual/config/macros/user_macros)) of executing web scenario.<br>Default: 1m.| |attempts|<|integer|The number of attempts for executing web scenario steps.<br>Possible values: 1-10 (default: 1).| |agent|<|string|Client agent. Zabbix will pretend to be the selected browser.<br>This is useful when a website returns different content for different browsers.<br>Default: Zabbix.| |http\_proxy|<|string|Proxy that will be used by the web scenario given as: `http://[username[:password]@]proxy.example.com[:port]`| |variables|<| |Root element for web scenario variables that may be used in scenario steps.| |<|name|string|(required) Variable name.| |^|value|text|(required) Variable value.| |headers|<| |Root element for HTTP headers to be sent when performing a request.<br>Headers should be listed using the same syntax as they would appear in the HTTP protocol.| |<|name|string|(required) Header name.| |^|value|text|(required) Header value.| |status|<|string|Web scenario status.<br>Possible values:^[1](#footnotes)^ ENABLED (0, default), DISABLED (1).| |authentication|<|string|Authentication method.<br>Possible values:^[1](#footnotes)^ NONE (0, default), BASIC (1), NTLM (2), Kerberos (3), or Digest (4).| |http\_user|<|string|User name used for BASIC (HTTP), NTLM, Kerberos, or Digest authentication.| |http\_password|<|string|Password used for BASIC (HTTP), NTLM, Kerberos, or Digest authentication.| |verify\_peer|<|string|Verify the SSL certificate of the web server.<br>Possible values:^[1](#footnotes)^ NO (0, default), YES (1).| |verify\_host|<|string|Verify that the *Common Name* field or the *Subject Alternate Name* field of the web server certificate matches.<br>Possible values:^[1](#footnotes)^ NO (0, default), YES (1).| |ssl\_cert\_file|<|string|Name of the SSL certificate file used for client authentication (must be in PEM format).| |ssl\_key\_file|<|string|Name of the SSL private key file used for client authentication (must be in PEM format).| |ssl\_key\_password|<|string|SSL private key file password.| |steps|<| |(required) Root element for [host web scenario steps](#host-web-scenario-steps).| |tags|<| |Root element for web scenario tags.| |<|tag|string|(required) Tag name.| |^|value|string|Tag value.| ::: noteclassic See also: [Web scenario object](/manual/api/reference/httptest/object) (refer to the relevant property with a matching name). ::: #### Hosta tīmekļa scenāriji |Element|<|Type|Apraksts| |-|---|---|-----------------------| |uuid|<|string|(obligāti) Unikāls šī tīmekļa scenārija identifikators.| |name|<|string|(obligāti) Tīmekļa scenārija nosaukums.| |delay|<|string|Tīmekļa scenārija izpildes biežums (izmantojot sekundes, [laika sufiksu](/manual/appendix/suffixes#time-suffixes) vai [lietotāja makrosu](/manual/config/macros/user_macros)).<br>Noklusējums: 1m.| |attempts|<|integer|Mēģinājumu skaits tīmekļa scenārija soļu izpildei.<br>Iespējamās vērtības: 1-10 (noklusējums: 1).| |agent|<|string|Klienta aģents. Zabbix uzdosies par izvēlēto pārlūku.<br>Tas ir noderīgi, ja vietne dažādām pārlūkprogrammām atgriež atšķirīgu saturu.<br>Noklusējums: Zabbix.| |http\_proxy|<|string|Starpniekserveris, kas tiks izmantots tīmekļa scenārijam, norādīts šādā formātā: `http://[username[:password]@]proxy.example.com[:port]`| |variables|<| |Saknes elements tīmekļa scenārija mainīgajiem, kurus var izmantot scenārija soļos.| |<|name|string|(obligāti) Mainīgā nosaukums.| |^|value|text|(obligāti) Mainīgā vērtība.| |headers|<| |Saknes elements HTTP galvenēm, kas tiks nosūtītas, izpildot pieprasījumu.<br>Galvenes jānorāda, izmantojot to pašu sintaksi, kāda tiktu izmantota HTTP protokolā.| |<|name|string|(obligāti) Galvenes nosaukums.| |^|value|text|(obligāti) Galvenes vērtība.| |status|<|string|Tīmekļa scenārija statuss.<br>Iespējamās vērtības:^[1](#footnotes)^ ENABLED (0, noklusējums), DISABLED (1).| |authentication|<|string|Autentifikācijas metode.<br>Iespējamās vērtības:^[1](#footnotes)^ NONE (0, noklusējums), BASIC (1), NTLM (2), Kerberos (3) vai Digest (4).| |http\_user|<|string|Lietotājvārds, kas tiek izmantots BASIC (HTTP), NTLM, Kerberos vai Digest autentifikācijai.| |http\_password|<|string|Parole, kas tiek izmantota BASIC (HTTP), NTLM, Kerberos vai Digest autentifikācijai.| |verify\_peer|<|string|Pārbaudīt tīmekļa servera SSL sertifikātu.<br>Iespējamās vērtības:^[1](#footnotes)^ NO (0, noklusējums), YES (1).| |verify\_host|<|string|Pārbaudīt, vai tīmekļa servera sertifikāta lauks *Common Name* vai lauks *Subject Alternate Name* atbilst.<br>Iespējamās vērtības:^[1](#footnotes)^ NO (0, noklusējums), YES (1).| |ssl\_cert\_file|<|string|SSL sertifikāta faila nosaukums, kas tiek izmantots klienta autentifikācijai (jābūt PEM formātā).| |ssl\_key\_file|<|string|SSL privātās atslēgas faila nosaukums, kas tiek izmantots klienta autentifikācijai (jābūt PEM formātā).| |ssl\_key\_password|<|string|SSL privātās atslēgas faila parole.| |steps|<| |(obligāti) Saknes elements [hosta tīmekļa scenārija soļiem](#host-web-scenario-steps).| |tags|<| |Saknes elements tīmekļa scenārija tagiem.| |<|tag|string|(obligāti) Taga nosaukums.| |^|value|string|Taga vērtība.| ::: noteclassic Skatiet arī: [Web scenario object](/manual/api/reference/httptest/object) (skatiet atbilstošo īpašību ar tādu pašu nosaukumu). ::: ##### Host web scenario steps |Element|<|Type|Description| |-|---|---|-----------------------| |name|<|string|(required) Web scenario step name.| |url|<|string|(required) URL for monitoring.| |query\_fields|<| |Root element for query parameters (an array of HTTP fields to be added to the URL when performing a request).| |<|name|string|(required) Query parameter name.| |^|value|string|Query parameter value.| |posts|<| |Root element for HTTP POST variables (a string (raw post data) or an array of HTTP fields (form field data)).| |<|name|string|(required) Post field name.| |^|value|string|(required) Post field value.| |variables|<| |Root element of step-level variables (macros) that should be applied after this step.<br>If the variable value has a 'regex:' prefix, then its value is extracted from the data returned by this step according to the regular expression pattern following the 'regex:' prefix| |<|name|string|(required) Variable name.| |^|value|text|(required) Variable value.| |headers|<| |Root element for HTTP headers to be sent when performing a request.| |<|name|string|(required) Header name.| |^|value|text|(required) Header value.| |follow\_redirects|<|string|Follow HTTP redirects.<br>Possible values:^[1](#footnotes)^ NO (0), YES (1, default).| |retrieve\_mode|<|string|HTTP response retrieve mode.<br>Possible values:^[1](#footnotes)^ BODY (0, default), HEADERS (1), BOTH (2).| |timeout|<|string|Timeout (using seconds, [time suffix](/manual/appendix/suffixes#time-suffixes), or [user macro](/manual/config/macros/user_macros)) of step execution.<br>Default: 15s.| |required|<|string|Text that must be present in the response (ignored if empty).| |status\_codes|<|string|A comma-delimited list of accepted HTTP status codes (e.g., `200-201,210-299`; ignored if empty).| ::: noteclassic See also: [Web scenario step object](/manual/api/reference/httptest/object#scenario-step) (refer to the relevant property with a matching name). ::: ##### Hosta tīmekļa scenārija soļi |Elements|<|Tips|Apraksts| |-|---|---|-----------------------| |name|<|string|(obligāti) Tīmekļa scenārija soļa nosaukums.| |url|<|string|(obligāti) URL uzraudzībai.| |query\_fields|<| |Saknes elements vaicājuma parametriem (HTTP lauku masīvs, kas tiks pievienots URL, izpildot pieprasījumu).| |<|name|string|(obligāti) Vaicājuma parametra nosaukums.| |^|value|string|Vaicājuma parametra vērtība.| |posts|<| |Saknes elements HTTP POST mainīgajiem (virkne (neapstrādāti POST dati) vai HTTP lauku masīvs (veidlapas lauku dati)).| |<|name|string|(obligāti) POST lauka nosaukums.| |^|value|string|(obligāti) POST lauka vērtība.| |variables|<| |Soļa līmeņa mainīgo (makrosu) saknes elements, kas jāpiemēro pēc šī soļa.<br>Ja mainīgā vērtībai ir prefikss 'regex:', tad tā vērtība tiek iegūta no šī soļa atgrieztajiem datiem atbilstoši regulārās izteiksmes šablonam, kas seko prefiksam 'regex:'| |<|name|string|(obligāti) Mainīgā nosaukums.| |^|value|text|(obligāti) Mainīgā vērtība.| |headers|<| |Saknes elements HTTP galvenēm, kas tiks nosūtītas, izpildot pieprasījumu.| |<|name|string|(obligāti) Galvenes nosaukums.| |^|value|text|(obligāti) Galvenes vērtība.| |follow\_redirects|<|string|Sekot HTTP pāradresācijām.<br>Iespējamās vērtības:^[1](#footnotes)^ NO (0), YES (1, pēc noklusējuma).| |retrieve\_mode|<|string|HTTP atbildes iegūšanas režīms.<br>Iespējamās vērtības:^[1](#footnotes)^ BODY (0, pēc noklusējuma), HEADERS (1), BOTH (2).| |timeout|<|string|Soļa izpildes noildze (izmantojot sekundes, [laika sufiksu](/manual/appendix/suffixes#time-suffixes) vai [lietotāja makrosu](/manual/config/macros/user_macros)).<br>Pēc noklusējuma: 15s.| |required|<|string|Teksts, kam jābūt atbildē (tiek ignorēts, ja tukšs).| |status\_codes|<|string|Ar komatiem atdalīts pieņemamo HTTP statusa kodu saraksts (piemēram, `200-201,210-299`; tiek ignorēts, ja tukšs).| ::: noteclassic Skatiet arī: [Tīmekļa scenārija soļa objekts](/manual/api/reference/httptest/object#scenario-step) (skatiet atbilstošo īpašību ar tādu pašu nosaukumu). ::: #### host [ZBX-23760](https://support.zabbix.com/browse/ZBX-23760) `host.delete`: It is no longer possible to delete a host that is used in action condition or operation. In such cases, an error message is returned instead of automatically disabling the action. #### hosts [ZBX-23760](https://support.zabbix.com/browse/ZBX-23760) `host.delete`: vairs nav iespējams dzēst hostu, kas tiek izmantots darbības nosacījumā vai operācijā. Šādos gadījumos tiek atgriezts kļūdas ziņojums, nevis automātiski atspējota darbība. #### host [ZBXNEXT-8758](https://support.zabbix.com/browse/ZBXNEXT-8758) Added new properties `monitored_by` and `proxy_groupid`.<br> [ZBXNEXT-8758](https://support.zabbix.com/browse/ZBXNEXT-8758) Added new read-only property `assigned_proxyid`.<br> [ZBXNEXT-8758](https://support.zabbix.com/browse/ZBXNEXT-8758) `host.get`: Added new parameter `proxy_groupids`.<br> [ZBXNEXT-2020](https://support.zabbix.com/browse/ZBXNEXT-2020) `host.get`: Method now also supports `status`, `ts_disable` and `disable_source` properties if `selectHostDiscovery` parameter is used. #### hosts [ZBXNEXT-8758](https://support.zabbix.com/browse/ZBXNEXT-8758) Pievienotas jaunas īpašības `monitored_by` un `proxy_groupid`.<br> [ZBXNEXT-8758](https://support.zabbix.com/browse/ZBXNEXT-8758) Pievienota jauna tikai lasāma īpašība `assigned_proxyid`.<br> [ZBXNEXT-8758](https://support.zabbix.com/browse/ZBXNEXT-8758) `host.get`: Pievienots jauns parametrs `proxy_groupids`.<br> [ZBXNEXT-2020](https://support.zabbix.com/browse/ZBXNEXT-2020) `host.get`: Metode tagad atbalsta arī `status`, `ts_disable` un `disable_source` īpašības, ja tiek izmantots parametrs `selectHostDiscovery`. #### host [ZBXNEXT-8758](https://support.zabbix.com/browse/ZBXNEXT-8758) The `proxyid` property is now *required* if `monitored_by` is set to "Proxy"; API requests using `proxyid` must now also use `monitored_by`.<br> [ZBXNEXT-5878](https://support.zabbix.com/browse/ZBXNEXT-5878) `host.create`, `host.update`, `host.massAdd`, `host.massUpdate`, `host.massRemove`: Added strict validation of the `groups`, `macros`, `tags`, `templates` parameters.<br> [ZBXNEXT-8500](https://support.zabbix.com/browse/ZBXNEXT-8500) `host.get`: Removed support for parameter `proxy_hosts`.<br> [ZBXNEXT-8500](https://support.zabbix.com/browse/ZBXNEXT-8500) Renamed property `proxy_hostid` to `proxyid`. #### hosts [ZBXNEXT-8758](https://support.zabbix.com/browse/ZBXNEXT-8758) Īpašība `proxyid` tagad ir *obligāta*, ja `monitored_by` ir iestatīts uz "Proxy"; API pieprasījumos, kuros tiek izmantots `proxyid`, tagad jāizmanto arī `monitored_by`.<br> [ZBXNEXT-5878](https://support.zabbix.com/browse/ZBXNEXT-5878) `host.create`, `host.update`, `host.massAdd`, `host.massUpdate`, `host.massRemove`: Pievienota stingra parametru `groups`, `macros`, `tags`, `templates` validācija.<br> [ZBXNEXT-8500](https://support.zabbix.com/browse/ZBXNEXT-8500) `host.get`: Noņemts atbalsts parametram `proxy_hosts`.<br> [ZBXNEXT-8500](https://support.zabbix.com/browse/ZBXNEXT-8500) Īpašums `proxy_hostid` pārdēvēts par `proxyid`. #### Housekeeping Configure housekeeping. [Housekeeping API](/manual/api/reference/housekeeping) #### Tīrīšana Konfigurējiet tīrīšanu. [Tīrīšanas API](/manual/api/reference/housekeeping) ##### HousekeepingFrequency How often Zabbix will perform housekeeping procedure (in hours). Housekeeping is removing outdated information from the database.<br>*Note*: To lower load on proxy startup housekeeping is postponed for 30 minutes after proxy start. Thus, if `HousekeepingFrequency` is `1`, the very first housekeeping procedure after proxy start will run after 30 minutes, and will repeat every hour thereafter.<br>It is possible to disable automatic housekeeping by setting `HousekeepingFrequency` to `0`. In this case the housekeeping procedure can only be started by `housekeeper_execute` runtime control option.<br>See also [runtime control](/manual/concepts/proxy#runtime-control) options. Default: `1`<br> Range: 0-24 ##### HousekeepingFrequency Cik bieži Zabbix veiks housekeeping procedūru (stundās). Housekeeping ir novecojušas informācijas noņemšana no datubāzes.<br>*Piezīme*: lai samazinātu slodzi starpniekservera startēšanas laikā, housekeeping tiek atlikts uz 30 minūtēm pēc starpniekservera palaišanas. Tādējādi, ja `HousekeepingFrequency` ir `1`, pati pirmā housekeeping procedūra pēc starpniekservera startēšanas tiks palaista pēc 30 minūtēm un pēc tam atkārtosies katru stundu.<br>Automātisko housekeeping ir iespējams atspējot, iestatot `HousekeepingFrequency` uz `0`. Šādā gadījumā housekeeping procedūru var palaist tikai ar `housekeeper_execute` izpildlaika vadības opciju.<br>Skatiet arī [izpildlaika vadības](/manual/concepts/proxy#runtime-control) opcijas. Noklusējums: `1`<br> Diapazons: 0-24 ##### HousekeepingFrequency This parameter determines how often Zabbix will perform the housekeeping procedure in hours. Housekeeping is removing outdated information from the database.<br>*Note*: To prevent housekeeper from being overloaded (for example, when history and trend periods are greatly reduced), no more than 4 times `HousekeepingFrequency` hours of outdated information are deleted in one housekeeping cycle, for each item. Thus, if `HousekeepingFrequency` is `1`, no more than 4 hours of outdated information (starting from the oldest entry) will be deleted per cycle.<br>*Note*: To lower load on server startup housekeeping is postponed for 30 minutes after server start. Thus, if `HousekeepingFrequency` is `1`, the very first housekeeping procedure after server start will run after 30 minutes, and will repeat with one hour delay thereafter.<br>It is possible to disable automatic housekeeping by setting `HousekeepingFrequency` to `0`. In this case the housekeeping procedure can only be started by `housekeeper_execute` runtime control option and the period of outdated information deleted in one housekeeping cycle is 4 times the period since the last housekeeping cycle, but not less than 4 hours and not greater than 4 days.<br>See also [runtime control](/manual/concepts/server#runtime-control) options. Default: `1`<br> Range: 0-24 ##### HousekeepingFrequency Šis parametrs nosaka, cik bieži Zabbix veiks housekeeping procedūru stundās. Housekeeping ir novecojušas informācijas dzēšana no datubāzes.<br>*Piezīme*: Lai novērstu housekeeper pārslodzi (piemēram, ja vēstures un tendenču periodi tiek būtiski samazināti), vienā housekeeping ciklā katram vienumam tiek dzēsts ne vairāk kā 4 reizes `HousekeepingFrequency` stundas novecojušas informācijas. Tādējādi, ja `HousekeepingFrequency` ir `1`, vienā ciklā tiks dzēstas ne vairāk kā 4 stundas novecojušas informācijas (sākot no vecākā ieraksta).<br>*Piezīme*: Lai samazinātu slodzi servera startēšanas laikā, housekeeping tiek atlikts uz 30 minūtēm pēc servera starta. Tādējādi, ja `HousekeepingFrequency` ir `1`, pati pirmā housekeeping procedūra pēc servera starta tiks palaista pēc 30 minūtēm un pēc tam atkārtosies ar vienas stundas intervālu.<br>Automātisko housekeeping ir iespējams atspējot, iestatot `HousekeepingFrequency` uz `0`. Šādā gadījumā housekeeping procedūru var palaist tikai ar `housekeeper_execute` izpildlaika vadības opciju, un novecojušas informācijas periods, kas tiek dzēsts vienā housekeeping ciklā, ir 4 reizes lielāks par periodu kopš pēdējā housekeeping cikla, bet ne mazāks par 4 stundām un ne lielāks par 4 dienām.<br>Skatiet arī [izpildlaika vadības](/manual/concepts/server#runtime-control) opcijas. Noklusējums: `1`<br> Diapazons: 0-24 # housekeeping.get # housekeeping.get # Housekeeping object The following objects are directly related to the `housekeeping` API. # Housekeeping objekts Tālāk norādītie objekti ir tieši saistīti ar `housekeeping` API. ### Housekeeping The settings object has the following properties. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |hk\_events\_mode|integer|Enable internal housekeeping for events and alerts.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_events\_trigger|string|Trigger data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 365d.| |hk\_events\_service|string|Service data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 1d.| |hk\_events\_internal|string|Internal data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 1d.| |hk\_events\_discovery|string|Network discovery data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 1d.| |hk\_events\_autoreg|string|Autoregistration data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 1d.| |hk\_services\_mode|integer|Enable internal housekeeping for services.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_services|string|Services data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 365d.| |hk\_audit\_mode|integer|Enable internal housekeeping for audit.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_audit|string|Audit data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 31d.| |hk\_sessions\_mode|integer|Enable internal housekeeping for sessions.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_sessions|string|Sessions data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 365d.| |hk\_history\_mode|integer|Enable internal housekeeping for history.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_history\_global|integer|Override item history period.<br><br>Possible values:<br>0 - Do not override;<br>1 - *(default)* Override.| |hk\_history|string|History data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 31d.| |hk\_trends\_mode|integer|Enable internal housekeeping for trends.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_trends\_global|integer|Override item trend period.<br><br>Possible values:<br>0 - Do not override;<br>1 - *(default)* Override.| |hk\_trends|string|Trends data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 365d.| |db\_extension|string|Configuration flag DB extension. If this flag is set to "timescaledb" then the server changes its behavior for housekeeping and item deletion.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |compression\_availability|integer|Whether data compression is supported by the database (or its extension).<br><br>Possible values:<br>0 - Unavailable;<br>1 - Available.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |compression\_status|integer|Enable TimescaleDB compression for history and trends.<br><br>Possible values:<br>0 - *(default)* Off;<br>1 - On.| |compress\_older|string|Compress history and trends records older than specified period. Accepts seconds and time unit with suffix.<br><br>Default: 7d.| ### Uzturēšana Iestatījumu objektam ir šādas īpašības. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |hk\_events\_mode|integer|Iespējot iekšējo uzturēšanu notikumiem un brīdinājumiem.<br><br>Iespējamās vērtības:<br>0 - Atspējot;<br>1 - *(noklusējums)* Iespējot.| |hk\_events\_trigger|string|Trigeru datu glabāšanas periods. Pieņem sekundes un laika vienību ar sufiksu.<br><br>Noklusējums: 365d.| |hk\_events\_service|string|Pakalpojumu datu glabāšanas periods. Pieņem sekundes un laika vienību ar sufiksu.<br><br>Noklusējums: 1d.| |hk\_events\_internal|string|Iekšējo datu glabāšanas periods. Pieņem sekundes un laika vienību ar sufiksu.<br><br>Noklusējums: 1d.| |hk\_events\_discovery|string|Tīkla atklāšanas datu glabāšanas periods. Pieņem sekundes un laika vienību ar sufiksu.<br><br>Noklusējums: 1d.| |hk\_events\_autoreg|string|Automātiskās reģistrācijas datu glabāšanas periods. Pieņem sekundes un laika vienību ar sufiksu.<br><br>Noklusējums: 1d.| |hk\_services\_mode|integer|Iespējot iekšējo uzturēšanu pakalpojumiem.<br><br>Iespējamās vērtības:<br>0 - Atspējot;<br>1 - *(noklusējums)* Iespējot.| |hk\_services|string|Pakalpojumu datu glabāšanas periods. Pieņem sekundes un laika vienību ar sufiksu.<br><br>Noklusējums: 365d.| |hk\_audit\_mode|integer|Iespējot iekšējo uzturēšanu auditam.<br><br>Iespējamās vērtības:<br>0 - Atspējot;<br>1 - *(noklusējums)* Iespējot.| |hk\_audit|string|Audita datu glabāšanas periods. Pieņem sekundes un laika vienību ar sufiksu.<br><br>Noklusējums: 31d.| |hk\_sessions\_mode|integer|Iespējot iekšējo uzturēšanu sesijām.<br><br>Iespējamās vērtības:<br>0 - Atspējot;<br>1 - *(noklusējums)* Iespējot.| |hk\_sessions|string|Sesiju datu glabāšanas periods. Pieņem sekundes un laika vienību ar sufiksu.<br><br>Noklusējums: 365d.| |hk\_history\_mode|integer|Iespējot iekšējo uzturēšanu vēsturei.<br><br>Iespējamās vērtības:<br>0 - Atspējot;<br>1 - *(noklusējums)* Iespējot.| |hk\_history\_global|integer|Pārrakstīt vienuma vēstures periodu.<br><br>Iespējamās vērtības:<br>0 - Nepārrakstīt;<br>1 - *(noklusējums)* Pārrakstīt.| |hk\_history|string|Vēstures datu glabāšanas periods. Pieņem sekundes un laika vienību ar sufiksu.<br><br>Noklusējums: 31d.| |hk\_trends\_mode|integer|Iespējot iekšējo uzturēšanu tendencēm.<br><br>Iespējamās vērtības:<br>0 - Atspējot;<br>1 - *(noklusējums)* Iespējot.| |hk\_trends\_global|integer|Pārrakstīt vienuma tendenču periodu.<br><br>Iespējamās vērtības:<br>0 - Nepārrakstīt;<br>1 - *(noklusējums)* Pārrakstīt.| |hk\_trends|string|Tendenču datu glabāšanas periods. Pieņem sekundes un laika vienību ar sufiksu.<br><br>Noklusējums: 365d.| |db\_extension|string|Konfigurācijas karogs DB paplašinājumam. Ja šis karogs ir iestatīts uz "timescaledb", tad serveris maina savu darbību uzturēšanai un vienumu dzēšanai.<br><br>[Īpašības uzvedība](/manual/api/reference_commentary#property-behavior):<br>- *tikai lasāms*| |compression\_availability|integer|Vai datu saspiešanu atbalsta datubāze (vai tās paplašinājums).<br><br>Iespējamās vērtības:<br>0 - Nav pieejams;<br>1 - Pieejams.<br><br>[Īpašības uzvedība](/manual/api/reference_commentary#property-behavior):<br>- *tikai lasāms*| |compression\_status|integer|Iespējot TimescaleDB saspiešanu vēsturei un tendencēm.<br><br>Iespējamās vērtības:<br>0 - *(noklusējums)* Izslēgts;<br>1 - Ieslēgts.| |compress\_older|string|Saspiest vēstures un tendenču ierakstus, kas ir vecāki par norādīto periodu. Pieņem sekundes un laika vienību ar sufiksu.<br><br>Noklusējums: 7d.| # Housekeeping This class is designed to work with housekeeping. Object references: - [Housekeeping](/manual/api/reference/housekeeping/object#housekeeping) Available methods: - [housekeeping.get](/manual/api/reference/housekeeping/get) - retrieve housekeeping - [housekeeping.update](/manual/api/reference/housekeeping/update) - update housekeeping # Housekeeping Šī klase ir paredzēta darbam ar housekeeping. Objektu atsauces: - [Housekeeping](/manual/api/reference/housekeeping/object#housekeeping) Pieejamās metodes: - [housekeeping.get](/manual/api/reference/housekeeping/get) - izgūt housekeeping - [housekeeping.update](/manual/api/reference/housekeeping/update) - atjaunināt housekeeping # housekeeping.update # housekeeping.update #### How it works In log monitoring you may encounter lines similar to these: Line1: Service 1 stopped Line2: Service 2 stopped Line3: Service 1 was restarted Line4: Service 2 was restarted The idea of event correlation is to be able to match the problem event from Line1 to the resolution from Line3 and the problem event from Line2 to the resolution from Line4, and close these problems one by one: Line1: Service 1 stopped Line3: Service 1 was restarted #problem from Line 1 closed Line2: Service 2 stopped Line4: Service 2 was restarted #problem from Line 2 closed To do this you need to tag these related events as, for example, "Service 1" and "Service 2". That can be done by applying a regular expression to the log line to extract the tag value. Then, when events are created, they are tagged "Service 1" and "Service 2" respectively and problem can be matched to the resolution. #### Kā tas darbojas Žurnālu uzraudzībā jūs varat sastapt rindas, kas ir līdzīgas šīm: Line1: Pakalpojums 1 apstājās Line2: Pakalpojums 2 apstājās Line3: Pakalpojums 1 tika restartēts Line4: Pakalpojums 2 tika restartēts Notikumu korelācijas ideja ir spēt sasaistīt problēmas notikumu no Line1 ar atrisinājumu no Line3 un problēmas notikumu no Line2 ar atrisinājumu no Line4, un aizvērt šīs problēmas pa vienai: Line1: Pakalpojums 1 apstājās Line3: Pakalpojums 1 tika restartēts #problēma no Line 1 aizvērta Line2: Pakalpojums 2 apstājās Line4: Pakalpojums 2 tika restartēts #problēma no Line 2 aizvērta Lai to izdarītu, jums šie saistītie notikumi ir jāmarķē, piemēram, kā "Service 1" un "Service 2". To var izdarīt, piemērojot regulāro izteiksmi žurnāla rindai, lai iegūtu birkas vērtību. Pēc tam, kad notikumi tiek izveidoti, tiem attiecīgi tiek piešķirtas birkas "Service 1" un "Service 2", un problēmu var sasaistīt ar atrisinājumu. ### How modules work - An enabled module is launched on each HTTP request, before executing the action code. - The module will register new actions or redefine the existing ones. - The module will add new frontend sections and remove or redefine the existing ones. - The module will hook to frontend events like onBeforeAction and onTerminate, if needed. - The requested action is finally executed by running the action code - either the default one, or module-defined. ### Kā darbojas moduļi - Iespējots modulis tiek palaists ar katru HTTP pieprasījumu pirms darbības koda izpildes. - Modulis reģistrēs jaunas darbības vai pārdefinēs esošās. - Modulis pievienos jaunas lietotāja saskarne sadaļas un noņems vai pārdefinēs esošās. - Modulis, ja nepieciešams, piesaistīsies lietotāja saskarne notikumiem, piemēram, onBeforeAction un onTerminate. - Pieprasītā darbība galu galā tiek izpildīta, palaižot darbības kodu — vai nu noklusēto, vai moduļa definēto. ##### htmldecode {#htmldecode} Decoding a macro value from HTML encoding. This function is supported since Zabbix 7.0.4. The following characters are supported: |Value|Decoded value| |----|------| |`&amp;`|`&`| |`&lt;`|`<`| |`&gt;`|`>`| |`&quot;`|`"`| |`&#039;`|`'`| |`&#39;`|`'`| Example: ```default {{ITEM.VALUE}.htmldecode()} - will HTML-decode a value like "&lt;" into "<" ``` ##### htmldecode {#htmldecode} Makro vērtības atkodēšana no HTML kodējuma. Šī funkcija tiek atbalstīta kopš Zabbix 7.0.4. Tiek atbalstītas šādas rakstzīmes: |Value|Decoded value| |----|------| |`&amp;`|`&`| |`&lt;`|`<`| |`&gt;`|`>`| |`&quot;`|`"`| |`&#039;`|`'`| |`&#39;`|`'`| Piemērs: ```default {{ITEM.VALUE}.htmldecode()} - atkodēs HTML vērtību, piemēram, "&lt;" uz "<" ``` #### HTML email templates When creating or editing [message templates](/manual/config/notifications/media#message-templates) used for HTML emails, always wrap every macro with the `htmlencode()` macro function. For example: ```default <b>Problem started</b> at {{EVENT.TIME}.htmlencode()} on {{EVENT.DATE}.htmlencode()}<br><b>Problem name:</b> {{EVENT.NAME}.htmlencode()}<br><b>Host:</b> {{HOST.NAME}.htmlencode()} <br><b>Severity:</b> {{EVENT.SEVERITY}.htmlencode()}<br><b>Operational data:</b> {{EVENT.OPDATA}.htmlencode()}<br><b>Original problem ID:</b> {{EVENT.ID}.htmlencode()}<br>{{TRIGGER.URL}.htmlencode()} ``` Using `htmlencode()` ensures that any HTML characters in macro values are escaped and prevents injection of HTML into notifications (for example, an attacker inserting a malicious/phishing link into a notification). Note: the default HTML email messages provided by Zabbix already apply `htmlencode()` to macros. This guidance applies when editing existing templates or creating new ones — verify that macros are encoded before using a template to send HTML email. #### HTML e-pasta veidnes Veidojot vai rediģējot [ziņojumu veidnes](/manual/config/notifications/media#message-templates), kas tiek izmantotas HTML e-pastiem, vienmēr apvelciet katru makro ar `htmlencode()` makro funkciju. Piemēram: ```default <b>Problēma sākās</b> plkst. {{EVENT.TIME}.htmlencode()} {{EVENT.DATE}.htmlencode()}<br><b>Problēmas nosaukums:</b> {{EVENT.NAME}.htmlencode()}<br><b>Hosts:</b> {{HOST.NAME}.htmlencode()} <br><b>Smagums:</b> {{EVENT.SEVERITY}.htmlencode()}<br><b>Operatīvie dati:</b> {{EVENT.OPDATA}.htmlencode()}<br><b>Sākotnējās problēmas ID:</b> {{EVENT.ID}.htmlencode()}<br>{{TRIGGER.URL}.htmlencode()} ``` `htmlencode()` izmantošana nodrošina, ka jebkuras HTML rakstzīmes makro vērtībās tiek aizstātas un novērš HTML ievietošanu paziņojumos (piemēram, uzbrucējs var ievietot ļaunprātīgu pikšķerēšanas saiti paziņojumā). Piezīme: Zabbix nodrošinātajos noklusējuma HTML e-pasta ziņojumos makro jau tiek lietots `htmlencode()`. Šis ieteikums attiecas uz esošu veidņu rediģēšanu vai jaunu veidņu izveidi — pirms veidnes izmantošanas HTML e-pasta nosūtīšanai pārliecinieties, ka makro ir kodēti. ##### htmlencode {#htmlencode} Encoding a macro value into HTML encoding. This function is supported since Zabbix 7.0.4. The following characters are supported: |Value|Encoded value| |----|------| |`&`|`&amp;`| |`<`|`&lt;`| |`>`|`&gt;`| |`"`|`&quot;`| |`'`|`&#39;`| Example: ```default {{ITEM.VALUE}.htmlencode()} - will HTML-encode a character like "<" into "&lt;" ``` ##### htmlencode {#htmlencode} Makro vērtības kodēšana HTML kodējumā. Šī funkcija tiek atbalstīta kopš Zabbix 7.0.4. Tiek atbalstītas šādas rakstzīmes: |Value|Encoded value| |----|------| |`&`|`&amp;`| |`<`|`&lt;`| |`>`|`&gt;`| |`"`|`&quot;`| |`'`|`&#39;`| Piemērs: ```default {{ITEM.VALUE}.htmlencode()} - HTML kodēs rakstzīmi, piemēram, "<" uz "&lt;" ``` ##### HTTP agent items [HTTP agent](/manual/config/items/itemtypes/http) item is an item for executing data requests over HTTP/HTTPS. HTTP agent items are useful for sending requests to HTTP endpoints to retrieve data from services such as *Elasticsearch* and *OpenWeatherMap*, for checking the status of Zabbix API or the status of Apache or Nginx web server, etc. HTTP agent items (with trapping enabled) can also function as [trapper items](#trapper-items). ##### HTTP aģenta vienumi [HTTP aģenta](/manual/config/items/itemtypes/http) vienums ir vienums datu pieprasījumu izpildei, izmantojot HTTP/HTTPS. HTTP aģenta vienumi ir noderīgi pieprasījumu sūtīšanai uz HTTP galapunktiem, lai izgūtu datus no tādiem pakalpojumiem kā *Elasticsearch* un *OpenWeatherMap*, pārbaudītu Zabbix API statusu vai Apache vai Nginx tīmekļa servera statusu utt. HTTP aģenta vienumi (ar iespējotu uztveršanu) var darboties arī kā [trapper vienumi](#trapper-items). #### HTTP field The HTTP field object defines the name and value that is used to specify the web scenario variables, HTTP headers, and POST fields or query fields. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |name|string|Name of header/variable/POST or GET field.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |value|string|Value of header/variable/POST or GET field.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| #### HTTP lauks HTTP lauka objekts definē nosaukumu un vērtību, ko izmanto, lai norādītu tīmekļa scenārija mainīgos, HTTP galvenes un POST laukus vai vaicājuma laukus. Tam ir šādas īpašības. |Īpašība|[Type](/manual/api/reference_commentary#data-types)|Apraksts| |--|--|------| |name|string|Galvenes/mainīgā/POST vai GET lauka nosaukums.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |value|string|Galvenes/mainīgā/POST vai GET lauka vērtība.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| #### HTTP header The header object has the following properties: |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--------|---------------------------------------------------|-----------| |name|string|HTTP header name.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |value|string|Header value.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| #### HTTP galvene Galvenes objektam ir šādas īpašības: |Īpašība|[Tips](/manual/api/reference_commentary#data-types)|Apraksts| |--------|---------------------------------------------------|-----------| |name|string|HTTP galvenes nosaukums.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāta*| |value|string|Galvenes vērtība.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāta*| #### HTTP header The header object has the following properties: |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--------|---------------------------------------------------|-----------| |name|string|HTTP header name.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |value|string|Header value.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| #### HTTP galvene Galvenes objektam ir šādas īpašības: |Īpašība|[Tips](/manual/api/reference_commentary#data-types)|Apraksts| |--------|---------------------------------------------------|-----------| |name|string|HTTP galvenes nosaukums.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāta*| |value|string|Galvenes vērtība.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāta*| #### HTTP header The header object has the following properties: |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--------|---------------------------------------------------|-----------| |name|string|HTTP header name.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |value|string|Header value.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| #### HTTP galvene Galvenes objektam ir šādas īpašības: |Īpašība|[Tips](/manual/api/reference_commentary#data-types)|Apraksts| |--------|---------------------------------------------------|-----------| |name|string|HTTP galvenes nosaukums.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāts*| |value|string|Galvenes vērtība.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāts*| #### HTTP query field The query field object defines a name and value that is used to specify a URL parameter. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--------|---------------------------------------------------|-----------| |name|string|Name of the parameter.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |value|string|Parameter value.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| #### HTTP vaicājuma lauks Vaicājuma lauka objekts definē nosaukumu un vērtību, ko izmanto URL parametra norādīšanai. Tam ir šādas īpašības: |Īpašība|[Tips](/manual/api/reference_commentary#data-types)|Apraksts| |--------|---------------------------------------------------|-----------| |name|string|Parametra nosaukums.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāts*| |value|string|Parametra vērtība.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāts*| #### HTTP query field The query field object defines a name and value that is used to specify a URL parameter. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--------|---------------------------------------------------|-----------| |name|string|Name of the parameter.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |value|string|Parameter value.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| #### HTTP vaicājuma lauks Vaicājuma lauka objekts definē nosaukumu un vērtību, ko izmanto URL parametra norādīšanai. Tam ir šādas īpašības: |Īpašība|[Tips](/manual/api/reference_commentary#data-types)|Apraksts| |--------|---------------------------------------------------|-----------| |name|string|Parametra nosaukums.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāts*| |value|string|Parametra vērtība.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāts*| #### HTTP query field The query field object defines a name and value that is used to specify a URL parameter. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--------|---------------------------------------------------|-----------| |name|string|Name of the parameter.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |value|string|Parameter value.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| #### HTTP vaicājuma lauks Vaicājuma lauka objekts definē nosaukumu un vērtību, ko izmanto URL parametra norādīšanai. Tam ir šādas īpašības: |Īpašība|[Tips](/manual/api/reference_commentary#data-types)|Apraksts| |--------|---------------------------------------------------|-----------| |name|string|Parametra nosaukums.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāta*| |value|string|Parametra vērtība.<br><br>[Īpašības darbība](/manual/api/reference_commentary#property-behavior):<br>- *obligāta*| #### HttpRequest This object encapsulates cURL handle allowing to make simple HTTP requests. Errors are thrown as exceptions. ::: noteimportant The initialization of multiple `HttpRequest` objects is limited to 10 per script execution. ::: |Method|Description| |--|--------| |`addHeader(value)`|Adds HTTP header field. This field is used for all following requests until cleared with the `clearHeader()` method.<br>The total length of header fields that can be added to a single `HttpRequest` object is limited to 128 Kbytes (special characters and header names included).| |`clearHeader()`|Clears HTTP header. If no header fields are set, `HttpRequest` will set Content-Type to application/json if the data being posted is JSON-formatted; text/plain otherwise.| |`connect(url)`|Sends HTTP CONNECT request to the URL and returns the response.| |`customRequest(method, url, data)`|Allows to specify any HTTP method in the first parameter. Sends the method request to the URL with optional *data* payload and returns the response.| |`delete(url, data)`|Sends HTTP DELETE request to the URL with optional *data* payload and returns the response.| |`getHeaders(<asArray>)`|Returns the object of received HTTP header fields.<br>The `asArray` parameter may be set to "true" (e.g., `getHeaders(true)`), "false" or be undefined. If set to "true", the received HTTP header field values will be returned as arrays; this should be used to retrieve the field values of multiple same-name headers.<br>If not set or set to "false", the received HTTP header field values will be returned as strings.| |`get(url, data)`|Sends HTTP GET request to the URL with optional *data* payload and returns the response.| |`head(url)`|Sends HTTP HEAD request to the URL and returns the response.| |`options(url)`|Sends HTTP OPTIONS request to the URL and returns the response.| |`patch(url, data)`|Sends HTTP PATCH request to the URL with optional *data* payload and returns the response.| |`put(url, data)`|Sends HTTP PUT request to the URL with optional *data* payload and returns the response.| |`post(url, data)`|Sends HTTP POST request to the URL with optional *data* payload and returns the response.| |`getStatus()`|Returns the status code of the last HTTP request.| |`setProxy(proxy)`|Sets HTTP proxy to "proxy" value. If this parameter is empty, then no proxy is used.| |`setHttpAuth(bitmask, username, password)`|Sets enabled HTTP authentication methods (HTTPAUTH\_BASIC, HTTPAUTH\_DIGEST, HTTPAUTH\_NEGOTIATE, HTTPAUTH\_NTLM, HTTPAUTH\_NONE) in the 'bitmask' parameter.<br>The HTTPAUTH\_NONE flag allows to disable HTTP authentication.<br>Examples:<br>``request.setHttpAuth(HTTPAUTH_NTLM | HTTPAUTH_BASIC, username, password)``<br>`request.setHttpAuth(HTTPAUTH_NONE)`| |`trace(url, data)`|Sends HTTP TRACE request to the URL with optional *data* payload and returns the response.| Example: ```javascript try { Zabbix.log(4, 'jira webhook script value='+value); var result = { 'tags': { 'endpoint': 'jira' } }, params = JSON.parse(value), req = new HttpRequest(), fields = {}, resp; req.addHeader('Content-Type: application/json'); req.addHeader('Authorization: Basic '+params.authentication); fields.summary = params.summary; fields.description = params.description; fields.project = {"key": params.project_key}; fields.issuetype = {"id": params.issue_id}; resp = req.post('https://jira.example.com/rest/api/2/issue/', JSON.stringify({"fields": fields}) ); if (req.getStatus() != 201) { throw 'Response code: '+req.getStatus(); } resp = JSON.parse(resp); result.tags.issue_id = resp.id; result.tags.issue_key = resp.key; } catch (error) { Zabbix.log(4, 'jira issue creation failed json : '+JSON.stringify({"fields": fields})); Zabbix.log(4, 'jira issue creation failed : '+error); result = {}; } return JSON.stringify(result); ``` #### HttpRequest Šis objekts ietver cURL turi, kas ļauj veikt vienkāršus HTTP pieprasījumus. Kļūdas tiek izmestas kā izņēmumi. ::: noteimportant Vairāku `HttpRequest` objektu inicializācija ir ierobežota līdz 10 vienam skripta izpildes gadījumam. ::: |Method|Description| |--|--------| |`addHeader(value)`|Pievieno HTTP galvenes lauku. Šis lauks tiek izmantots visiem turpmākajiem pieprasījumiem, līdz tas tiek notīrīts ar `clearHeader()` metodi.<br>Kopējais galvenes lauku garums, ko var pievienot vienam `HttpRequest` objektam, ir ierobežots līdz 128 Kbaitiem (ieskaitot speciālās rakstzīmes un galveņu nosaukumus).| |`clearHeader()`|Notīra HTTP galveni. Ja nav iestatīts neviens galvenes lauks, `HttpRequest` iestatīs Content-Type uz application/json, ja nosūtāmie dati ir JSON formātā; pretējā gadījumā — text/plain.| |`connect(url)`|Nosūta HTTP CONNECT pieprasījumu uz URL un atgriež atbildi.| |`customRequest(method, url, data)`|Ļauj pirmajā parametrā norādīt jebkuru HTTP metodi. Nosūta šīs metodes pieprasījumu uz URL ar neobligātu *data* slodzi un atgriež atbildi.| |`delete(url, data)`|Nosūta HTTP DELETE pieprasījumu uz URL ar neobligātu *data* slodzi un atgriež atbildi.| |`getHeaders(<asArray>)`|Atgriež saņemto HTTP galvenes lauku objektu.<br>Parametram `asArray` var iestatīt vērtību "true" (piemēram, `getHeaders(true)`), "false" vai tas var nebūt definēts. Ja iestatīts uz "true", saņemto HTTP galvenes lauku vērtības tiks atgrieztas kā masīvi; tas jāizmanto, lai iegūtu vairāku vienāda nosaukuma galveņu lauku vērtības.<br>Ja parametrs nav iestatīts vai ir iestatīts uz "false", saņemto HTTP galvenes lauku vērtības tiks atgrieztas kā virknes.| |`get(url, data)`|Nosūta HTTP GET pieprasījumu uz URL ar neobligātu *data* slodzi un atgriež atbildi.| |`head(url)`|Nosūta HTTP HEAD pieprasījumu uz URL un atgriež atbildi.| |`options(url)`|Nosūta HTTP OPTIONS pieprasījumu uz URL un atgriež atbildi.| |`patch(url, data)`|Nosūta HTTP PATCH pieprasījumu uz URL ar neobligātu *data* slodzi un atgriež atbildi.| |`put(url, data)`|Nosūta HTTP PUT pieprasījumu uz URL ar neobligātu *data* slodzi un atgriež atbildi.| |`post(url, data)`|Nosūta HTTP POST pieprasījumu uz URL ar neobligātu *data* slodzi un atgriež atbildi.| |`getStatus()`|Atgriež pēdējā HTTP pieprasījuma statusa kodu.| |`setProxy(proxy)`|Iestata HTTP starpniekserveri uz "proxy" vērtību. Ja šis parametrs ir tukšs, starpniekserveris netiek izmantots.| |`setHttpAuth(bitmask, username, password)`|Iestata iespējotās HTTP autentifikācijas metodes (HTTPAUTH\_BASIC, HTTPAUTH\_DIGEST, HTTPAUTH\_NEGOTIATE, HTTPAUTH\_NTLM, HTTPAUTH\_NONE) parametrā 'bitmask'.<br>Karogs HTTPAUTH\_NONE ļauj atspējot HTTP autentifikāciju.<br>Piemēri:<br>``request.setHttpAuth(HTTPAUTH_NTLM | HTTPAUTH_BASIC, username, password)``<br>`request.setHttpAuth(HTTPAUTH_NONE)`| |`trace(url, data)`|Nosūta HTTP TRACE pieprasījumu uz URL ar neobligātu *data* slodzi un atgriež atbildi.| Piemērs: ```javascript try { Zabbix.log(4, 'jira webhook script value='+value); var result = { 'tags': { 'endpoint': 'jira' } }, params = JSON.parse(value), req = new HttpRequest(), fields = {}, resp; req.addHeader('Content-Type: application/json'); req.addHeader('Authorization: Basic '+params.authentication); fields.summary = params.summary; fields.description = params.description; fields.project = {"key": params.project_key}; fields.issuetype = {"id": params.issue_id}; resp = req.post('https://jira.example.com/rest/api/2/issue/', JSON.stringify({"fields": fields}) ); if (req.getStatus() != 201) { throw 'Response code: '+req.getStatus(); } resp = JSON.parse(resp); result.tags.issue_id = resp.id; result.tags.issue_key = resp.key; } catch (error) { Zabbix.log(4, 'jira issue creation failed json : '+JSON.stringify({"fields": fields})); Zabbix.log(4, 'jira issue creation failed : '+error); result = {}; } return JSON.stringify(result); ``` # httptest.create # httptest.create # httptest.delete # httptest.delete # httptest.get # httptest.get # httptest.update # httptest.update #### Hysteresis Sometimes an interval is needed between problem and recovery states, rather than a simple threshold. For example, if we want to define a trigger that reports a problem when server room temperature goes above 20°C and we want it to stay in the problem state until the temperature drops below 15°C, a simple trigger threshold at 20°C will not be enough. Instead, we need to define a trigger expression for the problem event first (temperature above 20°C). Then we need to define an additional recovery condition (temperature below 15°C). This is done by defining an additional *Recovery expression* parameter when [defining](/manual/config/triggers/trigger) a trigger. In this case, problem recovery will take place in two steps: - First, the problem expression (temperature above 20°C) will have to evaluate to FALSE - Second, the recovery expression (temperature below 15°C) will have to evaluate to TRUE The recovery expression will be evaluated only when the problem event is resolved first. ::: notewarning The recovery expression being TRUE alone does not resolve a problem if the problem expression is still TRUE! ::: #### Histerēze Dažkārt starp problēmas un atjaunošanās stāvokļiem ir nepieciešams intervāls, nevis vienkāršs slieksnis. Piemēram, ja vēlamies definēt trigeri, kas ziņo par problēmu, kad servera telpas temperatūra pārsniedz 20°C, un vēlamies, lai tas paliek problēmas stāvoklī, līdz temperatūra nokrītas zem 15°C, ar vienkāršu trigeris slieksni pie 20°C nepietiks. Tā vietā vispirms ir jādefinē trigeris izteiksme problēmas notikumam (temperatūra virs 20°C). Pēc tam ir jādefinē papildu atjaunošanās nosacījums (temperatūra zem 15°C). To izdara, definējot papildu *Recovery expression* parametru, kad [definē](/manual/config/triggers/trigger) trigeri. Šajā gadījumā problēmas atjaunošanās notiks divos soļos: - Vispirms problēmas izteiksmei (temperatūra virs 20°C) ir jānovērtējas kā FALSE - Pēc tam atjaunošanās izteiksmei (temperatūra zem 15°C) ir jānovērtējas kā TRUE Atjaunošanās izteiksme tiks novērtēta tikai tad, kad problēmas notikums vispirms ir atrisināts. ::: notewarning Ja atjaunošanās izteiksme ir TRUE pati par sevi, tā neatrisina problēmu, ja problēmas izteiksme joprojām ir TRUE! ::: ##### icmppingloss\[<target>,<packets>,<interval>,<size>,<timeout>,<options>\] {#icmppingloss} <br> The percentage of lost packets.<br> Return value: *Float*. Parameters: - **target** - the host IP or DNS name; - **packets** - the number of packets; - **interval** - the time between successive packets in milliseconds; - **size** - the packet size in bytes; - **timeout** - the timeout in milliseconds; - **options** - used for allowing redirect: if empty (default value), redirected responses are treated as target host down; if set to *allow_redirect*, redirected responses are treated as target host up. See also the table of [default values](#default-values). ##### icmppingloss\[<target>,<packets>,<interval>,<size>,<timeout>,<options>\] {#icmppingloss} <br> Zaudēto pakešu procentuālā daļa.<br> Atgrieztā vērtība: *Float*. Parametri: - **target** - hosta IP vai DNS nosaukums; - **packets** - pakešu skaits; - **interval** - laiks starp secīgām paketēm milisekundēs; - **size** - paketes izmērs baitos; - **timeout** - noildze milisekundēs; - **options** - tiek izmantots, lai atļautu pāradresāciju: ja tukšs (noklusējuma vērtība), pāradresētās atbildes tiek uzskatītas par mērķa hosta nepieejamību; ja iestatīts uz *allow_redirect*, pāradresētās atbildes tiek uzskatītas par mērķa hosta pieejamību. Skatiet arī [noklusējuma vērtību](#default-values) tabulu. ##### icmppingsec\[<target>,<packets>,<interval>,<size>,<timeout>,<mode>,<options>\] {#icmppingsec} <br> The ICMP ping response time (in seconds).<br> Return value: *Float*. Parameters: - **target** - the host IP or DNS name; - **packets** - the number of packets; - **interval** - the time between successive packets in milliseconds; - **size** - the packet size in bytes; - **timeout** - the timeout in milliseconds; - **mode** - possible values: *min*, *max*, or *avg* (default); - **options** - used for allowing redirect: if empty (default value), redirected responses are treated as target host down; if set to *allow_redirect*, redirected responses are treated as target host up. Comments: - Packets which are lost or timed out are not used in the calculation; - If the host is not available (timeout reached), the item will return 0; - If the return value is less than 0.0001 seconds, the value will be set to 0.0001 seconds; - See also the table of [default values](#default-values). ##### icmppingsec\[<target>,<packets>,<interval>,<size>,<timeout>,<mode>,<options>\] {#icmppingsec} <br> ICMP ping atbildes laiks (sekundēs).<br> Atgrieztā vērtība: *Float*. Parametri: - **target** - hosta IP adrese vai DNS nosaukums; - **packets** - pakešu skaits; - **interval** - laiks starp secīgām paketēm milisekundēs; - **size** - paketes izmērs baitos; - **timeout** - noildze milisekundēs; - **mode** - iespējamās vērtības: *min*, *max* vai *avg* (noklusējums); - **options** - izmanto, lai atļautu pāradresāciju: ja tukšs (noklusējuma vērtība), pāradresētās atbildes tiek uzskatītas par mērķa hosta nepieejamību; ja iestatīts uz *allow_redirect*, pāradresētās atbildes tiek uzskatītas par mērķa hosta pieejamību. Komentāri: - Aprēķinā netiek izmantotas paketes, kas ir zudušas vai kurām iestājusies noildze; - Ja hosts nav pieejams (sasniegta noildze), vienums atgriezīs 0; - Ja atgrieztā vērtība ir mazāka par 0.0001 sekundēm, vērtība tiks iestatīta uz 0.0001 sekundēm; - Skatiet arī [noklusējuma vērtību](#default-values) tabulu. ### ICMP pings Zabbix uses an external utility **[fping](https://fping.org/)** to process ICMP pings (**icmpping**, **icmppingloss**, **icmppingsec**). ### ICMP pingi Zabbix izmanto ārēju utilītu **[fping](https://fping.org/)**, lai apstrādātu ICMP pingus (**icmpping**, **icmppingloss**, **icmppingsec**). ##### icmpping\[<target>,<packets>,<interval>,<size>,<timeout>,<options>\] {#icmpping} <br> The host accessibility by ICMP ping.<br> Return value: *0* - ICMP ping fails; *1* - ICMP ping successful. Parameters: - **target** - the host IP or DNS name; - **packets** - the number of packets; - **interval** - the time between successive packets in milliseconds; - **size** - the packet size in bytes; - **timeout** - the timeout in milliseconds; - **options** - used for allowing redirect: if empty (default value), redirected responses are treated as target host down; if set to *allow_redirect*, redirected responses are treated as target host up. See also the table of [default values](#default-values). Comment: - If at least one of the packets defined by the `packets` parameter is returned, the item returns `1`. If all of the packets fail to return, the item returns `0`. Example: icmpping[,4] #If at least one of the four packets is returned, the item returns 1.